execbro 0.0.1-reserve → 1.10.13

package/build/core/guides.js

@@ -0,0 +1,397 @@
+/**
+ * Usage guides for MCP tools.
+ * Returned by the get_usage_guide tool to help agents understand recommended workflows.
+ */
+const guides = [
+    {
+        id: "setup",
+        title: "Session Setup",
+        summary: "Connect to a running React Native app via Metro bundler",
+        content: `# Session Setup
+
+## Prerequisites (CRITICAL — install BEFORE using device tools)
+- **iOS UI driver (required for tap, ios_button, and all iOS interaction tools):**
+  - Default: AXe — brew install cameroncooke/axe/axe
+  - Alternative: IDB — brew install idb-companion (set IOS_DRIVER=idb in MCP server env to use it)
+  - Without a UI driver, most iOS tools will fail with "not installed" errors
+- **Android:** ADB must be in PATH (comes with Android SDK Platform Tools)
+
+## Quick Start
+1. scan_metro — auto-discovers Metro on common ports (8081, 8082, 19000-19002) and connects. Note: this occupies the CDP slot, which prevents the built-in React Native debugger from connecting. See "Switch to Native Debugger" below.
+2. get_apps — verify the app appears in connected list
+3. get_connection_status — check connection health
+
+## If No App Running
+- list_ios_simulators / list_android_devices — find available devices
+- ios_boot_simulator — boot an iOS simulator if needed
+- ios_launch_app / android_launch_app — launch the app
+- Wait 2-3 seconds, then scan_metro
+
+## Switch to Native Debugger
+- disconnect_metro — closes all CDP connections and stops auto-reconnect
+- The built-in React Native debugger can now connect
+- Use scan_metro to reconnect when done with native debugger
+
+## Key Tools
+- scan_metro: auto-discover and connect (preferred)
+- connect_metro: connect to specific port (when you know it)
+- disconnect_metro: close all connections (free CDP slot for native debugger)
+- ensure_connection: health check with healthCheck=true
+- get_connection_status: check uptime and gaps`
+    },
+    {
+        id: "inspect",
+        title: "Component Inspection",
+        summary: "Identify which React component renders a UI element, get hierarchy and file paths",
+        content: `# Component Inspection
+
+## Recommended Workflow: Identify a Component on Screen
+1. Take a screenshot (ios_screenshot / android_screenshot) or use ocr_screenshot
+2. Identify the target element visually, estimate its coordinates
+3. Convert screenshot pixels to points: divide by device pixel ratio (e.g. pixel_x / 3 for @3x iPhones)
+4. Pick the right tool (see decision below) and call it with (x, y)
+
+## get_inspector_selection vs inspect_at_point — DECISION GUIDE
+
+Both answer "what is at (x, y)?" but surface different supplementary data. Pick by what you need next.
+
+| Question you're asking | Use |
+|---|---|
+| "Why is the borderRadius wrong?" / "What's the padding here?" | get_inspector_selection — RICH STYLE per ancestor |
+| "Why is this hit area so small?" / "Where exactly is each ancestor?" | inspect_at_point — FRAME PER ANCESTOR |
+| "What handler is wired to this Pressable?" / "What testID does it have?" | inspect_at_point — full PROPS (including [Function] handlers) |
+| "Which file owns this component?" | get_inspector_selection (source paths pre-wired; null on React 19 today) |
+| "I need to call this multiple times rapidly" or "before/after a transition" | inspect_at_point — pure JS, no overlay flicker |
+
+### get_inspector_selection(x, y)
+- Invokes RN's Element Inspector programmatically (auto toggles overlay on, captures, toggles back off — ~600ms total, brief flicker).
+- Returns: element name, full owner-tree path, frame of the inspected element, merged style of the inspected element, AND a hierarchy where each entry has its own resolved style (paddingHorizontal, borderRadius, fontFamily, etc.).
+- Best for visual/style debugging where you want to see exactly what RN's on-device overlay shows.
+
+### inspect_at_point(x, y)
+- Pure fiber-tree hit test via measureInWindow. NO overlay, zero visual side effect.
+- Returns: element name, path, hit-tested ancestors with FRAME PER ANCESTOR, and PROPS (handlers, refs, testID, custom props, style as a flat reference).
+- Best for layout measurements, props inspection, and any rapid/repeated calls.
+
+### Other inspection tools
+- find_components(pattern) — regex search by component name across the fiber tree.
+- get_component_tree — full tree overview. Use focusedOnly=true and structureOnly=true for compact output.
+- inspect_component(name) — deep dive into a specific component's props, state, and hooks.
+
+## Tips
+- Both tools work on Paper, Fabric, and Bridgeless / new arch.
+- toggle_element_inspector is rarely needed — get_inspector_selection auto-toggles the overlay around its capture and hides it afterward.
+- Coordinates: get_inspector_selection accepts points/dp; inspect_at_point accepts dp (divide screenshot pixels by pixel ratio).`
+    },
+    {
+        id: "layout",
+        title: "Layout Debugging",
+        summary: "Capture screenshots, verify UI changes, inspect layout frames and styles",
+        content: `# Layout Debugging
+
+## Verify UI Changes
+1. ios_screenshot / android_screenshot — capture current screen
+2. Compare visually against expected result or Figma design
+3. If an issue is spotted, drill down with inspection tools
+
+## Inspect at a Point — Pick the Right Tool
+- Style/identity ("what is this and how is it styled?") → get_inspector_selection(x, y)
+  - Returns RN's curated hierarchy with merged style PER ANCESTOR (padding, margin, border, layout).
+  - Briefly toggles the on-device overlay (auto-hidden after capture).
+- Layout/props ("frames per ancestor, handler functions, refs") → inspect_at_point(x, y)
+  - Returns frame for each hit ancestor + full props (handlers as [Function], testID, refs).
+  - Pure JS hit test, no overlay flicker — preferred for rapid calls or before/after comparisons.
+
+Most layout-debugging questions ("why is this clipped?", "what's the actual size?") fit inspect_at_point.
+Most styling questions ("why does this border look wrong?") fit get_inspector_selection.
+
+## Full Screen Layout
+- get_screen_layout — full layout data for all components
+- Use componentsOnly=true to hide host components (View, Text) and see only custom components
+- find_components with includeLayout=true for targeted layout info
+
+## Key Tools
+- ios_screenshot / android_screenshot: visual capture
+- tap: also returns a post-tap screenshot by default (no separate screenshot call needed after tapping)
+- ocr_screenshot: screenshot with text recognition and tap coordinates
+- inspect_at_point: frames per ancestor + props (no overlay, fast)
+- get_inspector_selection: rich style per ancestor (briefly toggles RN inspector overlay)`
+    },
+    {
+        id: "interact",
+        title: "Device Interaction",
+        summary: "Tap buttons, swipe, type text, and navigate the app UI",
+        content: `# Device Interaction
+
+## Prerequisites
+iOS interaction tools (tap, ios_button) require a UI driver:
+- Default: AXe — brew install cameroncooke/axe/axe
+- Alternative: IDB — brew install idb-companion (set IOS_DRIVER=idb in MCP server env to use it)
+Without a UI driver installed, these tools will fail.
+
+## Tapping Elements
+Use tap — it tries multiple strategies automatically and returns a post-tap screenshot:
+1. tap(testID="login-btn") — most reliable, works via fiber tree (both platforms) and accessibility (Android)
+2. tap(text="Login") — text match via fiber tree, then accessibility, then OCR
+3. tap(component="IconName") — component name match with parent traversal (for icon-only buttons; use find_components to discover names first)
+4. tap(x=..., y=...) — coordinate-based tap from screenshot (last resort)
+5. tap(x=..., y=..., native=true) — taps directly via ADB/simctl without React Native connection (for system dialogs, non-RN apps)
+
+tap returns a screenshot after every action (screenshot=true by default) — no need to call ios_screenshot/android_screenshot after tapping.
+For coordinate/accessibility/OCR taps, it also verifies if the tap caused a visual change (verify=true by default). Set screenshot=false for fastest execution.
+
+## Best Practice: Use testID
+Set testID on all interactive elements (buttons, inputs, links) for reliable tapping:
+- More stable than text matching — doesn't break with translations or UI text changes
+- Exact match — no ambiguity when multiple elements share similar text
+- Works across fiber (iOS + Android) and accessibility (Android via resource-id)
+- Also enables TextInput focusing: tap(testID="email-input") finds inputs via fiber
+
+## TextInput Fields
+tap detects TextInput elements (onChangeText/onFocus) in the fiber tree and falls through to native tap (accessibility or coordinates) for actual focus. This means tap(testID="email-input") works even though inputs don't have onPress.
+
+### Replacing pre-filled values (Bridgeless/Fabric only)
+Inputs that already contain text are the most common verification-blocker. The typing tools APPEND by default — typing "https://app.example.com" into a field that already holds "https://demo.example.com" produces "https://demo.example.comhttps://app.example.com", not the intended replacement. Three dedicated tools handle this on Bridgeless/Fabric apps:
+
+- **clear_focused_input** — empty the currently focused TextInput, with the React state owner notified via onChangeText. Use BEFORE typing into a pre-filled field. Returns "no focused TextInput" (not a silent no-op) if nothing has focus.
+- **ios_input_text / android_input_text with replace:true** — one-shot: clear the focused field, then type. Equivalent to clear_focused_input + input_text but in a single call.
+- **dismiss_keyboard** — blur the currently focused TextInput, closing the on-screen keyboard. Useful before tapping buttons hidden behind the keyboard, or to verify "tap outside dismisses" behavior.
+
+All three target whatever has focus (no testID needed). They update React state via onChangeText("") — controlled components (Formik, react-hook-form, useState) stay consistent. Calling publicInstance.clear() directly does NOT do this; it only updates the native side and leaves form state stale.
+
+Multi-device sessions: pass device="<rn-device-name>" (substring match) to disambiguate when replace:true is used. Single-device sessions can omit.
+
+## Icon-Only Buttons
+For buttons that contain only an icon (no text):
+- tap(component="CartIcon") — finds the icon and walks up the fiber tree to press the nearest pressable parent
+- Use maxTraversalDepth to increase parent search depth (default: 15) for deeply wrapped components
+
+## Non-ASCII Text (Cyrillic, CJK, Arabic)
+tap(text=...) skips fiber for non-ASCII (Hermes limitation) and uses accessibility/OCR instead. For best results, use testID or coordinates.
+
+## Other Interactions
+- swipe: cross-platform swipe/scroll with start/end coordinates. Use for FlatList/SectionList scrolling where off-screen items aren't mounted. Returns verification.meaningful — if false the gesture had no visual effect (end-of-list, non-scrollable surface, or coordinates missed the scroll surface). Set burst:true to surface overscroll/bounce feedback even when the final state is unchanged. Set verify:false, screenshot:false for the fastest path when you only care about firing the gesture. Pass delta on iOS to control touch step size.
+- android_input_text / ios_input_text: type text (tap input field first to focus). Pass replace:true to clear pre-filled values before typing (Bridgeless/Fabric only).
+- clear_focused_input: clear the focused TextInput via onChangeText (controlled-state safe). Pair with input_text for replace flows, or use input_text({replace:true}) for one-shot.
+- dismiss_keyboard: blur the focused input, closing the keyboard.
+- ios_button / android_key_event: hardware buttons (HOME, BACK, etc.)
+- ios_open_url: deep links and universal links
+
+## After Interactions
+- Take a screenshot to verify the result`
+    },
+    {
+        id: "logs",
+        title: "Debug Logs",
+        summary: "Read console logs, errors, and warnings from the running app",
+        content: `# Debug Logs
+
+## Workflow
+1. get_logs with summary=true — get counts by level and last 5 messages (overview first)
+2. Based on what you see:
+   - get_logs with level="error" — errors only
+   - search_logs with text="..." — find specific messages
+   - get_logs with verbose=true and maxLogs=10 — full details for recent entries
+3. clear_logs — reset buffer, then re-capture after a specific action
+
+## Key Tools
+- get_logs: retrieve logs with filtering (level, maxLogs, summary, verbose, startFromText)
+- search_logs: text search across all captured logs
+- clear_logs: reset the log buffer
+
+## Tips
+- Always start with summary=true to avoid token overload
+- Use verbose=true with low maxLogs for full error details
+- Use startFromText to begin reading from a specific point`
+    },
+    {
+        id: "network",
+        title: "Network Inspection",
+        summary: "Debug API calls, check request/response data, find failed requests",
+        content: `# Network Inspection
+
+## Important: Network Capture Limitations
+
+Network capture works differently depending on your React Native architecture:
+
+**Without SDK (basic mode):**
+- Works best on RN 0.73-0.75 (Hermes + Bridge) via CDP Network domain
+- On Bridgeless targets (Expo SDK 52+, RN 0.76+), uses a JS fetch interceptor as fallback — may miss early startup requests (auth, config, initial API calls)
+- Does NOT capture request/response bodies or full headers
+- Some architecture combinations may not capture network data at all
+
+**With SDK (recommended for network debugging):**
+- Install: npm install execbro-sdk
+- Captures ALL requests from app startup including auth flows and token refresh
+- Full request/response headers and bodies (including GraphQL queries and responses)
+- Works reliably on all RN architectures
+
+If network tools return no data or you need startup requests, recommend the SDK to the user.
+
+## Workflow
+1. get_network_stats or get_network_requests with summary=true — overview of all requests
+2. Filter by what you need:
+   - get_network_requests with urlPattern, method, or status filters
+   - search_network with urlPattern for text search
+3. get_request_details with requestId — full headers, body, timing for a specific request
+4. clear_network — reset buffer, then re-capture
+
+## Key Tools
+- get_network_requests: list requests with filters (urlPattern, method, status, summary)
+- get_network_stats: quick stats overview
+- search_network: search by URL pattern
+- get_request_details: full request/response details (use verbose=true for large payloads). With SDK installed, includes full request/response bodies.
+- clear_network: reset the request buffer
+
+## Tips
+- Start with summary=true to see the request landscape
+- Use get_request_details with verbose=true for full JSON payloads
+- If no network data appears, the app may be on a Bridgeless target — suggest installing the SDK
+- With SDK: response bodies show full GraphQL responses, useful for debugging data issues`
+    },
+    {
+        id: "state",
+        title: "App State",
+        summary: "Inspect Redux store, global variables, and execute JavaScript in the app",
+        content: `# App State
+
+## Workflow
+1. list_debug_globals — discover what's exposed (Redux store, navigation refs, action creators). If the SDK is installed, the response includes an \`sdk.paths\` array of ready-to-use dotted paths.
+2. inspect_global with objectName — see properties and methods before calling them. Accepts identifiers AND dotted paths (e.g. \`__RN_AI_DEVTOOLS__.stores.redux\`).
+3. execute_in_app — run JavaScript expressions in the app context
+
+## SDK Integration (execbro-sdk, formerly react-native-ai-devtools-sdk)
+If the app called \`init({ stores, navigation, custom })\`, prefer the SDK paths over scattered globals:
+- Inspect a registered store: inspect_global("__RN_AI_DEVTOOLS__.stores.redux")
+- Inspect navigation ref: inspect_global("__RN_AI_DEVTOOLS__.navigation")
+- Inspect a custom object (e.g. mmkv, api client): inspect_global("__RN_AI_DEVTOOLS__.custom.mmkv")
+- Read state: execute_in_app("__RN_AI_DEVTOOLS__.stores.redux.getState().sliceName")
+
+## Common Patterns (no SDK)
+- Read Redux: execute_in_app("globalThis.__REDUX_STORE__.getState().sliceName")
+- Dispatch action: execute_in_app("globalThis.__dispatch__(globalThis.__REDUX_ACTIONS__.slice.action(args))")
+- Navigate: execute_in_app("globalThis.__navigate__('ScreenName')")
+- Current route: execute_in_app("globalThis.__getCurrentRoute__()")
+
+## Hermes Limitations
+- NO require() or import — only pre-existing globals
+- NO async/await — use simple expressions or .then() chains
+- NO emoji or non-ASCII in string literals
+- Use globalThis instead of global
+
+## Tips
+- Always inspect_global before calling methods on unfamiliar objects
+- Use verbose=true with caution — Redux stores can return 10KB+
+- Set higher maxResultLength when default 2000 chars isn't enough`
+    },
+    {
+        id: "bundle",
+        title: "Bundle Health",
+        summary: "Check Metro bundler status, fix compilation errors, reload the app",
+        content: `# Bundle Health
+
+## Workflow
+1. get_bundle_status — check if Metro is running and its build state
+2. get_bundle_errors — check for compilation/bundling errors
+3. Fix errors in code
+4. clear_bundle_errors — clear the error buffer
+5. reload_app — trigger full JS bundle reload (only if needed)
+
+## When to Reload
+React Native has Fast Refresh by default. Only reload_app when:
+- Changes aren't appearing after a few seconds
+- App is in a broken/error state
+- Need to reset full app state (navigation, context)
+- Made changes to native code or config files
+
+## Red Screen Errors
+If no errors captured via CDP, use get_bundle_errors with platform="ios" or "android" — this triggers screenshot+OCR fallback to read errors from the device screen.
+
+## Key Tools
+- get_bundle_status: Metro health check
+- get_bundle_errors: compilation errors
+- clear_bundle_errors: clear error buffer
+- reload_app: full JS bundle reload
+- ensure_connection: verify connection with healthCheck=true`
+    },
+    {
+        id: "feedback",
+        title: "Feedback",
+        summary: "Share feedback, request features, or report bugs to the development team",
+        content: `# Feedback
+
+## When to Use
+When you or the user want to report something about the ExecBro tools themselves — a tool that misbehaved, was confusing, was missing, or could be improved. Scope is strictly the debugging tooling. Do NOT use this to report bugs in the user's app under test or to summarize the feature/task worked on in the session — that is not what this channel is for.
+
+## How It Works
+1. Call send_feedback with a type (feedback, feature_request, or bug), title, and description
+2. The tool auto-collects environment info (server version, platform, device, license)
+3. It returns a pre-filled GitHub issue URL and a formatted issue body
+4. Ask the user to open the URL and paste the body to submit
+
+## Parameters
+- type: "feedback", "feature_request", or "bug"
+- title: short summary (becomes the GitHub issue title)
+- description: detailed explanation
+- workflow_context (optional): what the user was trying to do
+
+## End-of-Session Experience Report
+At the end of a session, you can self-report your experience using the tools — this is some of the most valuable feedback we get. When asked (or proactively when a session wrapped up with notable friction):
+1. Write a report covering where the ExecBro tools made you struggle and what about them could be improved — which tool, what you expected, what happened. Keep it about the tools, not the app you were debugging. Save it as a Markdown file for the user.
+2. Call send_feedback with type "feedback", a short title, and the report as the description (set workflow_context to which ExecBro tools / steps were involved). This turns the report into a pre-filled GitHub issue URL.
+3. Give the user the returned URL and ask them to open and submit it.
+
+Saving the Markdown file alone does NOT reach the team — you must call send_feedback to generate the GitHub issue.
+
+Suggested prompt the user can paste to trigger this:
+> Write a report about your experience with the ExecBro tools specifically — which tools made the debugging work harder, what you expected vs. what happened, and what could be improved. Don't summarize the app feature we worked on; focus on the tools. Save it as a Markdown file for me, then submit it using the send_feedback tool (type "feedback") so it becomes a GitHub issue.
+
+## Tips
+- Include workflow_context when possible — name the ExecBro tools/steps in play so the team can reproduce the tooling issue
+- The user can review and edit the issue body before submitting
+- No GitHub account setup or CLI tools needed — just a browser`
+    }
+];
+/**
+ * Shared quick decision tree body — embedded into the MCP server-level
+ * `instructions` field (src/index.ts) AND into `getGuideOverview()` so agents
+ * see identical guidance regardless of whether their client surfaces
+ * `instructions`. Keep this as the single source of truth.
+ */
+export const DECISION_TREE = [
+    "Primary tools: scan_metro, get_logs / search_logs, ios_screenshot / android_screenshot, tap, get_pressable_elements, get_screen_layout.",
+    "Platform-specific ios_* / android_* tools (ios_button, android_input_text, android_key_event, android_long_press, ios_open_url, etc.) are FALLBACKS for non-React or native-only flows — prefer the cross-platform primary tools above whenever possible.",
+    "",
+    "Call get_usage_guide(topic=...) for end-to-end workflows. Available topics:",
+    "  setup     — session setup (scan_metro, connect_metro, ensure_connection)",
+    "  logs      — console debugging (get_logs, search_logs)",
+    "  interact  — device interaction (tap, swipe, screenshots, android_input_text, clear_focused_input, dismiss_keyboard)",
+    "  layout    — on-screen layout check (get_screen_layout, get_pressable_elements)",
+    "  inspect   — component inspection (find_components, inspect_component, get_inspector_selection)",
+    "  network   — network request inspection (get_network_requests, search_network)",
+    "  state     — app state & JS execution (execute_in_app, list_debug_globals)",
+    "  bundle    — bundle / Metro error checks (get_bundle_status, get_bundle_errors)",
+    "  feedback  — share feedback, feature requests, or bug reports (send_feedback)"
+].join("\n");
+export function getGuideOverview() {
+    const guideList = guides.map((g) => `  ${g.id} — ${g.summary}`).join("\n");
+    return `Quick decision tree
+-------------------
+${DECISION_TREE}
+
+Available usage guides:
+
+${guideList}
+
+Call get_usage_guide with a topic parameter for the full guide.`;
+}
+export function getGuideByTopic(topic) {
+    const guide = guides.find((g) => g.id === topic.toLowerCase());
+    if (!guide)
+        return null;
+    return guide.content;
+}
+export function getAvailableTopics() {
+    return guides.map((g) => g.id);
+}
+//# sourceMappingURL=guides.js.map

