@epicbagel/saas-kit 1.20.0 → 1.22.0

package/README.md

@@ -60,6 +60,45 @@ does not import a voice provider. Stop and release audio tracks before setting
 }} />
 ```
 
+## Workflow assistant
+
+`primitives/workflow-assistant` exports `WorkflowAssistant`, a controlled
+conversation panel beside a working list. It uses `ChatThread`, `ChatInput`
+and the same `voiceSession` contract as Chat. The panel is non-modal: it
+leaves the page interactive, does not trap focus, and keeps the current
+`context` visible in its header. On short screens the panel can scroll while
+the header stays reachable.
+
+Opening the launcher starts an inactive voice session. Minimizing preserves
+the session, transcript and host-owned draft; the minimized launcher reports
+the current voice state and keeps End available. `disabled`, `pending` or
+`voiceSession.disabled` prevent a new call but never prevent reopening or
+ending an active call. Activation moves keyboard focus to the panel heading;
+minimizing returns it to the launcher. A host-driven open or scope update
+does not move focus away from the page.
+
+```tsx
+import { WorkflowAssistant } from "@epicbagel/saas-kit/primitives/workflow-assistant";
+
+<WorkflowAssistant
+  open={open} onOpenChange={setOpen}
+  expanded={expanded} onExpandedChange={setExpanded}
+  title="Voice review" context={`Current list · ${items.length} items`}
+  messages={messages} value={draft} onChange={setDraft} onSend={sendRequest}
+  pending={pending} error={error}
+  voiceSession={{ state, muted, onMutedChange: setMuted,
+    onStart: startVoice, onEnd: endVoice }}
+/>
+```
+
+The host owns authorization, list scope, messages, draft clearing, audio and
+connection cleanup. When scope changes, the host must cancel or replace any
+session that still refers to the previous list. Omit `voiceSession` for a
+text-only conversation, omit `onExpandedChange` to hide the expand control,
+and use `besideCornerAction` to leave space for an existing corner action.
+Override panel actions with `labels`; minimized session status and End also
+honor `voiceSession.labels`.
+
 ## API dictation
 
 Wrap the application in `DictationProvider` to use an authenticated transcription

package/dist/primitives/agent-audio-visualizer-bar.d.cts

@@ -11,10 +11,10 @@ import { AgentVisualizerState } from '../hooks/use-agent-audio-visualizer-bar.cj
  */
 declare function normalizeVolumeBands(bands: number[], count: number): number[];
 declare const AgentAudioVisualizerBarElementVariants: (props?: ({
-    size?: "sm" | "md" | "lg" | "xl" | "icon" | null | undefined;
+    size?: "icon" | "md" | "sm" | "lg" | "xl" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const AgentAudioVisualizerBarVariants: (props?: ({
-    size?: "sm" | "md" | "lg" | "xl" | "icon" | null | undefined;
+    size?: "icon" | "md" | "sm" | "lg" | "xl" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 /**
  * Props for the AgentAudioVisualizerBar component.

package/dist/primitives/agent-audio-visualizer-bar.d.ts

@@ -11,10 +11,10 @@ import { AgentVisualizerState } from '../hooks/use-agent-audio-visualizer-bar.js
  */
 declare function normalizeVolumeBands(bands: number[], count: number): number[];
 declare const AgentAudioVisualizerBarElementVariants: (props?: ({
-    size?: "sm" | "md" | "lg" | "xl" | "icon" | null | undefined;
+    size?: "icon" | "md" | "sm" | "lg" | "xl" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const AgentAudioVisualizerBarVariants: (props?: ({
-    size?: "sm" | "md" | "lg" | "xl" | "icon" | null | undefined;
+    size?: "icon" | "md" | "sm" | "lg" | "xl" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 /**
  * Props for the AgentAudioVisualizerBar component.

package/dist/primitives/alert.d.cts

@@ -4,7 +4,7 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
 import { VariantProps } from 'class-variance-authority';
 
 declare const alertVariants: (props?: ({
-    variant?: "default" | "destructive" | "success" | "warning" | null | undefined;
+    variant?: "success" | "default" | "destructive" | "warning" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface AlertProps extends HTMLAttributes<HTMLDivElement>, VariantProps<typeof alertVariants> {
     marginBottom?: "none" | "md";

package/dist/primitives/alert.d.ts

@@ -4,7 +4,7 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
 import { VariantProps } from 'class-variance-authority';
 
 declare const alertVariants: (props?: ({
-    variant?: "default" | "destructive" | "success" | "warning" | null | undefined;
+    variant?: "success" | "default" | "destructive" | "warning" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface AlertProps extends HTMLAttributes<HTMLDivElement>, VariantProps<typeof alertVariants> {
     marginBottom?: "none" | "md";

package/dist/primitives/attachment.d.cts

@@ -12,7 +12,7 @@ declare function Attachment({ className, state, size, orientation, ...props }: R
     state?: "idle" | "uploading" | "processing" | "error" | "done";
 }): react_jsx_runtime.JSX.Element;
 declare const attachmentMediaVariants: (props?: ({
-    variant?: "image" | "icon" | null | undefined;
+    variant?: "icon" | "image" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function AttachmentMedia({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof attachmentMediaVariants>): react_jsx_runtime.JSX.Element;
 declare function AttachmentContent({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;

package/dist/primitives/attachment.d.ts

@@ -12,7 +12,7 @@ declare function Attachment({ className, state, size, orientation, ...props }: R
     state?: "idle" | "uploading" | "processing" | "error" | "done";
 }): react_jsx_runtime.JSX.Element;
 declare const attachmentMediaVariants: (props?: ({
-    variant?: "image" | "icon" | null | undefined;
+    variant?: "icon" | "image" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function AttachmentMedia({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof attachmentMediaVariants>): react_jsx_runtime.JSX.Element;
 declare function AttachmentContent({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;

package/dist/primitives/badge.d.cts

@@ -4,7 +4,7 @@ import { VariantProps } from 'class-variance-authority';
 import { ElementType } from 'react';
 
 declare const badgeVariants: (props?: ({
-    variant?: "default" | "secondary" | "destructive" | "outline" | "success" | "warning" | "error" | "info" | "neutral" | null | undefined;
+    variant?: "error" | "success" | "default" | "secondary" | "destructive" | "outline" | "warning" | "info" | "neutral" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
     weight?: "normal" | "semibold" | "bold";

package/dist/primitives/badge.d.ts

@@ -4,7 +4,7 @@ import { VariantProps } from 'class-variance-authority';
 import { ElementType } from 'react';
 
 declare const badgeVariants: (props?: ({
-    variant?: "default" | "secondary" | "destructive" | "outline" | "success" | "warning" | "error" | "info" | "neutral" | null | undefined;
+    variant?: "error" | "success" | "default" | "secondary" | "destructive" | "outline" | "warning" | "info" | "neutral" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
     weight?: "normal" | "semibold" | "bold";

package/dist/primitives/bubble.d.cts

@@ -5,7 +5,7 @@ import { VariantProps } from 'class-variance-authority';
 
 declare function BubbleGroup({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare const bubbleVariants: (props?: ({
-    variant?: "default" | "muted" | "secondary" | "destructive" | "outline" | "ghost" | "tinted" | null | undefined;
+    variant?: "muted" | "default" | "secondary" | "destructive" | "outline" | "ghost" | "tinted" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function Bubble({ variant, align, className, ...props }: React.ComponentProps<"div"> & VariantProps<typeof bubbleVariants> & {
     align?: "start" | "end";

package/dist/primitives/bubble.d.ts

@@ -5,7 +5,7 @@ import { VariantProps } from 'class-variance-authority';
 
 declare function BubbleGroup({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare const bubbleVariants: (props?: ({
-    variant?: "default" | "muted" | "secondary" | "destructive" | "outline" | "ghost" | "tinted" | null | undefined;
+    variant?: "muted" | "default" | "secondary" | "destructive" | "outline" | "ghost" | "tinted" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function Bubble({ variant, align, className, ...props }: React.ComponentProps<"div"> & VariantProps<typeof bubbleVariants> & {
     align?: "start" | "end";

package/dist/primitives/button.d.cts

@@ -5,12 +5,12 @@ import { VariantProps } from 'class-variance-authority';
 
 declare const buttonVariants: (props?: ({
     variant?: "link" | "default" | "secondary" | "destructive" | "outline" | "outline-muted" | "ghost" | "quiet" | "ghost-destructive" | "link-muted" | "inverted" | "status-error" | "status-warning" | "status-muted" | null | undefined;
-    size?: "filter" | "status" | "toolbar" | "sm" | "lg" | "default" | "micro" | "compact" | "hero" | "icon" | "icon-lg" | "icon-sm" | "icon-md" | "icon-xs" | "icon-compact" | "icon-micro" | "bare" | "voice-sm" | "voice" | "suggestion" | "tone" | null | undefined;
+    size?: "filter" | "status" | "icon" | "toolbar" | "sm" | "lg" | "default" | "micro" | "compact" | "hero" | "icon-lg" | "icon-sm" | "icon-md" | "icon-xs" | "icon-compact" | "icon-micro" | "bare" | "voice-sm" | "voice" | "suggestion" | "tone" | null | undefined;
     width?: "auto" | "full" | "responsive" | null | undefined;
     align?: "center" | "start" | null | undefined;
     shrink?: boolean | null | undefined;
     shape?: "circle" | "default" | "pill" | null | undefined;
-    ring?: "none" | "surface" | null | undefined;
+    ring?: "surface" | "none" | null | undefined;
     grow?: boolean | null | undefined;
     minWidth?: "auto" | "zero" | null | undefined;
     textAlign?: "center" | "start" | null | undefined;

package/dist/primitives/button.d.ts

@@ -5,12 +5,12 @@ import { VariantProps } from 'class-variance-authority';
 
 declare const buttonVariants: (props?: ({
     variant?: "link" | "default" | "secondary" | "destructive" | "outline" | "outline-muted" | "ghost" | "quiet" | "ghost-destructive" | "link-muted" | "inverted" | "status-error" | "status-warning" | "status-muted" | null | undefined;
-    size?: "filter" | "status" | "toolbar" | "sm" | "lg" | "default" | "micro" | "compact" | "hero" | "icon" | "icon-lg" | "icon-sm" | "icon-md" | "icon-xs" | "icon-compact" | "icon-micro" | "bare" | "voice-sm" | "voice" | "suggestion" | "tone" | null | undefined;
+    size?: "filter" | "status" | "icon" | "toolbar" | "sm" | "lg" | "default" | "micro" | "compact" | "hero" | "icon-lg" | "icon-sm" | "icon-md" | "icon-xs" | "icon-compact" | "icon-micro" | "bare" | "voice-sm" | "voice" | "suggestion" | "tone" | null | undefined;
     width?: "auto" | "full" | "responsive" | null | undefined;
     align?: "center" | "start" | null | undefined;
     shrink?: boolean | null | undefined;
     shape?: "circle" | "default" | "pill" | null | undefined;
-    ring?: "none" | "surface" | null | undefined;
+    ring?: "surface" | "none" | null | undefined;
     grow?: boolean | null | undefined;
     minWidth?: "auto" | "zero" | null | undefined;
     textAlign?: "center" | "start" | null | undefined;

package/dist/primitives/item.d.cts

@@ -8,14 +8,14 @@ import '@radix-ui/react-separator';
 declare function ItemGroup({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare function ItemSeparator({ className, ...props }: React.ComponentProps<typeof Separator>): react_jsx_runtime.JSX.Element;
 declare const itemVariants: (props?: ({
-    variant?: "default" | "muted" | "outline" | null | undefined;
+    variant?: "muted" | "default" | "outline" | null | undefined;
     size?: "xs" | "sm" | "default" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function Item({ className, variant, size, asChild, ...props }: React.ComponentProps<"div"> & VariantProps<typeof itemVariants> & {
     asChild?: boolean;
 }): react_jsx_runtime.JSX.Element;
 declare const itemMediaVariants: (props?: ({
-    variant?: "image" | "default" | "icon" | null | undefined;
+    variant?: "icon" | "image" | "default" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function ItemMedia({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof itemMediaVariants>): react_jsx_runtime.JSX.Element;
 declare function ItemContent({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;

package/dist/primitives/item.d.ts

@@ -8,14 +8,14 @@ import '@radix-ui/react-separator';
 declare function ItemGroup({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare function ItemSeparator({ className, ...props }: React.ComponentProps<typeof Separator>): react_jsx_runtime.JSX.Element;
 declare const itemVariants: (props?: ({
-    variant?: "default" | "muted" | "outline" | null | undefined;
+    variant?: "muted" | "default" | "outline" | null | undefined;
     size?: "xs" | "sm" | "default" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function Item({ className, variant, size, asChild, ...props }: React.ComponentProps<"div"> & VariantProps<typeof itemVariants> & {
     asChild?: boolean;
 }): react_jsx_runtime.JSX.Element;
 declare const itemMediaVariants: (props?: ({
-    variant?: "image" | "default" | "icon" | null | undefined;
+    variant?: "icon" | "image" | "default" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function ItemMedia({ className, variant, ...props }: React.ComponentProps<"div"> & VariantProps<typeof itemMediaVariants>): react_jsx_runtime.JSX.Element;
 declare function ItemContent({ className, ...props }: React.ComponentProps<"div">): react_jsx_runtime.JSX.Element;

package/dist/primitives/section-header.d.cts

@@ -5,7 +5,7 @@ import { VariantProps } from 'class-variance-authority';
 
 declare const sectionHeaderVariants: (props?: ({
     variant?: "muted" | "plain" | null | undefined;
-    spacing?: "none" | "tight" | "loose" | null | undefined;
+    spacing?: "tight" | "loose" | "none" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SectionHeaderProps extends Omit<HTMLAttributes<HTMLHeadingElement>, "children">, VariantProps<typeof sectionHeaderVariants> {
     /** Pre-rendered icon node. Sized to match the header text. */

package/dist/primitives/section-header.d.ts

@@ -5,7 +5,7 @@ import { VariantProps } from 'class-variance-authority';
 
 declare const sectionHeaderVariants: (props?: ({
     variant?: "muted" | "plain" | null | undefined;
-    spacing?: "none" | "tight" | "loose" | null | undefined;
+    spacing?: "tight" | "loose" | "none" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SectionHeaderProps extends Omit<HTMLAttributes<HTMLHeadingElement>, "children">, VariantProps<typeof sectionHeaderVariants> {
     /** Pre-rendered icon node. Sized to match the header text. */

package/dist/primitives/toggle-group.d.cts

@@ -5,11 +5,11 @@ import { VariantProps } from 'class-variance-authority';
 
 declare const ToggleGroup: React.ForwardRefExoticComponent<((Omit<ToggleGroupPrimitive.ToggleGroupSingleProps & React.RefAttributes<HTMLDivElement>, "ref"> | Omit<ToggleGroupPrimitive.ToggleGroupMultipleProps & React.RefAttributes<HTMLDivElement>, "ref">) & VariantProps<(props?: ({
     variant?: "default" | "outline" | null | undefined;
-    size?: "sm" | "lg" | "default" | "icon" | "icon-lg" | "avatar" | "chip" | null | undefined;
+    size?: "icon" | "sm" | "lg" | "default" | "icon-lg" | "avatar" | "chip" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string>) & React.RefAttributes<HTMLDivElement>>;
 declare const ToggleGroupItem: React.ForwardRefExoticComponent<Omit<ToggleGroupPrimitive.ToggleGroupItemProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
     variant?: "default" | "outline" | null | undefined;
-    size?: "sm" | "lg" | "default" | "icon" | "icon-lg" | "avatar" | "chip" | null | undefined;
+    size?: "icon" | "sm" | "lg" | "default" | "icon-lg" | "avatar" | "chip" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & {
     grow?: boolean;
     textSize?: "inherit" | "xs";

package/dist/primitives/toggle-group.d.ts

@@ -5,11 +5,11 @@ import { VariantProps } from 'class-variance-authority';
 
 declare const ToggleGroup: React.ForwardRefExoticComponent<((Omit<ToggleGroupPrimitive.ToggleGroupSingleProps & React.RefAttributes<HTMLDivElement>, "ref"> | Omit<ToggleGroupPrimitive.ToggleGroupMultipleProps & React.RefAttributes<HTMLDivElement>, "ref">) & VariantProps<(props?: ({
     variant?: "default" | "outline" | null | undefined;
-    size?: "sm" | "lg" | "default" | "icon" | "icon-lg" | "avatar" | "chip" | null | undefined;
+    size?: "icon" | "sm" | "lg" | "default" | "icon-lg" | "avatar" | "chip" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string>) & React.RefAttributes<HTMLDivElement>>;
 declare const ToggleGroupItem: React.ForwardRefExoticComponent<Omit<ToggleGroupPrimitive.ToggleGroupItemProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
     variant?: "default" | "outline" | null | undefined;
-    size?: "sm" | "lg" | "default" | "icon" | "icon-lg" | "avatar" | "chip" | null | undefined;
+    size?: "icon" | "sm" | "lg" | "default" | "icon-lg" | "avatar" | "chip" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & {
     grow?: boolean;
     textSize?: "inherit" | "xs";

package/dist/primitives/toggle.d.cts

@@ -5,11 +5,11 @@ import * as React from 'react';
 
 declare const toggleVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
-    size?: "sm" | "lg" | "default" | "icon" | "icon-lg" | "avatar" | "chip" | null | undefined;
+    size?: "icon" | "sm" | "lg" | "default" | "icon-lg" | "avatar" | "chip" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const Toggle: React.ForwardRefExoticComponent<Omit<TogglePrimitive.ToggleProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
     variant?: "default" | "outline" | null | undefined;
-    size?: "sm" | "lg" | "default" | "icon" | "icon-lg" | "avatar" | "chip" | null | undefined;
+    size?: "icon" | "sm" | "lg" | "default" | "icon-lg" | "avatar" | "chip" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & React.RefAttributes<HTMLButtonElement>>;
 
 export { Toggle, toggleVariants };

package/dist/primitives/toggle.d.ts

@@ -5,11 +5,11 @@ import * as React from 'react';
 
 declare const toggleVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
-    size?: "sm" | "lg" | "default" | "icon" | "icon-lg" | "avatar" | "chip" | null | undefined;
+    size?: "icon" | "sm" | "lg" | "default" | "icon-lg" | "avatar" | "chip" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const Toggle: React.ForwardRefExoticComponent<Omit<TogglePrimitive.ToggleProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
     variant?: "default" | "outline" | null | undefined;
-    size?: "sm" | "lg" | "default" | "icon" | "icon-lg" | "avatar" | "chip" | null | undefined;
+    size?: "icon" | "sm" | "lg" | "default" | "icon-lg" | "avatar" | "chip" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & React.RefAttributes<HTMLButtonElement>>;
 
 export { Toggle, toggleVariants };

package/dist/primitives/workflow-assistant.cjs

@@ -0,0 +1,170 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
+"use client";
+
+
+var _chunkYMI3X2YLcjs = require('../chunk-YMI3X2YL.cjs');
+require('../chunk-NKWHDI4C.cjs');
+
+
+var _chunkJDEXZGIYcjs = require('../chunk-JDEXZGIY.cjs');
+
+
+var _chunkKWLSBTB2cjs = require('../chunk-KWLSBTB2.cjs');
+require('../chunk-2BSFYU22.cjs');
+
+// src/primitives/workflow-assistant.tsx
+var _react = require('react');
+var _lucidereact = require('lucide-react');
+var _jsxruntime = require('react/jsx-runtime');
+var SESSION_LABELS = {
+  disconnected: "Voice chat",
+  connecting: "Connecting\u2026",
+  listening: "Listening\u2026",
+  thinking: "Thinking\u2026",
+  speaking: "Speaking",
+  reconnecting: "Reconnecting\u2026",
+  error: "Voice chat unavailable"
+};
+var WorkflowAssistant = _react.forwardRef.call(void 0, function WorkflowAssistant2({
+  open,
+  onOpenChange,
+  expanded = false,
+  onExpandedChange,
+  title = "Voice review",
+  context,
+  description,
+  summaries,
+  voiceSession,
+  pending,
+  disabled,
+  error,
+  besideCornerAction = false,
+  labels,
+  className
+}, ref) {
+  const titleId = _react.useId.call(void 0, );
+  const statusId = _react.useId.call(void 0, );
+  const launcher = _react.useRef.call(void 0, null);
+  const heading = _react.useRef.call(void 0, null);
+  const moveFocus = _react.useRef.call(void 0, false);
+  _react.useEffect.call(void 0, () => {
+    if (!moveFocus.current) return;
+    moveFocus.current = false;
+    _optionalChain([(open ? heading.current : launcher.current), 'optionalAccess', _ => _.focus, 'call', _2 => _2()]);
+  }, [open]);
+  const toggle = (next) => {
+    moveFocus.current = true;
+    onOpenChange(next);
+  };
+  const startDisabled = pending || disabled || voiceSession.disabled;
+  const active = voiceSession.state !== "disconnected" && voiceSession.state !== "error";
+  const status = voiceSession.muted && voiceSession.state === "listening" ? _nullishCoalesce(_optionalChain([voiceSession, 'access', _3 => _3.labels, 'optionalAccess', _4 => _4.muted]), () => ( "Microphone muted")) : _nullishCoalesce(_optionalChain([voiceSession, 'access', _5 => _5.labels, 'optionalAccess', _6 => _6[voiceSession.state]]), () => ( SESSION_LABELS[voiceSession.state]));
+  const unavailable = voiceSession.state === "error" && voiceSession.disabled;
+  if (!open) return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+    "aside",
+    {
+      ref,
+      "data-slot": "workflow-assistant-launcher",
+      "aria-label": title,
+      className: _chunkKWLSBTB2cjs.cn.call(void 0, "fixed bottom-[calc(1.5rem+env(safe-area-inset-bottom))] z-40 flex max-w-[calc(100vw-9rem)] items-center gap-1", besideCornerAction ? "right-32 md:right-36" : "right-6 md:right-8", className),
+      children: [
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+          _chunkJDEXZGIYcjs.Button,
+          {
+            ref: launcher,
+            type: "button",
+            shape: "pill",
+            className: "min-h-12 min-w-12 max-w-full gap-2 shadow-lg",
+            disabled: startDisabled && !active && !unavailable,
+            "aria-label": active ? title : unavailable ? "Voice review unavailable" : _nullishCoalesce(_optionalChain([labels, 'optionalAccess', _7 => _7.start]), () => ( "Start voice review")),
+            "aria-expanded": false,
+            "aria-describedby": active ? statusId : void 0,
+            onClick: () => {
+              toggle(true);
+              if (!active && !startDisabled) voiceSession.onStart();
+            },
+            children: [
+              /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.AudioLines, { "aria-hidden": "true", className: "shrink-0" }),
+              /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { id: statusId, role: active ? "status" : void 0, className: "truncate", children: active ? status : unavailable ? "Voice unavailable" : title })
+            ]
+          }
+        ),
+        active && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+          _chunkJDEXZGIYcjs.Button,
+          {
+            type: "button",
+            variant: "outline",
+            shape: "circle",
+            size: "icon",
+            className: "min-h-12 min-w-12 bg-background shadow-lg",
+            onClick: () => {
+              _optionalChain([launcher, 'access', _8 => _8.current, 'optionalAccess', _9 => _9.focus, 'call', _10 => _10()]);
+              voiceSession.onEnd();
+            },
+            "aria-label": _nullishCoalesce(_nullishCoalesce(_optionalChain([labels, 'optionalAccess', _11 => _11.end]), () => ( _optionalChain([voiceSession, 'access', _12 => _12.labels, 'optionalAccess', _13 => _13.end]))), () => ( "End voice chat")),
+            children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.Square, { "aria-hidden": "true" })
+          }
+        )
+      ]
+    }
+  );
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+    "aside",
+    {
+      ref,
+      "data-slot": "workflow-assistant",
+      "aria-labelledby": titleId,
+      className: _chunkKWLSBTB2cjs.cn.call(void 0, 
+        "fixed inset-x-2 bottom-[calc(1rem+env(safe-area-inset-bottom))] z-40 flex min-h-0 flex-col overflow-y-auto overscroll-contain rounded-2xl border bg-background shadow-xl sm:inset-x-auto sm:right-6 sm:w-[28rem] md:right-8",
+        expanded ? "h-[calc(100dvh-6rem)]" : "max-h-[min(36rem,70dvh)]",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "sticky top-0 z-10 flex shrink-0 items-start gap-2 border-b bg-background p-3", children: [
+          /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "min-w-0 flex-1", children: [
+            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { ref: heading, tabIndex: -1, id: titleId, className: "text-sm font-semibold", children: title }),
+            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { title: context, className: "mt-1 truncate text-xs text-muted-foreground", children: context })
+          ] }),
+          onExpandedChange && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+            _chunkJDEXZGIYcjs.Button,
+            {
+              type: "button",
+              variant: "ghost",
+              size: "icon",
+              "aria-label": expanded ? _nullishCoalesce(_optionalChain([labels, 'optionalAccess', _14 => _14.collapse]), () => ( "Reduce panel")) : _nullishCoalesce(_optionalChain([labels, 'optionalAccess', _15 => _15.expand]), () => ( "Expand panel")),
+              onClick: () => onExpandedChange(!expanded),
+              children: expanded ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.Minimize2, { "aria-hidden": "true" }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.Maximize2, { "aria-hidden": "true" })
+            }
+          ),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJDEXZGIYcjs.Button, { type: "button", variant: "ghost", size: "icon", "aria-label": _nullishCoalesce(_optionalChain([labels, 'optionalAccess', _16 => _16.minimize]), () => ( "Minimize voice review")), onClick: () => toggle(false), children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.ChevronDown, { "aria-hidden": "true" }) })
+        ] }),
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "shrink-0", "data-slot": "workflow-assistant-voice", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+          _chunkYMI3X2YLcjs.VoiceSessionControls,
+          {
+            ...voiceSession,
+            disabled: Boolean(startDisabled),
+            size: "hero",
+            onEnd: () => {
+              _optionalChain([heading, 'access', _17 => _17.current, 'optionalAccess', _18 => _18.focus, 'call', _19 => _19()]);
+              voiceSession.onEnd();
+            },
+            className: _chunkKWLSBTB2cjs.cn.call(void 0, !active && "justify-center px-4 py-6 text-center")
+          }
+        ) }),
+        description && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "shrink-0 px-4 py-3 text-sm text-muted-foreground", children: description }),
+        error && (voiceSession.state !== "error" || error !== voiceSession.error) && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { role: "alert", className: "shrink-0 px-4 py-2 text-sm text-destructive", children: error }),
+        pending && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { role: "status", className: "shrink-0 px-4 py-2 text-sm text-muted-foreground", children: "Applying your instructions\u2026" }),
+        summaries.length > 0 && /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "section", { "aria-label": "Action summaries", className: "min-h-20 flex-1 overflow-y-auto border-t px-4 py-3", children: [
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h3", { className: "mb-3 text-xs font-medium text-muted-foreground", children: "Action summaries" }),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "ol", { className: "space-y-3", "aria-live": "polite", "aria-relevant": "additions", children: [...summaries].reverse().map((summary) => /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "li", { className: "space-y-1 border-b pb-3 last:border-0 last:pb-0", children: [
+            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { className: "text-xs text-muted-foreground", children: summary.context }),
+            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { className: "whitespace-pre-wrap break-words text-sm", children: summary.body })
+          ] }, summary.id)) })
+        ] })
+      ]
+    }
+  );
+});
+
+
+exports.WorkflowAssistant = WorkflowAssistant;

package/dist/primitives/workflow-assistant.d.cts

@@ -0,0 +1,43 @@
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { VoiceSessionControlsProps } from './voice-session-controls.cjs';
+import 'react/jsx-runtime';
+
+interface WorkflowSummary {
+    id: string;
+    /** Scope at the time of the action, which may differ from the current list. */
+    context: string;
+    body: string;
+}
+interface WorkflowAssistantProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    expanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
+    title?: string;
+    /** Current host-owned scope. Keep it visible while the summaries scroll. */
+    context: string;
+    description?: ReactNode;
+    /** Saved action receipts and clarification questions, newest last. Read-only. */
+    summaries: WorkflowSummary[];
+    /** Minimizing preserves this host-owned session; only End calls onEnd. */
+    voiceSession: VoiceSessionControlsProps;
+    pending?: boolean;
+    disabled?: boolean;
+    error?: string | null;
+    /** Leave room for an existing corner action such as New. */
+    besideCornerAction?: boolean;
+    labels?: {
+        start?: string;
+        minimize?: string;
+        expand?: string;
+        collapse?: string;
+        end?: string;
+    };
+    className?: string;
+}
+/** Voice-only workflow controls: the underlying list stays usable.
+ * The host owns scope, authorization, persistence and the voice connection. */
+declare const WorkflowAssistant: React.ForwardRefExoticComponent<WorkflowAssistantProps & React.RefAttributes<HTMLElement>>;
+
+export { WorkflowAssistant, type WorkflowAssistantProps, type WorkflowSummary };

package/dist/primitives/workflow-assistant.d.ts

@@ -0,0 +1,43 @@
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { VoiceSessionControlsProps } from './voice-session-controls.js';
+import 'react/jsx-runtime';
+
+interface WorkflowSummary {
+    id: string;
+    /** Scope at the time of the action, which may differ from the current list. */
+    context: string;
+    body: string;
+}
+interface WorkflowAssistantProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    expanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
+    title?: string;
+    /** Current host-owned scope. Keep it visible while the summaries scroll. */
+    context: string;
+    description?: ReactNode;
+    /** Saved action receipts and clarification questions, newest last. Read-only. */
+    summaries: WorkflowSummary[];
+    /** Minimizing preserves this host-owned session; only End calls onEnd. */
+    voiceSession: VoiceSessionControlsProps;
+    pending?: boolean;
+    disabled?: boolean;
+    error?: string | null;
+    /** Leave room for an existing corner action such as New. */
+    besideCornerAction?: boolean;
+    labels?: {
+        start?: string;
+        minimize?: string;
+        expand?: string;
+        collapse?: string;
+        end?: string;
+    };
+    className?: string;
+}
+/** Voice-only workflow controls: the underlying list stays usable.
+ * The host owns scope, authorization, persistence and the voice connection. */
+declare const WorkflowAssistant: React.ForwardRefExoticComponent<WorkflowAssistantProps & React.RefAttributes<HTMLElement>>;
+
+export { WorkflowAssistant, type WorkflowAssistantProps, type WorkflowSummary };

package/dist/primitives/workflow-assistant.js

@@ -0,0 +1,170 @@
+"use client";
+"use client";
+import {
+  VoiceSessionControls
+} from "../chunk-KF4X37DP.js";
+import "../chunk-5OF6D3GH.js";
+import {
+  Button
+} from "../chunk-W326GKML.js";
+import {
+  cn
+} from "../chunk-G6SRSWXB.js";
+import "../chunk-GJ7S3L6R.js";
+
+// src/primitives/workflow-assistant.tsx
+import { forwardRef, useEffect, useId, useRef } from "react";
+import { AudioLines, ChevronDown, Maximize2, Minimize2, Square } from "lucide-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var SESSION_LABELS = {
+  disconnected: "Voice chat",
+  connecting: "Connecting\u2026",
+  listening: "Listening\u2026",
+  thinking: "Thinking\u2026",
+  speaking: "Speaking",
+  reconnecting: "Reconnecting\u2026",
+  error: "Voice chat unavailable"
+};
+var WorkflowAssistant = forwardRef(function WorkflowAssistant2({
+  open,
+  onOpenChange,
+  expanded = false,
+  onExpandedChange,
+  title = "Voice review",
+  context,
+  description,
+  summaries,
+  voiceSession,
+  pending,
+  disabled,
+  error,
+  besideCornerAction = false,
+  labels,
+  className
+}, ref) {
+  const titleId = useId();
+  const statusId = useId();
+  const launcher = useRef(null);
+  const heading = useRef(null);
+  const moveFocus = useRef(false);
+  useEffect(() => {
+    if (!moveFocus.current) return;
+    moveFocus.current = false;
+    (open ? heading.current : launcher.current)?.focus();
+  }, [open]);
+  const toggle = (next) => {
+    moveFocus.current = true;
+    onOpenChange(next);
+  };
+  const startDisabled = pending || disabled || voiceSession.disabled;
+  const active = voiceSession.state !== "disconnected" && voiceSession.state !== "error";
+  const status = voiceSession.muted && voiceSession.state === "listening" ? voiceSession.labels?.muted ?? "Microphone muted" : voiceSession.labels?.[voiceSession.state] ?? SESSION_LABELS[voiceSession.state];
+  const unavailable = voiceSession.state === "error" && voiceSession.disabled;
+  if (!open) return /* @__PURE__ */ jsxs(
+    "aside",
+    {
+      ref,
+      "data-slot": "workflow-assistant-launcher",
+      "aria-label": title,
+      className: cn("fixed bottom-[calc(1.5rem+env(safe-area-inset-bottom))] z-40 flex max-w-[calc(100vw-9rem)] items-center gap-1", besideCornerAction ? "right-32 md:right-36" : "right-6 md:right-8", className),
+      children: [
+        /* @__PURE__ */ jsxs(
+          Button,
+          {
+            ref: launcher,
+            type: "button",
+            shape: "pill",
+            className: "min-h-12 min-w-12 max-w-full gap-2 shadow-lg",
+            disabled: startDisabled && !active && !unavailable,
+            "aria-label": active ? title : unavailable ? "Voice review unavailable" : labels?.start ?? "Start voice review",
+            "aria-expanded": false,
+            "aria-describedby": active ? statusId : void 0,
+            onClick: () => {
+              toggle(true);
+              if (!active && !startDisabled) voiceSession.onStart();
+            },
+            children: [
+              /* @__PURE__ */ jsx(AudioLines, { "aria-hidden": "true", className: "shrink-0" }),
+              /* @__PURE__ */ jsx("span", { id: statusId, role: active ? "status" : void 0, className: "truncate", children: active ? status : unavailable ? "Voice unavailable" : title })
+            ]
+          }
+        ),
+        active && /* @__PURE__ */ jsx(
+          Button,
+          {
+            type: "button",
+            variant: "outline",
+            shape: "circle",
+            size: "icon",
+            className: "min-h-12 min-w-12 bg-background shadow-lg",
+            onClick: () => {
+              launcher.current?.focus();
+              voiceSession.onEnd();
+            },
+            "aria-label": labels?.end ?? voiceSession.labels?.end ?? "End voice chat",
+            children: /* @__PURE__ */ jsx(Square, { "aria-hidden": "true" })
+          }
+        )
+      ]
+    }
+  );
+  return /* @__PURE__ */ jsxs(
+    "aside",
+    {
+      ref,
+      "data-slot": "workflow-assistant",
+      "aria-labelledby": titleId,
+      className: cn(
+        "fixed inset-x-2 bottom-[calc(1rem+env(safe-area-inset-bottom))] z-40 flex min-h-0 flex-col overflow-y-auto overscroll-contain rounded-2xl border bg-background shadow-xl sm:inset-x-auto sm:right-6 sm:w-[28rem] md:right-8",
+        expanded ? "h-[calc(100dvh-6rem)]" : "max-h-[min(36rem,70dvh)]",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: "sticky top-0 z-10 flex shrink-0 items-start gap-2 border-b bg-background p-3", children: [
+          /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+            /* @__PURE__ */ jsx("h2", { ref: heading, tabIndex: -1, id: titleId, className: "text-sm font-semibold", children: title }),
+            /* @__PURE__ */ jsx("p", { title: context, className: "mt-1 truncate text-xs text-muted-foreground", children: context })
+          ] }),
+          onExpandedChange && /* @__PURE__ */ jsx(
+            Button,
+            {
+              type: "button",
+              variant: "ghost",
+              size: "icon",
+              "aria-label": expanded ? labels?.collapse ?? "Reduce panel" : labels?.expand ?? "Expand panel",
+              onClick: () => onExpandedChange(!expanded),
+              children: expanded ? /* @__PURE__ */ jsx(Minimize2, { "aria-hidden": "true" }) : /* @__PURE__ */ jsx(Maximize2, { "aria-hidden": "true" })
+            }
+          ),
+          /* @__PURE__ */ jsx(Button, { type: "button", variant: "ghost", size: "icon", "aria-label": labels?.minimize ?? "Minimize voice review", onClick: () => toggle(false), children: /* @__PURE__ */ jsx(ChevronDown, { "aria-hidden": "true" }) })
+        ] }),
+        /* @__PURE__ */ jsx("div", { className: "shrink-0", "data-slot": "workflow-assistant-voice", children: /* @__PURE__ */ jsx(
+          VoiceSessionControls,
+          {
+            ...voiceSession,
+            disabled: Boolean(startDisabled),
+            size: "hero",
+            onEnd: () => {
+              heading.current?.focus();
+              voiceSession.onEnd();
+            },
+            className: cn(!active && "justify-center px-4 py-6 text-center")
+          }
+        ) }),
+        description && /* @__PURE__ */ jsx("div", { className: "shrink-0 px-4 py-3 text-sm text-muted-foreground", children: description }),
+        error && (voiceSession.state !== "error" || error !== voiceSession.error) && /* @__PURE__ */ jsx("p", { role: "alert", className: "shrink-0 px-4 py-2 text-sm text-destructive", children: error }),
+        pending && /* @__PURE__ */ jsx("p", { role: "status", className: "shrink-0 px-4 py-2 text-sm text-muted-foreground", children: "Applying your instructions\u2026" }),
+        summaries.length > 0 && /* @__PURE__ */ jsxs("section", { "aria-label": "Action summaries", className: "min-h-20 flex-1 overflow-y-auto border-t px-4 py-3", children: [
+          /* @__PURE__ */ jsx("h3", { className: "mb-3 text-xs font-medium text-muted-foreground", children: "Action summaries" }),
+          /* @__PURE__ */ jsx("ol", { className: "space-y-3", "aria-live": "polite", "aria-relevant": "additions", children: [...summaries].reverse().map((summary) => /* @__PURE__ */ jsxs("li", { className: "space-y-1 border-b pb-3 last:border-0 last:pb-0", children: [
+            /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground", children: summary.context }),
+            /* @__PURE__ */ jsx("p", { className: "whitespace-pre-wrap break-words text-sm", children: summary.body })
+          ] }, summary.id)) })
+        ] })
+      ]
+    }
+  );
+});
+export {
+  WorkflowAssistant
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epicbagel/saas-kit",
-  "version": "1.20.0",
+  "version": "1.22.0",
   "description": "Accessible React primitives, layout components and design tokens for SaaS apps, built on Radix UI and Tailwind CSS v4.",
   "license": "MIT",
   "keywords": [
@@ -1290,6 +1290,16 @@
         "default": "./dist/primitives/voice-session-controls.cjs"
       }
     },
+    "./primitives/workflow-assistant": {
+      "import": {
+        "types": "./dist/primitives/workflow-assistant.d.ts",
+        "default": "./dist/primitives/workflow-assistant.js"
+      },
+      "require": {
+        "types": "./dist/primitives/workflow-assistant.d.cts",
+        "default": "./dist/primitives/workflow-assistant.cjs"
+      }
+    },
     "./hooks/use-agent-audio-visualizer-bar": {
       "import": {
         "types": "./dist/hooks/use-agent-audio-visualizer-bar.d.ts",