cursor-buddy 0.0.10 → 0.0.11

package/dist/react/index.d.mts

@@ -1,5 +1,5 @@
 "use client";
-import { c as CursorRenderProps, d as SpeechBubbleRenderProps, i as CursorBuddyMediaMode, m as WaveformRenderProps, o as CursorBuddySpeechConfig, p as VoiceState, r as CursorBuddyClientOptions, s as CursorBuddyTranscriptionConfig, u as PointingTarget } from "../client-sjVVGYPU.mjs";
+import { _ as ToolCallState, b as ToolDisplayOptions, c as CursorRenderProps, d as SpeechBubbleRenderProps, g as ToolCallEvent, h as ToolBubbleRenderProps, m as WaveformRenderProps, n as CursorBuddyClientOptions, o as CursorBuddySpeechConfig, p as VoiceState, r as CursorBuddyMediaMode, s as CursorBuddyTranscriptionConfig, u as PointingTarget, v as ToolCallStatus, x as ToolResultEvent, y as ToolDisplayConfig } from "../types-BU0Gegg2.mjs";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/react/components/Overlay.d.ts
@@ -10,12 +10,16 @@ interface OverlayProps {
   speechBubble?: (props: SpeechBubbleRenderProps) => React.ReactNode;
   /** Custom waveform renderer */
   waveform?: (props: WaveformRenderProps) => React.ReactNode;
+  /** Tool display configuration */
+  toolDisplay?: ToolDisplayConfig;
+  /** Custom tool bubble renderer (overrides per-tool config) */
+  renderToolBubble?: (props: ToolBubbleRenderProps) => React.ReactNode;
   /** Container element for portal (defaults to document.body) */
   container?: HTMLElement | null;
 }
 //#endregion
 //#region src/react/components/CursorBuddy.d.ts
