@utilia-os/sdk-js 1.0.0 → 1.2.0

package/dist/index.d.mts

@@ -43,10 +43,22 @@ declare class UtiliaClient {
      * Ejecuta una funcion con reintentos y backoff exponencial
      */
     private executeWithRetry;
+    /**
+     * Genera un ID simple como fallback cuando crypto.randomUUID no esta disponible
+     */
+    private generateSimpleId;
     /**
      * Helper para esperar un tiempo
      */
     private sleep;
+    /**
+     * Construye una URL completa para conexiones SSE con la API key como query param.
+     * Util para EventSource que no soporta headers personalizados.
+     *
+     * @param path - Ruta relativa de la API (ej: /external/v1/tickets/ai-suggest/123/stream)
+     * @returns URL completa con apiKey como parametro de consulta
+     */
+    buildSseUrl(path: string): string;
     /**
      * Realiza una peticion GET
      */
@@ -310,6 +322,13 @@ interface TicketMessage {
     attachments: TicketAttachment[];
     createdAt: string;
 }
+/**
+ * Datos del usuario que reporto el ticket
+ */
+interface TicketReporter {
+    name: string;
+    email?: string;
+}
 /**
  * Detalle completo de un ticket
  */
@@ -327,6 +346,10 @@ interface TicketDetail {
     messages: TicketMessage[];
     /** Archivos adjuntos del ticket original */
     attachments: TicketAttachment[];
+    /** Contexto capturado al crear el ticket */
+    context?: TicketContext | null;
+    /** Datos del usuario que reporto el ticket */
+    reporter?: TicketReporter | null;
 }
 /**
  * Respuesta al crear un mensaje
@@ -580,7 +603,19 @@ interface AiSuggestInput {
         description?: string;
         category?: string;
         priority?: string;
+        /** URL actual donde se reporta el problema */
+        currentUrl?: string;
+        /** User agent del navegador */
+        userAgent?: string;
+        /** Version de la aplicacion */
+        appVersion?: string;
     };
+    /** Imagenes adjuntas para analisis con vision (base64, max 5) */
+    images?: Array<{
+        base64: string;
+        filename: string;
+        mimeType: string;
+    }>;
 }
 /**
  * Sugerencias generadas por IA
@@ -609,6 +644,8 @@ interface AiJobStatus {
         transcription?: string;
         /** Sugerencias generadas */
         suggestions?: AiSuggestions;
+        /** ID del evento de analytics para tracking de aceptacion/rechazo */
+        analyticsEventId?: string;
     };
     /** Mensaje de error (si status es 'failed') */
     error?: string;
