@app-studio/web 0.9.15 → 0.9.17

package/dist/components/adk/AgentTrace/AgentTrace.d.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+import { AgentTraceProps } from './AgentTrace/AgentTrace.props';
+/**
+ * AgentTrace Component
+ *
+ * A comprehensive trace visualization component for ADK agents.
+ * Displays execution traces, events, and performance metrics in an interactive format.
+ *
+ * @example
+ * ```tsx
+ * <AgentTrace
+ *   sessionId="session-123"
+ *   userId="user123"
+ *   appName="my-agent"
+ *   onEventSelect={(event) => console.log('Event selected:', event)}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With custom visualization and filtering
+ * <AgentTrace
+ *   sessionId="session-123"
+ *   userId="user123"
+ *   appName="my-agent"
+ *   showTimeline={true}
+ *   showMetrics={true}
+ *   enableFiltering={true}
+ *   enableExport={true}
+ *   visualizationType="tree"
+ *   autoRefresh={true}
+ *   refreshInterval={5000}
+ *   views={{
+ *     container: { backgroundColor: 'color.gray.50' },
+ *     timeline: { height: '200px' },
+ *     eventList: { maxHeight: '400px' }
+ *   }}
+ * />
+ * ```
+ */
+declare const AgentTrace: React.FC<AgentTraceProps>;
+export default AgentTrace;
+export { AgentTrace };
+export type { AgentTraceProps };

package/dist/components/adk/AgentTrace/examples/default.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+/**
+ * Default AgentTrace Example
+ *
+ * Demonstrates basic usage of the AgentTrace component
+ */
+export declare const DefaultDemo: () => React.JSX.Element;
+/**
+ * AgentTrace with Mock Data Example
+ *
+ * Shows the component with sample trace data
+ */
+export declare const MockDataDemo: () => React.JSX.Element;
+/**
+ * Compact AgentTrace Example
+ *
+ * Shows the component in compact mode
+ */
+export declare const CompactDemo: () => React.JSX.Element;
+/**
+ * Real-time AgentTrace Example
+ *
+ * Demonstrates real-time updates and auto-refresh
+ */
+export declare const RealTimeDemo: () => React.JSX.Element;
+/**
+ * Customized AgentTrace Example
+ *
+ * Shows advanced customization options
+ */
+export declare const CustomizedDemo: () => React.JSX.Element;

package/dist/components/index.d.ts

@@ -56,6 +56,10 @@ export * from './Tree/Tree';
 export * from './Flow/Flow';
 export * from './ChatInput/ChatInput';
 export * from './Background/Background';
+export { default as AgentChat } from './adk/AgentChat/AgentChat';
+export { default as AgentSession } from './adk/AgentSession/AgentSession';
+export { default as AgentTrace } from './adk/AgentTrace/AgentTrace';
+export { default as AgentEval } from './adk/AgentEval/AgentEval';
 export * from './Accordion/Accordion/Accordion.props';
 export * from './Alert/Alert/Alert.props';
 export * from './AspectRatio/AspectRatio/AspectRatio.props';
@@ -107,3 +111,7 @@ export * from './Tree/Tree/Tree.props';
 export * from './Flow/Flow/Flow.props';
 export * from './ChatInput/ChatInput/ChatInput.props';
 export * from './Background/Background/Background.props';
+export type { AgentRunRequest, MessagePart, AgentMessage, MessageAttachment, AgentChatViews, AgentChatEventHandlers, AgentChatProps, } from './adk/AgentChat/AgentChat/AgentChat.props';
+export type { AgentSession as AgentSessionType, AgentEvent, SessionSummary, AgentSessionViews, AgentSessionEventHandlers, SessionFilters, SessionSortOptions, AgentSessionProps, SessionAction, SessionStatus, SessionExportData, SessionImportOptions, } from './adk/AgentSession/AgentSession/AgentSession.props';
+export * from './adk/AgentTrace/AgentTrace/AgentTrace.props';
+export * from './adk/AgentEval/AgentEval/AgentEval.props';

