mitra-interactions-sdk 1.0.58-beta.1 → 1.0.58-beta.3

package/dist/index.d.mts

@@ -22,8 +22,6 @@ interface LoginResponse {
     baseURL: string;
     /** URL do serviço de integrações (opcional) */
     integrationURL?: string;
-    /** URL do WebSocket do Agent Chat (opcional — vem do sdk-auth quando configurado) */
-    agentWsUrl?: string;
 }
 interface EmailSignupOptions {
     /** URL da página de auth (ex: https://validacao.mitralab.io/sdk-auth/). Opcional se já configurado via configureSdkMitra. */
@@ -521,6 +519,7 @@ interface SetProfilePermissionResponse {
         [key: string]: unknown;
     };
 }
+type AgentType = 'claudecode' | 'codex' | 'opencode-cli' | 'opencode-sdk';
 interface AgentChat {
     id: string;
     name: string;
@@ -541,65 +540,92 @@ interface GetAgentChatsOptions {
     /** Sobrescreve o projectId configurado globalmente. */
     projectId?: number;
 }
-interface GetAgentHistoryOptions {
-    /** ID do chat cuja conversa será carregada. */
-    taskId: string;
-    /** Quantidade máxima de mensagens (default: tudo). */
-    limit?: number;
+interface GetAgentTaskCreateOptions {
+    /** Cria chat novo. taskId é preenchido depois do primeiro send(). */
+    create: true;
+    /** Sobrescreve projectId global. */
+    projectId?: number;
+    /** Tipo do agente. Default: 'claudecode'. */
+    agentType?: AgentType;
+    /** Nome do chat (default: derivado do prompt). */
+    name?: string;
 }
-interface AgentStreamDeltaEvent {
+interface GetAgentTaskOpenOptions {
+    /** Abre chat existente. Detecta automático se stream está ativo. */
     taskId: string;
-    /** Pedaço de texto que chegou. */
+}
+type GetAgentTaskOptions = GetAgentTaskCreateOptions | GetAgentTaskOpenOptions;
+type AgentTaskStatus = 'opening' | 'idle' | 'streaming' | 'cancelled' | 'error' | 'closed';
+interface QueuedItem {
+    id: string;
+    text: string;
+    agentType?: AgentType;
+    seq: number;
+    createdAt: number;
+    status: 'pending' | 'sending';
+    injected?: boolean;
+}
+interface SendOptions {
+    agentType?: AgentType;
+}
+interface AgentDeltaEvent {
     delta: string;
-    /** Tipo do conteúdo: 'text' (resposta do agente) ou 'tool' (atividade de ferramenta). */
     kind: 'text' | 'tool';
 }
-interface AgentStreamToolEvent {
-    taskId: string;
+interface AgentToolEvent {
     tool: string;
     input?: string;
     content?: string;
     timestamp: number;
 }
-interface AgentStreamEndEvent {
-    taskId: string;
-    /** Conteúdo final acumulado (concatenação dos deltas). */
+interface AgentTurnEndEvent {
+    /** Conteúdo final acumulado do turno. */
     content: string;
 }
 interface AgentTaskCreatedEvent {
     task: AgentChat;
 }
 interface AgentErrorEvent {
-    taskId?: string;
     error: string;
 }
-interface SendAgentPromptOptions {
-    /** Texto enviado ao agente. */
-    prompt: string;
-    /** ID do chat existente. Se ausente, cria um chat novo. */
-    taskId?: string;
-    /** Tipo do agente. Default: 'claudecode'. */
-    agentType?: 'claudecode' | 'codex' | 'opencode-cli' | 'opencode-sdk';
-    /** Sobrescreve projectId global. */
-    projectId?: number;
-    /** Nome do chat quando criando novo (default: derivado do prompt). */
-    name?: string;
-    /** Callback chamado a cada chunk de texto. */
-    onDelta?: (event: AgentStreamDeltaEvent) => void;
-    /** Callback chamado quando uma ferramenta é usada. */
-    onTool?: (event: AgentStreamToolEvent) => void;
-    /** Callback chamado quando um novo chat é criado (só dispara se taskId era ausente). */
-    onTaskCreated?: (event: AgentTaskCreatedEvent) => void;
-    /** Callback chamado quando ocorre erro durante o stream. */
-    onError?: (event: AgentErrorEvent) => void;
-    /** Permite cancelar o stream mid-flight. */
-    signal?: AbortSignal;
-}
-interface SendAgentPromptResponse {
-    /** ID do chat (existente ou recém-criado). */
-    taskId: string;
-    /** Texto completo acumulado dos deltas. */
-    content: string;
+interface AgentQueueChangeEvent {
+    queue: ReadonlyArray<QueuedItem>;
+}
+interface AgentStatusChangeEvent {
+    status: AgentTaskStatus;
+    previous: AgentTaskStatus;
+}
+type AgentTaskEventMap = {
+    historyLoaded: AgentMessage[];
+    turnStart: void;
+    delta: AgentDeltaEvent;
+    tool: AgentToolEvent;
+    turnEnd: AgentTurnEndEvent;
+    taskCreated: AgentTaskCreatedEvent;
+    cancelled: void;
+    error: AgentErrorEvent;
+    queueChange: AgentQueueChangeEvent;
+    statusChange: AgentStatusChangeEvent;
+};
+type AgentTaskEventName = keyof AgentTaskEventMap;
+interface AgentTaskSession {
+    readonly taskId: string | null;
+    readonly task: AgentChat | null;
+    readonly isNew: boolean;
+    readonly status: AgentTaskStatus;
+    readonly history: ReadonlyArray<AgentMessage>;
+    readonly content: string;
+    readonly queue: ReadonlyArray<QueuedItem>;
+    loadHistory(options?: {
+        limit?: number;
+    }): Promise<AgentMessage[]>;
+    close(): void;
+    send(prompt: string, options?: SendOptions): void;
+    cancel(): Promise<void>;
+    editQueueItem(itemId: string, newText: string): boolean;
+    removeQueueItem(itemId: string): boolean;
+    clearQueue(): void;
+    on<E extends AgentTaskEventName>(event: E, handler: (payload: AgentTaskEventMap[E]) => void): () => void;
 }
 
 /**
@@ -649,8 +675,7 @@ interface MitraInstance {
     validatePasswordResetCode(options: ValidatePasswordResetCodeOptions): Promise<Record<string, unknown>>;
     resetPassword(options: ResetPasswordOptions): Promise<Record<string, unknown>>;
     getAgentChats(options?: GetAgentChatsOptions): Promise<AgentChat[]>;
-    getAgentHistory(options: GetAgentHistoryOptions): Promise<AgentMessage[]>;
-    sendAgentPrompt(options: SendAgentPromptOptions): Promise<SendAgentPromptResponse>;
+    getAgentTask(options: GetAgentTaskOptions): AgentTaskSession;
     disconnectAgentChat(): void;
     openChat(): void;
     closeChat(): void;
@@ -658,16 +683,14 @@ interface MitraInstance {
 declare function createMitraInstance(initialConfig: Partial<MitraConfig>): MitraInstance;
 
 interface MitraConfig {
-    /** URL base da API (ex: https://api.mitra.com) */
-    baseURL: string;
+    /** URL base da API (ex: https://api.mitra.com). Opcional se houver window.__mitraEnv.apiBaseURL (build-proxy). */
+    baseURL?: string;
     /** Token JWT para autenticação (opcional para Server Functions públicas) */
     token?: string;
     /** URL base do serviço de integrações (ex: https://api0.mitraecp.com:1003) */
     integrationURL?: string;
     /** URL da página de autenticação Mitra (ex: https://coder.mitralab.io/sdk-auth/) */
     authUrl?: string;
-    /** URL do WebSocket do Agent Chat (ex: wss://agent.mitralab.io/sdk-ws ou ws://localhost:3456/sdk-ws) */
-    agentWsUrl?: string;
     /** ID do projeto (usado como fallback nos métodos de login e serviços) */
     projectId?: number;
     /** Callback chamado quando o token é renovado automaticamente (após 401/403). Recebe a nova sessão. */
@@ -675,8 +698,12 @@ interface MitraConfig {
 }
 /**
  * Configura o SDK globalmente e retorna uma instância configurada.
+ *
+ * Em apps publicadas pelo Mitra (window.__mitraEnv presente), nenhum campo
+ * precisa ser passado — todas as URLs vêm da injeção do build-proxy.
+ * Em outros contextos, baseURL ainda é necessário (manual ou via login).
  */
-declare function configureSdkMitra(config: MitraConfig): MitraInstance;
+declare function configureSdkMitra(config?: Partial<MitraConfig>): MitraInstance;
 /**
  * Obtém a configuração atual
  */
@@ -779,24 +806,35 @@ declare function validatePasswordResetCodeMitra(options: ValidatePasswordResetCo
 declare function resetPasswordMitra(options: ResetPasswordOptions): Promise<Record<string, unknown>>;
 
 /**
- * Mitra Interactions SDK - Agent Chat (embedded)
+ * Mitra Interactions SDK — Agent Chat
  *
- * Conecta via WebSocket ao mitra-agent-websocket. Tudo (lista de chats,
- * histórico, envio de prompt + stream) trafega pela mesma conexão.
+ * Hub do WebSocket compartilhado e factories da API pública:
+ *   - getAgentChatsMitra({ projectId? })
+ *   - getAgentTaskMitra({ create | taskId, ... })
  *
- * - Open: lazy — só conecta na primeira chamada.
- * - Auth: JWT do config global passado como query param do handshake.
- *   O backend valida o token e resolve userSpaceID server-side.
- * - Request/Response: cada chamada envia { type, requestId } e aguarda
- *   { type: 'response', requestId, ok, data | error }.
- * - Stream: send_prompt dispara push events (stream_delta, stream_end, ...).
+ * O WS é singleton: todas as sessions usam UMA conexão. O roteamento
+ * de eventos é feito por taskId, despachando pra session correspondente.
+ *
+ * NÃO há `sendAgentPromptMitra` ou `getAgentHistoryMitra` exportados —
+ * essas operações vivem dentro de `AgentTaskSession`.
  */
 
+/**
+ * Lista chats do user para um projeto.
+ */
 declare function getAgentChatsMitra(options?: GetAgentChatsOptions): Promise<AgentChat[]>;
-declare function getAgentHistoryMitra(options: GetAgentHistoryOptions): Promise<AgentMessage[]>;
-declare function sendAgentPromptMitra(options: SendAgentPromptOptions): Promise<SendAgentPromptResponse>;
 /**
- * Fecha o WebSocket do Agent Chat. Útil em testes ou no logout.
+ * Abre um handle de chat (session). Use:
+ *   - `{ create: true }` para iniciar um chat novo
+ *   - `{ taskId: 'X' }` para abrir um chat existente
+ *
+ * A session expõe histórico, streaming, fila, cancel e eventos. Se a
+ * mesma taskId for aberta duas vezes, retorna a MESMA instância (cache).
+ */
+declare function getAgentTaskMitra(options: GetAgentTaskOptions): AgentTaskSession;
+/**
+ * Fecha o WebSocket do Agent Chat. Sessions ativas devem chamar close()
+ * antes — esta função é destinada a teardown global (logout, testes).
  */
 declare function disconnectAgentChatMitra(): void;
 
@@ -955,4 +993,4 @@ declare function setProfileScreensMitra(options: SetProfileScreensOptions): Prom
  */
 declare function setProfileServerFunctionsMitra(options: SetProfileServerFunctionsOptions): Promise<SetProfilePermissionResponse>;
 
-export { type AgentChat, type AgentErrorEvent, type AgentMessage, type AgentStreamDeltaEvent, type AgentStreamEndEvent, type AgentStreamToolEvent, type AgentTaskCreatedEvent, type CallIntegrationOptions, type CallIntegrationResponse, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteProfileOptions, type DeleteProfileResponse, type DeleteRecordOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDataLoaderOptions, type ExecuteDataLoaderResponse, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetAgentChatsOptions, type GetAgentHistoryOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableRef, type ResetPasswordOptions, type RunActionOptions, type RunActionResponse, type SendAgentPromptOptions, type SendAgentPromptResponse, type SendPasswordResetCodeOptions, type SetFileStatusOptions, type SetFileStatusResponse, type SetProfileActionsOptions, type SetProfileDmlTablesOptions, type SetProfilePermissionResponse, type SetProfileScreensOptions, type SetProfileSelectTablesOptions, type SetProfileServerFunctionsOptions, type SetProfileUsersOptions, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateProfileOptions, type UpdateProfileResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, type ValidatePasswordResetCodeOptions, callIntegrationMitra, closeChatMitra, configureSdkMitra, createMitraInstance, createProfileMitra, createRecordMitra, createRecordsBatchMitra, deleteProfileMitra, deleteRecordMitra, disconnectAgentChatMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentChatsMitra, getAgentHistoryMitra, getConfig, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, openChatMitra, patchRecordMitra, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendAgentPromptMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };
+export { type AgentChat, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentQueueChangeEvent, type AgentStatusChangeEvent, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type CallIntegrationOptions, type CallIntegrationResponse, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteProfileOptions, type DeleteProfileResponse, type DeleteRecordOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDataLoaderOptions, type ExecuteDataLoaderResponse, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetAgentChatsOptions, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableRef, type QueuedItem, type ResetPasswordOptions, type RunActionOptions, type RunActionResponse, type SendOptions, type SendPasswordResetCodeOptions, type SetFileStatusOptions, type SetFileStatusResponse, type SetProfileActionsOptions, type SetProfileDmlTablesOptions, type SetProfilePermissionResponse, type SetProfileScreensOptions, type SetProfileSelectTablesOptions, type SetProfileServerFunctionsOptions, type SetProfileUsersOptions, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateProfileOptions, type UpdateProfileResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, type ValidatePasswordResetCodeOptions, callIntegrationMitra, closeChatMitra, configureSdkMitra, createMitraInstance, createProfileMitra, createRecordMitra, createRecordsBatchMitra, deleteProfileMitra, deleteRecordMitra, disconnectAgentChatMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentChatsMitra, getAgentTaskMitra, getConfig, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, openChatMitra, patchRecordMitra, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };

package/dist/index.d.ts

@@ -22,8 +22,6 @@ interface LoginResponse {
     baseURL: string;
     /** URL do serviço de integrações (opcional) */
     integrationURL?: string;
-    /** URL do WebSocket do Agent Chat (opcional — vem do sdk-auth quando configurado) */
-    agentWsUrl?: string;
 }
 interface EmailSignupOptions {
     /** URL da página de auth (ex: https://validacao.mitralab.io/sdk-auth/). Opcional se já configurado via configureSdkMitra. */
@@ -521,6 +519,7 @@ interface SetProfilePermissionResponse {
         [key: string]: unknown;
     };
 }
+type AgentType = 'claudecode' | 'codex' | 'opencode-cli' | 'opencode-sdk';
 interface AgentChat {
     id: string;
     name: string;
@@ -541,65 +540,92 @@ interface GetAgentChatsOptions {
     /** Sobrescreve o projectId configurado globalmente. */
     projectId?: number;
 }
-interface GetAgentHistoryOptions {
-    /** ID do chat cuja conversa será carregada. */
-    taskId: string;
-    /** Quantidade máxima de mensagens (default: tudo). */
-    limit?: number;
+interface GetAgentTaskCreateOptions {
+    /** Cria chat novo. taskId é preenchido depois do primeiro send(). */
+    create: true;
+    /** Sobrescreve projectId global. */
+    projectId?: number;
+    /** Tipo do agente. Default: 'claudecode'. */
+    agentType?: AgentType;
+    /** Nome do chat (default: derivado do prompt). */
+    name?: string;
 }
-interface AgentStreamDeltaEvent {
+interface GetAgentTaskOpenOptions {
+    /** Abre chat existente. Detecta automático se stream está ativo. */
     taskId: string;
-    /** Pedaço de texto que chegou. */
+}
+type GetAgentTaskOptions = GetAgentTaskCreateOptions | GetAgentTaskOpenOptions;
+type AgentTaskStatus = 'opening' | 'idle' | 'streaming' | 'cancelled' | 'error' | 'closed';
+interface QueuedItem {
+    id: string;
+    text: string;
+    agentType?: AgentType;
+    seq: number;
+    createdAt: number;
+    status: 'pending' | 'sending';
+    injected?: boolean;
+}
+interface SendOptions {
+    agentType?: AgentType;
+}
+interface AgentDeltaEvent {
     delta: string;
-    /** Tipo do conteúdo: 'text' (resposta do agente) ou 'tool' (atividade de ferramenta). */
     kind: 'text' | 'tool';
 }
-interface AgentStreamToolEvent {
-    taskId: string;
+interface AgentToolEvent {
     tool: string;
     input?: string;
     content?: string;
     timestamp: number;
 }
-interface AgentStreamEndEvent {
-    taskId: string;
-    /** Conteúdo final acumulado (concatenação dos deltas). */
+interface AgentTurnEndEvent {
+    /** Conteúdo final acumulado do turno. */
     content: string;
 }
 interface AgentTaskCreatedEvent {
     task: AgentChat;
 }
 interface AgentErrorEvent {
-    taskId?: string;
     error: string;
 }
-interface SendAgentPromptOptions {
-    /** Texto enviado ao agente. */
-    prompt: string;
-    /** ID do chat existente. Se ausente, cria um chat novo. */
-    taskId?: string;
-    /** Tipo do agente. Default: 'claudecode'. */
-    agentType?: 'claudecode' | 'codex' | 'opencode-cli' | 'opencode-sdk';
-    /** Sobrescreve projectId global. */
-    projectId?: number;
-    /** Nome do chat quando criando novo (default: derivado do prompt). */
-    name?: string;
-    /** Callback chamado a cada chunk de texto. */
-    onDelta?: (event: AgentStreamDeltaEvent) => void;
-    /** Callback chamado quando uma ferramenta é usada. */
-    onTool?: (event: AgentStreamToolEvent) => void;
-    /** Callback chamado quando um novo chat é criado (só dispara se taskId era ausente). */
-    onTaskCreated?: (event: AgentTaskCreatedEvent) => void;
-    /** Callback chamado quando ocorre erro durante o stream. */
-    onError?: (event: AgentErrorEvent) => void;
-    /** Permite cancelar o stream mid-flight. */
-    signal?: AbortSignal;
-}
-interface SendAgentPromptResponse {
-    /** ID do chat (existente ou recém-criado). */
-    taskId: string;
-    /** Texto completo acumulado dos deltas. */
-    content: string;
+interface AgentQueueChangeEvent {
+    queue: ReadonlyArray<QueuedItem>;
+}
+interface AgentStatusChangeEvent {
+    status: AgentTaskStatus;
+    previous: AgentTaskStatus;
+}
+type AgentTaskEventMap = {
+    historyLoaded: AgentMessage[];
+    turnStart: void;
+    delta: AgentDeltaEvent;
+    tool: AgentToolEvent;
+    turnEnd: AgentTurnEndEvent;
+    taskCreated: AgentTaskCreatedEvent;
+    cancelled: void;
+    error: AgentErrorEvent;
+    queueChange: AgentQueueChangeEvent;
+    statusChange: AgentStatusChangeEvent;
+};
+type AgentTaskEventName = keyof AgentTaskEventMap;
+interface AgentTaskSession {
+    readonly taskId: string | null;
+    readonly task: AgentChat | null;
+    readonly isNew: boolean;
+    readonly status: AgentTaskStatus;
+    readonly history: ReadonlyArray<AgentMessage>;
+    readonly content: string;
+    readonly queue: ReadonlyArray<QueuedItem>;
+    loadHistory(options?: {
+        limit?: number;
+    }): Promise<AgentMessage[]>;
+    close(): void;
+    send(prompt: string, options?: SendOptions): void;
+    cancel(): Promise<void>;
+    editQueueItem(itemId: string, newText: string): boolean;
+    removeQueueItem(itemId: string): boolean;
+    clearQueue(): void;
+    on<E extends AgentTaskEventName>(event: E, handler: (payload: AgentTaskEventMap[E]) => void): () => void;
 }
 
 /**
@@ -649,8 +675,7 @@ interface MitraInstance {
     validatePasswordResetCode(options: ValidatePasswordResetCodeOptions): Promise<Record<string, unknown>>;
     resetPassword(options: ResetPasswordOptions): Promise<Record<string, unknown>>;
     getAgentChats(options?: GetAgentChatsOptions): Promise<AgentChat[]>;
-    getAgentHistory(options: GetAgentHistoryOptions): Promise<AgentMessage[]>;
-    sendAgentPrompt(options: SendAgentPromptOptions): Promise<SendAgentPromptResponse>;
+    getAgentTask(options: GetAgentTaskOptions): AgentTaskSession;
     disconnectAgentChat(): void;
     openChat(): void;
     closeChat(): void;
@@ -658,16 +683,14 @@ interface MitraInstance {
 declare function createMitraInstance(initialConfig: Partial<MitraConfig>): MitraInstance;
 
 interface MitraConfig {
-    /** URL base da API (ex: https://api.mitra.com) */
-    baseURL: string;
+    /** URL base da API (ex: https://api.mitra.com). Opcional se houver window.__mitraEnv.apiBaseURL (build-proxy). */
+    baseURL?: string;
     /** Token JWT para autenticação (opcional para Server Functions públicas) */
     token?: string;
     /** URL base do serviço de integrações (ex: https://api0.mitraecp.com:1003) */
     integrationURL?: string;
     /** URL da página de autenticação Mitra (ex: https://coder.mitralab.io/sdk-auth/) */
     authUrl?: string;
-    /** URL do WebSocket do Agent Chat (ex: wss://agent.mitralab.io/sdk-ws ou ws://localhost:3456/sdk-ws) */
-    agentWsUrl?: string;
     /** ID do projeto (usado como fallback nos métodos de login e serviços) */
     projectId?: number;
     /** Callback chamado quando o token é renovado automaticamente (após 401/403). Recebe a nova sessão. */
@@ -675,8 +698,12 @@ interface MitraConfig {
 }
 /**
  * Configura o SDK globalmente e retorna uma instância configurada.
+ *
+ * Em apps publicadas pelo Mitra (window.__mitraEnv presente), nenhum campo
+ * precisa ser passado — todas as URLs vêm da injeção do build-proxy.
+ * Em outros contextos, baseURL ainda é necessário (manual ou via login).
  */
-declare function configureSdkMitra(config: MitraConfig): MitraInstance;
+declare function configureSdkMitra(config?: Partial<MitraConfig>): MitraInstance;
 /**
  * Obtém a configuração atual
  */
@@ -779,24 +806,35 @@ declare function validatePasswordResetCodeMitra(options: ValidatePasswordResetCo
 declare function resetPasswordMitra(options: ResetPasswordOptions): Promise<Record<string, unknown>>;
 
 /**
- * Mitra Interactions SDK - Agent Chat (embedded)
+ * Mitra Interactions SDK — Agent Chat
  *
- * Conecta via WebSocket ao mitra-agent-websocket. Tudo (lista de chats,
- * histórico, envio de prompt + stream) trafega pela mesma conexão.
+ * Hub do WebSocket compartilhado e factories da API pública:
+ *   - getAgentChatsMitra({ projectId? })
+ *   - getAgentTaskMitra({ create | taskId, ... })
  *
- * - Open: lazy — só conecta na primeira chamada.
- * - Auth: JWT do config global passado como query param do handshake.
- *   O backend valida o token e resolve userSpaceID server-side.
- * - Request/Response: cada chamada envia { type, requestId } e aguarda
- *   { type: 'response', requestId, ok, data | error }.
- * - Stream: send_prompt dispara push events (stream_delta, stream_end, ...).
+ * O WS é singleton: todas as sessions usam UMA conexão. O roteamento
+ * de eventos é feito por taskId, despachando pra session correspondente.
+ *
+ * NÃO há `sendAgentPromptMitra` ou `getAgentHistoryMitra` exportados —
+ * essas operações vivem dentro de `AgentTaskSession`.
  */
 
+/**
+ * Lista chats do user para um projeto.
+ */
 declare function getAgentChatsMitra(options?: GetAgentChatsOptions): Promise<AgentChat[]>;
-declare function getAgentHistoryMitra(options: GetAgentHistoryOptions): Promise<AgentMessage[]>;
-declare function sendAgentPromptMitra(options: SendAgentPromptOptions): Promise<SendAgentPromptResponse>;
 /**
- * Fecha o WebSocket do Agent Chat. Útil em testes ou no logout.
+ * Abre um handle de chat (session). Use:
+ *   - `{ create: true }` para iniciar um chat novo
+ *   - `{ taskId: 'X' }` para abrir um chat existente
+ *
+ * A session expõe histórico, streaming, fila, cancel e eventos. Se a
+ * mesma taskId for aberta duas vezes, retorna a MESMA instância (cache).
+ */
+declare function getAgentTaskMitra(options: GetAgentTaskOptions): AgentTaskSession;
+/**
+ * Fecha o WebSocket do Agent Chat. Sessions ativas devem chamar close()
+ * antes — esta função é destinada a teardown global (logout, testes).
  */
 declare function disconnectAgentChatMitra(): void;
 
@@ -955,4 +993,4 @@ declare function setProfileScreensMitra(options: SetProfileScreensOptions): Prom
  */
 declare function setProfileServerFunctionsMitra(options: SetProfileServerFunctionsOptions): Promise<SetProfilePermissionResponse>;
 
-export { type AgentChat, type AgentErrorEvent, type AgentMessage, type AgentStreamDeltaEvent, type AgentStreamEndEvent, type AgentStreamToolEvent, type AgentTaskCreatedEvent, type CallIntegrationOptions, type CallIntegrationResponse, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteProfileOptions, type DeleteProfileResponse, type DeleteRecordOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDataLoaderOptions, type ExecuteDataLoaderResponse, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetAgentChatsOptions, type GetAgentHistoryOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableRef, type ResetPasswordOptions, type RunActionOptions, type RunActionResponse, type SendAgentPromptOptions, type SendAgentPromptResponse, type SendPasswordResetCodeOptions, type SetFileStatusOptions, type SetFileStatusResponse, type SetProfileActionsOptions, type SetProfileDmlTablesOptions, type SetProfilePermissionResponse, type SetProfileScreensOptions, type SetProfileSelectTablesOptions, type SetProfileServerFunctionsOptions, type SetProfileUsersOptions, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateProfileOptions, type UpdateProfileResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, type ValidatePasswordResetCodeOptions, callIntegrationMitra, closeChatMitra, configureSdkMitra, createMitraInstance, createProfileMitra, createRecordMitra, createRecordsBatchMitra, deleteProfileMitra, deleteRecordMitra, disconnectAgentChatMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentChatsMitra, getAgentHistoryMitra, getConfig, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, openChatMitra, patchRecordMitra, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendAgentPromptMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };
+export { type AgentChat, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentQueueChangeEvent, type AgentStatusChangeEvent, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type CallIntegrationOptions, type CallIntegrationResponse, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type DeleteProfileOptions, type DeleteProfileResponse, type DeleteRecordOptions, type EmailLoginOptions, type EmailResendCodeOptions, type EmailSignupOptions, type EmailVerifyCodeOptions, type ExecuteDataLoaderOptions, type ExecuteDataLoaderResponse, type ExecuteDbActionOptions, type ExecuteDbActionResponse, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetAgentChatsOptions, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableRef, type QueuedItem, type ResetPasswordOptions, type RunActionOptions, type RunActionResponse, type SendOptions, type SendPasswordResetCodeOptions, type SetFileStatusOptions, type SetFileStatusResponse, type SetProfileActionsOptions, type SetProfileDmlTablesOptions, type SetProfilePermissionResponse, type SetProfileScreensOptions, type SetProfileSelectTablesOptions, type SetProfileServerFunctionsOptions, type SetProfileUsersOptions, type SetVariableOptions, type SetVariableResponse, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateProfileOptions, type UpdateProfileResponse, type UpdateRecordOptions, type UploadFileOptions, type UploadFileResponse, type ValidatePasswordResetCodeOptions, callIntegrationMitra, closeChatMitra, configureSdkMitra, createMitraInstance, createProfileMitra, createRecordMitra, createRecordsBatchMitra, deleteProfileMitra, deleteRecordMitra, disconnectAgentChatMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentChatsMitra, getAgentTaskMitra, getConfig, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, openChatMitra, patchRecordMitra, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };