guideai-app 0.5.0 → 0.5.1-2

package/dist/utils/localStorageHelper.d.ts

@@ -9,6 +9,8 @@ declare const STORAGE_KEYS: {
     readonly HAS_INTERACTED: "guideAI_hasInteracted";
     readonly IS_MUTED: "guideAI_isMuted";
     readonly LOGGER_ENABLED: "guideAI_loggerEnabled";
+    readonly AUDIO_CONFIG: "guideAI_audioConfig";
+    readonly CONFIG_ENABLED: "guideAI_configEnabled";
 };
 /**
  * Check if localStorage is available
@@ -51,6 +53,22 @@ export declare const getLoggerEnabled: () => boolean;
  * Set logger enabled flag
  */
 export declare const setLoggerEnabled: (value: boolean) => void;
+/**
+ * Get stored audio configuration
+ */
+export declare const getAudioConfig: () => import("../types/audioConfig.types").StoredAudioConfig | null;
+/**
+ * Save audio configuration
+ */
+export declare const setAudioConfig: (value: import("../types/audioConfig.types").StoredAudioConfig | null) => void;
+/**
+ * Get configuration button enabled flag
+ */
+export declare const getConfigEnabled: () => boolean;
+/**
+ * Set configuration button enabled flag and dispatch event for live updates
+ */
+export declare const setConfigEnabled: (value: boolean) => void;
 /**
  * Export storage keys for reference (read-only)
  */

package/dist/utils/logger.d.ts

