mitra-interactions-sdk 1.0.60-beta.24 → 1.0.60-beta.26

package/README.md

@@ -246,7 +246,7 @@ const result2 = await listRecordsMitra({
 
 ## Agent Chat (copilot)
 
-Chat com o agente de IA embarcado. **REST-first**: chats, histórico, credenciais e modelos são HTTP no gateway `{origin}/copilot/api/v1` (mesmo domínio da `baseURL`, `Authorization: Bearer`). **Só o prompt é streaming** — um WebSocket por task em `wss://{origin}/copilot/ws/tasks/{taskId}?token=JWT`, aberto pela SDK quando a conversa começa.
+Chat com o agente de IA embarcado. **REST-first, tudo pela BFF no `baseURL` normal** (`/agentAiShortcut/*` — herda `fetchWithRefresh` e CORS): chats (`createChat`/`listChats`/`readChat`/`renameChat`/`deleteChat`), histórico (`listChatMessages`), credenciais e modelos. `projectId` obrigatório em todas (opcional na chamada se veio do `configureSdkMitra`). **Só o prompt é streaming** — um WebSocket por task em `wss://{origin}/copilot/ws/tasks/{taskId}?token=JWT`, aberto pela SDK quando a conversa começa (WS não passa por preflight de CORS).
 
 Precisa de `token` e `baseURL` configurados (o login já deixa pronto). O transporte do prompt aceita `transport: 'ws' | 'http'` — `'ws'` é o default; `'http'` é reservado pra ambientes serverless e hoje lança erro claro (o backend ainda não expõe prompt por HTTP).
 
@@ -265,12 +265,12 @@ const deleted  = await manageAgentChatMitra({ action: 'delete', taskId }); // ar
 ```
 
 - `action: 'list'` → `AgentChat[]` — `{ id, name, agentType, agentId, archived, createdAt, updatedAt }`. Filtros: `agentId?`, `archived?`, `search?`, `page?`, `size?`.
-- `action: 'rename'` → `{ taskId, name }` (PATCH `/tasks/{id}`)
-- `action: 'delete'` → `{ taskId, deleted }` (PATCH `/tasks/{id}/archive` — o histórico não é destruído)
+- `action: 'rename'` → `{ taskId, name }` (POST `/agentAiShortcut/renameChat`)
+- `action: 'delete'` → `{ taskId, deleted }` (POST `/agentAiShortcut/deleteChat` — arquiva, o histórico não é destruído)
 
 ### Abrir uma session — `getAgentTaskMitra`
 
-Retorna uma `AgentTaskSession` que encapsula o ciclo de vida do chat. A task é criada via REST (`POST /tasks`) no primeiro `send()`; o WS da task conecta em seguida. Abrir a mesma `taskId` duas vezes devolve a **mesma** instância (cache).
+Retorna uma `AgentTaskSession` que encapsula o ciclo de vida do chat. A task é criada via BFF (`POST /agentAiShortcut/createChat`) no primeiro `send()`; o WS da task conecta em seguida. Abrir a mesma `taskId` duas vezes devolve a **mesma** instância (cache).
 
 ```typescript
 import { getAgentTaskMitra } from 'mitra-interactions-sdk';
@@ -331,7 +331,9 @@ session.send('Analise estas vendas e gere um resumo');
 
 ### Credenciais do agente — `manageAgentCredentialMitra`
 
-Função única, toda HTTP. Providers: `'anthropic'`, `'openai'`, `'google'`. API key via `save`/`remove`; OAuth via `auth`/`connect`; device flow via `device_auth`/`device_poll`.
+Função única, toda HTTP **via BFF** (`/agentAiShortcut/listProviders`, `saveCredential`, `oauthStart`...). Providers: `'anthropic'`, `'openai'`, `'google'`. API key via `save`/`remove`; OAuth via `auth`/`connect`; device flow via `device_auth`/`device_poll`.
+
+**`projectId` é obrigatório** em todas as actions (opcional na chamada se já veio do `configureSdkMitra`) — é ele que define de qual app é a credencial; o BFF resolve `projectId → appId` e cunha o token de app.
 
 > 🔒 Tokens/keys nunca voltam crus — o backend devolve só status, e-mail da conta e a key mascarada.
 

package/dist/index.d.mts

@@ -222,6 +222,8 @@ interface AgentMessage {
 type ChatManageAction = 'list' | 'rename' | 'delete';
 interface ManageAgentChatListOptions {
     action: 'list';
+    /** Obrigatório (opcional na chamada se configurado via configureSdkMitra). */
+    projectId?: number | string;
     /** Filtra os chats de um agente business específico. Omitido = todos os chats. */
     agentId?: string;
     /** Inclui só arquivados (true) ou só ativos (false, default). */
@@ -237,10 +239,14 @@ interface ManageAgentChatRenameOptions {
     action: 'rename';
     taskId: string;
     name: string;
+    /** Obrigatório (opcional na chamada se configurado via configureSdkMitra). */
+    projectId?: number | string;
 }
 interface ManageAgentChatDeleteOptions {
     action: 'delete';
     taskId: string;
+    /** Obrigatório (opcional na chamada se configurado via configureSdkMitra). */
+    projectId?: number | string;
 }
 type ManageAgentChatOptions = ManageAgentChatListOptions | ManageAgentChatRenameOptions | ManageAgentChatDeleteOptions;
 interface RenameAgentChatResult {
@@ -259,8 +265,10 @@ interface DeleteAgentChatResult {
  */
 type AgentTaskTransport = 'ws' | 'http';
 interface GetAgentTaskCreateOptions {
-    /** Cria chat novo. A task é criada via REST no primeiro send(). */
+    /** Cria chat novo. A task é criada via BFF no primeiro send(). */
     create: true;
+    /** Obrigatório (opcional na chamada se configurado via configureSdkMitra). */
+    projectId?: number | string;
     /** Tipo/modelo do agente (de list_models). Default: 'ANTHROPIC_CLAUDE_OPUS'. */
     agentType?: AgentType;
     /** Nome/título do chat. */
@@ -278,6 +286,8 @@ interface GetAgentTaskCreateOptions {
 interface GetAgentTaskOpenOptions {
     /** Abre chat existente. */
     taskId: string;
+    /** Obrigatório (opcional na chamada se configurado via configureSdkMitra). */
+    projectId?: number | string;
     /** Transporte do prompt (default 'ws'). */
     transport?: AgentTaskTransport;
 }
@@ -408,32 +418,44 @@ interface DeviceAuthAgentCredentialResult {
     verificationUri: string;
     intervalSeconds: number;
 }
+/**
+ * `projectId` é obrigatório em todas as actions (opcional na chamada se já
+ * configurado via configureSdkMitra) — define de qual app é a credencial.
+ */
 type ManageAgentCredentialOptions = {
     action: 'list_providers';
+    projectId?: number | string;
 } | {
     action: 'list_models';
+    projectId?: number | string;
 } | {
     action: 'save';
     target: AgentProvider;
     key: string;
+    projectId?: number | string;
 } | {
     action: 'remove';
     target: AgentProvider;
+    projectId?: number | string;
 } | {
     action: 'auth';
     target: AgentProvider;
+    projectId?: number | string;
 } | {
     action: 'connect';
     target: AgentProvider;
     code: string;
     state: string;
+    projectId?: number | string;
 } | {
     action: 'device_auth';
     target: AgentProvider;
+    projectId?: number | string;
 } | {
     action: 'device_poll';
     target: AgentProvider;
     deviceAuthId: string;
+    projectId?: number | string;
 };
 
 /**
@@ -526,11 +548,15 @@ declare function exchangeSsoCodeMitra(options: {
 }): Promise<LoginResponse>;
 
 /**
- * Mitra Interactions SDK — Agent Chat (copilot novo mundo)
+ * Mitra Interactions SDK — Agent Chat (via BFF)
+ *
+ * REST-first, tudo pela BFF no baseURL normal (`/agentAiShortcut/*`) — herda
+ * fetchWithRefresh e o CORS do BFF. Envelope `{ status, result }`; listas vêm
+ * desembrulhadas do Page (result é o array direto).
  *
- * REST-first: chats (tasks), histórico, credenciais e modelos são HTTP no
- * gateway `{origin}/copilot/api/v1`. SÓ o prompt é streaming — WebSocket por
- * task em `{origin}/copilot/ws/tasks/{taskId}?token=JWT`.
+ * SÓ o prompt é streaming: WebSocket por task em
+ * `wss://{origin}/copilot/ws/tasks/{taskId}?token=JWT` (não passa por
+ * preflight de CORS).
  *
  * API pública:
  *   - manageAgentChatMitra({ action: 'list' | 'rename' | 'delete', ... })
@@ -538,10 +564,12 @@ declare function exchangeSsoCodeMitra(options: {
  */
 
 /**
- * Gerencia a coleção de chats do usuário — tudo HTTP:
- *   - list   → GET /copilot/api/v1/tasks (filtros: agentId, archived, search, page, size)
- *   - rename → PATCH /copilot/api/v1/tasks/{id}
- *   - delete → PATCH /copilot/api/v1/tasks/{id}/archive (arquiva; some da lista default)
+ * Gerencia a coleção de chats do usuário — tudo HTTP via BFF:
+ *   - list   → GET  /agentAiShortcut/listChats (filtros: agentId, archived, search, page, size)
+ *   - rename → POST /agentAiShortcut/renameChat
+ *   - delete → POST /agentAiShortcut/deleteChat (arquiva; some da lista default)
+ *
+ * `projectId` é obrigatório (opcional na chamada se configurado no configureSdkMitra).
  *
  * @example
  * const chats = await manageAgentChatMitra({ action: 'list' });
@@ -554,7 +582,7 @@ declare function manageAgentChatMitra(options: ManageAgentChatRenameOptions): Pr
 declare function manageAgentChatMitra(options: ManageAgentChatDeleteOptions): Promise<DeleteAgentChatResult>;
 /**
  * Abre um handle de chat (session). Use:
- *   - `{ create: true }` para iniciar um chat novo (a task é criada via REST no 1º send)
+ *   - `{ create: true }` para iniciar um chat novo (a task é criada via BFF no 1º send)
  *   - `{ taskId: 'X' }` para abrir um chat existente
  *
  * A session expõe histórico, streaming, fila, cancel e eventos. Se a
@@ -563,56 +591,71 @@ declare function manageAgentChatMitra(options: ManageAgentChatDeleteOptions): Pr
 declare function getAgentTaskMitra(options: GetAgentTaskOptions): AgentTaskSession;
 
 /**
- * Mitra Interactions SDK — Agent Credentials (copilot novo mundo)
+ * Mitra Interactions SDK — Agent Credentials (via BFF)
+ *
+ * Função ÚNICA `manageAgentCredentialMitra`, toda HTTP pela BFF no baseURL
+ * normal (`/agentAiShortcut/*`) — herda fetchWithRefresh e o CORS do BFF:
+ *   - list_providers → GET  /agentAiShortcut/listProviders?projectId=
+ *   - list_models    → GET  /agentAiShortcut/listModels?projectId=
+ *   - save           → POST /agentAiShortcut/saveCredential   {projectId, provider, key}
+ *   - remove         → POST /agentAiShortcut/removeCredential {projectId, provider}
+ *   - auth           → POST /agentAiShortcut/oauthStart       {projectId, provider}
+ *   - connect        → POST /agentAiShortcut/oauthExchange    {projectId, provider, code, state}
+ *   - device_auth    → POST /agentAiShortcut/deviceStart      {projectId, provider}
+ *   - device_poll    → POST /agentAiShortcut/devicePoll       {projectId, provider, deviceAuthId}
  *
- * Função ÚNICA `manageAgentCredentialMitra`, toda HTTP no gateway
- * `{origin}/copilot/api/v1`:
- *   - list_providers → GET  /credentials
- *   - list_models    → GET  /models
- *   - save           → PUT  /credentials/{provider}/api-key
- *   - remove         → DELETE /credentials/{provider}
- *   - auth           → POST /oauth/start           (OAuth: { authUrl, state })
- *   - connect        → POST /oauth/exchange        (OAuth: { code, state })
- *   - device_auth    → POST /credentials/{provider}/device-authorizations
- *   - device_poll    → POST /credentials/{provider}/device-authorizations/{id}/poll
+ * `projectId` é obrigatório (opcional na chamada se configurado no
+ * configureSdkMitra): é ele que define de qual app é a credencial — o BFF
+ * resolve projectId → appId e cunha o token de app.
  *
- * SEGURANÇA: tokens/keys nunca voltam crus — o backend devolve só status,
- * e-mail da conta e a key mascarada.
+ * As respostas vêm no envelope BFF `{ status, result }`; a SDK devolve o
+ * `result` cru (mesmos campos que o copilot retorna hoje, nada renomeado).
+ *
+ * SEGURANÇA: tokens/keys nunca voltam crus — só status, e-mail da conta e a
+ * key mascarada.
  */
 
 declare function manageAgentCredentialMitra(options: {
     action: 'list_providers';
+    projectId?: number | string;
 }): Promise<ListAgentProvidersResult>;
 declare function manageAgentCredentialMitra(options: {
     action: 'list_models';
+    projectId?: number | string;
 }): Promise<ListAgentModelsResult>;
 declare function manageAgentCredentialMitra(options: {
     action: 'save';
     target: AgentProvider;
     key: string;
+    projectId?: number | string;
 }): Promise<void>;
 declare function manageAgentCredentialMitra(options: {
     action: 'remove';
     target: AgentProvider;
+    projectId?: number | string;
 }): Promise<void>;
 declare function manageAgentCredentialMitra(options: {
     action: 'auth';
     target: AgentProvider;
+    projectId?: number | string;
 }): Promise<AuthAgentCredentialResult>;
 declare function manageAgentCredentialMitra(options: {
     action: 'connect';
     target: AgentProvider;
     code: string;
     state: string;
+    projectId?: number | string;
 }): Promise<ConnectAgentCredentialResult>;
 declare function manageAgentCredentialMitra(options: {
     action: 'device_auth';
     target: AgentProvider;
+    projectId?: number | string;
 }): Promise<DeviceAuthAgentCredentialResult>;
 declare function manageAgentCredentialMitra(options: {
     action: 'device_poll';
     target: AgentProvider;
     deviceAuthId: string;
+    projectId?: number | string;
 }): Promise<ConnectAgentCredentialResult>;
 
 /**

package/dist/index.d.ts

@@ -222,6 +222,8 @@ interface AgentMessage {
 type ChatManageAction = 'list' | 'rename' | 'delete';
 interface ManageAgentChatListOptions {
     action: 'list';
+    /** Obrigatório (opcional na chamada se configurado via configureSdkMitra). */
+    projectId?: number | string;
     /** Filtra os chats de um agente business específico. Omitido = todos os chats. */
     agentId?: string;
     /** Inclui só arquivados (true) ou só ativos (false, default). */
@@ -237,10 +239,14 @@ interface ManageAgentChatRenameOptions {
     action: 'rename';
     taskId: string;
     name: string;
+    /** Obrigatório (opcional na chamada se configurado via configureSdkMitra). */
+    projectId?: number | string;
 }
 interface ManageAgentChatDeleteOptions {
     action: 'delete';
     taskId: string;
+    /** Obrigatório (opcional na chamada se configurado via configureSdkMitra). */
+    projectId?: number | string;
 }
 type ManageAgentChatOptions = ManageAgentChatListOptions | ManageAgentChatRenameOptions | ManageAgentChatDeleteOptions;
 interface RenameAgentChatResult {
@@ -259,8 +265,10 @@ interface DeleteAgentChatResult {
  */
 type AgentTaskTransport = 'ws' | 'http';
 interface GetAgentTaskCreateOptions {
-    /** Cria chat novo. A task é criada via REST no primeiro send(). */
+    /** Cria chat novo. A task é criada via BFF no primeiro send(). */
     create: true;
+    /** Obrigatório (opcional na chamada se configurado via configureSdkMitra). */
+    projectId?: number | string;
     /** Tipo/modelo do agente (de list_models). Default: 'ANTHROPIC_CLAUDE_OPUS'. */
     agentType?: AgentType;
     /** Nome/título do chat. */
@@ -278,6 +286,8 @@ interface GetAgentTaskCreateOptions {
 interface GetAgentTaskOpenOptions {
     /** Abre chat existente. */
     taskId: string;
+    /** Obrigatório (opcional na chamada se configurado via configureSdkMitra). */
+    projectId?: number | string;
     /** Transporte do prompt (default 'ws'). */
     transport?: AgentTaskTransport;
 }
@@ -408,32 +418,44 @@ interface DeviceAuthAgentCredentialResult {
     verificationUri: string;
     intervalSeconds: number;
 }
+/**
+ * `projectId` é obrigatório em todas as actions (opcional na chamada se já
+ * configurado via configureSdkMitra) — define de qual app é a credencial.
+ */
 type ManageAgentCredentialOptions = {
     action: 'list_providers';
+    projectId?: number | string;
 } | {
     action: 'list_models';
+    projectId?: number | string;
 } | {
     action: 'save';
     target: AgentProvider;
     key: string;
+    projectId?: number | string;
 } | {
     action: 'remove';
     target: AgentProvider;
+    projectId?: number | string;
 } | {
     action: 'auth';
     target: AgentProvider;
+    projectId?: number | string;
 } | {
     action: 'connect';
     target: AgentProvider;
     code: string;
     state: string;
+    projectId?: number | string;
 } | {
     action: 'device_auth';
     target: AgentProvider;
+    projectId?: number | string;
 } | {
     action: 'device_poll';
     target: AgentProvider;
     deviceAuthId: string;
+    projectId?: number | string;
 };
 
 /**
@@ -526,11 +548,15 @@ declare function exchangeSsoCodeMitra(options: {
 }): Promise<LoginResponse>;
 
 /**
- * Mitra Interactions SDK — Agent Chat (copilot novo mundo)
+ * Mitra Interactions SDK — Agent Chat (via BFF)
+ *
+ * REST-first, tudo pela BFF no baseURL normal (`/agentAiShortcut/*`) — herda
+ * fetchWithRefresh e o CORS do BFF. Envelope `{ status, result }`; listas vêm
+ * desembrulhadas do Page (result é o array direto).
  *
- * REST-first: chats (tasks), histórico, credenciais e modelos são HTTP no
- * gateway `{origin}/copilot/api/v1`. SÓ o prompt é streaming — WebSocket por
- * task em `{origin}/copilot/ws/tasks/{taskId}?token=JWT`.
+ * SÓ o prompt é streaming: WebSocket por task em
+ * `wss://{origin}/copilot/ws/tasks/{taskId}?token=JWT` (não passa por
+ * preflight de CORS).
  *
  * API pública:
  *   - manageAgentChatMitra({ action: 'list' | 'rename' | 'delete', ... })
@@ -538,10 +564,12 @@ declare function exchangeSsoCodeMitra(options: {
  */
 
 /**
- * Gerencia a coleção de chats do usuário — tudo HTTP:
- *   - list   → GET /copilot/api/v1/tasks (filtros: agentId, archived, search, page, size)
- *   - rename → PATCH /copilot/api/v1/tasks/{id}
- *   - delete → PATCH /copilot/api/v1/tasks/{id}/archive (arquiva; some da lista default)
+ * Gerencia a coleção de chats do usuário — tudo HTTP via BFF:
+ *   - list   → GET  /agentAiShortcut/listChats (filtros: agentId, archived, search, page, size)
+ *   - rename → POST /agentAiShortcut/renameChat
+ *   - delete → POST /agentAiShortcut/deleteChat (arquiva; some da lista default)
+ *
+ * `projectId` é obrigatório (opcional na chamada se configurado no configureSdkMitra).
  *
  * @example
  * const chats = await manageAgentChatMitra({ action: 'list' });
@@ -554,7 +582,7 @@ declare function manageAgentChatMitra(options: ManageAgentChatRenameOptions): Pr
 declare function manageAgentChatMitra(options: ManageAgentChatDeleteOptions): Promise<DeleteAgentChatResult>;
 /**
  * Abre um handle de chat (session). Use:
- *   - `{ create: true }` para iniciar um chat novo (a task é criada via REST no 1º send)
+ *   - `{ create: true }` para iniciar um chat novo (a task é criada via BFF no 1º send)
  *   - `{ taskId: 'X' }` para abrir um chat existente
  *
  * A session expõe histórico, streaming, fila, cancel e eventos. Se a
@@ -563,56 +591,71 @@ declare function manageAgentChatMitra(options: ManageAgentChatDeleteOptions): Pr
 declare function getAgentTaskMitra(options: GetAgentTaskOptions): AgentTaskSession;
 
 /**
- * Mitra Interactions SDK — Agent Credentials (copilot novo mundo)
+ * Mitra Interactions SDK — Agent Credentials (via BFF)
+ *
+ * Função ÚNICA `manageAgentCredentialMitra`, toda HTTP pela BFF no baseURL
+ * normal (`/agentAiShortcut/*`) — herda fetchWithRefresh e o CORS do BFF:
+ *   - list_providers → GET  /agentAiShortcut/listProviders?projectId=
+ *   - list_models    → GET  /agentAiShortcut/listModels?projectId=
+ *   - save           → POST /agentAiShortcut/saveCredential   {projectId, provider, key}
+ *   - remove         → POST /agentAiShortcut/removeCredential {projectId, provider}
+ *   - auth           → POST /agentAiShortcut/oauthStart       {projectId, provider}
+ *   - connect        → POST /agentAiShortcut/oauthExchange    {projectId, provider, code, state}
+ *   - device_auth    → POST /agentAiShortcut/deviceStart      {projectId, provider}
+ *   - device_poll    → POST /agentAiShortcut/devicePoll       {projectId, provider, deviceAuthId}
  *
- * Função ÚNICA `manageAgentCredentialMitra`, toda HTTP no gateway
- * `{origin}/copilot/api/v1`:
- *   - list_providers → GET  /credentials
- *   - list_models    → GET  /models
- *   - save           → PUT  /credentials/{provider}/api-key
- *   - remove         → DELETE /credentials/{provider}
- *   - auth           → POST /oauth/start           (OAuth: { authUrl, state })
- *   - connect        → POST /oauth/exchange        (OAuth: { code, state })
- *   - device_auth    → POST /credentials/{provider}/device-authorizations
- *   - device_poll    → POST /credentials/{provider}/device-authorizations/{id}/poll
+ * `projectId` é obrigatório (opcional na chamada se configurado no
+ * configureSdkMitra): é ele que define de qual app é a credencial — o BFF
+ * resolve projectId → appId e cunha o token de app.
  *
- * SEGURANÇA: tokens/keys nunca voltam crus — o backend devolve só status,
- * e-mail da conta e a key mascarada.
+ * As respostas vêm no envelope BFF `{ status, result }`; a SDK devolve o
+ * `result` cru (mesmos campos que o copilot retorna hoje, nada renomeado).
+ *
+ * SEGURANÇA: tokens/keys nunca voltam crus — só status, e-mail da conta e a
+ * key mascarada.
  */
 
 declare function manageAgentCredentialMitra(options: {
     action: 'list_providers';
+    projectId?: number | string;
 }): Promise<ListAgentProvidersResult>;
 declare function manageAgentCredentialMitra(options: {
     action: 'list_models';
+    projectId?: number | string;
 }): Promise<ListAgentModelsResult>;
 declare function manageAgentCredentialMitra(options: {
     action: 'save';
     target: AgentProvider;
     key: string;
+    projectId?: number | string;
 }): Promise<void>;
 declare function manageAgentCredentialMitra(options: {
     action: 'remove';
     target: AgentProvider;
+    projectId?: number | string;
 }): Promise<void>;
 declare function manageAgentCredentialMitra(options: {
     action: 'auth';
     target: AgentProvider;
+    projectId?: number | string;
 }): Promise<AuthAgentCredentialResult>;
 declare function manageAgentCredentialMitra(options: {
     action: 'connect';
     target: AgentProvider;
     code: string;
     state: string;
+    projectId?: number | string;
 }): Promise<ConnectAgentCredentialResult>;
 declare function manageAgentCredentialMitra(options: {
     action: 'device_auth';
     target: AgentProvider;
+    projectId?: number | string;
 }): Promise<DeviceAuthAgentCredentialResult>;
 declare function manageAgentCredentialMitra(options: {
     action: 'device_poll';
     target: AgentProvider;
     deviceAuthId: string;
+    projectId?: number | string;
 }): Promise<ConnectAgentCredentialResult>;
 
 /**