package/build/core/guides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guides.js","sourceRoot":"","sources":["../../src/core/guides.ts"],"names":[],"mappings":"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"}

package/build/core/iconSemantics.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Map an icon component name to a semantic guess, or null when the name
+ * carries no recognizable icon keyword.
+ *
+ *   iconSemanticHint("SvgChevronBackward") → "possibly back button"
+ *   iconSemanticHint("CheckboxOutline")    → "possibly checkbox"
+ *   iconSemanticHint("FloatingHeader")     → null
+ */
+export declare function iconSemanticHint(name: string | null | undefined): string | null;
+/**
+ * Build the display label for an icon-only pressable: the most specific
+ * component name plus the semantic guess when one exists.
+ *
+ *   iconLabel("FloatingHeader", "SvgChevronBackward") → "SvgChevronBackward — possibly back button"
+ *   iconLabel("FloatingHeader", null)                 → null
+ */
+export declare function iconLabel(component: string | null | undefined, icon: string | null | undefined): string | null;
+//# sourceMappingURL=iconSemantics.d.ts.map

package/build/core/iconSemantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconSemantics.d.ts","sourceRoot":"","sources":["../../src/core/iconSemantics.ts"],"names":[],"mappings":"AA8EA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAe/E;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAI9G"}

package/build/core/iconSemantics.js

