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

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**: 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).
 
 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).
 
@@ -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

@@ -408,32 +408,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;
 };
 
 /**
@@ -563,56 +575,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 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
+ * 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}
  *
- * SEGURANÇA: tokens/keys nunca voltam crus — o backend devolve só status,
- * e-mail da conta e a key mascarada.
+ * `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.
+ *
+ * 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

@@ -408,32 +408,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;
 };
 
 /**
@@ -563,56 +575,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 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
+ * 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}
  *
- * SEGURANÇA: tokens/keys nunca voltam crus — o backend devolve só status,
- * e-mail da conta e a key mascarada.
+ * `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.
+ *
+ * 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>;
 
 /**