mitra-interactions-sdk 1.0.64 → 1.0.66

package/dist/index.d.mts

@@ -290,7 +290,75 @@ interface UploadFileResponse {
     status: string;
     result: {
         fileName: string;
+        /** No PUBLIC é a URL completa; no PRIVATE/LOADABLE é a chave relativa. Prefira `key`. */
         currentPath: string;
+        /**
+         * Chave relativa do objeto. No PRIVATE: `ai-files/private/{24 chars aleatórios}/nome` — não é
+         * adivinhável e dois uploads com o mesmo nome não se sobrescrevem. Guarde-a na tabela da
+         * aplicação, na linha do registro dono; é ela que a Server Function usa para liberar o
+         * arquivo. (Backends anteriores ao TKT-000a0394 não a enviam.)
+         */
+        key?: string;
+        publicUrl: string | null;
+        message: string;
+    };
+}
+interface DownloadFileOptions {
+    /** ID do projeto (opcional se já configurado via configureSdkMitra) */
+    projectId?: number;
+    /**
+     * Chave do arquivo: `result.key` do upload (`ai-files/private/{aleatório}/nome`, ou
+     * `ai-files/{public|loadable}/nome`). Também aceita `result.currentPath`, inclusive a URL
+     * pública de um upload PUBLIC do mesmo projeto. Chave fora dessas pastas é recusada com 400.
+     *
+     * Permissão: só usuário DEV do projeto ou Server Function em execução. Tela de usuário final
+     * NÃO chama isto — pede o anexo pelo registro a uma SF (ver README, "Anexos").
+     */
+    key: string;
+}
+interface FileLinkOptions {
+    /** ID do projeto (opcional se já configurado via configureSdkMitra) */
+    projectId?: number;
+    /** Chave do arquivo — mesma regra de `DownloadFileOptions.key` */
+    key: string;
+    /** Validade em segundos (padrão 300 no backend; máximo configurado no backend, 3600 por padrão) */
+    ttlSeconds?: number;
+}
+/**
+ * Sucesso: `{ status: "success", result }`. Erro: `{ status: "error", error: { code, message } }`
+ * com HTTP 400 (INVALID_KEY/MISSING_*), 403 (ACCESS_DENIED), 404 (FILE_NOT_FOUND), 500.
+ */
+interface FileLinkResponse {
+    status: string;
+    result?: {
+        key: string;
+        /** URL assinada; vale até `expiresAt` */
+        url: string;
+        expiresAt: string;
+        expiresInSeconds: number;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface DeleteFileOptions {
+    /** ID do projeto (opcional se já configurado via configureSdkMitra) */
+    projectId?: number;
+    /** Chave do arquivo — mesma regra de `DownloadFileOptions.key`. Exclui exatamente um objeto. */
+    key: string;
+}
+/**
+ * Sucesso: `{ status: "success", result }`. Erro: `{ status: "error", error: { code, message } }`
+ * com code MISSING_KEY | INVALID_KEY | ACCESS_DENIED (usuário sem perfil DEV no projeto ou API key
+ * BUSINESS) | FILE_NOT_FOUND (nada apagado) | INTERNAL_ERROR.
+ */
+interface DeleteFileResponse {
+    status: string;
+    result: {
+        fileName: string;
+        currentPath: string;
+        key?: string;
         publicUrl: string | null;
         message: string;
     };
@@ -892,7 +960,11 @@ interface MitraInstance {
     getPublicServerFunctionExecution(options: GetPublicServerFunctionExecutionOptions): Promise<GetPublicServerFunctionExecutionResponse>;
     stopServerFunctionExecution(options: StopServerFunctionExecutionOptions): Promise<StopServerFunctionExecutionResponse>;
     uploadFilePublic(options: UploadFileOptions): Promise<UploadFileResponse>;
+    uploadFilePrivate(options: UploadFileOptions): Promise<UploadFileResponse>;
     uploadFileLoadable(options: UploadFileOptions): Promise<UploadFileResponse>;
+    downloadFilePrivate(options: DownloadFileOptions): Promise<Blob>;
+    getFileLink(options: FileLinkOptions): Promise<FileLinkResponse>;
+    deleteFile(options: DeleteFileOptions): Promise<DeleteFileResponse>;
     listIntegrations(options?: ListIntegrationsOptions): Promise<IntegrationResponse[]>;
     callIntegration(options: CallIntegrationOptions): Promise<CallIntegrationResponse>;
     listRecords(options: ListRecordsOptions): Promise<ListRecordsResponse>;
@@ -1243,6 +1315,36 @@ declare function uploadFilePublicMitra(options: UploadFileOptions): Promise<Uplo
  * Faz upload de um arquivo para a pasta LOADABLE do projeto.
  */
 declare function uploadFileLoadableMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
+/**
+ * POST /interactions/uploadFilePrivate (multipart/form-data)
+ * Faz upload de um arquivo para a pasta PRIVATE do projeto. O arquivo NAO fica publico
+ * no S3 (sem ACL public-read) — este e o modo recomendado/padrao. O acesso e feito por
+ * download autenticado; guarde `result.key` (a chave relativa) para baixar ou excluir depois.
+ * `result.publicUrl` sempre vem `null` para upload privado. Privado e por PROJETO, nao por
+ * usuario: qualquer usuario do projeto que conheca a chave consegue baixar.
+ */
+declare function uploadFilePrivateMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
+/**
+ * GET /interactions/downloadFile
+ * Baixa (com credencial) um arquivo do projeto e retorna o conteúdo como Blob.
+ * `key` é a chave retornada no upload (`result.key`; `result.currentPath` também é aceito).
+ * Permissão: usuário DEV do projeto ou Server Function em execução (403 para usuário final).
+ */
+declare function downloadFilePrivateMitra(options: DownloadFileOptions): Promise<Blob>;
+/**
+ * GET /interactions/fileLink
+ * Link temporário (assinado) para um arquivo do projeto. Mesma permissão do download: DEV ou
+ * Server Function em execução. Use quando precisar exibir muitas imagens numa tela de DEV ou em
+ * ferramental; para usuário final, a SF é quem emite o link depois de validar o registro.
+ */
+declare function getFileLinkMitra(options: FileLinkOptions): Promise<FileLinkResponse>;
+/**
+ * DELETE /interactions/deleteFile
+ * Exclui exatamente um arquivo do projeto pela `key` (`result.key` do upload).
+ * Permissão: usuário DEV do projeto ou Server Function em execução (403 para usuário final);
+ * chave inexistente devolve FILE_NOT_FOUND (HTTP 404).
+ */
+declare function deleteFileMitra(options: DeleteFileOptions): Promise<DeleteFileResponse>;
 declare function listRecordsMitra(options: ListRecordsOptions): Promise<ListRecordsResponse>;
 declare function getRecordMitra(options: GetRecordOptions): Promise<Record<string, any>>;
 declare function createRecordMitra(options: CreateRecordOptions): Promise<Record<string, any>>;
@@ -1306,4 +1408,4 @@ declare function setProfileScreensMitra(options: SetProfileScreensOptions): Prom
  */
 declare function setProfileServerFunctionsMitra(options: SetProfileServerFunctionsOptions): Promise<SetProfilePermissionResponse>;
 
-export { type AgentApiKeyTarget, type AgentAttachment, type AgentAttachmentType, type AgentAuthMeta, type AgentChat, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModelGroup, type AgentModelOption, type AgentProviderListItem, type AgentQueueChangeEvent, type AgentStatusChangeEvent, type AgentSubscriptionAccount, type AgentSubscriptionTarget, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialOptions, type AuthAgentCredentialResult, type AuthClaudeResult, type AuthCodexResult, type AuthMethod, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialOptions, type ConnectAgentSubscriptionResult, type ConnectableSubscriptionTarget, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAccessType, type CredentialAction, type CredentialTarget, type DeleteAgentChatResult, 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 GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type ManageAgentCredentialResult, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableRef, type QueuedItem, type RenameAgentChatResult, 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, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, openChatMitra, patchRecordMitra, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };
+export { type AgentApiKeyTarget, type AgentAttachment, type AgentAttachmentType, type AgentAuthMeta, type AgentChat, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModelGroup, type AgentModelOption, type AgentProviderListItem, type AgentQueueChangeEvent, type AgentStatusChangeEvent, type AgentSubscriptionAccount, type AgentSubscriptionTarget, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialOptions, type AuthAgentCredentialResult, type AuthClaudeResult, type AuthCodexResult, type AuthMethod, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialOptions, type ConnectAgentSubscriptionResult, type ConnectableSubscriptionTarget, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAccessType, type CredentialAction, type CredentialTarget, type DeleteAgentChatResult, type DeleteFileOptions, type DeleteFileResponse, type DeleteProfileOptions, type DeleteProfileResponse, type DeleteRecordOptions, type DownloadFileOptions, 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 FileLinkOptions, type FileLinkResponse, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type ManageAgentCredentialResult, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableRef, type QueuedItem, type RenameAgentChatResult, 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, deleteFileMitra, deleteProfileMitra, deleteRecordMitra, downloadFilePrivateMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getFileLinkMitra, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, openChatMitra, patchRecordMitra, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePrivateMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };

package/dist/index.d.ts

@@ -290,7 +290,75 @@ interface UploadFileResponse {
     status: string;
     result: {
         fileName: string;
+        /** No PUBLIC é a URL completa; no PRIVATE/LOADABLE é a chave relativa. Prefira `key`. */
         currentPath: string;
+        /**
+         * Chave relativa do objeto. No PRIVATE: `ai-files/private/{24 chars aleatórios}/nome` — não é
+         * adivinhável e dois uploads com o mesmo nome não se sobrescrevem. Guarde-a na tabela da
+         * aplicação, na linha do registro dono; é ela que a Server Function usa para liberar o
+         * arquivo. (Backends anteriores ao TKT-000a0394 não a enviam.)
+         */
+        key?: string;
+        publicUrl: string | null;
+        message: string;
+    };
+}
+interface DownloadFileOptions {
+    /** ID do projeto (opcional se já configurado via configureSdkMitra) */
+    projectId?: number;
+    /**
+     * Chave do arquivo: `result.key` do upload (`ai-files/private/{aleatório}/nome`, ou
+     * `ai-files/{public|loadable}/nome`). Também aceita `result.currentPath`, inclusive a URL
+     * pública de um upload PUBLIC do mesmo projeto. Chave fora dessas pastas é recusada com 400.
+     *
+     * Permissão: só usuário DEV do projeto ou Server Function em execução. Tela de usuário final
+     * NÃO chama isto — pede o anexo pelo registro a uma SF (ver README, "Anexos").
+     */
+    key: string;
+}
+interface FileLinkOptions {
+    /** ID do projeto (opcional se já configurado via configureSdkMitra) */
+    projectId?: number;
+    /** Chave do arquivo — mesma regra de `DownloadFileOptions.key` */
+    key: string;
+    /** Validade em segundos (padrão 300 no backend; máximo configurado no backend, 3600 por padrão) */
+    ttlSeconds?: number;
+}
+/**
+ * Sucesso: `{ status: "success", result }`. Erro: `{ status: "error", error: { code, message } }`
+ * com HTTP 400 (INVALID_KEY/MISSING_*), 403 (ACCESS_DENIED), 404 (FILE_NOT_FOUND), 500.
+ */
+interface FileLinkResponse {
+    status: string;
+    result?: {
+        key: string;
+        /** URL assinada; vale até `expiresAt` */
+        url: string;
+        expiresAt: string;
+        expiresInSeconds: number;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface DeleteFileOptions {
+    /** ID do projeto (opcional se já configurado via configureSdkMitra) */
+    projectId?: number;
+    /** Chave do arquivo — mesma regra de `DownloadFileOptions.key`. Exclui exatamente um objeto. */
+    key: string;
+}
+/**
+ * Sucesso: `{ status: "success", result }`. Erro: `{ status: "error", error: { code, message } }`
+ * com code MISSING_KEY | INVALID_KEY | ACCESS_DENIED (usuário sem perfil DEV no projeto ou API key
+ * BUSINESS) | FILE_NOT_FOUND (nada apagado) | INTERNAL_ERROR.
+ */
+interface DeleteFileResponse {
+    status: string;
+    result: {
+        fileName: string;
+        currentPath: string;
+        key?: string;
         publicUrl: string | null;
         message: string;
     };
@@ -892,7 +960,11 @@ interface MitraInstance {
     getPublicServerFunctionExecution(options: GetPublicServerFunctionExecutionOptions): Promise<GetPublicServerFunctionExecutionResponse>;
     stopServerFunctionExecution(options: StopServerFunctionExecutionOptions): Promise<StopServerFunctionExecutionResponse>;
     uploadFilePublic(options: UploadFileOptions): Promise<UploadFileResponse>;
+    uploadFilePrivate(options: UploadFileOptions): Promise<UploadFileResponse>;
     uploadFileLoadable(options: UploadFileOptions): Promise<UploadFileResponse>;
+    downloadFilePrivate(options: DownloadFileOptions): Promise<Blob>;
+    getFileLink(options: FileLinkOptions): Promise<FileLinkResponse>;
+    deleteFile(options: DeleteFileOptions): Promise<DeleteFileResponse>;
     listIntegrations(options?: ListIntegrationsOptions): Promise<IntegrationResponse[]>;
     callIntegration(options: CallIntegrationOptions): Promise<CallIntegrationResponse>;
     listRecords(options: ListRecordsOptions): Promise<ListRecordsResponse>;
@@ -1243,6 +1315,36 @@ declare function uploadFilePublicMitra(options: UploadFileOptions): Promise<Uplo
  * Faz upload de um arquivo para a pasta LOADABLE do projeto.
  */
 declare function uploadFileLoadableMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
+/**
+ * POST /interactions/uploadFilePrivate (multipart/form-data)
+ * Faz upload de um arquivo para a pasta PRIVATE do projeto. O arquivo NAO fica publico
+ * no S3 (sem ACL public-read) — este e o modo recomendado/padrao. O acesso e feito por
+ * download autenticado; guarde `result.key` (a chave relativa) para baixar ou excluir depois.
+ * `result.publicUrl` sempre vem `null` para upload privado. Privado e por PROJETO, nao por
+ * usuario: qualquer usuario do projeto que conheca a chave consegue baixar.
+ */
+declare function uploadFilePrivateMitra(options: UploadFileOptions): Promise<UploadFileResponse>;
+/**
+ * GET /interactions/downloadFile
+ * Baixa (com credencial) um arquivo do projeto e retorna o conteúdo como Blob.
+ * `key` é a chave retornada no upload (`result.key`; `result.currentPath` também é aceito).
+ * Permissão: usuário DEV do projeto ou Server Function em execução (403 para usuário final).
+ */
+declare function downloadFilePrivateMitra(options: DownloadFileOptions): Promise<Blob>;
+/**
+ * GET /interactions/fileLink
+ * Link temporário (assinado) para um arquivo do projeto. Mesma permissão do download: DEV ou
+ * Server Function em execução. Use quando precisar exibir muitas imagens numa tela de DEV ou em
+ * ferramental; para usuário final, a SF é quem emite o link depois de validar o registro.
+ */
+declare function getFileLinkMitra(options: FileLinkOptions): Promise<FileLinkResponse>;
+/**
+ * DELETE /interactions/deleteFile
+ * Exclui exatamente um arquivo do projeto pela `key` (`result.key` do upload).
+ * Permissão: usuário DEV do projeto ou Server Function em execução (403 para usuário final);
+ * chave inexistente devolve FILE_NOT_FOUND (HTTP 404).
+ */
+declare function deleteFileMitra(options: DeleteFileOptions): Promise<DeleteFileResponse>;
 declare function listRecordsMitra(options: ListRecordsOptions): Promise<ListRecordsResponse>;
 declare function getRecordMitra(options: GetRecordOptions): Promise<Record<string, any>>;
 declare function createRecordMitra(options: CreateRecordOptions): Promise<Record<string, any>>;
@@ -1306,4 +1408,4 @@ declare function setProfileScreensMitra(options: SetProfileScreensOptions): Prom
  */
 declare function setProfileServerFunctionsMitra(options: SetProfileServerFunctionsOptions): Promise<SetProfilePermissionResponse>;
 
-export { type AgentApiKeyTarget, type AgentAttachment, type AgentAttachmentType, type AgentAuthMeta, type AgentChat, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModelGroup, type AgentModelOption, type AgentProviderListItem, type AgentQueueChangeEvent, type AgentStatusChangeEvent, type AgentSubscriptionAccount, type AgentSubscriptionTarget, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialOptions, type AuthAgentCredentialResult, type AuthClaudeResult, type AuthCodexResult, type AuthMethod, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialOptions, type ConnectAgentSubscriptionResult, type ConnectableSubscriptionTarget, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAccessType, type CredentialAction, type CredentialTarget, type DeleteAgentChatResult, 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 GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type ManageAgentCredentialResult, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableRef, type QueuedItem, type RenameAgentChatResult, 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, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, openChatMitra, patchRecordMitra, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };
+export { type AgentApiKeyTarget, type AgentAttachment, type AgentAttachmentType, type AgentAuthMeta, type AgentChat, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModelGroup, type AgentModelOption, type AgentProviderListItem, type AgentQueueChangeEvent, type AgentStatusChangeEvent, type AgentSubscriptionAccount, type AgentSubscriptionTarget, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialOptions, type AuthAgentCredentialResult, type AuthClaudeResult, type AuthCodexResult, type AuthMethod, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialOptions, type ConnectAgentSubscriptionResult, type ConnectableSubscriptionTarget, type CreateProfileOptions, type CreateProfileResponse, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAccessType, type CredentialAction, type CredentialTarget, type DeleteAgentChatResult, type DeleteFileOptions, type DeleteFileResponse, type DeleteProfileOptions, type DeleteProfileResponse, type DeleteRecordOptions, type DownloadFileOptions, 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 FileLinkOptions, type FileLinkResponse, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetProfileDetailsOptions, type GetProfileDetailsResponse, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type GetVariableOptions, type GetVariableResponse, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListProfilesOptions, type ListProfilesResponse, type ListRecordsOptions, type ListRecordsResponse, type ListVariablesOptions, type ListVariablesResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type ManageAgentCredentialResult, type MitraConfig, type MitraInstance, type PatchRecordOptions, type ProfileTableRef, type QueuedItem, type RenameAgentChatResult, 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, deleteFileMitra, deleteProfileMitra, deleteRecordMitra, downloadFilePrivateMitra, emailLoginMitra, emailResendCodeMitra, emailSignupMitra, emailVerifyCodeMitra, executeDataLoaderMitra, executeDbActionMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getFileLinkMitra, getProfileDetailsMitra, getPublicServerFunctionExecutionMitra, getRecordMitra, getVariableMitra, listIntegrationsMitra, listProfilesMitra, listRecordsMitra, listVariablesMitra, loginMitra, loginWithEmailMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, openChatMitra, patchRecordMitra, refreshTokenSilently, resetPasswordMitra, resolveProjectId, runActionMitra, sendPasswordResetCodeMitra, setFileStatusMitra, setProfileActionsMitra, setProfileDmlTablesMitra, setProfileScreensMitra, setProfileSelectTablesMitra, setProfileServerFunctionsMitra, setProfileUsersMitra, setVariableMitra, stopServerFunctionExecutionMitra, updateProfileMitra, updateRecordMitra, uploadFileLoadableMitra, uploadFilePrivateMitra, uploadFilePublicMitra, validatePasswordResetCodeMitra };

package/dist/index.js

@@ -486,6 +486,34 @@ var http = {
       headers,
       body: formData
     });
+  },
+  // Download binário (Blob). Usado para baixar arquivos privados com credencial,
+  // já que a resposta não é JSON. Mesma lógica de refresh-on-403 do fetchWithRefresh.
+  async download(endpoint, params) {
+    const fetchFn = getFetch2();
+    const url = buildUrl(endpoint, params);
+    let response = await fetchFn(url, { method: "GET", headers: buildHeaders() });
+    if (response.status === 403) {
+      const refreshed = await tryRefreshToken();
+      if (refreshed) {
+        response = await fetchFn(url, { method: "GET", headers: buildHeaders() });
+      }
+    }
+    if (!response.ok) {
+      const text = await response.text();
+      let data = null;
+      try {
+        data = text ? JSON.parse(text) : null;
+      } catch (e) {
+      }
+      const base = (data == null ? void 0 : data.message) || (data == null ? void 0 : data.error) || `HTTP ${response.status}`;
+      throw {
+        message: (data == null ? void 0 : data.hint) ? `${base} \u2014 ${data.hint}` : base,
+        status: response.status,
+        details: data
+      };
+    }
+    return response.blob();
   }
 };
 async function requestWithTenant(method, endpoint, tenantId, options) {
@@ -683,6 +711,32 @@ async function uploadFileLoadableMitra(options) {
   if (options.debug !== void 0) formData.append("debug", String(options.debug));
   return http.upload("/interactions/uploadFileLoadable", formData);
 }
+async function uploadFilePrivateMitra(options) {
+  const formData = new FormData();
+  formData.append("file", options.file);
+  formData.append("projectId", String(resolveProjectId2(options.projectId)));
+  if (options.debug !== void 0) formData.append("debug", String(options.debug));
+  return http.upload("/interactions/uploadFilePrivate", formData);
+}
+async function downloadFilePrivateMitra(options) {
+  return http.download("/interactions/downloadFile", {
+    projectId: resolveProjectId2(options.projectId),
+    key: options.key
+  });
+}
+async function getFileLinkMitra(options) {
+  return http.get("/interactions/fileLink", {
+    projectId: resolveProjectId2(options.projectId),
+    key: options.key,
+    ...options.ttlSeconds !== void 0 ? { ttlSeconds: options.ttlSeconds } : {}
+  });
+}
+async function deleteFileMitra(options) {
+  return http.del("/interactions/deleteFile", {
+    projectId: resolveProjectId2(options.projectId),
+    key: options.key
+  });
+}
 async function listRecordsMitra(options) {
   const { tableName, page, size, filters, jdbcConnectionConfigId } = options;
   const pid = resolveProjectId2(options.projectId);
@@ -1871,6 +1925,30 @@ function createMitraInstance(initialConfig) {
       body: formData
     });
   }
+  async function requestDownload(endpoint, params) {
+    let url = `${_config.baseURL}${endpoint}`;
+    if (params) {
+      const q = buildQuery(params);
+      if (q) url += `?${q}`;
+    }
+    const fetchFn = getFetch3();
+    let response = await fetchFn(url, { method: "GET", headers: authHeaders() });
+    if (response.status === 403) {
+      const refreshed = await tryRefreshToken2();
+      if (refreshed) response = await fetchFn(url, { method: "GET", headers: authHeaders() });
+    }
+    if (!response.ok) {
+      const text = await response.text();
+      let data = null;
+      try {
+        data = text ? JSON.parse(text) : null;
+      } catch (e) {
+      }
+      const base = (data == null ? void 0 : data.message) || (data == null ? void 0 : data.error) || `HTTP ${response.status}`;
+      throw { message: (data == null ? void 0 : data.hint) ? `${base} \u2014 ${data.hint}` : base, status: response.status, details: data };
+    }
+    return response.blob();
+  }
   async function requestTenant(method, endpoint, tenantId, opts) {
     let url = `${_config.baseURL}${endpoint}`;
     if (opts == null ? void 0 : opts.params) {
@@ -1978,6 +2056,13 @@ function createMitraInstance(initialConfig) {
       if (options.debug !== void 0) formData.append("debug", String(options.debug));
       return requestUpload("/interactions/uploadFilePublic", formData);
     },
+    async uploadFilePrivate(options) {
+      const formData = new FormData();
+      formData.append("file", options.file);
+      formData.append("projectId", String(resolveProjectId4(options.projectId)));
+      if (options.debug !== void 0) formData.append("debug", String(options.debug));
+      return requestUpload("/interactions/uploadFilePrivate", formData);
+    },
     async uploadFileLoadable(options) {
       const formData = new FormData();
       formData.append("file", options.file);
@@ -1985,6 +2070,26 @@ function createMitraInstance(initialConfig) {
       if (options.debug !== void 0) formData.append("debug", String(options.debug));
       return requestUpload("/interactions/uploadFileLoadable", formData);
     },
+    async downloadFilePrivate(options) {
+      return requestDownload("/interactions/downloadFile", {
+        projectId: resolveProjectId4(options.projectId),
+        key: options.key
+      });
+    },
+    async getFileLink(options) {
+      return request("GET", "/interactions/fileLink", {
+        params: {
+          projectId: resolveProjectId4(options.projectId),
+          key: options.key,
+          ...options.ttlSeconds !== void 0 ? { ttlSeconds: options.ttlSeconds } : {}
+        }
+      });
+    },
+    async deleteFile(options) {
+      return request("DELETE", "/interactions/deleteFile", {
+        params: { projectId: resolveProjectId4(options.projectId), key: options.key }
+      });
+    },
     // Integrations
     async listIntegrations(options = {}) {
       return request("GET", "/interactions/integrations", { params: { projectId: resolveProjectId4(options.projectId) } });
@@ -2212,8 +2317,10 @@ exports.createMitraInstance = createMitraInstance;
 exports.createProfileMitra = createProfileMitra;
 exports.createRecordMitra = createRecordMitra;
 exports.createRecordsBatchMitra = createRecordsBatchMitra;
+exports.deleteFileMitra = deleteFileMitra;
 exports.deleteProfileMitra = deleteProfileMitra;
 exports.deleteRecordMitra = deleteRecordMitra;
+exports.downloadFilePrivateMitra = downloadFilePrivateMitra;
 exports.emailLoginMitra = emailLoginMitra;
 exports.emailResendCodeMitra = emailResendCodeMitra;
 exports.emailSignupMitra = emailSignupMitra;
@@ -2226,6 +2333,7 @@ exports.executeServerFunctionAsyncMitra = executeServerFunctionAsyncMitra;
 exports.executeServerFunctionMitra = executeServerFunctionMitra;
 exports.getAgentTaskMitra = getAgentTaskMitra;
 exports.getConfig = getConfig;
+exports.getFileLinkMitra = getFileLinkMitra;
 exports.getProfileDetailsMitra = getProfileDetailsMitra;
 exports.getPublicServerFunctionExecutionMitra = getPublicServerFunctionExecutionMitra;
 exports.getRecordMitra = getRecordMitra;
@@ -2259,6 +2367,7 @@ exports.stopServerFunctionExecutionMitra = stopServerFunctionExecutionMitra;
 exports.updateProfileMitra = updateProfileMitra;
 exports.updateRecordMitra = updateRecordMitra;
 exports.uploadFileLoadableMitra = uploadFileLoadableMitra;
+exports.uploadFilePrivateMitra = uploadFilePrivateMitra;
 exports.uploadFilePublicMitra = uploadFilePublicMitra;
 exports.validatePasswordResetCodeMitra = validatePasswordResetCodeMitra;
 //# sourceMappingURL=index.js.map