-interface CursorBuddyProps extends Pick<OverlayProps, "cursor" | "speechBubble" | "waveform"> {
+interface CursorBuddyProps extends Pick<OverlayProps, "cursor" | "speechBubble" | "waveform" | "toolDisplay" | "renderToolBubble"> {
   /** API endpoint for cursor buddy server */
   endpoint: string;
   /** Hotkey for push-to-talk (default: "ctrl+alt") */
@@ -36,6 +40,10 @@ interface CursorBuddyProps extends Pick<OverlayProps, "cursor" | "speechBubble"
   onStateChange?: (state: VoiceState) => void;
   /** Callback when error occurs */
   onError?: (error: Error) => void;
+  /** Callback when a tool is called */
+  onToolCall?: (event: ToolCallEvent) => void;
+  /** Callback when a tool completes */
+  onToolResult?: (event: ToolResultEvent) => void;
 }
 /**
  * Drop-in cursor buddy component.
@@ -69,11 +77,15 @@ declare function CursorBuddy({
   cursor,
   speechBubble,
   waveform,
+  toolDisplay,
+  renderToolBubble,
   onTranscript,
   onResponse,
   onPoint,
   onStateChange,
-  onError
+  onError,
+  onToolCall,
+  onToolResult
 }: CursorBuddyProps): _$react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/react/hooks.d.ts
@@ -84,7 +96,7 @@ interface UseCursorBuddyReturn {
   liveTranscript: string;
   /** Latest transcribed user speech */
   transcript: string;
-  /** Latest AI response (stripped of POINT tags) */
+  /** Latest AI response */
   response: string;
   /** Current audio level (0-1) */
   audioLevel: number;
@@ -94,6 +106,12 @@ interface UseCursorBuddyReturn {
   isPointing: boolean;
   /** Current error (null if none) */
   error: Error | null;
+  /** All tool calls in current turn */
+  toolCalls: ToolCallState[];
+  /** Visible, non-expired tool calls */
+  activeToolCalls: ToolCallState[];
+  /** Tool awaiting user approval, or null */
+  pendingApproval: ToolCallState | null;
   /** Start listening (called automatically by hotkey) */
   startListening: () => void;
   /** Stop listening and process (called automatically by hotkey release) */
@@ -106,6 +124,12 @@ interface UseCursorBuddyReturn {
   dismissPointing: () => void;
   /** Reset to idle state */
   reset: () => void;
+  /** Approve a pending tool call */
+  approveToolCall: (id: string) => void;
+  /** Deny a pending tool call */
+  denyToolCall: (id: string) => void;
+  /** Dismiss a tool call bubble manually */
+  dismissToolCall: (id: string) => void;
 }
 /**
  * Hook to access cursor buddy state and actions.
@@ -130,13 +154,66 @@ declare function CursorBuddyProvider({
   endpoint,
   transcription,
   speech,
+  toolDisplay,
   children,
   onTranscript,
   onResponse,
   onPoint,
   onStateChange,
-  onError
+  onError,
+  onToolCall,
+  onToolResult
 }: CursorBuddyProviderProps): _$react_jsx_runtime0.JSX.Element;
 //#endregion
-export { CursorBuddy, type CursorBuddyMediaMode, type CursorBuddyProps, CursorBuddyProvider, type CursorBuddyProviderProps, type CursorBuddySpeechConfig, type CursorBuddyTranscriptionConfig, type CursorRenderProps, type SpeechBubbleRenderProps, type UseCursorBuddyReturn, type WaveformRenderProps, useCursorBuddy };
+//#region src/react/components/ToolBubble.d.ts
+interface ToolBubbleProps extends ToolBubbleRenderProps {
+  /** Custom render function (from toolDisplay config) */
+  customRender?: (props: ToolBubbleRenderProps) => React.ReactNode;
+}
+/**
+ * Default tool bubble component.
+ * Displays tool call status with optional approve/deny buttons.
+ */
+declare function ToolBubble({
+  toolName,
+  args,
+  status,
+  label,
+  result,
+  error,
+  approve,
+  deny,
+  dismiss,
+  customRender
+}: ToolBubbleProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/react/components/ToolBubbleStack.d.ts
+interface ToolBubbleStackProps {
+  /** Active tool calls to display */
+  toolCalls: ToolCallState[];
+  /** Tool display configuration */
+  toolDisplay?: ToolDisplayConfig;
+  /** Approve a tool call */
+  onApprove: (id: string) => void;
+  /** Deny a tool call */
+  onDeny: (id: string) => void;
+  /** Dismiss a tool call bubble */
+  onDismiss: (id: string) => void;
+  /** Custom render function for all bubbles (overrides per-tool config) */
+  renderToolBubble?: (props: ToolBubbleRenderProps) => React.ReactNode;
+}
+/**
+ * Stack of tool bubbles displayed near the cursor.
+ * Renders all active tool calls in a vertical column.
+ */
+declare function ToolBubbleStack({
+  toolCalls,
+  toolDisplay,
+  onApprove,
+  onDeny,
+  onDismiss,
+  renderToolBubble
+}: ToolBubbleStackProps): _$react_jsx_runtime0.JSX.Element | null;
+//#endregion
+export { CursorBuddy, type CursorBuddyMediaMode, type CursorBuddyProps, CursorBuddyProvider, type CursorBuddyProviderProps, type CursorBuddySpeechConfig, type CursorBuddyTranscriptionConfig, type CursorRenderProps, type SpeechBubbleRenderProps, ToolBubble, type ToolBubbleProps, type ToolBubbleRenderProps, ToolBubbleStack, type ToolBubbleStackProps, type ToolCallEvent, type ToolCallState, type ToolCallStatus, type ToolDisplayConfig, type ToolDisplayOptions, type ToolResultEvent, type UseCursorBuddyReturn, type WaveformRenderProps, useCursorBuddy };
 //# sourceMappingURL=index.d.mts.map

package/dist/react/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/react/components/Overlay.tsx","../../src/react/components/CursorBuddy.tsx","../../src/react/hooks.ts","../../src/react/provider.tsx"],"mappings":";;;;UAsBiB,YAAA;;EAEf,MAAA,GAAS,KAAA,CAAM,SAAA,KAAc,KAAA,EAAO,iBAAA,KAAsB,KAAA,CAAM,SAAA;;EAEhE,YAAA,IAAgB,KAAA,EAAO,uBAAA,KAA4B,KAAA,CAAM,SAAA;EAJ9B;EAM3B,QAAA,IAAY,KAAA,EAAO,mBAAA,KAAwB,KAAA,CAAM,SAAA;EAJxC;EAMT,SAAA,GAAY,WAAA;AAAA;;;UCjBG,gBAAA,SACP,IAAA,CAAK,YAAA;;EAEb,QAAA;EDMe;ECJf,MAAA;;EAEA,SAAA,GAAY,WAAA;EDIwB;ECFpC,aAAA,GAAgB,8BAAA;EDIO;ECFvB,MAAA,GAAS,uBAAA;EDIU;ECFnB,YAAA,IAAgB,IAAA;EDIJ;ECFZ,UAAA,IAAc,IAAA;EDES;ECAvB,OAAA,IAAW,MAAA,EAAQ,cAAA;EDNV;ECQT,aAAA,IAAiB,KAAA,EAAO,UAAA;EDRY;ECUpC,OAAA,IAAW,KAAA,EAAO,KAAA;AAAA;;;;;;;;;;;;;;;;;;;AArBpB;;;;;iBA2EgB,WAAA,CAAA;EACd,QAAA;EACA,MAAA;EACA,SAAA;EACA,MAAA;EACA,aAAA;EACA,MAAA;EACA,YAAA;EACA,QAAA;EACA,YAAA;EACA,UAAA;EACA,OAAA;EACA,aAAA;EACA;AAAA,GACC,gBAAA,GAAgB,oBAAA,CAAA,GAAA,CAAA,OAAA;;;UC9FF,oBAAA;;EAEf,KAAA,EAAO,UAAA;;EAEP,cAAA;EFU2B;EER3B,UAAA;EFUS;EERT,QAAA;EFQ0D;EEN1D,UAAA;EFQmD;EENnD,SAAA;EFQ2C;EEN3C,UAAA;EFQuB;EENvB,KAAA,EAAO,KAAA;EFAP;EEGA,cAAA;EFHe;EEKf,aAAA;EFL6B;EEO7B,UAAA,GAAa,OAAA;EFPmD;EEShE,OAAA,GAAU,CAAA,UAAW,CAAA,UAAW,KAAA;EFPT;EESvB,eAAA;EFTmD;EEWnD,KAAA;AAAA;;;;iBAMc,cAAA,CAAA,GAAkB,oBAAA;;;UC7BjB,wBAAA,SAAiC,wBAAA;;EAEhD,QAAA;EHMe;EGJf,aAAA,GAAgB,8BAAA;;EAEhB,MAAA,GAAS,uBAAA;EHI2B;EGFpC,QAAA,EAAU,KAAA,CAAM,SAAA;AAAA;;;;iBAMF,mBAAA,CAAA;EACd,QAAA;EACA,aAAA;EACA,MAAA;EACA,QAAA;EACA,YAAA;EACA,UAAA;EACA,OAAA;EACA,aAAA;EACA;AAAA,GACC,wBAAA,GAAwB,oBAAA,CAAA,GAAA,CAAA,OAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/react/components/Overlay.tsx","../../src/react/components/CursorBuddy.tsx","../../src/react/hooks.ts","../../src/react/provider.tsx","../../src/react/components/ToolBubble.tsx","../../src/react/components/ToolBubbleStack.tsx"],"mappings":"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"}

package/dist/react/index.mjs

@@ -1,11 +1,11 @@
 "use client";
-import { a as $buddyScale, i as $buddyRotation, n as $audioLevel, o as $cursorPosition, r as $buddyPosition, s as $pointingTarget, t as CursorBuddyClient } from "../client-CliXcNch.mjs";
+import { a as $buddyScale, i as $buddyRotation, n as $audioLevel, o as $cursorPosition, r as $buddyPosition, s as $pointingTarget, t as CursorBuddyClient } from "../client-D7kFGsuH.mjs";
 import { useStore } from "@nanostores/react";
 import { createContext, useCallback, useContext, useEffect, useRef, useState, useSyncExternalStore } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { createPortal } from "react-dom";
 //#region src/react/styles.css?inline
-var styles_default = "/**\n * Cursor Buddy Styles\n *\n * Customize by overriding CSS variables in your own stylesheet:\n *\n * :root {\n *   --cursor-buddy-color-idle: #8b5cf6;\n * }\n */\n\n:root {\n  /* Cursor colors by state */\n  --cursor-buddy-color-idle: #3b82f6;\n  --cursor-buddy-color-listening: #ef4444;\n  --cursor-buddy-color-processing: #eab308;\n  --cursor-buddy-color-responding: #22c55e;\n  --cursor-buddy-cursor-stroke: #ffffff;\n  --cursor-buddy-cursor-shadow: 0 2px 4px rgba(0, 0, 0, 0.3);\n\n  /* Speech bubble */\n  --cursor-buddy-bubble-bg: #ffffff;\n  --cursor-buddy-bubble-text: #1f2937;\n  --cursor-buddy-bubble-radius: 8px;\n  --cursor-buddy-bubble-padding: 8px 12px;\n  --cursor-buddy-bubble-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);\n  --cursor-buddy-bubble-max-width: 200px;\n  --cursor-buddy-bubble-font-size: 14px;\n\n  /* Waveform */\n  --cursor-buddy-waveform-color: #ef4444;\n  --cursor-buddy-waveform-bar-width: 4px;\n  --cursor-buddy-waveform-bar-radius: 2px;\n  --cursor-buddy-waveform-gap: 3px;\n\n  /* Overlay */\n  --cursor-buddy-z-index: 2147483647;\n\n  /* Animation durations */\n  --cursor-buddy-transition-fast: 0.1s;\n  --cursor-buddy-transition-normal: 0.2s;\n  --cursor-buddy-animation-duration: 0.3s;\n}\n\n/* Overlay container */\n.cursor-buddy-overlay {\n  position: fixed;\n  inset: 0;\n  pointer-events: none;\n  isolation: isolate;\n  z-index: var(--cursor-buddy-z-index);\n}\n\n/* Buddy container (cursor + accessories)\n   Positioned at the $buddyPosition coordinates (cursor center).\n   CSS transform shifts the cursor to the right of the mouse pointer\n   to avoid overlapping with the system cursor.\n   Customize this offset via CSS to change cursor positioning.\n*/\n.cursor-buddy-container {\n  position: absolute;\n  transform: translate(8px, 4px);\n}\n\n/* Cursor SVG */\n.cursor-buddy-cursor {\n  transition: transform var(--cursor-buddy-transition-fast) ease-out;\n  filter: drop-shadow(var(--cursor-buddy-cursor-shadow));\n}\n\n.cursor-buddy-cursor polygon {\n  stroke: var(--cursor-buddy-cursor-stroke);\n  stroke-width: 2;\n  transition: fill var(--cursor-buddy-transition-normal) ease-out;\n}\n\n.cursor-buddy-cursor--idle polygon {\n  fill: var(--cursor-buddy-color-idle);\n}\n\n.cursor-buddy-cursor--listening polygon {\n  fill: var(--cursor-buddy-color-listening);\n}\n\n.cursor-buddy-cursor--processing polygon {\n  fill: var(--cursor-buddy-color-processing);\n}\n\n.cursor-buddy-cursor--responding polygon {\n  fill: var(--cursor-buddy-color-responding);\n}\n\n/* Processing spinner */\n.cursor-buddy-cursor__spinner {\n  color: var(--cursor-buddy-color-processing);\n}\n\n/* Cursor pulse animation during listening */\n.cursor-buddy-cursor--listening {\n  animation: cursor-buddy-pulse 1.5s ease-in-out infinite;\n}\n\n@keyframes cursor-buddy-pulse {\n  0%,\n  100% {\n    filter: drop-shadow(var(--cursor-buddy-cursor-shadow));\n  }\n  50% {\n    filter: drop-shadow(0 0 8px var(--cursor-buddy-color-listening));\n  }\n}\n\n/* Processing spinner effect */\n.cursor-buddy-cursor--processing {\n  animation: cursor-buddy-spin-subtle 2s linear infinite;\n}\n\n@keyframes cursor-buddy-spin-subtle {\n  0% {\n    filter: drop-shadow(var(--cursor-buddy-cursor-shadow)) hue-rotate(0deg);\n  }\n  100% {\n    filter: drop-shadow(var(--cursor-buddy-cursor-shadow)) hue-rotate(360deg);\n  }\n}\n\n/* Speech bubble */\n.cursor-buddy-bubble {\n  position: absolute;\n  left: 24px;\n  top: -8px;\n  pointer-events: auto;\n  cursor: pointer;\n  max-width: var(--cursor-buddy-bubble-max-width);\n  padding: var(--cursor-buddy-bubble-padding);\n  background-color: var(--cursor-buddy-bubble-bg);\n  color: var(--cursor-buddy-bubble-text);\n  border-radius: var(--cursor-buddy-bubble-radius);\n  box-shadow: var(--cursor-buddy-bubble-shadow);\n  font-size: var(--cursor-buddy-bubble-font-size);\n  line-height: 1.4;\n  width: max-content;\n  overflow-wrap: break-word;\n  word-break: break-word;\n  user-select: none;\n  animation: cursor-buddy-fade-in var(--cursor-buddy-animation-duration)\n    ease-out;\n}\n\n@keyframes cursor-buddy-fade-in {\n  from {\n    opacity: 0;\n    transform: translateY(-4px);\n  }\n  to {\n    opacity: 1;\n    transform: translateY(0);\n  }\n}\n\n/* Waveform container */\n.cursor-buddy-waveform {\n  position: absolute;\n  left: 24px;\n  top: 2px;\n  display: flex;\n  align-items: center;\n  gap: var(--cursor-buddy-waveform-gap);\n  height: 24px;\n  animation: cursor-buddy-fade-in var(--cursor-buddy-animation-duration)\n    ease-out;\n}\n\n/* Waveform bars */\n.cursor-buddy-waveform-bar {\n  width: var(--cursor-buddy-waveform-bar-width);\n  background-color: var(--cursor-buddy-waveform-color);\n  border-radius: var(--cursor-buddy-waveform-bar-radius);\n  transition: height 0.05s ease-out;\n}\n\n/* Fade out animation (applied via JS) */\n.cursor-buddy-fade-out {\n  animation: cursor-buddy-fade-out var(--cursor-buddy-animation-duration)\n    ease-out forwards;\n}\n\n@keyframes cursor-buddy-fade-out {\n  from {\n    opacity: 1;\n  }\n  to {\n    opacity: 0;\n  }\n}\n";
+var styles_default = ":root{--cursor-buddy-color-idle:#3b82f6;--cursor-buddy-color-listening:#ef4444;--cursor-buddy-color-processing:#eab308;--cursor-buddy-color-responding:#22c55e;--cursor-buddy-cursor-stroke:#fff;--cursor-buddy-cursor-shadow:0 2px 4px #0000004d;--cursor-buddy-bubble-bg:#fff;--cursor-buddy-bubble-text:#1f2937;--cursor-buddy-bubble-radius:8px;--cursor-buddy-bubble-padding:8px 12px;--cursor-buddy-bubble-shadow:0 4px 12px #00000026;--cursor-buddy-bubble-max-width:200px;--cursor-buddy-bubble-font-size:14px;--cursor-buddy-waveform-color:#ef4444;--cursor-buddy-waveform-bar-width:4px;--cursor-buddy-waveform-bar-radius:2px;--cursor-buddy-waveform-gap:3px;--cursor-buddy-z-index:2147480000;--cursor-buddy-transition-fast:.1s;--cursor-buddy-transition-normal:.2s;--cursor-buddy-animation-duration:.3s}.cursor-buddy-overlay{pointer-events:none;isolation:isolate;z-index:var(--cursor-buddy-z-index);position:fixed;inset:0}.cursor-buddy-container{position:absolute;transform:translate(8px,4px)}.cursor-buddy-cursor{transition:transform var(--cursor-buddy-transition-fast) ease-out;filter:drop-shadow(var(--cursor-buddy-cursor-shadow))}.cursor-buddy-cursor polygon{stroke:var(--cursor-buddy-cursor-stroke);stroke-width:2px;transition:fill var(--cursor-buddy-transition-normal) ease-out}.cursor-buddy-cursor--idle polygon{fill:var(--cursor-buddy-color-idle)}.cursor-buddy-cursor--listening polygon{fill:var(--cursor-buddy-color-listening)}.cursor-buddy-cursor--processing polygon{fill:var(--cursor-buddy-color-processing)}.cursor-buddy-cursor--responding polygon{fill:var(--cursor-buddy-color-responding)}.cursor-buddy-cursor__spinner{color:var(--cursor-buddy-color-processing)}.cursor-buddy-cursor--listening{animation:1.5s ease-in-out infinite cursor-buddy-pulse}@keyframes cursor-buddy-pulse{0%,to{filter:drop-shadow(var(--cursor-buddy-cursor-shadow))}50%{filter:drop-shadow(0 0 8px var(--cursor-buddy-color-listening))}}.cursor-buddy-cursor--processing{animation:2s linear infinite cursor-buddy-spin-subtle}@keyframes cursor-buddy-spin-subtle{0%{filter:drop-shadow(var(--cursor-buddy-cursor-shadow)) hue-rotate(0deg)}to{filter:drop-shadow(var(--cursor-buddy-cursor-shadow)) hue-rotate(360deg)}}.cursor-buddy-bubble{pointer-events:auto;cursor:pointer;max-width:var(--cursor-buddy-bubble-max-width);padding:var(--cursor-buddy-bubble-padding);background-color:var(--cursor-buddy-bubble-bg);color:var(--cursor-buddy-bubble-text);border-radius:var(--cursor-buddy-bubble-radius);box-shadow:var(--cursor-buddy-bubble-shadow);font-size:var(--cursor-buddy-bubble-font-size);overflow-wrap:break-word;word-break:break-word;user-select:none;width:max-content;animation:cursor-buddy-fade-in var(--cursor-buddy-animation-duration) ease-out;line-height:1.4;position:absolute;top:-8px;left:24px}@keyframes cursor-buddy-fade-in{0%{opacity:0;transform:translateY(-4px)}to{opacity:1;transform:translateY(0)}}.cursor-buddy-waveform{align-items:center;gap:var(--cursor-buddy-waveform-gap);height:24px;animation:cursor-buddy-fade-in var(--cursor-buddy-animation-duration) ease-out;display:flex;position:absolute;top:2px;left:24px}.cursor-buddy-waveform-bar{width:var(--cursor-buddy-waveform-bar-width);background-color:var(--cursor-buddy-waveform-color);border-radius:var(--cursor-buddy-waveform-bar-radius);transition:height 50ms ease-out}.cursor-buddy-fade-out{animation:cursor-buddy-fade-out var(--cursor-buddy-animation-duration) ease-out forwards}@keyframes cursor-buddy-fade-out{0%{opacity:1}to{opacity:0}}:root{--cursor-buddy-tool-bg:#fff;--cursor-buddy-tool-text:#1f2937;--cursor-buddy-tool-border:#e5e7eb;--cursor-buddy-tool-radius:8px;--cursor-buddy-tool-padding:8px 12px;--cursor-buddy-tool-shadow:0 4px 12px #00000026;--cursor-buddy-tool-gap:8px;--cursor-buddy-tool-pending:#3b82f6;--cursor-buddy-tool-approval:#f59e0b;--cursor-buddy-tool-success:#22c55e;--cursor-buddy-tool-error:#ef4444;--cursor-buddy-tool-denied:#6b7280;--cursor-buddy-tool-btn-approve-bg:#22c55e;--cursor-buddy-tool-btn-approve-text:#fff;--cursor-buddy-tool-btn-deny-bg:#ef4444;--cursor-buddy-tool-btn-deny-text:#fff}.cursor-buddy-tool-stack{gap:var(--cursor-buddy-tool-gap);pointer-events:auto;flex-direction:column;display:flex;position:absolute;top:32px;left:24px}.cursor-buddy-tool-stack__item{animation:cursor-buddy-fade-in var(--cursor-buddy-animation-duration) ease-out}.cursor-buddy-tool-bubble{padding:var(--cursor-buddy-tool-padding);background-color:var(--cursor-buddy-tool-bg);color:var(--cursor-buddy-tool-text);border-radius:var(--cursor-buddy-tool-radius);box-shadow:var(--cursor-buddy-tool-shadow);white-space:nowrap;user-select:none;border-left:3px solid var(--cursor-buddy-tool-pending);align-items:center;gap:8px;font-size:13px;line-height:1.4;display:flex}.cursor-buddy-tool-bubble--pending,.cursor-buddy-tool-bubble--approved{border-left-color:var(--cursor-buddy-tool-pending)}.cursor-buddy-tool-bubble--awaiting_approval{border-left-color:var(--cursor-buddy-tool-approval)}.cursor-buddy-tool-bubble--completed{border-left-color:var(--cursor-buddy-tool-success)}.cursor-buddy-tool-bubble--failed{border-left-color:var(--cursor-buddy-tool-error)}.cursor-buddy-tool-bubble--denied{border-left-color:var(--cursor-buddy-tool-denied)}.cursor-buddy-tool-bubble__content{align-items:center;gap:6px;display:flex}.cursor-buddy-tool-bubble__label{font-weight:500}.cursor-buddy-tool-icon{justify-content:center;align-items:center;width:16px;height:16px;font-size:12px;font-weight:700;display:inline-flex}.cursor-buddy-tool-icon--spinner{border:2px solid var(--cursor-buddy-tool-pending);border-top-color:#0000;border-radius:50%;width:14px;height:14px;animation:.8s linear infinite cursor-buddy-tool-spin}@keyframes cursor-buddy-tool-spin{to{transform:rotate(360deg)}}.cursor-buddy-tool-icon--check{color:var(--cursor-buddy-tool-success)}.cursor-buddy-tool-icon--error{color:var(--cursor-buddy-tool-error)}.cursor-buddy-tool-icon--denied{color:var(--cursor-buddy-tool-denied)}.cursor-buddy-tool-icon--question{color:var(--cursor-buddy-tool-approval)}.cursor-buddy-tool-bubble__actions{gap:4px;margin-left:4px;display:flex}.cursor-buddy-tool-button{cursor:pointer;border:none;border-radius:4px;padding:4px 10px;font-size:12px;font-weight:500;transition:opacity .15s}.cursor-buddy-tool-button:hover{opacity:.9}.cursor-buddy-tool-button:active{opacity:.8}.cursor-buddy-tool-button--approve{background-color:var(--cursor-buddy-tool-btn-approve-bg);color:var(--cursor-buddy-tool-btn-approve-text)}.cursor-buddy-tool-button--deny{background-color:var(--cursor-buddy-tool-btn-deny-bg);color:var(--cursor-buddy-tool-btn-deny-text)}.cursor-buddy-tool-bubble__dismiss{color:#9ca3af;cursor:pointer;background-color:#0000;border:none;border-radius:50%;justify-content:center;align-items:center;width:18px;height:18px;margin-left:auto;padding:0;font-size:12px;transition:color .15s,background-color .15s;display:flex}.cursor-buddy-tool-bubble__dismiss:hover{color:#6b7280;background-color:#f3f4f6}";
 //#endregion
 //#region src/react/utils/inject-styles.ts
 const STYLE_ID = "cursor-buddy-styles";
@@ -36,15 +36,18 @@ const CursorBuddyContext = createContext(null);
 /**
 * Provider for cursor buddy. Creates and manages the client instance.
 */
-function CursorBuddyProvider({ endpoint, transcription, speech, children, onTranscript, onResponse, onPoint, onStateChange, onError }) {
+function CursorBuddyProvider({ endpoint, transcription, speech, toolDisplay, children, onTranscript, onResponse, onPoint, onStateChange, onError, onToolCall, onToolResult }) {
 	const [client] = useState(() => new CursorBuddyClient(endpoint, {
 		onTranscript,
 		onResponse,
 		onPoint,
 		onStateChange,
 		onError,
+		onToolCall,
+		onToolResult,
 		speech,
-		transcription
+		transcription,
+		toolDisplay
 	}));
 	useEffect(() => {
 		injectStyles();
@@ -93,7 +96,10 @@ function useCursorBuddy() {
 		setEnabled: useCallback((enabled) => client.setEnabled(enabled), [client]),
 		pointAt: useCallback((x, y, label) => client.pointAt(x, y, label), [client]),
 		dismissPointing: useCallback(() => client.dismissPointing(), [client]),
-		reset: useCallback(() => client.reset(), [client])
+		reset: useCallback(() => client.reset(), [client]),
+		approveToolCall: useCallback((id) => client.approveToolCall(id), [client]),
+		denyToolCall: useCallback((id) => client.denyToolCall(id), [client]),
+		dismissToolCall: useCallback((id) => client.dismissToolCall(id), [client])
 	};
 }
 //#endregion
@@ -300,6 +306,61 @@ function createHotkeyController(hotkey, options) {
 	};
 }
 //#endregion
+//#region src/core/hotkeys/approval-shortcuts.ts
+/**
+* Approval shortcut keys
+*/
+const APPROVE_KEYS = ["y", "enter"];
+const DENY_KEYS = ["n", "escape"];
+/**
+* Create a controller for approval keyboard shortcuts.
+*
+* Listens for:
+* - Y or Enter → onApprove
+* - N or Escape → onDeny
+*
+* @example
+* ```ts
+* const controller = createApprovalShortcutController({
+*   onApprove: () => approveToolCall(id),
+*   onDeny: () => denyToolCall(id),
+*   enabled: pendingApproval !== null,
+* })
+*
+* // Later, cleanup
+* controller.destroy()
+* ```
+*/
+function createApprovalShortcutController(options) {
+	let enabled = options.enabled ?? true;
+	const { onApprove, onDeny } = options;
+	function handleKeyDown(event) {
+		if (!enabled) return;
+		const target = event.target;
+		if (target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.isContentEditable) return;
+		const key = event.key.toLowerCase();
+		if (APPROVE_KEYS.includes(key)) {
+			event.preventDefault();
+			onApprove();
+		} else if (DENY_KEYS.includes(key)) {
+			event.preventDefault();
+			onDeny();
+		}
+	}
+	window.addEventListener("keydown", handleKeyDown);
+	return {
+		get isEnabled() {
+			return enabled;
+		},
+		setEnabled(newEnabled) {
+			enabled = newEnabled;
+		},
+		destroy() {
+			window.removeEventListener("keydown", handleKeyDown);
+		}
+	};
+}
+//#endregion
 //#region src/react/use-hotkey.ts
 /**
 * Hook for detecting hotkey press/release.
@@ -352,6 +413,52 @@ function useHotkey(hotkey, onPress, onRelease, enabled = true) {
 	}, [enabled]);
 }
 //#endregion
+//#region src/react/use-approval-shortcuts.ts
+/**
+* Hook for approval keyboard shortcuts.
+*
+* When enabled, listens for:
+* - Y or Enter → onApprove
+* - N or Escape → onDeny
+*
+* Automatically enables when `enabled` is true.
+* Ignores keypresses when focus is in an input/textarea.
+*
+* @param enabled - Whether shortcuts should be active
+* @param onApprove - Called when user presses Y or Enter
+* @param onDeny - Called when user presses N or Escape
+*
+* @example
+* ```tsx
+* useApprovalShortcuts(
+*   pendingApproval !== null,
+*   () => approveToolCall(pendingApproval.id),
+*   () => denyToolCall(pendingApproval.id)
+* )
+* ```
+*/
+function useApprovalShortcuts(enabled, onApprove, onDeny) {
+	const onApproveRef = useRef(onApprove);
+	const onDenyRef = useRef(onDeny);
+	onApproveRef.current = onApprove;
+	onDenyRef.current = onDeny;
+	const controllerRef = useRef(null);
+	useEffect(() => {
+		controllerRef.current = createApprovalShortcutController({
+			onApprove: () => onApproveRef.current(),
+			onDeny: () => onDenyRef.current(),
+			enabled
+		});
+		return () => {
+			controllerRef.current?.destroy();
+			controllerRef.current = null;
+		};
+	}, []);
+	useEffect(() => {
+		controllerRef.current?.setEnabled(enabled);
+	}, [enabled]);
+}
+//#endregion
 //#region src/react/components/Cursor.tsx
 const BASE_ROTATION = -Math.PI / 6;
 /**
@@ -425,6 +532,138 @@ function DefaultSpeechBubble({ text, isVisible, onClick }) {
 	});
 }
 //#endregion
+//#region src/react/components/ToolBubble.tsx
+/**
+* Status icons for tool call states
+*/
+function StatusIcon({ status }) {
+	switch (status) {
+		case "pending":
+		case "approved": return /* @__PURE__ */ jsx("span", {
+			className: "cursor-buddy-tool-icon cursor-buddy-tool-icon--spinner",
+			"aria-label": "Loading"
+		});
+		case "awaiting_approval": return /* @__PURE__ */ jsx("span", {
+			className: "cursor-buddy-tool-icon cursor-buddy-tool-icon--question",
+			"aria-label": "Needs approval",
+			children: "?"
+		});
+		case "completed": return /* @__PURE__ */ jsx("span", {
+			className: "cursor-buddy-tool-icon cursor-buddy-tool-icon--check",
+			"aria-label": "Completed",
+			children: "✓"
+		});
+		case "denied": return /* @__PURE__ */ jsx("span", {
+			className: "cursor-buddy-tool-icon cursor-buddy-tool-icon--denied",
+			"aria-label": "Denied",
+			children: "✕"
+		});
+		case "failed": return /* @__PURE__ */ jsx("span", {
+			className: "cursor-buddy-tool-icon cursor-buddy-tool-icon--error",
+			"aria-label": "Failed",
+			children: "!"
+		});
+		default: return null;
+	}
+}
+/**
+* Default tool bubble component.
+* Displays tool call status with optional approve/deny buttons.
+*/
+function ToolBubble({ toolName, args, status, label, result, error, approve, deny, dismiss, customRender }) {
+	if (customRender) return /* @__PURE__ */ jsx(Fragment, { children: customRender({
+		toolName,
+		args,
+		status,
+		label,
+		result,
+		error,
+		approve,
+		deny,
+		dismiss
+	}) });
+	const needsApproval = status === "awaiting_approval";
+	const isTerminal = status === "completed" || status === "denied" || status === "failed";
+	return /* @__PURE__ */ jsxs("div", {
+		className: `cursor-buddy-tool-bubble cursor-buddy-tool-bubble--${status}`,
+		role: "status",
+		"aria-live": "polite",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "cursor-buddy-tool-bubble__content",
+				children: [/* @__PURE__ */ jsx(StatusIcon, { status }), /* @__PURE__ */ jsx("span", {
+					className: "cursor-buddy-tool-bubble__label",
+					children: label
+				})]
+			}),
+			needsApproval && approve && deny && /* @__PURE__ */ jsxs("div", {
+				className: "cursor-buddy-tool-bubble__actions",
+				children: [/* @__PURE__ */ jsx("button", {
+					type: "button",
+					className: "cursor-buddy-tool-button cursor-buddy-tool-button--approve",
+					onClick: approve,
+					"aria-label": `Approve ${toolName}`,
+					children: "Yes (Y)"
+				}), /* @__PURE__ */ jsx("button", {
+					type: "button",
+					className: "cursor-buddy-tool-button cursor-buddy-tool-button--deny",
+					onClick: deny,
+					"aria-label": `Deny ${toolName}`,
+					children: "No (Esc)"
+				})]
+			}),
+			isTerminal && /* @__PURE__ */ jsx("button", {
+				type: "button",
+				className: "cursor-buddy-tool-bubble__dismiss",
+				onClick: dismiss,
+				"aria-label": "Dismiss",
+				children: "✕"
+			})
+		]
+	});
+}
+//#endregion
+//#region src/react/components/ToolBubbleStack.tsx
+/**
+* Stack of tool bubbles displayed near the cursor.
+* Renders all active tool calls in a vertical column.
+*/
+function ToolBubbleStack({ toolCalls, toolDisplay, onApprove, onDeny, onDismiss, renderToolBubble }) {
+	if (toolCalls.length === 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		className: "cursor-buddy-tool-stack",
+		role: "region",
+		"aria-label": "Tool calls",
+		children: toolCalls.map((toolCall) => {
+			const toolConfig = toolDisplay?.[toolCall.toolName] ?? toolDisplay?.["*"];
+			if (toolConfig?.mode === "hidden") return null;
+			const needsApproval = toolCall.status === "awaiting_approval";
+			const bubbleProps = {
+				toolName: toolCall.toolName,
+				args: toolCall.args,
+				status: toolCall.status,
+				label: toolCall.label,
+				result: toolCall.result,
+				error: toolCall.error,
+				approve: needsApproval ? () => onApprove(toolCall.id) : void 0,
+				deny: needsApproval ? () => onDeny(toolCall.id) : void 0,
+				dismiss: () => onDismiss(toolCall.id)
+			};
+			if (renderToolBubble) return /* @__PURE__ */ jsx("div", {
+				className: "cursor-buddy-tool-stack__item",
+				children: renderToolBubble(bubbleProps)
+			}, toolCall.id);
+			return /* @__PURE__ */ jsx("div", {
+				className: "cursor-buddy-tool-stack__item",
+				children: /* @__PURE__ */ jsx(ToolBubble, {
+					...bubbleProps,
+					customRender: toolConfig?.render
+				})
+			}, toolCall.id);
+		})
+	});
+}
+//#endregion
 //#region src/react/components/Waveform.tsx
 const EMPTY_BARS = Array.from({ length: 12 }, () => 0);
 /**
@@ -460,13 +699,14 @@ function DefaultWaveform({ audioLevel, isListening }) {
 //#endregion
 //#region src/react/components/Overlay.tsx
 /**
-* Overlay component that renders the cursor, speech bubble, and waveform.
+* Overlay component that renders the cursor, speech bubble, waveform, and tool bubbles.
 * Uses React portal to render at the document body level.
 */