@@ -0,0 +1,114 @@
+// ============================================================================
+// Icon component name → semantic hint ("possibly back button")
+//
+// Icon-only pressables usually wrap an icon component whose NAME carries the
+// semantics the visible UI doesn't (SvgChevronBackward, CloseIcon, RadioOn).
+// This module maps those names to a human/agent-readable guess so labels read
+// "SvgChevronBackward — possibly back button" instead of "(icon/image)".
+// ============================================================================
+/**
+ * Split a component name into lowercase words: strips Svg/Icon affixes,
+ * splits camelCase / kebab / snake. "SvgChevronBackward" → ["chevron","backward"].
+ */
+function iconNameWords(name) {
+    return String(name)
+        .replace(/^(Svg|Icon|Ico)(?=[A-Z0-9])/, "")
+        .replace(/(Svg|Icon)$/, "")
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2")
+        .replace(/[^a-zA-Z0-9]+/g, " ")
+        .toLowerCase()
+        .split(/\s+/)
+        .filter(Boolean);
+}
+// Ordered rules — first match wins. Keywords are matched as whole words so
+// "Feedback" does not match "back" and "Background" does not match "back".
+// More specific rules (checkbox) must precede their prefixes (check).
+const ICON_HINT_RULES = [
+    { keywords: ["checkbox"], hint: "possibly checkbox" },
+    { keywords: ["radio"], hint: "possibly radio button" },
+    { keywords: ["back", "backward", "backwards", "goback", "previous", "prev"], hint: "possibly back button" },
+    { keywords: ["forward", "next"], hint: "possibly forward/next button" },
+    { keywords: ["close", "cross", "xmark", "times", "dismiss"], hint: "possibly close button" },
+    { keywords: ["check", "checkmark", "tick", "done"], hint: "possibly confirm/check button" },
+    { keywords: ["plus", "add"], hint: "possibly add button" },
+    { keywords: ["minus", "subtract"], hint: "possibly remove/decrease button" },
+    { keywords: ["trash", "delete", "bin", "garbage"], hint: "possibly delete button" },
+    { keywords: ["search", "magnifier", "magnify", "magnifying"], hint: "possibly search button" },
+    { keywords: ["menu", "hamburger", "bars", "drawer"], hint: "possibly menu button" },
+    { keywords: ["settings", "gear", "cog"], hint: "possibly settings button" },
+    { keywords: ["heart", "favorite", "favourite"], hint: "possibly favorite button" },
+    { keywords: ["star", "rating"], hint: "possibly rating/favorite button" },
+    { keywords: ["share", "export"], hint: "possibly share button" },
+    { keywords: ["edit", "pencil", "pen"], hint: "possibly edit button" },
+    { keywords: ["camera", "photo"], hint: "possibly camera button" },
+    { keywords: ["bell", "notification", "notifications"], hint: "possibly notifications button" },
+    { keywords: ["user", "profile", "person", "avatar", "account"], hint: "possibly profile button" },
+    { keywords: ["home", "house"], hint: "possibly home button" },
+    { keywords: ["cart", "bag", "basket"], hint: "possibly cart button" },
+    { keywords: ["filter", "funnel"], hint: "possibly filter button" },
+    { keywords: ["refresh", "reload", "sync"], hint: "possibly refresh button" },
+    { keywords: ["logout", "signout"], hint: "possibly logout button" },
+    { keywords: ["send"], hint: "possibly send button" },
+    { keywords: ["download"], hint: "possibly download button" },
+    { keywords: ["upload"], hint: "possibly upload button" },
+    { keywords: ["copy"], hint: "possibly copy button" },
+    { keywords: ["qr", "scan", "barcode"], hint: "possibly scan button" },
+    { keywords: ["play"], hint: "possibly play button" },
+    { keywords: ["pause"], hint: "possibly pause button" },
+    { keywords: ["eye", "visibility"], hint: "possibly visibility toggle" },
+    { keywords: ["lock", "padlock"], hint: "possibly lock button" },
+    { keywords: ["calendar", "date"], hint: "possibly calendar/date button" },
+    { keywords: ["info", "information"], hint: "possibly info button" },
+    { keywords: ["question", "help", "faq"], hint: "possibly help button" },
+    { keywords: ["more", "dots", "ellipsis", "kebab", "meatball", "options"], hint: "possibly more-options button" },
+    { keywords: ["toggle", "switch"], hint: "possibly toggle" },
+];
+// Direction words for composite chevron/arrow/caret matching.
+const ICON_BASES = ["chevron", "arrow", "caret", "angle"];
+const DIRECTION_HINTS = [
+    { keywords: ["left", "back", "backward", "backwards", "previous", "prev"], hint: "possibly back button" },
+    { keywords: ["right", "forward", "next"], hint: "possibly forward/next button" },
+    { keywords: ["down"], hint: "possibly expand/open button" },
+    { keywords: ["up"], hint: "possibly collapse button" },
+];
+/**
+ * Map an icon component name to a semantic guess, or null when the name
+ * carries no recognizable icon keyword.
+ *
+ *   iconSemanticHint("SvgChevronBackward") → "possibly back button"
+ *   iconSemanticHint("CheckboxOutline")    → "possibly checkbox"
+ *   iconSemanticHint("FloatingHeader")     → null
+ */
+export function iconSemanticHint(name) {
+    if (!name)
+        return null;
+    const words = iconNameWords(name);
+    if (words.length === 0)
+        return null;
+    const has = (keywords) => keywords.some((k) => words.includes(k));
+    if (has(ICON_BASES)) {
+        for (const rule of DIRECTION_HINTS) {
+            if (has(rule.keywords))
+                return rule.hint;
+        }
+    }
+    for (const rule of ICON_HINT_RULES) {
+        if (has(rule.keywords))
+            return rule.hint;
+    }
+    return null;
+}
+/**
+ * Build the display label for an icon-only pressable: the most specific
+ * component name plus the semantic guess when one exists.
+ *
+ *   iconLabel("FloatingHeader", "SvgChevronBackward") → "SvgChevronBackward — possibly back button"
+ *   iconLabel("FloatingHeader", null)                 → null
+ */
+export function iconLabel(component, icon) {
+    const source = icon || component;
+    const hint = iconSemanticHint(source);
+    return hint ? `${source} — ${hint}` : null;
+}
+//# sourceMappingURL=iconSemantics.js.map