package/dist/configs/AppConfig.d.ts

@@ -0,0 +1,4 @@
+export declare const APP_NAME = "App Studio Component";
+export declare const DEV: boolean;
+export declare const API_URL: string;
+export declare const DEFAULT_LANGUAGE = "en";

package/dist/hooks/useAdk.d.ts

@@ -0,0 +1,42 @@
+/// <reference types="react" />
+import type { CreateSessionParams, AgentRunRequest, SessionResponse } from '../services/api';
+/**
+ * Custom hook for ADK operations
+ * Integrates with the existing ADK service and auth store
+ */
+export declare const useAdk: () => {
+    isAuthenticated: any;
+    user: any;
+    currentSessionId: string | null;
+    sessions: SessionResponse[];
+    createSession: (params: CreateSessionParams) => void;
+    loadSessions: (appName?: string | undefined) => void;
+    loadSession: (sessionId: string) => void;
+    deleteSession: (sessionId: string) => void;
+    runAgent: (request: AgentRunRequest) => void;
+    runAgentStreaming: (request: AgentRunRequest) => void;
+    checkHealth: () => void;
+    getServiceInfo: () => void;
+    setCurrentSessionId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    isCreatingSession: boolean;
+    isLoadingSessions: boolean;
+    isLoadingSession: boolean;
+    isDeletingSession: boolean;
+    isRunningAgent: boolean;
+    isRunningAgentStreaming: boolean;
+    isCheckingHealth: boolean;
+    isLoadingServiceInfo: boolean;
+    sessionData: any;
+    agentResponse: any;
+    agentStreamingResponse: any;
+    healthData: any;
+    serviceInfo: any;
+    createSessionError: Error | undefined;
+    listSessionsError: Error | undefined;
+    getSessionError: Error | undefined;
+    deleteSessionError: Error | undefined;
+    runAgentError: Error | undefined;
+    runAgentStreamingError: Error | undefined;
+    healthError: Error | undefined;
+    serviceInfoError: Error | undefined;
+};

package/dist/pages/adk/CompleteAgentApp.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+/**
+ * Complete Agent Application Example
+ *
+ * This example demonstrates how to integrate all ADK components
+ * into a complete agent application with proper service management,
+ * state coordination, and user experience.
+ */
+interface CompleteAgentAppProps {
+    appName: string;
+    userId: string;
+    apiBaseUrl: string;
+}
+/**
+ * Complete Agent Application with Service Provider
+ */
+declare const CompleteAgentApp: React.FC<CompleteAgentAppProps>;
+/**
+ * Usage Example
+ */
+export declare const CompleteAgentAppExample: () => React.JSX.Element;
+/**
+ * Development Example with Local API
+ */
+export declare const DevelopmentExample: () => React.JSX.Element;
+/**
+ * Production Example with Environment Variables
+ */
+export declare const ProductionExample: () => React.JSX.Element;
+export default CompleteAgentApp;

package/dist/pages/adk/adkComponents.page.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * ADK Components Demo Page
+ *
+ * Comprehensive showcase of all ADK-compatible React components
+ */
+declare const ADKComponentsPage: React.FC;
+export default ADKComponentsPage;

package/dist/pages/adk/adkIntegration.page.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+/**
+ * ADK Integration Page with Provider
+ */
+declare const AdkIntegrationPage: React.FC;
+export default AdkIntegrationPage;

package/dist/pages/adk/agentChat.page.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * AgentChat Component Demo Page
+ *
+ * Showcases the AgentChat component with various configurations and use cases
+ */
+declare const AgentChatPage: React.FC;
+export default AgentChatPage;

package/dist/pages/adk/providers/AdkProvider.d.ts

@@ -0,0 +1,83 @@
+import React, { ReactNode } from 'react';
+/**
+ * ADK Context Type
+ */
+interface AdkContextType {
+    isAuthenticated: boolean;
+    user: any;
+    currentSessionId: string | null;
+    sessions: any[];
+    createSession: (params: any) => void;
+    loadSessions: (appName?: string) => void;
+    loadSession: (sessionId: string) => void;
+    deleteSession: (sessionId: string) => void;
+    runAgent: (request: any) => void;
+    runAgentStreaming: (request: any) => void;
+    checkHealth: () => void;
+    getServiceInfo: () => void;
+    setCurrentSessionId: (sessionId: string | null) => void;
+    isCreatingSession: boolean;
+    isLoadingSessions: boolean;
+    isLoadingSession: boolean;
+    isDeletingSession: boolean;
+    isRunningAgent: boolean;
+    isRunningAgentStreaming: boolean;
+    isCheckingHealth: boolean;
+    isLoadingServiceInfo: boolean;
+    sessionData: any;
+    agentResponse: any;
+    agentStreamingResponse: any;
+    healthData: any;
+    serviceInfo: any;
+    createSessionError: any;
+    listSessionsError: any;
+    getSessionError: any;
+    deleteSessionError: any;
+    runAgentError: any;
+    runAgentStreamingError: any;
+    healthError: any;
+    serviceInfoError: any;
+    isConnected: boolean;
+    error: string | null;
+}
+/**
+ * ADK Provider Props
+ */
+interface AdkProviderProps {
+    children: ReactNode;
+}
+/**
+ * ADK Provider Component
+ *
+ * Provides ADK functionality using the existing API services and auth store
+ */
+export declare const AdkProvider: React.FC<AdkProviderProps>;
+/**
+ * Hook to use ADK context
+ */
+export declare const useAdkContext: () => AdkContextType;
+/**
+ * Legacy hook for compatibility with existing components
+ */
+export declare const useAgentService: () => {
+    isConnected: boolean;
+    error: string | null;
+    service: {
+        createSession: (params: any) => void;
+        listSessions: (appName?: string | undefined) => void;
+        getSession: (sessionId: string) => void;
+        deleteSession: (sessionId: string) => void;
+        runAgent: (request: any) => void;
+        runAgentStreaming: (request: any) => void;
+        healthCheck: () => void;
+        getServiceInfo: () => void;
+    };
+    currentSessionId: string | null;
+    sessions: any[];
+    isCreatingSession: boolean;
+    isLoadingSessions: boolean;
+    isRunningAgent: boolean;
+    agentResponse: any;
+    sessionData: any;
+};
+export {};

package/dist/pages/adk/providers/index.d.ts

@@ -0,0 +1 @@
+export { AdkProvider, useAdkContext, useAgentService } from './AdkProvider';