-function Overlay({ cursor, speechBubble, waveform, container }) {
+function Overlay({ cursor, speechBubble, waveform, toolDisplay, renderToolBubble, container }) {
 	const [isMounted, setIsMounted] = useState(false);
 	useEffect(() => setIsMounted(true), []);
-	const { state, isPointing, isEnabled, dismissPointing } = useCursorBuddy();
+	const { state, isPointing, isEnabled, dismissPointing, activeToolCalls, pendingApproval, approveToolCall, denyToolCall, dismissToolCall } = useCursorBuddy();
+	useApprovalShortcuts(pendingApproval !== null, () => pendingApproval && approveToolCall(pendingApproval.id), () => pendingApproval && denyToolCall(pendingApproval.id));
 	const buddyPosition = useStore($buddyPosition);
 	const buddyRotation = useStore($buddyRotation);
 	const buddyScale = useStore($buddyScale);
@@ -503,7 +743,15 @@ function Overlay({ cursor, speechBubble, waveform, container }) {
 			children: [
 				cursorElement,
 				state === "listening" && waveformElement,
-				isPointing && speechBubbleElement
+				isPointing && speechBubbleElement,
+				/* @__PURE__ */ jsx(ToolBubbleStack, {
+					toolCalls: activeToolCalls,
+					toolDisplay,
+					onApprove: approveToolCall,
+					onDeny: denyToolCall,
+					onDismiss: dismissToolCall,
+					renderToolBubble
+				})
 			]
 		})
 	});