package/build/core/iconSemantics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconSemantics.js","sourceRoot":"","sources":["../../src/core/iconSemantics.ts"],"names":[],"mappings":"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"}

package/build/core/imageBuffer.d.ts

@@ -0,0 +1,37 @@
+export interface ImageEntry {
+    id: string;
+    image: Buffer;
+    timestamp: number;
+    source: string;
+    groupId?: string;
+    metadata?: Record<string, any>;
+}
+export interface ImageGroup {
+    groupId: string;
+    intent: string;
+    source: string;
+    timestamp: number;
+    frameCount: number;
+    summary: Record<string, any>;
+}
+export type ImageEntryMeta = Omit<ImageEntry, "image">;
+export declare class ImageBuffer {
+    private entries;
+    private groups;
+    private maxSize;
+    constructor(maxSize?: number);
+    add(entry: ImageEntry): void;
+    addGroup(group: ImageGroup): void;
+    getById(id: string): ImageEntry | undefined;
+    getByGroupFrame(groupId: string, frameIndex: number): ImageEntry | undefined;
+    listEntries(options?: {
+        source?: string;
+        groupId?: string;
+        last?: number;
+    }): ImageEntryMeta[];
+    listGroups(): ImageGroup[];
+    clear(): number;
+    get size(): number;
+    private cleanupGroupIfEmpty;
+}
+//# sourceMappingURL=imageBuffer.d.ts.map