package/dist/pages/adk/services/AgentService.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Agent Service Integration
+ *
+ * Enhanced service layer for backend communication with ADK agents.
+ * Provides a unified interface for all agent-related operations.
+ */
+import { AgentSession, AgentMessage, AgentRunRequest } from '../../../components/adk/AgentChat/AgentChat/AgentChat.props';
+import { TraceEvent, TraceSpan, TraceMetrics } from '../../../components/adk/AgentTrace/AgentTrace/AgentTrace.props';
+import { EvaluationRun, EvaluationTestCase, EvaluationMetric } from '../../../components/adk/AgentEval/AgentEval/AgentEval.props';
+/**
+ * Configuration for the Agent Service
+ */
+export interface AgentServiceConfig {
+    baseUrl: string;
+    timeout?: number;
+    retryCount?: number;
+    enableLogging?: boolean;
+    apiKey?: string;
+    headers?: Record<string, string>;
+}
+/**
+ * Event listener types for real-time updates
+ */
+export declare type AgentEventListener = (event: any) => void;
+/**
+ * Enhanced Agent Service Class
+ *
+ * Provides a comprehensive interface for interacting with ADK agents,
+ * including session management, messaging, tracing, and evaluation.
+ */
+export declare class AgentService {
+    private config;
+    private eventListeners;
+    private activeConnections;
+    constructor(config: AgentServiceConfig);
+    /**
+     * Session Management
+     */
+    /**
+     * Create a new agent session
+     */
+    createSession(appName: string, userId: string, metadata?: any): Promise<AgentSession>;
+    /**
+     * Get session details
+     */
+    getSession(sessionId: string): Promise<AgentSession>;
+    /**
+     * List sessions for a user
+     */
+    listSessions(userId: string, appName?: string, limit?: number): Promise<AgentSession[]>;
+    /**
+     * Delete a session
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Messaging
+     */
+    /**
+     * Send a message to an agent (non-streaming)
+     */
+    sendMessage(request: AgentRunRequest): Promise<any>;
+    /**
+     * Send a message to an agent with streaming response
+     */
+    sendMessageStreaming(request: AgentRunRequest, onMessage: (message: AgentMessage) => void, onError?: (error: Error) => void, onComplete?: () => void): Promise<void>;
+    /**
+     * Cancel a streaming request
+     */
+    cancelStreaming(sessionId: string): void;
+    /**
+     * Tracing
+     */
+    /**
+     * Get trace events for a session
+     */
+    getTraceEvents(sessionId: string, filters?: {
+        eventTypes?: string[];
+        startTime?: number;
+        endTime?: number;
+        limit?: number;
+    }): Promise<TraceEvent[]>;
+    /**
+     * Get trace spans for a session
+     */
+    getTraceSpans(sessionId: string): Promise<TraceSpan[]>;
+    /**
+     * Get trace metrics for a session
+     */
+    getTraceMetrics(sessionId: string): Promise<TraceMetrics>;
+    /**
+     * Subscribe to real-time trace updates
+     */
+    subscribeToTraceUpdates(sessionId: string, onUpdate: (update: any) => void, onError?: (error: Error) => void): void;
+    /**
+     * Evaluation
+     */
+    /**
+     * Create a new evaluation
+     */
+    createEvaluation(name: string, appName: string, userId: string, testCases: EvaluationTestCase[], metrics: EvaluationMetric[], config?: any): Promise<EvaluationRun>;
+    /**
+     * Start an evaluation
+     */
+    startEvaluation(evaluationId: string): Promise<void>;
+    /**
+     * Cancel an evaluation
+     */
+    cancelEvaluation(evaluationId: string): Promise<void>;
+    /**
+     * Get evaluation details
+     */
+    getEvaluation(evaluationId: string): Promise<EvaluationRun>;
+    /**
+     * List evaluations
+     */
+    listEvaluations(appName: string, userId: string, limit?: number): Promise<EvaluationRun[]>;
+    /**
+     * Delete an evaluation
+     */
+    deleteEvaluation(evaluationId: string): Promise<void>;
+    /**
+     * Subscribe to evaluation updates
+     */
+    subscribeToEvaluationUpdates(userId: string, onUpdate: (update: any) => void, onError?: (error: Error) => void): void;
+    /**
+     * Utility Methods
+     */
+    /**
+     * Make an HTTP request with retry logic
+     */
+    private request;
+    /**
+     * Get default headers for requests
+     */
+    private getHeaders;
+    /**
+     * Event Management
+     */
+    /**
+     * Add event listener
+     */
+    addEventListener(event: string, listener: AgentEventListener): void;
+    /**
+     * Remove event listener
+     */
+    removeEventListener(event: string, listener: AgentEventListener): void;
+    /**
+     * Emit event to listeners
+     */
+    private emit;
+    /**
+     * Cleanup all connections and listeners
+     */
+    cleanup(): void;
+}
+/**
+ * Default Agent Service Instance
+ *
+ * Pre-configured service instance for common use cases
+ */
+export declare const createAgentService: (config: AgentServiceConfig) => AgentService;
+/**
+ * Agent Service Hook for React Components
+ *
+ * Provides a convenient way to use the Agent Service in React components
+ */
+export declare const useAgentServiceHook: (config: AgentServiceConfig) => AgentService;

