mitra-interactions-sdk 1.0.60-beta.25 → 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**: credenciais e modelos vão pela **BFF no `baseURL` normal** (`/agentAiShortcut/*` — herdam `fetchWithRefresh` e CORS); chats e histórico via `{origin}/copilot/api/v1`. **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).
+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';

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;
 }
@@ -538,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', ... })
@@ -550,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' });
@@ -566,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

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;
 }
@@ -538,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', ... })
@@ -550,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' });
@@ -566,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