package/build/core/imageBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageBuffer.d.ts","sourceRoot":"","sources":["../../src/core/imageBuffer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAEvD,qBAAa,WAAW;IACpB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAW;IAIhC,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAU5B,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI3C,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAM5E,WAAW,CAAC,OAAO,GAAE;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACZ,GAAG,cAAc,EAAE;IAkBzB,UAAU,IAAI,UAAU,EAAE;IAI1B,KAAK,IAAI,MAAM;IAOf,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,mBAAmB;CAM9B"}

package/build/core/imageBuffer.js

@@ -0,0 +1,58 @@
+export class ImageBuffer {
+    entries = [];
+    groups = new Map();
+    maxSize;
+    constructor(maxSize = 50) {
+        this.maxSize = maxSize;
+    }
+    add(entry) {
+        this.entries.push(entry);
+        while (this.entries.length > this.maxSize) {
+            const evicted = this.entries.shift();
+            if (evicted?.groupId) {
+                this.cleanupGroupIfEmpty(evicted.groupId);
+            }
+        }
+    }
+    addGroup(group) {
+        this.groups.set(group.groupId, group);
+    }
+    getById(id) {
+        return this.entries.find((e) => e.id === id);
+    }
+    getByGroupFrame(groupId, frameIndex) {
+        return this.entries.find((e) => e.groupId === groupId && e.metadata?.frameIndex === frameIndex);
+    }
+    listEntries(options = {}) {
+        let filtered = this.entries;
+        if (options.source) {
+            filtered = filtered.filter((e) => e.source === options.source);
+        }
+        if (options.groupId) {
+            filtered = filtered.filter((e) => e.groupId === options.groupId);
+        }
+        if (options.last && options.last > 0) {
+            filtered = filtered.slice(-options.last);
+        }
+        return filtered.map(({ image, ...meta }) => meta);
+    }
+    listGroups() {
+        return Array.from(this.groups.values());
+    }
+    clear() {
+        const count = this.entries.length;
+        this.entries = [];
+        this.groups.clear();
+        return count;
+    }
+    get size() {
+        return this.entries.length;
+    }
+    cleanupGroupIfEmpty(groupId) {
+        const hasEntries = this.entries.some((e) => e.groupId === groupId);
+        if (!hasEntries) {
+            this.groups.delete(groupId);
+        }
+    }
+}
+//# sourceMappingURL=imageBuffer.js.map