Add Kevin AI support chat to the studio footer

app/app-services.ts

@@ -67,6 +67,8 @@ export { StreamAvatarService } from 'services/stream-avatar/stream-avatar-servic
 export { StreamAvatarApiService } from 'services/stream-avatar/stream-avatar-api-service';
 export { AutomationsService } from 'services/stream-avatar/automations-service';
 export { AutomationsEngineService } from 'services/stream-avatar/automations-engine-service';
+export { KevinSupportService } from 'services/stream-avatar/kevin-support-service';
+export { AgentToolsService } from 'services/stream-avatar/v2/agent-tools';
 export { OnboardingV2Service } from 'services/onboarding/onboarding-v2';
 
 // ONLINE SERVICES
@@ -214,6 +216,8 @@ import { VirtualWebcamService } from 'services/virtual-webcam';
 import { StreamAvatarApiService } from 'services/stream-avatar/stream-avatar-api-service';
 import { AutomationsService } from 'services/stream-avatar/automations-service';
 import { AutomationsEngineService } from 'services/stream-avatar/automations-engine-service';
+import { KevinSupportService } from 'services/stream-avatar/kevin-support-service';
+import { AgentToolsService } from 'services/stream-avatar/v2/agent-tools';
 
 export const AppServices = {
   AppService,
@@ -305,4 +309,6 @@ export const AppServices = {
   StreamAvatarApiService,
   AutomationsService,
   AutomationsEngineService,
+  KevinSupportService,
+  AgentToolsService,
 };

app/components-react/agent/KevinApprovalBubble.m.less

@@ -0,0 +1,95 @@
+@import '../../styles/index';
+
+/**
+ * A callout above the footer's Kevin icon, pointing down at it.
+ *
+ * `fixed`, not `absolute`: the footer clips on both axes (`overflow-y: hidden`
+ * on `.footer`, `overflow-x: auto` on it and on `.footer--left`), so a child
+ * positioned above the bar disappears. Fixed escapes ancestor overflow, and no
+ * ancestor sets a transform that would turn it back into a containing block.
+ * The component sets left/bottom from the icon's measured rect.
+ *
+ * Kept in the React tree rather than portalled to document.body: the theme is a
+ * class on the main window's root div, and everything below reads its CSS vars.
+ * Portalling out renders the card unstyled and light against a dark app.
+ *
+ * Deliberately the same fills, border and radius as the inline card in
+ * KevinSupport.m.less, so the two read as one component in two places.
+ */
+.bubble {
+  position: fixed;
+  width: 320px;
+  padding: 12px 14px;
+  background-color: var(--section-alt);
+  border: 1px solid var(--border);
+  border-radius: 12px;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.4);
+  color: var(--title);
+  font-size: 14px;
+  line-height: 1.5;
+  // Above the footer and the OBS display, below a real modal (.ant-modal-wrap
+  // is 1003 in Main.m.less).
+  z-index: 1002;
+  cursor: default;
+
+  // The arrow, pointing down at the icon. Two triangles so the border reads as
+  // a continuous outline rather than stopping where the bubble ends. Nothing
+  // here may sit inside an overflow container -- both are outside the box, and
+  // an `overflow` on this element would clip them and add a stray scrollbar.
+  &::before,
+  &::after {
+    content: '';
+    position: absolute;
+    top: 100%;
+    left: 18px;
+    width: 0;
+    height: 0;
+    border-style: solid;
+  }
+
+  &::before {
+    border-width: 8px 8px 0 8px;
+    border-color: var(--border) transparent transparent transparent;
+  }
+
+  &::after {
+    border-width: 7px 7px 0 7px;
+    border-color: var(--section-alt) transparent transparent transparent;
+    left: 19px;
+  }
+}
+
+/* Left accent marks a decision point, matching `.approval` in
+   KevinSupport.m.less. Stacked when one turn proposes more than one. */
+.approval {
+  padding-left: 10px;
+  border-left: 3px solid var(--warning);
+
+  & + & {
+    margin-top: 12px;
+    padding-top: 12px;
+    border-top: 1px solid var(--border);
+  }
+}
+
+.summary {
+  font-weight: 600;
+  margin-bottom: 4px;
+}
+
+.warning {
+  color: var(--warning);
+  font-size: 12px;
+  margin-bottom: 8px;
+}
+
+.actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-top: 10px;
+
+  button {
+    margin: 0;
+  }
+}

app/components-react/agent/KevinApprovalBubble.tsx