package/dist/pages/adk/services/AgentServiceProvider.d.ts

@@ -0,0 +1,83 @@
+import React from 'react';
+import { AgentService, AgentServiceConfig } from './AgentService';
+/**
+ * Agent Service Context
+ *
+ * Provides the Agent Service instance throughout the React component tree
+ */
+interface AgentServiceContextType {
+    service: AgentService | null;
+    isConnected: boolean;
+    error: string | null;
+    reconnect: () => void;
+}
+/**
+ * Agent Service Provider Props
+ */
+export interface AgentServiceProviderProps {
+    config: AgentServiceConfig;
+    children: React.ReactNode;
+    onConnectionChange?: (isConnected: boolean) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Agent Service Provider Component
+ *
+ * Provides the Agent Service instance to all child components
+ * and manages connection state and error handling.
+ */
+export declare const AgentServiceProvider: React.FC<AgentServiceProviderProps>;
+/**
+ * Hook to use the Agent Service
+ *
+ * Provides access to the Agent Service instance and connection state
+ */
+export declare const useAgentService: () => AgentServiceContextType;
+/**
+ * Hook for Agent Service Operations
+ *
+ * Provides common operations with built-in error handling and loading states
+ */
+export declare const useAgentOperations: () => {
+    isLoading: boolean;
+    error: string | null;
+    setError: React.Dispatch<React.SetStateAction<string | null>>;
+    executeOperation: <T>(operation: () => Promise<T>, onSuccess?: ((result: T) => void) | undefined, onError?: ((error: Error) => void) | undefined) => Promise<T | null>;
+    sessions: {
+        create: (appName: string, userId: string, metadata?: any) => Promise<import("../../../components/adk/AgentChat/AgentChat/AgentChat.props").AgentSession | null>;
+        get: (sessionId: string) => Promise<import("../../../components/adk/AgentChat/AgentChat/AgentChat.props").AgentSession | null>;
+        list: (userId: string, appName?: string | undefined, limit?: number | undefined) => Promise<import("../../../components/adk/AgentChat/AgentChat/AgentChat.props").AgentSession[] | null>;
+        delete: (sessionId: string) => Promise<void | null>;
+    };
+    messages: {
+        send: (request: any) => Promise<any>;
+        sendStreaming: (request: any, onMessage: (message: any) => void, onComplete?: (() => void) | undefined) => Promise<void | null>;
+        cancelStreaming: (sessionId: string) => void;
+    };
+    trace: {
+        getEvents: (sessionId: string, filters?: any) => Promise<import("../../../components").TraceEvent[] | null>;
+        getSpans: (sessionId: string) => Promise<import("../../../components").TraceSpan[] | null>;
+        getMetrics: (sessionId: string) => Promise<import("../../../components").TraceMetrics | null>;
+        subscribe: (sessionId: string, onUpdate: (update: any) => void) => void;
+    };
+    evaluations: {
+        create: (name: string, appName: string, userId: string, testCases: any[], metrics: any[], config?: any) => Promise<import("../../../components").EvaluationRun | null>;
+        start: (evaluationId: string) => Promise<void | null>;
+        cancel: (evaluationId: string) => Promise<void | null>;
+        get: (evaluationId: string) => Promise<import("../../../components").EvaluationRun | null>;
+        list: (appName: string, userId: string, limit?: number | undefined) => Promise<import("../../../components").EvaluationRun[] | null>;
+        delete: (evaluationId: string) => Promise<void | null>;
+        subscribe: (userId: string, onUpdate: (update: any) => void) => void;
+    };
+};
+/**
+ * Connection Status Component
+ *
+ * Displays the current connection status of the Agent Service
+ */
+export interface ConnectionStatusProps {
+    showDetails?: boolean;
+    onReconnect?: () => void;
+}
+export declare const ConnectionStatus: React.FC<ConnectionStatusProps>;
+export {};