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

package/README.md

@@ -275,11 +275,9 @@ Retorna uma `AgentTaskSession` que encapsula o ciclo de vida do chat. A task é
 ```typescript
 import { getAgentTaskMitra } from 'mitra-interactions-sdk';
 
-// Chat novo — taskId é preenchido no primeiro send() (evento taskCreated)
-const session = getAgentTaskMitra({ create: true, agentType: 'ANTHROPIC_CLAUDE_OPUS', name: 'Meu chat' });
-
-// Chat com um agente business (system prompt + SFs do agente; token escopado)
-const sales = getAgentTaskMitra({ create: true, agentId: 'uuid-do-agente' });
+// Chat novo — SEMPRE com agentId (sessão sem agente não executa nada).
+// taskId é preenchido no primeiro send() (evento taskCreated)
+const session = getAgentTaskMitra({ create: true, agentId: 'uuid-do-agente', agentType: 'ANTHROPIC_CLAUDE_OPUS', name: 'Meu chat' });
 
 // Chat existente
 const existing = getAgentTaskMitra({ taskId: 'uuid-da-task' });
@@ -289,7 +287,7 @@ await existing.loadHistory({ limit: 50 });
 `getAgentTaskMitra({ create: true, agentType?, name?, agentId?, transport? })` ou `getAgentTaskMitra({ taskId, transport? })`.
 
 - `agentType` vem de `manageAgentCredentialMitra({ action: 'list_models' })` — ex.: `'ANTHROPIC_CLAUDE_OPUS'`, `'OPENAI_GPT5'`, `'GOOGLE_GEMINI_PRO'`. Default: `'ANTHROPIC_CLAUDE_OPUS'`.
-- **`agentId`**: id de um agente business (CRUD via `mitra-sdk`: `listAgentsMitra` e família). A sessão sobe com o system prompt do agente e um token escopado — as tools enxergam só as Server Functions dele. Sem `agentId`, é o chat de desenvolvimento.
+- **`agentId`**: id de um agente business (CRUD via `mitra-sdk`: `listAgentsMitra` e família). A sessão sobe com o system prompt do agente e um token escopado — as tools enxergam só as Server Functions dele. **Sem `agentId`: sessão business sem agente** — sem system prompt e sem acesso às Server Functions (as tools recusam); não há adoção automática de agente único. Na prática, sempre passe `agentId`.
 
 #### Propriedades (somente leitura)
 
@@ -318,7 +316,7 @@ await existing.loadHistory({ limit: 50 });
 `statusChange` · `historyLoaded` · `taskCreated` · `turnStart` · `delta` (`{ delta, kind: 'text' | 'thinking' }`) · `tool` (`{ tool, toolId?, input?, content?, phase: 'call' | 'result' }`) · `turnEnd` (`{ content }`) · `cancelled` · `queueChange` · `error` (`{ code?, error }`) · `raw` (eventos não mapeados do stream, ex.: `workspace`).
 
 ```typescript
-const session = getAgentTaskMitra({ create: true });
+const session = getAgentTaskMitra({ create: true, agentId: 'uuid-do-agente' });
 
 session.on('delta', ({ delta, kind }) => { if (kind === 'text') process.stdout.write(delta); });
 session.on('tool',  ({ tool, phase }) => console.log('🔧', phase, tool));

package/dist/index.d.mts

