@skippr/live-agent-sdk 0.79.0 → 0.81.0

package/dist/types/capture/agentActionSignal.d.ts

@@ -6,11 +6,9 @@ export declare function isAgentActionInProgress(): boolean;
 export declare function onSnapshotRequest(handler: () => void): () => void;
 /** PageActionHandler calls this after performing an agent action. */
 export declare function requestSnapshotAfterAction(): void;
-export declare function setActionsPaused(paused: boolean): void;
-export declare function isActionsPaused(): boolean;
-/** PageActionHandler subscribes to re-drain its held queue on resume; returns an unsubscribe. */
-export declare function onActionsPausedChange(cb: (paused: boolean) => void): () => void;
+export declare function stopActions(): void;
+export declare function onActionsStopped(subscriber: () => void): () => void;
 export declare function setActionsBusy(busy: boolean): void;
 export declare function isActionsBusy(): boolean;
 /** Control bar subscribes to show/hide the Stop button; returns an unsubscribe. */
-export declare function subscribeActionsBusy(cb: (busy: boolean) => void): () => void;
+export declare function subscribeActionsBusy(subscriber: (busy: boolean) => void): () => void;

package/dist/types/components/AutoStartMedia.d.ts

@@ -1,6 +1,6 @@
 interface AutoStartMediaProps {
     pendingScreenStream: MediaStream | null;
-    tapToTalk?: boolean;
+    pushOrTapMicMode?: boolean;
 }
-export declare function AutoStartMedia({ pendingScreenStream, tapToTalk }: AutoStartMediaProps): null;
+export declare function AutoStartMedia({ pendingScreenStream, pushOrTapMicMode, }: AutoStartMediaProps): null;
 export {};

package/dist/types/components/DomCapture.d.ts

@@ -1,5 +1,5 @@
 interface DomCaptureProps {
-    tapToTalk?: boolean;
+    pushOrTapMicMode?: boolean;
 }
-export declare function DomCapture({ tapToTalk }: DomCaptureProps): null;
+export declare function DomCapture({ pushOrTapMicMode }: DomCaptureProps): null;
 export {};

package/dist/types/components/PushToTalkHint.d.ts

@@ -0,0 +1 @@
+export declare function PushToTalkHint(): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/PushToTalkMic.d.ts