@@ -0,0 +1,159 @@
+import React, { useEffect, useLayoutEffect, useState } from 'react';
+import { Services } from 'components-react/service-provider';
+import { useVuex } from 'components-react/hooks';
+import { $t } from 'services/i18n';
+import {
+  browserViewRects,
+  isCoveredByBrowserView,
+  IViewRect,
+} from 'components-react/shared/browser-view-rects';
+import styles from './KevinApprovalBubble.m.less';
+
+interface Props {
+  /** The footer icon this points at. Measured, never positioned against. */
+  anchorRef: React.RefObject<HTMLElement>;
+}
+
+/** Must match `.bubble` in KevinApprovalBubble.m.less. */
+const BUBBLE_WIDTH = 320;
+/** Must match the `bottom` offset applied below. */
+const ANCHOR_GAP = 10;
+// ponytail: a fixed cap rather than the rendered height. The bubble grows with the
+// number of pending approvals, but anything covering it is essentially always the
+// whole page container, so an exact height buys nothing — and measuring the bubble
+// to decide whether to draw the bubble flickers.
+const BUBBLE_MAX_HEIGHT = 240;
+
+/**
+ * The approval prompt, shown above the Kevin icon in the studio footer.
+ *
+ * An approval used to force the support window open and focus it, which is an
+ * ambush mid-stream: a window jumps in front of whatever the streamer was doing,
+ * for a decision that is usually a single "yes". This carries the whole decision
+ * instead, so they answer without leaving the editor.
+ *
+ * Positioned `fixed` from the icon's measured rect rather than absolutely inside
+ * the footer, because the footer scrolls: `.footer` sets `overflow-y: hidden`
+ * and `overflow-x: auto`, and `.footer--left` another `overflow-x: auto`. A
+ * child positioned above the bar is clipped by both, which is invisible rather
+ * than merely misplaced. Fixed escapes that; it stays in the React tree so it
+ * keeps inheriting the theme class's CSS variables.
+ *
+ * It duplicates the card in KevinSupport.tsx rather than sharing one, because
+ * the two differ in everything but the three buttons: that one is a turn in a
+ * conversation, this one is a floating callout with no room for an avatar or a
+ * lead-in. Both call the same `resolveApproval`, which is the part that matters.
+ *
+ * It draws nothing when an Electron BrowserView covers where it would land —
+ * plugin pages, the app store, Alertbox Library, a Browser editor element. Those
+ * are composited by the OS above the entire host page, so no z-index reaches over
+ * them and the bubble would render as the arrow alone. The fallback is the dot on
+ * the footer icon (StudioFooter.tsx), which is below every such view and always
+ * visible; clicking it opens the chat window, which is a real BrowserWindow and
+ * carries the same card. The alternative was blanking the plugin for as long as
+ * the approval sat unanswered, which is worse than one extra click.
+ */
+export default function KevinApprovalBubble({ anchorRef }: Props) {
+  const { KevinSupportService, WindowsService } = Services;
+
+  const { pendingApprovals, chatFocused } = useVuex(() => ({
+    pendingApprovals: KevinSupportService.state.pendingApprovals,
+    // The state entry is deleted when the window closes, so `undefined` covers
+    // "closed" and `false` covers "open but behind something" in one read.
+    chatFocused: !!WindowsService.state['kevin-support']?.isFocused,
+  }));
+
+  // Nothing to add when the streamer is already looking at the chat — the card
+  // in there is the live surface, and two copies of one decision is worse than
+  // one in the wrong place.
+  const show = !chatFocused && pendingApprovals.length > 0;
+
+  const [anchor, setAnchor] = useState<DOMRect | null>(null);
+
+  useLayoutEffect(() => {
+    if (!show) return;
+    const measure = () => setAnchor(anchorRef.current?.getBoundingClientRect() ?? null);
+    measure();
+    // ponytail: re-measured on resize only. The icon also shifts when the
+    // performance metrics beside it change width, or if the footer is scrolled
+    // horizontally — watch those with a ResizeObserver if it ever looks off.
+    window.addEventListener('resize', measure);
+    return () => window.removeEventListener('resize', measure);
+  }, [show, anchorRef]);
+
+  // This subscription is also what re-renders on navigation: moving to a plugin
+  // page fires no resize, so nothing else here would notice the page went native.
+  const [views, setViews] = useState<IViewRect[]>([]);
+
+  useEffect(() => {
+    const subscription = browserViewRects.subscribe(setViews);
+    return () => subscription.unsubscribe();
+  }, []);
+
+  const occluded =
+    !!anchor &&
+    isCoveredByBrowserView(
+      {
+        left: anchor.left,
+        top: anchor.top - ANCHOR_GAP - BUBBLE_MAX_HEIGHT,
+        width: BUBBLE_WIDTH,
+        height: BUBBLE_MAX_HEIGHT,
+      },
+      views,
+    );
+
+  if (!show || !anchor || occluded) return <></>;
+
+  return (
+    // role="alert" rather than "alertdialog": the content is what should be
+    // announced, and an alertdialog would need a label naming a prompt whose
+    // whole text is already the summary below.
+    <div
+      className={styles.bubble}
+      role="alert"
+      style={{ left: anchor.left, bottom: window.innerHeight - anchor.top + ANCHOR_GAP }}
+    >
+      {pendingApprovals.map(approval => (
+        <div key={approval.approvalId} className={styles.approval}>
+          <div className={styles.summary}>{approval.summary}</div>
+          {approval.risk === 'irreversible' && (
+            <div className={styles.warning}>{$t('This cannot be undone.')}</div>
+          )}
+          {approval.risk === 'external' && (
+            <div className={styles.warning}>{$t('This will be visible to your viewers.')}</div>
+          )}
+          <div className={styles.actions}>
+            <button
+              className="button button--action"
+              onClick={() =>
+                KevinSupportService.actions.resolveApproval(
+                  approval.approvalId,
+                  'approve',
+                  'footer',
+                )
+              }
+            >
+              {$t('Allow once')}
+            </button>
+            <button
+              className="button button--default"
+              onClick={() =>
+                KevinSupportService.actions.resolveApproval(approval.approvalId, 'always', 'footer')
+              }
+            >
+              {$t('Always allow')}
+            </button>
+            <button
+              className="button button--default"
+              onClick={() =>
+                KevinSupportService.actions.resolveApproval(approval.approvalId, 'deny', 'footer')
+              }
+            >
+              {$t('Deny')}
+            </button>
+          </div>
+        </div>
+      ))}
+    </div>
+  );
+}