@@ -616,6 +653,29 @@ interface AiJobStatus {
 /**
  * Opciones para el metodo getSuggestions con polling
  */
+/**
+ * Acciones del usuario sobre sugerencias de IA
+ */
+type AiUserAction = 'ACCEPTED_ALL' | 'ACCEPTED_PARTIAL' | 'REJECTED' | 'MODIFIED' | 'IGNORED';
+/**
+ * Entrada para reportar la accion del usuario sobre sugerencias de IA
+ */
+interface TrackAiActionInput {
+    /** ID del evento de analytics retornado en el resultado de sugerencias */
+    eventId: string;
+    /** Accion tomada por el usuario */
+    userAction: AiUserAction;
+    /** Campos que el usuario acepto */
+    fieldsAccepted?: string[];
+    /** Campos que el usuario modifico */
+    fieldsModified?: string[];
+    /** Campos que el usuario rechazo */
+    fieldsRejected?: string[];
+    /** Tiempo en milisegundos desde que se mostraron las sugerencias hasta la decision */
+    timeToDecisionMs?: number;
+    /** Origen de la accion */
+    source?: 'SDK_EXTERNAL' | 'WIDGET';
+}
 interface GetSuggestionsOptions {
     /** Intervalo de polling en ms (default: 1000) */
     pollInterval?: number;
@@ -624,6 +684,65 @@ interface GetSuggestionsOptions {
     /** Callback para reportar progreso */
     onProgress?: (progress: number) => void;
 }
+/**
+ * Evento SSE recibido durante el streaming de un job
+ */
+interface SseEvent {
+    /** Tipo de evento */
+    event: 'progress' | 'completed' | 'failed' | 'heartbeat';
+    /** Progreso actual (0-100) */
+    progress?: number;
+    /** Estado descriptivo */
+    status?: string;
+    /** Resultado del job (disponible en evento 'completed') */
+    result?: AiJobStatus['result'];
+    /** Mensaje de error (disponible en evento 'failed') */
+    error?: string;
+}
+/**
+ * Opciones para el metodo streamSuggestions
+ */
+interface StreamSuggestionsOptions {
+    /** Callback para reportar progreso (0-100) */
+    onProgress?: (progress: number) => void;
+    /** Callback para errores no fatales */
+    onError?: (error: Error) => void;
+    /** Timeout en ms (default: 120000) */
+    timeout?: number;
+}
+/**
+ * Handle retornado por streamSuggestions para controlar la conexion SSE
+ */
+interface StreamSuggestionsHandle {
+    /** Promesa que resuelve con el resultado cuando el job completa */
+    result: Promise<AiJobStatus['result']>;
+    /** Funcion para abortar la conexion SSE */
+    abort: () => void;
+}
+/**
+ * Estado del job de transcripcion asincrona
+ */
+interface TranscriptionJobStatus {
+    /** Estado actual del job */
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    /** Progreso del job (0-100) */
+    progress?: number;
+    /** Texto transcrito (disponible cuando status es 'completed') */
+    transcription?: string;
+    /** Mensaje de error (si status es 'failed') */
+    error?: string;
+}
+/**
+ * Opciones para el metodo streamTranscription
+ */
+interface StreamTranscriptionOptions {
+    /** Callback para reportar progreso (0-100) */
+    onProgress?: (progress: number) => void;
+    /** Callback para errores no fatales */
+    onError?: (error: Error) => void;
+    /** Timeout en ms (default: 120000) */
+    timeout?: number;
+}
 declare class AiService {
     private readonly client;
     private readonly basePath;
@@ -720,6 +839,148 @@ declare class AiService {
      * ```
      */
     getSuggestions(data: AiSuggestInput, options?: GetSuggestionsOptions): Promise<AiJobStatus['result']>;
+    /**
+     * Reporta la accion del usuario sobre sugerencias de IA.
+     * Permite trackear si el usuario acepto, rechazo o modifico las sugerencias.
+     *
+     * @param data - Datos de la accion del usuario
+     * @returns Confirmacion de que la accion fue registrada
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.ai.getSuggestions({
+     *   userId: 'user-123',
+     *   text: 'No puedo iniciar sesion',
+     * });
+     *
+     * // El usuario revisa las sugerencias y acepta todas
+     * await sdk.ai.trackAiAction({
+     *   eventId: result?.analyticsEventId!,
+     *   userAction: 'ACCEPTED_ALL',
+     *   fieldsAccepted: ['title', 'description', 'category', 'priority'],
+     *   timeToDecisionMs: 3500,
+     * });
+     * ```
+     */
+    trackAiAction(data: TrackAiActionInput): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Solicita sugerencias de IA y recibe el resultado via SSE (Server-Sent Events).
+     * Alternativa al polling que ofrece actualizaciones en tiempo real.
+     *
+     * Requiere un entorno con EventSource nativo (navegador).
+     * Para Node.js se necesita un polyfill como 'eventsource'.
+     *
+     * @param data - Datos para generar sugerencias
+     * @param options - Opciones de streaming
+     * @returns Handle con promesa de resultado y funcion de aborto
+     *
+     * @example
+     * ```typescript
+     * const handle = await sdk.ai.streamSuggestions(
+     *   { userId: 'user-123', text: 'No puedo iniciar sesion' },
+     *   { onProgress: (p) => console.log(`Progreso: ${p}%`) },
+     * );
+     *
+     * // Esperar resultado
+     * const result = await handle.result;
+     * console.log(result?.suggestions);
+     *
+     * // O abortar si el usuario cancela
+     * handle.abort();
+     * ```
+     */
+    streamSuggestions(data: AiSuggestInput, options?: StreamSuggestionsOptions): Promise<StreamSuggestionsHandle>;
+    /**
+     * Solicita una transcripcion de audio de forma asincrona.
+     * Retorna un jobId para consultar el estado o usar con streamTranscription.
+     *
+     * @param audioBase64 - Audio codificado en base64
+     * @param audioFilename - Nombre del archivo con extension
+     * @returns ID del job para consultar estado
+     *
+     * @example
+     * ```typescript
+     * const { jobId } = await sdk.ai.requestTranscription(
+     *   audioBase64,
+     *   'recording.webm',
+     * );
+     * ```
+     */
+    requestTranscription(audioBase64: string, audioFilename: string): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Obtiene el estado de un job de transcripcion asincrona.
+     *
+     * @param jobId - ID del job obtenido de requestTranscription
+     * @returns Estado actual del job de transcripcion
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.ai.getTranscriptionStatus(jobId);
+     *
+     * if (status.status === 'completed') {
+     *   console.log(status.transcription);
+     * }
+     * ```
+     */
+    getTranscriptionStatus(jobId: string): Promise<TranscriptionJobStatus>;
+    /**
+     * Solicita una transcripcion de audio y recibe el resultado via SSE.
+     * Alternativa al polling para transcripciones asincronas.
+     *
+     * Requiere un entorno con EventSource nativo (navegador).
+     * Para Node.js se necesita un polyfill como 'eventsource'.
+     *
+     * @param audioBase64 - Audio codificado en base64
+     * @param audioFilename - Nombre del archivo con extension
+     * @param options - Opciones de streaming
+     * @returns Promesa que resuelve con el texto transcrito
+     *
+     * @example
+     * ```typescript
+     * const { transcription } = await sdk.ai.streamTranscription(
+     *   audioBase64,
+     *   'recording.webm',
+     *   { onProgress: (p) => console.log(`Progreso: ${p}%`) },
+     * );
+     * console.log(transcription);
+     * ```
+     */
+    streamTranscription(audioBase64: string, audioFilename: string, options?: StreamTranscriptionOptions): Promise<{
+        transcription: string;
+    }>;
+    /**
+     * Reporta un error del cliente al servidor para monitoreo.
+     * Este metodo nunca lanza excepciones; los errores de reporte se ignoran silenciosamente.
+     *
+     * @param params - Datos del error a reportar
+     *
+     * @example
+     * ```typescript
+     * await sdk.ai.reportError({
+     *   message: 'No se pudo cargar el widget',
+     *   code: 'WIDGET_LOAD_ERROR',
+     *   component: 'widget',
+     *   url: window.location.href,
+     *   userAgent: navigator.userAgent,
+     * });
+     * ```
+     */
+    reportError(params: {
+        message: string;
+        stack?: string;
+        code?: string;
+        component?: string;
+        context?: string;
+        endpoint?: string;
+        method?: string;
+        requestId?: string;
+        url?: string;
+        userAgent?: string;
+    }): Promise<void>;
     /**
      * Helper para esperar un tiempo
      */
@@ -754,7 +1015,14 @@ declare class UtiliaSDKError extends Error {
     readonly code: ErrorCode;
     /** Timestamp de cuando ocurrio el error */
     readonly timestamp: Date;
-    constructor(code: ErrorCode, message: string);
+    /** ID de la peticion que genero el error */
+    readonly requestId?: string;
+    /** Codigo de estado HTTP de la respuesta */
+    readonly statusCode?: number;
+    constructor(code: ErrorCode, message: string, options?: {
+        requestId?: string;
+        statusCode?: number;
+    });
     /**
      * Serializa el error a un objeto JSON
      */
@@ -763,6 +1031,8 @@ declare class UtiliaSDKError extends Error {
         code: ErrorCode;
         message: string;
         timestamp: string;
+        requestId: string | undefined;
+        statusCode: number | undefined;
     };
     /**
      * Verifica si el error es de tipo rate limit
@@ -869,4 +1139,4 @@ declare class UtiliaSDK {
     constructor(config: UtiliaSDKConfig);
 }
 
-export { type AddMessageInput, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type CreateTicketInput, type CreateTicketUser, type CreatedMessage, type CreatedTicket, ErrorCode, type ExternalUser, type FileQuota, type GetSuggestionsOptions, type IdentifyUserInput, type MessageAuthor, type PaginatedResponse, type PaginationMeta, type RequestConfig, SDK_LIMITS, type TicketAttachment, type TicketCategory, type TicketContext, type TicketDetail, type TicketFilters, type TicketListItem, type TicketMessage, type TicketPriority, type TicketStatus, type UnreadCount, type UploadFileOptions, type UploadedFile, UtiliaSDK, type UtiliaSDKConfig, UtiliaSDKError };
+export { type AddMessageInput, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type AiUserAction, type CreateTicketInput, type CreateTicketUser, type CreatedMessage, type CreatedTicket, ErrorCode, type ExternalUser, type FileQuota, type GetSuggestionsOptions, type IdentifyUserInput, type MessageAuthor, type PaginatedResponse, type PaginationMeta, type RequestConfig, SDK_LIMITS, type SseEvent, type StreamSuggestionsHandle, type StreamSuggestionsOptions, type StreamTranscriptionOptions, type TicketAttachment, type TicketCategory, type TicketContext, type TicketDetail, type TicketFilters, type TicketListItem, type TicketMessage, type TicketPriority, type TicketReporter, type TicketStatus, type TrackAiActionInput, type TranscriptionJobStatus, type UnreadCount, type UploadFileOptions, type UploadedFile, UtiliaSDK, type UtiliaSDKConfig, UtiliaSDKError };

package/dist/index.d.ts

@@ -43,10 +43,22 @@ declare class UtiliaClient {
      * Ejecuta una funcion con reintentos y backoff exponencial
      */
     private executeWithRetry;
+    /**
+     * Genera un ID simple como fallback cuando crypto.randomUUID no esta disponible
+     */
+    private generateSimpleId;
     /**
      * Helper para esperar un tiempo
      */
     private sleep;
+    /**
+     * Construye una URL completa para conexiones SSE con la API key como query param.
+     * Util para EventSource que no soporta headers personalizados.
+     *
+     * @param path - Ruta relativa de la API (ej: /external/v1/tickets/ai-suggest/123/stream)
+     * @returns URL completa con apiKey como parametro de consulta
+     */
+    buildSseUrl(path: string): string;
     /**
      * Realiza una peticion GET
      */
@@ -310,6 +322,13 @@ interface TicketMessage {
     attachments: TicketAttachment[];
     createdAt: string;
 }
+/**
+ * Datos del usuario que reporto el ticket
+ */
+interface TicketReporter {
+    name: string;
+    email?: string;
+}
 /**
  * Detalle completo de un ticket
  */
@@ -327,6 +346,10 @@ interface TicketDetail {
     messages: TicketMessage[];
     /** Archivos adjuntos del ticket original */
     attachments: TicketAttachment[];
+    /** Contexto capturado al crear el ticket */
+    context?: TicketContext | null;
+    /** Datos del usuario que reporto el ticket */
+    reporter?: TicketReporter | null;
 }
 /**
  * Respuesta al crear un mensaje
@@ -580,7 +603,19 @@ interface AiSuggestInput {
         description?: string;
         category?: string;
         priority?: string;
+        /** URL actual donde se reporta el problema */
+        currentUrl?: string;
+        /** User agent del navegador */
+        userAgent?: string;
+        /** Version de la aplicacion */
+        appVersion?: string;
     };
+    /** Imagenes adjuntas para analisis con vision (base64, max 5) */
+    images?: Array<{
+        base64: string;
+        filename: string;
+        mimeType: string;
+    }>;
 }
 /**
  * Sugerencias generadas por IA
@@ -609,6 +644,8 @@ interface AiJobStatus {
         transcription?: string;
         /** Sugerencias generadas */
         suggestions?: AiSuggestions;
+        /** ID del evento de analytics para tracking de aceptacion/rechazo */
+        analyticsEventId?: string;
     };
     /** Mensaje de error (si status es 'failed') */
     error?: string;
@@ -616,6 +653,29 @@ interface AiJobStatus {
 /**
  * Opciones para el metodo getSuggestions con polling
  */
+/**
+ * Acciones del usuario sobre sugerencias de IA
+ */
+type AiUserAction = 'ACCEPTED_ALL' | 'ACCEPTED_PARTIAL' | 'REJECTED' | 'MODIFIED' | 'IGNORED';
+/**
+ * Entrada para reportar la accion del usuario sobre sugerencias de IA
+ */
+interface TrackAiActionInput {
+    /** ID del evento de analytics retornado en el resultado de sugerencias */
+    eventId: string;
+    /** Accion tomada por el usuario */
+    userAction: AiUserAction;
+    /** Campos que el usuario acepto */
+    fieldsAccepted?: string[];
+    /** Campos que el usuario modifico */
+    fieldsModified?: string[];
+    /** Campos que el usuario rechazo */
+    fieldsRejected?: string[];
+    /** Tiempo en milisegundos desde que se mostraron las sugerencias hasta la decision */
+    timeToDecisionMs?: number;
+    /** Origen de la accion */
+    source?: 'SDK_EXTERNAL' | 'WIDGET';
+}
 interface GetSuggestionsOptions {
     /** Intervalo de polling en ms (default: 1000) */
     pollInterval?: number;
@@ -624,6 +684,65 @@ interface GetSuggestionsOptions {
     /** Callback para reportar progreso */
     onProgress?: (progress: number) => void;
 }
+/**
+ * Evento SSE recibido durante el streaming de un job
+ */
+interface SseEvent {
+    /** Tipo de evento */
+    event: 'progress' | 'completed' | 'failed' | 'heartbeat';
+    /** Progreso actual (0-100) */
+    progress?: number;
+    /** Estado descriptivo */
+    status?: string;
+    /** Resultado del job (disponible en evento 'completed') */
+    result?: AiJobStatus['result'];
+    /** Mensaje de error (disponible en evento 'failed') */
+    error?: string;
+}
+/**
+ * Opciones para el metodo streamSuggestions
+ */
+interface StreamSuggestionsOptions {
+    /** Callback para reportar progreso (0-100) */
+    onProgress?: (progress: number) => void;
+    /** Callback para errores no fatales */
+    onError?: (error: Error) => void;
+    /** Timeout en ms (default: 120000) */
+    timeout?: number;
+}
+/**
+ * Handle retornado por streamSuggestions para controlar la conexion SSE
+ */
+interface StreamSuggestionsHandle {
+    /** Promesa que resuelve con el resultado cuando el job completa */
+    result: Promise<AiJobStatus['result']>;
+    /** Funcion para abortar la conexion SSE */
+    abort: () => void;
+}
+/**
+ * Estado del job de transcripcion asincrona
+ */
+interface TranscriptionJobStatus {
+    /** Estado actual del job */
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    /** Progreso del job (0-100) */
+    progress?: number;
+    /** Texto transcrito (disponible cuando status es 'completed') */
+    transcription?: string;
+    /** Mensaje de error (si status es 'failed') */
+    error?: string;
+}
+/**
+ * Opciones para el metodo streamTranscription
+ */
+interface StreamTranscriptionOptions {
+    /** Callback para reportar progreso (0-100) */
+    onProgress?: (progress: number) => void;
+    /** Callback para errores no fatales */
+    onError?: (error: Error) => void;
+    /** Timeout en ms (default: 120000) */
+    timeout?: number;
+}
 declare class AiService {
     private readonly client;
     private readonly basePath;
@@ -720,6 +839,148 @@ declare class AiService {
      * ```
      */
     getSuggestions(data: AiSuggestInput, options?: GetSuggestionsOptions): Promise<AiJobStatus['result']>;
+    /**
+     * Reporta la accion del usuario sobre sugerencias de IA.
+     * Permite trackear si el usuario acepto, rechazo o modifico las sugerencias.
+     *
+     * @param data - Datos de la accion del usuario
+     * @returns Confirmacion de que la accion fue registrada
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.ai.getSuggestions({
+     *   userId: 'user-123',
+     *   text: 'No puedo iniciar sesion',
+     * });
+     *
+     * // El usuario revisa las sugerencias y acepta todas
+     * await sdk.ai.trackAiAction({
+     *   eventId: result?.analyticsEventId!,
+     *   userAction: 'ACCEPTED_ALL',
+     *   fieldsAccepted: ['title', 'description', 'category', 'priority'],
+     *   timeToDecisionMs: 3500,
+     * });
+     * ```
+     */
+    trackAiAction(data: TrackAiActionInput): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Solicita sugerencias de IA y recibe el resultado via SSE (Server-Sent Events).
+     * Alternativa al polling que ofrece actualizaciones en tiempo real.
+     *
+     * Requiere un entorno con EventSource nativo (navegador).
+     * Para Node.js se necesita un polyfill como 'eventsource'.
+     *
+     * @param data - Datos para generar sugerencias
+     * @param options - Opciones de streaming
+     * @returns Handle con promesa de resultado y funcion de aborto
+     *
+     * @example
+     * ```typescript
+     * const handle = await sdk.ai.streamSuggestions(
+     *   { userId: 'user-123', text: 'No puedo iniciar sesion' },
+     *   { onProgress: (p) => console.log(`Progreso: ${p}%`) },
+     * );
+     *
+     * // Esperar resultado
+     * const result = await handle.result;
+     * console.log(result?.suggestions);
+     *
+     * // O abortar si el usuario cancela
+     * handle.abort();
+     * ```
+     */
+    streamSuggestions(data: AiSuggestInput, options?: StreamSuggestionsOptions): Promise<StreamSuggestionsHandle>;
+    /**
+     * Solicita una transcripcion de audio de forma asincrona.
+     * Retorna un jobId para consultar el estado o usar con streamTranscription.
+     *
+     * @param audioBase64 - Audio codificado en base64
+     * @param audioFilename - Nombre del archivo con extension
+     * @returns ID del job para consultar estado
+     *
+     * @example
+     * ```typescript
+     * const { jobId } = await sdk.ai.requestTranscription(
+     *   audioBase64,
+     *   'recording.webm',
+     * );
+     * ```
+     */
+    requestTranscription(audioBase64: string, audioFilename: string): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Obtiene el estado de un job de transcripcion asincrona.
+     *
+     * @param jobId - ID del job obtenido de requestTranscription
+     * @returns Estado actual del job de transcripcion
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.ai.getTranscriptionStatus(jobId);
+     *
+     * if (status.status === 'completed') {
+     *   console.log(status.transcription);
+     * }
+     * ```
+     */
+    getTranscriptionStatus(jobId: string): Promise<TranscriptionJobStatus>;
+    /**
+     * Solicita una transcripcion de audio y recibe el resultado via SSE.
+     * Alternativa al polling para transcripciones asincronas.
+     *
+     * Requiere un entorno con EventSource nativo (navegador).
+     * Para Node.js se necesita un polyfill como 'eventsource'.
+     *
+     * @param audioBase64 - Audio codificado en base64
+     * @param audioFilename - Nombre del archivo con extension
+     * @param options - Opciones de streaming
+     * @returns Promesa que resuelve con el texto transcrito
+     *
+     * @example
+     * ```typescript
+     * const { transcription } = await sdk.ai.streamTranscription(
+     *   audioBase64,
+     *   'recording.webm',
+     *   { onProgress: (p) => console.log(`Progreso: ${p}%`) },
+     * );
+     * console.log(transcription);
+     * ```
+     */
+    streamTranscription(audioBase64: string, audioFilename: string, options?: StreamTranscriptionOptions): Promise<{
+        transcription: string;
+    }>;
+    /**
+     * Reporta un error del cliente al servidor para monitoreo.
+     * Este metodo nunca lanza excepciones; los errores de reporte se ignoran silenciosamente.
+     *
+     * @param params - Datos del error a reportar
+     *
+     * @example
+     * ```typescript
+     * await sdk.ai.reportError({
+     *   message: 'No se pudo cargar el widget',
+     *   code: 'WIDGET_LOAD_ERROR',
+     *   component: 'widget',
+     *   url: window.location.href,
+     *   userAgent: navigator.userAgent,
+     * });
+     * ```
+     */
+    reportError(params: {
+        message: string;
+        stack?: string;
+        code?: string;
+        component?: string;
+        context?: string;
+        endpoint?: string;
+        method?: string;
+        requestId?: string;
+        url?: string;
+        userAgent?: string;
+    }): Promise<void>;
     /**
      * Helper para esperar un tiempo
      */
@@ -754,7 +1015,14 @@ declare class UtiliaSDKError extends Error {
     readonly code: ErrorCode;
     /** Timestamp de cuando ocurrio el error */
     readonly timestamp: Date;
-    constructor(code: ErrorCode, message: string);
+    /** ID de la peticion que genero el error */
+    readonly requestId?: string;
+    /** Codigo de estado HTTP de la respuesta */
+    readonly statusCode?: number;
+    constructor(code: ErrorCode, message: string, options?: {
+        requestId?: string;
+        statusCode?: number;
+    });
     /**
      * Serializa el error a un objeto JSON
      */
@@ -763,6 +1031,8 @@ declare class UtiliaSDKError extends Error {
         code: ErrorCode;
         message: string;
         timestamp: string;
+        requestId: string | undefined;
+        statusCode: number | undefined;
     };
     /**
      * Verifica si el error es de tipo rate limit
@@ -869,4 +1139,4 @@ declare class UtiliaSDK {
     constructor(config: UtiliaSDKConfig);
 }
 
-export { type AddMessageInput, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type CreateTicketInput, type CreateTicketUser, type CreatedMessage, type CreatedTicket, ErrorCode, type ExternalUser, type FileQuota, type GetSuggestionsOptions, type IdentifyUserInput, type MessageAuthor, type PaginatedResponse, type PaginationMeta, type RequestConfig, SDK_LIMITS, type TicketAttachment, type TicketCategory, type TicketContext, type TicketDetail, type TicketFilters, type TicketListItem, type TicketMessage, type TicketPriority, type TicketStatus, type UnreadCount, type UploadFileOptions, type UploadedFile, UtiliaSDK, type UtiliaSDKConfig, UtiliaSDKError };
+export { type AddMessageInput, type AiJobStatus, type AiSuggestInput, type AiSuggestions, type AiUserAction, type CreateTicketInput, type CreateTicketUser, type CreatedMessage, type CreatedTicket, ErrorCode, type ExternalUser, type FileQuota, type GetSuggestionsOptions, type IdentifyUserInput, type MessageAuthor, type PaginatedResponse, type PaginationMeta, type RequestConfig, SDK_LIMITS, type SseEvent, type StreamSuggestionsHandle, type StreamSuggestionsOptions, type StreamTranscriptionOptions, type TicketAttachment, type TicketCategory, type TicketContext, type TicketDetail, type TicketFilters, type TicketListItem, type TicketMessage, type TicketPriority, type TicketReporter, type TicketStatus, type TrackAiActionInput, type TranscriptionJobStatus, type UnreadCount, type UploadFileOptions, type UploadedFile, UtiliaSDK, type UtiliaSDKConfig, UtiliaSDKError };