site-operator 0.1.13 → 0.2.1

package/README.md

@@ -10,6 +10,14 @@ This package is framework-agnostic and built with Lit.
 npm install site-operator
 ```
 
+## Development
+
+```bash
+npm run dev
+npm run build
+npm run preview
+```
+
 ## Chat Portal API
 
 The Chat Portal API is the bridge that allows the AI Agent to understand and interact with your application. It consists of two main parts:
@@ -112,4 +120,3 @@ chatService.setAppState(currentState);
 </script>
 ```
 
-

package/dist/index.d.ts

@@ -2,11 +2,15 @@ import { CSSResult } from 'lit';
 import { LitElement } from 'lit';
 import { Message } from '@ag-ui/client';
 import { Message as Message_2 } from '@ag-ui/core';
+import { ReactiveController } from 'lit';
+import { ReactiveControllerHost } from 'lit';
 import { TemplateResult } from 'lit-html';
 
 export declare class AgentChat extends LitElement {
     static styles: CSSResult;
     private _chatController;
+    get controller(): ChatController;
+    protected firstUpdated(): void;
     backendUrl: string;
     appName: string;
     conversationUrl: string;
@@ -45,6 +49,8 @@ export declare class AgentChat extends LitElement {
     private _handleSelectThread;
     private _toggleInspector;
     render(): TemplateResult<1>;
+    private _handleContextUpdate;
+    private _handleStateUpdate;
 }
 
 /**
@@ -145,6 +151,133 @@ export declare interface AppState {
     };
 }
 
+/**
+ * Controlador reactivo para gestionar la conexión con el ChatService.
+ * Se encarga de suscribirse a los cambios de estado y limpiar los recursos
+ * cuando el componente host se desconecta.
+ */
+export declare class ChatController implements ReactiveController {
+    private _host;
+    constructor(host: ReactiveControllerHost);
+    /**
+     * Inicializa el servicio de chat con las URLs necesarias y el nombre de la aplicación.
+     * @param config Configuración de inicialización.
+     */
+    initialize(config: {
+        backendUrl: string;
+        appName: string;
+        conversationUrl: string;
+        inspector?: boolean;
+    }): Promise<void>;
+    /**
+     * Se ejecuta cuando el componente se conecta al DOM.
+     * Registra el listener para actualizaciones de estado.
+     */
+    hostConnected(): void;
+    /**
+     * Se ejecuta cuando el componente se desconecta del DOM.
+     * Elimina el listener para evitar fugas de memoria.
+     */
+    hostDisconnected(): void;
+    /**
+     * Retorna el estado actual del hilo de chat.
+     */
+    get isRunning(): boolean;
+    /**
+     * Retorna el listado de mensajes.
+     */
+    get messages(): ({
+        id: string;
+        role: "developer";
+        content: string;
+        name?: string | undefined;
+    } | {
+        id: string;
+        role: "system";
+        content: string;
+        name?: string | undefined;
+    } | {
+        id: string;
+        role: "assistant";
+        name?: string | undefined;
+        content?: string | undefined;
+        toolCalls?: {
+            function: {
+                name: string;
+                arguments: string;
+            };
+            type: "function";
+            id: string;
+        }[] | undefined;
+    } | {
+        id: string;
+        role: "user";
+        content: string | ({
+            type: "text";
+            text: string;
+        } | {
+            type: "binary";
+            mimeType: string;
+            id?: string | undefined;
+            url?: string | undefined;
+            data?: string | undefined;
+            filename?: string | undefined;
+        })[];
+        name?: string | undefined;
+    } | {
+        id: string;
+        role: "tool";
+        content: string;
+        toolCallId: string;
+        error?: string | undefined;
+    } | {
+        id: string;
+        role: "activity";
+        content: Record<string, any>;
+        activityType: string;
+    })[];
+    /**
+     * Retorna el listado de conversaciones recientes.
+     */
+    get conversations(): ConversationSummary[];
+    /**
+     * Envía un mensaje a través del servicio.
+     * @param content Contenido del mensaje.
+     */
+    sendMessage(content: string): Promise<void>;
+    /**
+     * Inicia un nuevo hilo de charla.
+     */
+    startNewThread(): Promise<void>;
+    /**
+     * Carga una conversación existente por su ID.
+     * @param id ID de la conversación a cargar.
+     */
+    loadConversation(id: string): Promise<void>;
+    /**
+     * Establece el contexto de la aplicación.
+     * @param context Objeto AgentState o AppContext con el contexto.
+     */
+    setAppContext(context: AppContext): void;
+    /**
+     * Establece el estado dinámico de la aplicación.
+     * @param state Objeto AppState.
+     */
+    setAppState(state: AppState): void;
+    setAppLocation(location: AppState["location"]): void;
+    setAppUI(ui: AppState["ui"]): void;
+    setAppFocus(focus: AppState["focus"]): void;
+    /**
+     * Refresca el listado de conversaciones desde el servidor.
+     */
+    refreshConversations(): Promise<void>;
+    /**
+     * Manejador interno para cambios de estado.
+     * Llama a requestUpdate() en el host para forzar el renderizado.
+     */
+    private _onStateChange;
+}
+
 /**
  * Core interface for the Chat Portal API.
  */
@@ -161,21 +294,18 @@ export declare interface ChatPortalAPI {
     executePlan(plan: unknown): Promise<ExecutePlanResult>;
 }
 
-export declare class ChatPortalService implements ChatPortalAPI {
+export declare class ChatPortalService extends EventTarget implements ChatPortalAPI {
     private _context;
     private static _instance;
     private constructor();
     static getInstance(): ChatPortalService;
     registerPortal(context: AppContext): void;
-    executePlan(plan: any): Promise<{
-        status: "ok" | "error";
-        details?: any;
-    }>;
+    executePlan(plan: unknown): Promise<ExecutePlanResult>;
     get context(): AppContext | null;
     /**
      * @deprecated Use context instead
      */
-    get specs(): any;
+    get specs(): AppContext | null;
 }
 
 export declare const chatPortalService: ChatPortalService;
@@ -210,7 +340,7 @@ export declare type ClickAction = {
 } | {
     /** Generic action type for extension */
     type: string;
-    [k: string]: any;
+    [k: string]: unknown;
 };
 
 /**
@@ -270,7 +400,7 @@ export declare class ConversationService {
     constructor();
     /**
      * Inicializa la URL base del servicio.
-     * @param apiUrl URL base del API de conversaciones (ej. http://localhost:8003)
+     * @param apiUrl URL base del API de conversaciones
      */
     initialize(apiUrl: string): void;
     /**
@@ -278,12 +408,20 @@ export declare class ConversationService {
      * @returns Promesa con el listado de conversaciones
      */
     getConversations(): Promise<Conversation[]>;
+    /**
+     * Obtiene una conversación por su ID.
+     * @param id ID de la conversación
+     * @returns Promesa con la conversación
+     */
+    getConversation(id: string): Promise<Conversation>;
     /**
      * Crea una nueva conversación.
-     * @param conversation Datos de la conversación a crear.
+     * @param data Datos de la conversación a crear (incluyendo opcionalmente el appContext).
      * @returns Promesa con la conversación creada
      */
-    createConversation(conversation: Partial<Conversation>): Promise<Conversation>;
+    createConversation(data: Partial<Conversation> & {
+        appContext?: AppContext;
+    }): Promise<Conversation>;
     /**
      * Actualiza una conversación existente.
      * @param id ID de la conversación
@@ -312,7 +450,7 @@ export declare interface ExecutePlanResult {
     /** Status of the execution */
     status: "ok" | "error";
     /** Optional details about the execution or error message */
-    details?: any;
+    details?: unknown;
 }
 
 /**
@@ -346,7 +484,7 @@ export declare const fetchInterceptorService: FetchInterceptorService;
 
 export declare interface InspectorEvent {
     event: string;
-    content: any;
+    content: unknown;
     time: string;
 }