@skippr/live-agent-sdk 0.33.0 → 0.35.0

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

@@ -1,7 +1,7 @@
 import { type ReactNode } from 'react';
 import { type AgentControls } from '../context/LiveAgentContext';
 interface LiveAgentBaseProps {
-    agentId: string;
+    agentId?: string | undefined;
     authToken?: string | undefined;
     appKey?: string | undefined;
     userToken?: string | undefined;

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

@@ -1,6 +1,10 @@
 interface MeetingControlsProps {
     onHangUp: () => void;
+    onPause?: () => void;
+    onResume?: () => void;
+    isPaused?: boolean;
+    isPausing?: boolean;
     showScreenShareToggle?: boolean;
 }
-export declare function MeetingControls({ onHangUp, showScreenShareToggle }: MeetingControlsProps): import("react/jsx-runtime").JSX.Element;
+export declare function MeetingControls({ onHangUp, onPause, onResume, isPaused, isPausing, showScreenShareToggle, }: MeetingControlsProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

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

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

@@ -1,8 +1,16 @@
+import type { AgentControls } from '../context/LiveAgentContext';
 interface StartSessionPromptProps {
-    onStartSession: () => void;
+    onStartSession: (opts: {
+        agentId: string;
+        agentControls?: AgentControls;
+    }) => void;
+    agentId: string | null;
+    agentControls?: AgentControls | undefined;
     isStarting?: boolean;
     error?: string;
     label?: string;
+    canResume?: boolean;
+    onResume?: () => void;
 }
-export declare function StartSessionPrompt({ onStartSession, isStarting, error, label, }: StartSessionPromptProps): import("react/jsx-runtime").JSX.Element;
+export declare function StartSessionPrompt({ onStartSession, agentId, agentControls, isStarting, error, label, canResume, onResume, }: StartSessionPromptProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,15 +1,39 @@
+import type { Message } from '../types';
 export type SidebarTab = 'chat' | 'agenda';
 export type CaptureMode = 'screenshare' | 'auto';
 export interface AgentControls {
     highlight?: boolean;
 }
+export interface Module {
+    id: string;
+    name: string;
+    description: string | null;
+    type: string;
+    priority: number;
+    controls: AgentControls;
+}
+export interface ResumableSession {
+    id: string;
+    agentId: string;
+}
 export interface LiveAgentPublicValue {
     isConnected: boolean;
     isStarting: boolean;
+    isDisconnecting: boolean;
+    isPausing: boolean;
     error: string;
     errorCode: number | null;
-    startSession: () => Promise<void>;
+    agentId: string | null;
+    startSession: (opts: {
+        agentId: string;
+        agentControls?: AgentControls;
+    }) => Promise<void>;
+    pauseSession: () => Promise<void>;
+    resumeSession: () => Promise<void>;
     disconnect: () => Promise<void>;
+    isPaused: boolean;
+    resumableSession: ResumableSession | null;
+    resumableSessions: ResumableSession[];
     isPanelOpen: boolean;
     openPanel: () => void;
     closePanel: () => void;
@@ -33,6 +57,13 @@ export interface LiveAgentPublicValue {
     autoFocusChat: boolean;
     captureMode: CaptureMode;
     agentControls?: AgentControls | undefined;
+    hasModuleSelector: boolean;
+    availableModules: Module[];
+    activeModule: Module | null;
+    isLoadingModules: boolean;
+    modulesError: string | null;
+    refetchModules: () => Promise<void>;
+    selectModule: (id: string) => void;
 }
 export interface LiveAgentContextValue extends LiveAgentPublicValue {
     connection: {
@@ -40,5 +71,8 @@ export interface LiveAgentContextValue extends LiveAgentPublicValue {
         token: string;
     } | null;
     shouldConnect: boolean;
+    historyMessages: Message[];
+    phasesSnapshot: unknown[];
+    setPhasesSnapshot: (phases: unknown[]) => void;
 }
 export declare const LiveAgentContext: import("react").Context<LiveAgentContextValue | null>;

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

@@ -0,0 +1,13 @@
+import type { Module } from '../context/LiveAgentContext';
+interface UseAvailableModulesParams {
+    enabled: boolean;
+    bearerToken: string | null;
+}
+interface UseAvailableModulesResult {
+    modules: Module[];
+    isLoading: boolean;
+    error: string | null;
+    refetch: () => Promise<void>;
+}
+export declare function useAvailableModules({ enabled, bearerToken, }: UseAvailableModulesParams): UseAvailableModulesResult;
+export {};

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

@@ -1,2 +1,3 @@
 import { type LiveAgentPublicValue } from '../context/LiveAgentContext';
+export type { AgentControls, CaptureMode, LiveAgentPublicValue, SidebarTab, } from '../context/LiveAgentContext';
 export declare function useLiveAgent(): LiveAgentPublicValue;

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

@@ -1,24 +1,46 @@
 import type { AgentControls, CaptureMode } from '../context/LiveAgentContext';
+import type { Message } from '../types';
 interface LiveKitConnection {
     livekitUrl: string;
     token: string;
 }
 interface UseSessionParams {
-    agentId: string;
     captureMode?: CaptureMode | undefined;
-    agentControls?: AgentControls | undefined;
     authToken?: string | undefined;
     appKey?: string | undefined;
     userToken?: string | undefined;
+    onStart?: () => void;
+    onStartError?: () => void;
+    onDisconnect?: () => void;
+}
+export interface StartSessionOptions {
+    agentId: string;
+    agentControls?: AgentControls;
+}
+export interface ResumableSession {
+    id: string;
+    agentId: string;
 }
-export declare function useSession({ agentId, captureMode, agentControls, authToken, appKey, userToken, }: UseSessionParams): {
+export declare function useSession({ captureMode, authToken, appKey, userToken, onStart, onStartError, onDisconnect, }: UseSessionParams): {
     connection: LiveKitConnection | null;
     shouldConnect: boolean;
     isStarting: boolean;
+    isDisconnecting: boolean;
     error: string;
     errorCode: number | null;
-    startSession: () => Promise<void>;
+    startSession: ({ agentId, agentControls }: StartSessionOptions) => Promise<void>;
+    pauseSession: () => Promise<void>;
+    resumeSession: ({ sessionId: resumeId, agentControls, }: {
+        sessionId: string;
+        agentControls?: AgentControls | undefined;
+    }) => Promise<void>;
     disconnect: () => Promise<void>;
+    isPaused: boolean;
+    isPausing: boolean;
+    resumableSessions: ResumableSession[];
+    historyMessages: Message[];
+    refetchResumable: () => Promise<void>;
     pendingScreenStream: MediaStream | null;
+    bearerToken: string | null;
 };
 export {};

package/dist/types/lib/react-compat.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+/**
+ * React 18 / 19 compatibility layer. The SDK declares `react: "^18 || ^19"`, so
+ * it must run on whichever React the host provides. React 19-only APIs that
+ * have a behaviourally identical 18 equivalent are mapped here; APIs with no 18
+ * equivalent (the Actions hooks, suspending `use(promise)`, Server Components)
+ * must be guarded with an explicit runtime check, never silently shimmed.
+ *
+ * Always consume these helpers instead of importing the raw API from `react` —
+ * the Biome `noRestrictedImports` rule enforces it.
+ */
+type UseContextHook = <T>(context: React.Context<T>) => T;
+/**
+ * Picks the hook used to read a context. React 19's `use(context)` is identical
+ * to `useContext(context)` for context reads, so we prefer the native `use`
+ * when present and fall back to `useContext` on React 18, where `use` is
+ * `undefined`. Pure and exported so the version branching is unit-testable.
+ */
+export declare function selectContextHook(use: UseContextHook | undefined, useContext: UseContextHook): UseContextHook;
+/**
+ * Reads a context value, version-agnostic. React's identity is fixed for the
+ * process, so resolving the hook once at module load keeps the call order
+ * stable across renders.
+ */
+export declare const useContextValue: UseContextHook;
+export {};

package/dist/types/lib-exports.d.ts

@@ -1,4 +1,5 @@
 export * from './components/LiveAgent';
+export type { Module } from './context/LiveAgentContext';
 export * from './hooks/useAgentVoiceState';
 export * from './hooks/useElapsedSeconds';
 export * from './hooks/useIsLocalSpeaking';

package/package.json

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