@@ -205,7 +205,7 @@ interface AgentChat {
     id: string;
     name: string | null;
     agentType: AgentType;
-    /** Agente business dono do chat (null = chat de desenvolvimento). */
+    /** Agente business dono do chat (null = sessão business sem agente — não executa nada). */
     agentId: string | null;
     archived: boolean;
     createdAt: string;
@@ -276,8 +276,10 @@ interface GetAgentTaskCreateOptions {
     /**
      * ID de um agente business (CRUD via mitra-sdk: listAgentsMitra e família).
      * Com agentId, a sessão sobe com o system prompt do agente e um token escopado —
-     * as tools enxergam só as Server Functions daquele agente. Sem agentId, é o
-     * chat de desenvolvimento de sempre.
+     * as tools enxergam só as Server Functions daquele agente.
+     * Sem agentId: sessão business SEM agente — sem system prompt e sem acesso às
+     * Server Functions (as tools recusam). Não há adoção automática de agente
+     * único; na prática, sempre passe agentId.
      */
     agentId?: string;
     /** Transporte do prompt (default 'ws'). */
@@ -523,29 +525,33 @@ declare function getConfig(): MitraConfig;
 declare function resolveProjectId(projectId?: number | string): number | string;
 
 /**
- * Mitra Interactions SDK - Autenticação (Router)
+ * Mitra Interactions SDK - Autenticação (Novo Mitra)
  *
- * Roteia chamadas de auth para a implementação correta com base no `authUrl`:
- * - URLs legadas (`coder.mitralab.io/sdk-auth/`, `agent.mitralab.io/sdk-auth/`) → auth-legacy.ts
- * - Qualquer outro authUrl → auth-new.ts (novo Mitra: Kong gateway + IAM service)
- *
- * A API pública é idêntica à legacy. Consumers não precisam alterar código.
+ * Implementação do auth para o novo Mitra (Kong gateway).
+ * - Email login/signup/refresh: via BFF (mitra-legacy-bff), POST {gateway}/auth/*.
+ *   O BFF resolve projectId->appId, chama o mitra-iam e já devolve o envelope
+ *   { token, baseURL, integrationURL } que a SDK consome.
+ * - SSO (Google): página atravessadora (sdk-auth.html) faz o start do OAuth e
+ *   devolve o `code` cru (popup via postMessage, redirect via #codeMitra). A SDK
+ *   troca o code por token no BFF (POST {gateway}/auth/{provider}), mesmo host do
+ *   /email/login. Provider-agnóstico: Microsoft entra só mudando a allowlist
+ *   quando o back liberar o endpoint. Suporta popup (desktop) e redirect (mobile).
  */
 
-declare function loginMitra(method: 'email' | 'google' | 'microsoft' | 'mitra', options?: LoginOptions): Promise<LoginResponse>;
-declare function loginWithGoogleMitra(options?: LoginOptions): Promise<LoginResponse>;
-declare function loginWithMicrosoftMitra(options?: LoginOptions): Promise<LoginResponse>;
-declare function refreshTokenSilently(authUrl: string, projectId: number | string): Promise<LoginResponse>;
 /**
- * Gera o JWT a partir do code do SSO (novo Mitra). O app lê codeMitra/stateMitra
- * do fragment (lógica de template) e chama aqui pra validar o nonce e trocar o
- * code por token no BFF. Exclusivo do novo mundo — no legacy o token já vem
- * pronto no fragment (tokenMitra).
+ * Gera o JWT a partir do `code` do SSO (retorno do redirect). Valida o `state`
+ * contra o nonce gerado no start (anti-CSRF), troca o code no BFF
+ * (POST {gateway}/auth/{provider}) e configura o SDK. Ler/limpar o fragment da
+ * URL é responsabilidade do app — aqui só se gera o token.
  */
 declare function exchangeSsoCodeMitra(options: {
     code: string;
     state: string;
 }): Promise<LoginResponse>;
+declare function loginWithGoogleMitra(options?: LoginOptions): Promise<LoginResponse>;
+declare function loginWithMicrosoftMitra(options?: LoginOptions): Promise<LoginResponse>;
+declare function loginMitra(method: 'email' | 'google' | 'microsoft' | 'mitra', options?: LoginOptions): Promise<LoginResponse>;
+declare function refreshTokenSilently(authUrl: string, _projectId: number | string): Promise<LoginResponse>;
 
 /**
  * Mitra Interactions SDK — Agent Chat (via BFF)

package/dist/index.d.ts

@@ -205,7 +205,7 @@ interface AgentChat {
     id: string;
     name: string | null;
     agentType: AgentType;
-    /** Agente business dono do chat (null = chat de desenvolvimento). */
+    /** Agente business dono do chat (null = sessão business sem agente — não executa nada). */
     agentId: string | null;
     archived: boolean;
     createdAt: string;
@@ -276,8 +276,10 @@ interface GetAgentTaskCreateOptions {
     /**
      * ID de um agente business (CRUD via mitra-sdk: listAgentsMitra e família).
      * Com agentId, a sessão sobe com o system prompt do agente e um token escopado —
-     * as tools enxergam só as Server Functions daquele agente. Sem agentId, é o
-     * chat de desenvolvimento de sempre.
+     * as tools enxergam só as Server Functions daquele agente.
+     * Sem agentId: sessão business SEM agente — sem system prompt e sem acesso às
+     * Server Functions (as tools recusam). Não há adoção automática de agente
+     * único; na prática, sempre passe agentId.
      */
     agentId?: string;
     /** Transporte do prompt (default 'ws'). */
@@ -523,29 +525,33 @@ declare function getConfig(): MitraConfig;
 declare function resolveProjectId(projectId?: number | string): number | string;
 
 /**
- * Mitra Interactions SDK - Autenticação (Router)
+ * Mitra Interactions SDK - Autenticação (Novo Mitra)
  *
- * Roteia chamadas de auth para a implementação correta com base no `authUrl`:
- * - URLs legadas (`coder.mitralab.io/sdk-auth/`, `agent.mitralab.io/sdk-auth/`) → auth-legacy.ts
- * - Qualquer outro authUrl → auth-new.ts (novo Mitra: Kong gateway + IAM service)
- *
- * A API pública é idêntica à legacy. Consumers não precisam alterar código.
+ * Implementação do auth para o novo Mitra (Kong gateway).
+ * - Email login/signup/refresh: via BFF (mitra-legacy-bff), POST {gateway}/auth/*.
+ *   O BFF resolve projectId->appId, chama o mitra-iam e já devolve o envelope
+ *   { token, baseURL, integrationURL } que a SDK consome.
+ * - SSO (Google): página atravessadora (sdk-auth.html) faz o start do OAuth e
+ *   devolve o `code` cru (popup via postMessage, redirect via #codeMitra). A SDK
+ *   troca o code por token no BFF (POST {gateway}/auth/{provider}), mesmo host do
+ *   /email/login. Provider-agnóstico: Microsoft entra só mudando a allowlist
+ *   quando o back liberar o endpoint. Suporta popup (desktop) e redirect (mobile).
  */
 
-declare function loginMitra(method: 'email' | 'google' | 'microsoft' | 'mitra', options?: LoginOptions): Promise<LoginResponse>;
-declare function loginWithGoogleMitra(options?: LoginOptions): Promise<LoginResponse>;
-declare function loginWithMicrosoftMitra(options?: LoginOptions): Promise<LoginResponse>;
-declare function refreshTokenSilently(authUrl: string, projectId: number | string): Promise<LoginResponse>;
 /**
- * Gera o JWT a partir do code do SSO (novo Mitra). O app lê codeMitra/stateMitra
- * do fragment (lógica de template) e chama aqui pra validar o nonce e trocar o
- * code por token no BFF. Exclusivo do novo mundo — no legacy o token já vem
- * pronto no fragment (tokenMitra).
+ * Gera o JWT a partir do `code` do SSO (retorno do redirect). Valida o `state`
+ * contra o nonce gerado no start (anti-CSRF), troca o code no BFF
+ * (POST {gateway}/auth/{provider}) e configura o SDK. Ler/limpar o fragment da
+ * URL é responsabilidade do app — aqui só se gera o token.
  */
 declare function exchangeSsoCodeMitra(options: {
     code: string;
     state: string;
 }): Promise<LoginResponse>;
+declare function loginWithGoogleMitra(options?: LoginOptions): Promise<LoginResponse>;
+declare function loginWithMicrosoftMitra(options?: LoginOptions): Promise<LoginResponse>;
+declare function loginMitra(method: 'email' | 'google' | 'microsoft' | 'mitra', options?: LoginOptions): Promise<LoginResponse>;
+declare function refreshTokenSilently(authUrl: string, _projectId: number | string): Promise<LoginResponse>;
 
 /**
  * Mitra Interactions SDK — Agent Chat (via BFF)