@@ -1,4 +1,4 @@
-type Component = 'GuideAI' | 'API' | 'TranscriptBox' | 'Onboarding' | 'VisualContext' | 'MessageStorage' | 'DataChannel' | 'ConversationManager' | 'LocalStorageHelper' | 'WebRTCConnection';
+type Component = 'GuideAI' | 'API' | 'TranscriptBox' | 'Onboarding' | 'VisualContext' | 'MessageStorage' | 'DataChannel' | 'ConversationManager' | 'LocalStorageHelper' | 'WebRTCConnection' | 'ToolCall';
 declare class Logger {
     private static formatMessage;
     private static checkLoggingEnabled;
@@ -10,22 +10,22 @@ declare class Logger {
     static init(): void;
     /**
      * Enable logging from console, or for a specific component.
-     * Usage: GuideAILogger.enable() or GuideAILogger.enable('API')
+     * Usage: GuideAI.logger.enable() or GuideAI.logger.enable('API')
      */
     static enable(component?: Component): void;
     /**
      * Disable logging from console, or for a specific component.
-     * Usage: GuideAILogger.disable() or GuideAILogger.disable('API')
+     * Usage: GuideAI.logger.disable() or GuideAI.logger.disable('API')
      */
     static disable(component?: Component): void;
     /**
      * Enable or disable logging for a specific component
-     * Usage: GuideAILogger.setComponentEnabled('API', true)
+     * Usage: GuideAI.logger.setComponentEnabled('API', true)
      */
     static setComponentEnabled(component: Component, enabled: boolean): void;
     /**
      * Get current logging status
-     * Usage: GuideAILogger.getStatus()
+     * Usage: GuideAI.logger.getStatus()
      */
     static getStatus(): {
         manualEnabled: boolean;
@@ -33,17 +33,17 @@ declare class Logger {
     };
     /**
      * Disable logging for all components
-     * Usage: GuideAILogger.disableAllComponents()
+     * Usage: GuideAI.logger.disableAllComponents()
      */
     static disableAllComponents(): void;
     /**
      * Enable logging for all components
-     * Usage: GuideAILogger.enableAllComponents()
+     * Usage: GuideAI.logger.enableAllComponents()
      */
     static enableAllComponents(): void;
     /**
      * Display help information listing all available Logger functions
-     * Usage: GuideAILogger.help()
+     * Usage: GuideAI.logger.help()
      */
     static help(): void;
     /**

package/dist/utils/navigateTo.d.ts

@@ -0,0 +1,2 @@
+import { ToolInput } from './elementInteractions';
+export declare const navigateTo: (out: ToolInput) => Promise<boolean>;

package/dist/utils/reactHooks.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Safely extract React hooks from the React instance passed as props.
+ * Used when the package receives React from the host (e.g. Chrome extension, Next.js).
+ */
+import type { UseCallbackHook } from '../types/GuideAI.types';
+export interface ReactHooks {
+    useState: typeof import('react').useState;
+    useEffect: typeof import('react').useEffect;
+    useRef: typeof import('react').useRef;
+    useMemo: typeof import('react').useMemo;
+    useCallback: UseCallbackHook;
+}
+export declare function getReactHooks(React: typeof import('react')): ReactHooks;

package/dist/utils/toolRegistry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Tool execution registry.
+ * Maps function names to handlers for built-in types and api_call.
+ * No eval - only registered handlers or HTTP fetch for api_call.
+ */
+export declare const BUILT_IN_TOOL_NAMES: string[];
+export interface ToolWithConfig {
+    toolConfig: {
+        type: string;
+        name: string;
+        description?: string;
+        parameters?: object;
+    };
+    functionConfig: {
+        handlerType: string;
+        url?: string;
+    };
+}
+/**
+ * Get built-in tools as ToolWithConfig[] for only the given names.
+ */
+export declare function getBuiltInToolsAsToolWithConfigForNames(names: string[]): ToolWithConfig[];
+/**
+ * Execute a tool by name using server-provided tools config and callbacks.
+ * Returns the result for function_call_output.
+ */
+export declare function executeTool(name: string, args: string, toolsConfig: ToolWithConfig[], propHandlers?: Record<string, (args: Record<string, unknown>) => Promise<unknown>>): Promise<unknown>;

package/dist/utils/webrtcConnection.d.ts

@@ -16,11 +16,16 @@ export interface WebRTCConnectionConfig {
     audioStream: MediaStream | null;
     /** Initialize endpoint URL (e.g. /api/initialize) - returns { id, answerSdp } */
     initializeEndpoint: string;
-    /** Payload for initialize (organizationKey, user, conversationId */
+    /** Payload for initialize (organizationKey, user, conversationId, propTools) */
     initializePayload: {
         organizationKey: string;
         user?: string;
         conversationId?: string | null;
+        propTools?: {
+            name: string;
+            description: string;
+            parameters: object;
+        }[];
     };
     /** Called when session data is received (id) */
     onSessionData?: (data: InitializeSessionData) => void;

package/dist/visualContext/debug-overlay.d.ts

@@ -6,5 +6,5 @@ interface DebugOverlayProps {
     onToggleGallery?: () => void;
     showGallery?: boolean;
 }
-export declare const DebugOverlay: ({ React, frames, latencyMs, onToggleGallery, showGallery }: DebugOverlayProps) => import("react").DetailedReactHTMLElement<import("react").HTMLAttributes<HTMLElement>, HTMLElement>;
+export declare const DebugOverlay: ({ React, frames, latencyMs, onToggleGallery, showGallery, }: DebugOverlayProps) => import("react").DetailedReactHTMLElement<import("react").HTMLAttributes<HTMLElement>, HTMLElement>;
 export {};

package/dist/visualContext/index.d.ts

@@ -8,5 +8,5 @@ export { VisualContextScheduler } from './VisualContextScheduler';
 export { DebugOverlay } from './debug-overlay';
 export { useVisualContext } from './useVisualContext';
 export { createDefaultScreenshotProvider, getDefaultScreenshotProvider } from './defaultProvider';
-export type { ScreenshotResponse, ScreenshotFrame, ScreenshotDetail, ScreenshotOptions, ScreenshotProvider, VisualContextConfig } from './types';
+export type { ScreenshotResponse, ScreenshotFrame, ScreenshotDetail, ScreenshotOptions, ScreenshotProvider, VisualContextConfig, } from './types';
 export { MAX_IMAGE_MESSAGE_BYTES } from './types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "guideai-app",
-  "version": "0.5.0",
+  "version": "0.5.1-2",
   "description": "AI-powered guide component for React applications",
   "main": "dist/GuideAI.js",
   "types": "dist/index.d.ts",
@@ -22,6 +22,7 @@
     "dev": "npm run watch",
     "serve:local": "npm run build:dev && npx serve -l 8080 dist",
     "prepare": "npm run build",
+    "lint": "eslint src --ext .ts,.tsx",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage"
@@ -44,10 +45,15 @@
     "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
     "@types/jest": "^30.0.0",
     "@types/react": "^18.2.0",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "eslint": "^10.0.1",
+    "eslint-config-prettier": "^10.1.8",
     "javascript-obfuscator": "^4.1.0",
     "jest": "^30.2.0",
     "jest-circus": "^30.2.0",
@@ -62,4 +68,4 @@
     "webpack": "^5.98.0",
     "webpack-cli": "^6.0.1"
   }
-}
+}