@@ -0,0 +1,8 @@
+interface PushToTalkMicProps {
+    isCapturingSpeech: boolean;
+    showLabel: boolean;
+    onStart: () => void;
+    onCommit: () => void;
+}
+export declare function PushToTalkMic({ isCapturingSpeech, showLabel, onStart, onCommit, }: PushToTalkMicProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/StopActionsIcon.d.ts

@@ -0,0 +1,5 @@
+interface StopActionsIconProps {
+    className?: string;
+}
+export declare function StopActionsIcon({ className }: StopActionsIconProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/context/LiveAgentContext.d.ts

@@ -1,15 +1,15 @@
 import type { LauncherDropTarget } from '../hooks/useLauncherDrag';
 import type { PhaseStatus } from '../hooks/usePhaseUpdates';
 import type { AgentMode } from '../lib/agentMode';
-import { CAPTURE_MODE, type CaptureMode, DEFAULT_CAPTURE_MODE } from '../lib/constants';
+import { CAPTURE_MODE, type CaptureMode, DEFAULT_CAPTURE_MODE, MIC_MODE, type MicMode } from '../lib/constants';
 import type { SessionStatus } from '../lib/sessionStatus';
 import type { Message } from '../types';
 export type SidebarTab = 'chat' | 'agenda';
-export { CAPTURE_MODE, type CaptureMode, DEFAULT_CAPTURE_MODE };
+export { CAPTURE_MODE, type CaptureMode, DEFAULT_CAPTURE_MODE, MIC_MODE, type MicMode };
 export interface AgentControls {
     highlight?: boolean;
     actions?: boolean;
-    tapToTalk?: boolean;
+    micMode?: MicMode;
 }
 export interface UiPreferences {
     animateCursor?: boolean;

package/dist/types/context/VoiceTurnContext.d.ts

@@ -0,0 +1,6 @@
+import { type ReactNode } from 'react';
+import { type UseVoiceTurnValue } from '../hooks/useVoiceTurn';
+export declare function VoiceTurnProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useVoiceTurnContext(): UseVoiceTurnValue;

package/dist/types/hooks/useActionControl.d.ts

@@ -1,8 +1,6 @@
 export interface UseActionControlValue {
     /** True while the agent's on-screen action flow is running (single action or multi-step plan). */
     actionsActive: boolean;
-    actionsPaused: boolean;
-    togglePaused: () => Promise<void>;
+    stopActions: () => Promise<void>;
 }
-/** Owns the user's pause/resume control over the agent's on-screen action flow. */
 export declare function useActionControl(): UseActionControlValue;

package/dist/types/hooks/useKeyboardPushToTalk.d.ts

@@ -0,0 +1,8 @@
+interface UseKeyboardPushToTalkOptions {
+    enabled: boolean;
+    onStart: () => void;
+    onCommit: () => void;
+    onKeyUsed?: () => void;
+}
+export declare function useKeyboardPushToTalk({ enabled, onStart, onCommit, onKeyUsed, }: UseKeyboardPushToTalkOptions): void;
+export {};

package/dist/types/hooks/usePlanUpdates.d.ts

@@ -1,5 +1,5 @@
 export type PlanStepStatus = 'pending' | 'active' | 'done' | 'failed';
-export type PlanState = 'proposed' | 'executing' | 'completed' | 'abandoned';
+export type PlanState = 'proposed' | 'executing' | 'completed' | 'abandoned' | 'aborted';
 export interface PlanStep {
     index: number;
     label: string;

package/dist/types/hooks/useVoiceTurn.d.ts

@@ -0,0 +1,7 @@
+export interface UseVoiceTurnValue {
+    isCapturingSpeech: boolean;
+    toggle: () => void;
+    start: () => void;
+    commit: () => void;
+}
+export declare function useVoiceTurn(): UseVoiceTurnValue;

package/dist/types/lib/constants.d.ts

@@ -15,7 +15,17 @@ export declare const PAGE_ACTIONS_TOPIC = "skippr.page-actions";
 export declare const TEXT_MODE_TOPIC = "skippr.text-mode";
 export declare const ACTION_CONTROL_TOPIC = "skippr.action-control";
 export declare const SESSION_HOLD_TOPIC = "skippr.session-hold";
-export declare const TAP_TO_TALK_TOPIC = "skippr.tap-to-talk";
+export declare const MIC_MODE_TURN_TOPIC = "skippr.mic-mode-turn";
+export declare const MIC_MODE: {
+    readonly Live: "live";
+    readonly PushToTalk: "pushToTalk";
+    readonly TapToTalk: "tapToTalk";
+};
+export type MicMode = (typeof MIC_MODE)[keyof typeof MIC_MODE];
+export declare const DEFAULT_MIC_MODE: MicMode;
+export declare function isRequestResponseMicMode(micMode: MicMode | undefined): micMode is typeof MIC_MODE.PushToTalk | typeof MIC_MODE.TapToTalk;
+export declare const PUSH_TO_TALK_KEY = "Backquote";
+export declare const PUSH_TO_TALK_KEY_LABEL = "`";
 export declare const IDLE_AUTO_PAUSE_MS: number;
 export declare const PLAN_ATTR = "skippr.action-plan";
 export declare const NAME_MAX_CHARS = 80;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skippr/live-agent-sdk",
-  "version": "0.79.0",
+  "version": "0.81.0",
   "type": "module",
   "main": "dist/esm/lib-exports.js",
   "module": "dist/esm/lib-exports.js",

package/dist/types/context/TapToTalkContext.d.ts

@@ -1,6 +0,0 @@
-import { type ReactNode } from 'react';
-import { type UseTapToTalkValue } from '../hooks/useTapToTalk';
-export declare function TapToTalkProvider({ children }: {
-    children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function useTapToTalkContext(): UseTapToTalkValue;

package/dist/types/hooks/useTapToTalk.d.ts

@@ -1,5 +0,0 @@
-export interface UseTapToTalkValue {
-    isCapturingSpeech: boolean;
-    toggle: () => void;
-}
-export declare function useTapToTalk(): UseTapToTalkValue;