site-operator 0.2.1 → 0.2.6

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { ActivitySnapshotEvent } from '@ag-ui/client';
 import { CSSResult } from 'lit';
 import { LitElement } from 'lit';
 import { Message } from '@ag-ui/client';
@@ -6,11 +7,46 @@ import { ReactiveController } from 'lit';
 import { ReactiveControllerHost } from 'lit';
 import { TemplateResult } from 'lit-html';
 
+/**
+ * Union type representing the possible actions triggered by a ClickTarget.
+ */
+export declare type Action = NavigationAction | {
+    /** Navigates to a different page using route ID */
+    type: "navigate";
+    /** ID of the target route */
+    toRouteId?: string;
+    /** Fallback path if route ID is not provided */
+    toPath?: string;
+} | {
+    /** Opens a modal, drawer, or panel */
+    type: "open";
+    /** Identifier for the target UI component to open */
+    targetId: string;
+} | {
+    /** Triggers a custom event or callback in the host application */
+    type: "trigger";
+    /** Custom string to identify the trigger in the application logic */
+    trigger: string;
+} | {
+    /** Clicks on a specific element by ID */
+    type: "click";
+    /** Identifier for the target UI element to click or interact with */
+    targetId: string;
+    /** Optional reason for the click */
+    reason?: string;
+} | {
+    /** Generic action type for extension */
+    type: string;
+    [k: string]: unknown;
+};
+
 export declare class AgentChat extends LitElement {
     static styles: CSSResult;
     private _chatController;
     get controller(): ChatController;
     protected firstUpdated(): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
     backendUrl: string;
     appName: string;
     conversationUrl: string;
@@ -45,11 +81,27 @@ export declare class AgentChat extends LitElement {
     setAppLocation(location: AppState["location"]): void;
     setAppUI(ui: AppState["ui"]): void;
     setAppFocus(focus: AppState["focus"]): void;
+    /**
+     * Establece los prompts sugeridos que se mostrarán al usuario.
+     * @param prompts Lista de prompts sugeridos.
+     */
+    setSuggestedPrompts(prompts: SuggestedPrompt[]): void;
     private _toggleHistory;
     private _handleSelectThread;
     private _toggleInspector;
     render(): TemplateResult<1>;
     private _handleContextUpdate;
+    private _handleA2UIAction;
+    /**
+     * Maneja acciones de tipo 'decision' (Aprobar/Denegar).
+     * Si es 'approve', abre una URL y espera a que se cierre la pestaña antes de notificar.
+     * Si es 'deny', notifica inmediatamente.
+     */
+    private _handleAuthDecision;
+    /**
+     * Handler genérico para cualquier acción que contenga una URL.
+     */
+    private _handleGenericUrlAction;
     private _handleStateUpdate;
 }
 
@@ -240,11 +292,20 @@ export declare class ChatController implements ReactiveController {
      * Retorna el listado de conversaciones recientes.
      */
     get conversations(): ConversationSummary[];
+    /**
+     * Retorna los prompts sugeridos.
+     */
+    get suggestedPrompts(): SuggestedPrompt[];
+    /**
+     * Indica si se deben mostrar los prompts.
+     */
+    get showPrompts(): boolean;
     /**
      * Envía un mensaje a través del servicio.
      * @param content Contenido del mensaje.
+     * @param role Rol del mensaje (opcional, por defecto 'user').
      */
-    sendMessage(content: string): Promise<void>;
+    sendMessage(content: string, role?: Parameters<typeof chatService.sendMessage>[1]): Promise<void>;
     /**
      * Inicia un nuevo hilo de charla.
      */
@@ -267,6 +328,15 @@ export declare class ChatController implements ReactiveController {
     setAppLocation(location: AppState["location"]): void;
     setAppUI(ui: AppState["ui"]): void;
     setAppFocus(focus: AppState["focus"]): void;
+    /**
+     * Establece los prompts sugeridos.
+     * @param prompts Lista de prompts.
+     */
+    setSuggestedPrompts(prompts: SuggestedPrompt[]): void;
+    /**
+     * Oculta los prompts sugeridos.
+     */
+    hideSuggestedPrompts(): void;
     /**
      * Refresca el listado de conversaciones desde el servidor.
      */
@@ -285,22 +355,31 @@ export declare interface ChatPortalAPI {
     /**
      * Registers the host application's static context.
      * @param context The application definition (routes, site info, etc.)
+     * @param handlers Optional handlers for executing plans (e.g. navigation)
      */
-    registerPortal(context: AppContext): void;
+    registerPortal(context: AppContext, handlers?: {
+        executePlan?: (plan: Action) => Promise<ExecutePlanResult>;
+    }): void;
     /**
      * Executes a proposed plan of actions (navigation, clicks).
      * @param plan The plan object generated by the agent.
      */
-    executePlan(plan: unknown): Promise<ExecutePlanResult>;
+    executePlan(plan: Action): Promise<ExecutePlanResult>;
 }
 
 export declare class ChatPortalService extends EventTarget implements ChatPortalAPI {
     private _context;
+    private _visibleTargetIds;
     private static _instance;
+    private _executePlanHandler;
     private constructor();
     static getInstance(): ChatPortalService;
-    registerPortal(context: AppContext): void;
-    executePlan(plan: unknown): Promise<ExecutePlanResult>;
+    registerPortal(context: AppContext, handlers?: {
+        executePlan?: (plan: Action) => Promise<ExecutePlanResult>;
+    }): void;
+    setVisibleTargets(ids: string[]): void;
+    executePlan(plan: Action): Promise<ExecutePlanResult>;
+    private _waitForTarget;
     get context(): AppContext | null;
     /**
      * @deprecated Use context instead
@@ -310,39 +389,137 @@ export declare class ChatPortalService extends EventTarget implements ChatPortal
 
 export declare const chatPortalService: ChatPortalService;
 
+declare class ChatService extends EventTarget {
+    private agent?;
+    private _conversations;
+    private _appContext;
+    private _appState;
+    private _suggestedPrompts;
+    private _showPrompts;
+    get isRunning(): boolean;
+    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;
+    })[];
+    get suggestedPrompts(): SuggestedPrompt[];
+    get showPrompts(): boolean;
+    private subscriber;
+    constructor();
+    /**
+     * 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;
+        conversationUrl: string;
+        appName: string;
+        inspector?: boolean;
+    }): Promise<void>;
+    /**
+     * Carga una conversación existente por su ID.
+     * @param id ID de la conversación a cargar.
+     */
+    loadConversation(id: string): Promise<void>;
+    get conversations(): ConversationSummary[];
+    /**
+     * Establece el contexto de la aplicación para el agente.
+     * Este contexto se envía en cada mensaje.
+     * @param context El contexto de la aplicación (AgentState o AppContext)
+     */
+    setAppContext(context: AppContext): void;
+    /**
+     * Establece el estado dinámico de la aplicación.
+     * @param state El estado completo de la aplicación.
+     */
+    setAppState(state: AppState): void;
+    /**
+     * Actualiza el estado dinámico de la aplicación de forma parcial.
+     * @param partial El estado parcial de la aplicación.
+     */
+    updateAppState(partial: Partial<AppState>): void;
+    setAppLocation(location: AppState["location"]): void;
+    setAppUI(ui: AppState["ui"]): void;
+    setAppFocus(focus: AppState["focus"]): void;
+    /**
+     * Establece los prompts sugeridos que se mostrarán al usuario.
+     * @param prompts Lista de prompts sugeridos. El caption tiene un máximo de 50 caracteres.
+     */
+    setSuggestedPrompts(prompts: SuggestedPrompt[]): void;
+    /**
+     * Oculta la lista de prompts sugeridos.
+     */
+    hideSuggestedPrompts(): void;
+    sendMessage(content: string, role?: "developer" | "user" | "assistant" | "system" | "tool" | "activity"): Promise<void>;
+    _ensureConversation(): Promise<void>;
+    addPlaceholderMessage(): void;
+    prepareMessageForStreaming(newId: string): void;
+    appendMessageContent(id: string, content: string): void;
+    setMessages(messages: Message[]): void;
+    addA2UIMessage(event: ActivitySnapshotEvent): void;
+    startNewThread(): Promise<void>;
+    /**
+     * Refresca la lista de conversaciones desde el servicio de conversaciones.
+     */
+    refreshConversations(): Promise<void>;
+    private notify;
+}
+
+declare const chatService: ChatService;
+
 export declare interface ChatThread {
     id: string;
     messages: UIMessage[];
     isRunning: boolean;
     title?: string;
+    suggestedPrompts?: SuggestedPrompt[];
 }
 
-/**
- * Union type representing the possible actions triggered by a ClickTarget.
- */
-export declare type ClickAction = {
-    /** Navigates to a different page */
-    type: "navigate";
-    /** ID of the target route */
-    toRouteId?: string;
-    /** Fallback path if route ID is not provided */
-    toPath?: string;
-} | {
-    /** Opens a modal, drawer, or panel */
-    type: "open";
-    /** Identifier for the target UI component to open */
-    targetId: string;
-} | {
-    /** Triggers a custom event or callback in the host application */
-    type: "trigger";
-    /** Custom string to identify the trigger in the application logic */
-    trigger: string;
-} | {
-    /** Generic action type for extension */
-    type: string;
-    [k: string]: unknown;
-};
-
 /**
  * Defines a clickable or interactive element in the UI.
  */
@@ -375,7 +552,7 @@ export declare interface ClickTarget {
         href?: string;
     };
     /** The action that should be performed when this target is activated */
-    action: ClickAction;
+    action: Action;
 }
 
 /**
@@ -497,12 +674,28 @@ export { Message }
  */
 export declare function mount(element: HTMLElement, options?: any): AgentChat;
 
+/**
+ * Specific action for navigation, often initiated by an agent.
+ */
+export declare interface NavigationAction {
+    type: "navigate";
+    /** The path to navigate to */
+    toPath: string;
+    /** The reason for the navigation */
+    reason?: string;
+}
+
 /**
  * Registers the web component.
  * (It's already registered by import, but this can be a safe-guard re-export or initialization function)
  */
 export declare function register(): void;
 
+export declare interface SuggestedPrompt {
+    caption: string;
+    message: string;
+}
+
 export declare type UIMessage = Message & {
     isThinking?: boolean;
     createdAt?: number;