@@ -516,13 +764,15 @@ function Overlay({ cursor, speechBubble, waveform, container }) {
 /**
 * Internal component that sets up hotkey handling
 */
-function CursorBuddyInner({ hotkey = "ctrl+alt", cursor, speechBubble, waveform, container }) {
+function CursorBuddyInner({ hotkey = "ctrl+alt", cursor, speechBubble, waveform, toolDisplay, renderToolBubble, container }) {
 	const { startListening, stopListening, isEnabled } = useCursorBuddy();
 	useHotkey(hotkey, startListening, stopListening, isEnabled);
 	return /* @__PURE__ */ jsx(Overlay, {
 		cursor,
 		speechBubble,
 		waveform,
+		toolDisplay,
+		renderToolBubble,
 		container
 	});
 }
@@ -549,26 +799,31 @@ function CursorBuddyInner({ hotkey = "ctrl+alt", cursor, speechBubble, waveform,
 * }
 * ```
 */
-function CursorBuddy({ endpoint, hotkey, container, speech, transcription, cursor, speechBubble, waveform, onTranscript, onResponse, onPoint, onStateChange, onError }) {
+function CursorBuddy({ endpoint, hotkey, container, speech, transcription, cursor, speechBubble, waveform, toolDisplay, renderToolBubble, onTranscript, onResponse, onPoint, onStateChange, onError, onToolCall, onToolResult }) {
 	return /* @__PURE__ */ jsx(CursorBuddyProvider, {
 		endpoint,
 		speech,
 		transcription,
+		toolDisplay,
 		onTranscript,
 		onResponse,
 		onPoint,
 		onStateChange,
 		onError,
+		onToolCall,
+		onToolResult,
 		children: /* @__PURE__ */ jsx(CursorBuddyInner, {
 			hotkey,
 			cursor,
 			speechBubble,
 			waveform,
+			toolDisplay,
+			renderToolBubble,
 			container
 		})
 	});
 }
 //#endregion
-export { CursorBuddy, CursorBuddyProvider, useCursorBuddy };
+export { CursorBuddy, CursorBuddyProvider, ToolBubble, ToolBubbleStack, useCursorBuddy };
 
 //# sourceMappingURL=index.mjs.map