mitra-interactions-sdk 1.0.60-beta.47 → 1.0.60-beta.48

package/README.md

@@ -301,9 +301,9 @@ const existing = getAgentTaskMitra({ taskId: 'uuid-da-task' });
 await existing.loadHistory({ limit: 50 });
 ```
 
-`getAgentTaskMitra({ create: true, agentType?, name?, agentId?, reasoningEffort?, transport?, userId? })` ou `getAgentTaskMitra({ taskId, transport? })`.
+`getAgentTaskMitra({ create: true, agentType?, name?, agentId?, reasoningEffort?, autonomous?, userId?, transport? })` ou `getAgentTaskMitra({ taskId, transport? })`.
 
-**Agente autônomo**: a autonomia é **propriedade do AGENTE** (`autonomous` em `createAgentMitra`/`updateAgentMitra`, no `mitra-sdk`) — não existe flag na criação do chat. Ao criar um chat contra um agente autônomo (`getAgentTaskMitra({ create: true, agentId })`), o copilot deriva a autonomia do agente e o chat já nasce **sem dono** (`user_id NULL` — a dona é o agente), usando a connection anexada ao agente como credencial. Exige auth `AGENT_WRITE` (chave de SF ou token de app EDIT) — usuário business comum não abre chat autônomo. Depois de criado, dirigir/listar é igual ao chat normal (`getAgentTaskMitra({ taskId })`, `send`, `manageAgentChatMitra({ list, agentId })`).
+**Chat autônomo (`autonomous: true`)**: cria o chat **sem dono** (`user_id NULL` — a dona é o agente), pra Server Function/webhook/cron dirigir o agente. A autonomia é **propriedade do CHAT** — o flag `autonomous` do agente não tem mais leitor no backend. Exige `agentId` (fail-fast no client) e o agente precisa ter uma **connection anexada** como credencial (senão `400 AUTONOMOUS_TASK_REQUIRES_CONNECTION`); auth `AGENT_WRITE` (chave de SF ou token de app EDIT), senão 403. Depois de criado, dirigir/listar é igual ao chat normal (`getAgentTaskMitra({ taskId })`, `send`, `manageAgentChatMitra({ list, agentId })`). Sem o flag, comportamento de sempre (chat com dono = o caller).
 
 - `agentType` vem de `manageAgentCredentialMitra({ action: 'list_models' })` — ex.: `'ANTHROPIC_CLAUDE_OPUS'`, `'OPENAI_GPT5'`. 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`: 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`.

package/dist/index.d.mts

@@ -333,6 +333,17 @@ interface GetAgentTaskCreateOptions {
      * ela age.
      */
     userId?: string;
+    /**
+     * Cria o chat SEM dono (user_id NULL — a dona é o agente): a modalidade
+     * AUTÔNOMA, onde uma Server Function / webhook / cron dirige o agente.
+     * Exige `agentId` e o agente precisa ter uma connection anexada (é a
+     * credencial do chat); auth AGENT_WRITE (chave de SF), senão 403. Agente
+     * sem connection: 400 AUTONOMOUS_TASK_REQUIRES_CONNECTION. Mutuamente
+     * exclusivo com `userId` (400 AUTONOMOUS_TASK_HAS_NO_OWNER).
+     * Omitido = chat com dono (o caller), comportamento de sempre.
+     * A autonomia é do CHAT: o flag `autonomous` do AGENTE não tem leitor.
+     */
+    autonomous?: boolean;
     /** Transporte do prompt (default 'ws'). */
     transport?: AgentTaskTransport;
 }

package/dist/index.d.ts

@@ -333,6 +333,17 @@ interface GetAgentTaskCreateOptions {
      * ela age.
      */
     userId?: string;
+    /**
+     * Cria o chat SEM dono (user_id NULL — a dona é o agente): a modalidade
+     * AUTÔNOMA, onde uma Server Function / webhook / cron dirige o agente.
+     * Exige `agentId` e o agente precisa ter uma connection anexada (é a
+     * credencial do chat); auth AGENT_WRITE (chave de SF), senão 403. Agente
+     * sem connection: 400 AUTONOMOUS_TASK_REQUIRES_CONNECTION. Mutuamente
+     * exclusivo com `userId` (400 AUTONOMOUS_TASK_HAS_NO_OWNER).
+     * Omitido = chat com dono (o caller), comportamento de sempre.
+     * A autonomia é do CHAT: o flag `autonomous` do AGENTE não tem leitor.
+     */
+    autonomous?: boolean;
     /** Transporte do prompt (default 'ws'). */
     transport?: AgentTaskTransport;
 }

package/dist/index.js

@@ -531,6 +531,7 @@ var AgentTaskSession = class {
       this._initialName = init.name;
       this._agentId = init.agentId;
       this._reasoningEffort = init.reasoningEffort;
+      this._autonomous = init.autonomous;
       this._status = "idle";
     } else {
       this._agentType = DEFAULT_AGENT_TYPE;
@@ -620,7 +621,8 @@ var AgentTaskSession = class {
             title: this._initialName,
             agentType: this._agentType,
             agentId: this._agentId,
-            userId: this._userId
+            userId: this._userId,
+            autonomous: this._autonomous
           });
           this._task = toAgentChat(t);
           this._taskId = this._task.id;
@@ -1113,15 +1115,16 @@ async function createChatTask(options) {
     projectId: resolveProjectId(options.projectId),
     ...options.title ? { title: options.title } : {},
     agentType: options.agentType,
-    // Autonomia é propriedade do AGENTE (createAgentMitra/updateAgentMitra no
-    // mitra-sdk): o copilot deriva do agentId — o chat de agente autônomo já
-    // nasce ownerless sem flag nenhum aqui.
+    // Autonomia é propriedade do CHAT: autonomous: true cria a task SEM dono
+    // (a dona é o agente; exige connection anexada e AGENT_WRITE). O flag no
+    // AGENTE não tem mais leitor no backend.
     ...options.agentId ? { agentId: options.agentId } : {},
+    ...options.autonomous ? { autonomous: true } : {},
     // Agir EM NOME do dono (SF/webhook/cron com AGENT_WRITE): o chat nasce
     // pertencendo a esse usuário; o turno roda com a identidade/credencial
     // DELE. Ausente = chat do caller, byte a byte como sempre.
     // Erros do backend passam crus: 403 (sem AGENT_WRITE),
-    // 400 AUTONOMOUS_TASK_HAS_NO_OWNER (userId + agente autônomo é contradição).
+    // 400 AUTONOMOUS_TASK_HAS_NO_OWNER (userId + autonomous é contradição).
     ...options.userId ? { userId: options.userId } : {}
   });
   return env.result;
@@ -1198,6 +1201,9 @@ function getAgentTaskMitra(options) {
     });
   }
   if ("create" in options && options.create) {
+    if (options.autonomous && !options.agentId) {
+      throw new Error("getAgentTaskMitra: autonomous exige agentId \u2014 o chat aut\xF4nomo pertence ao agente (e o agente precisa ter uma connection anexada).");
+    }
     return new AgentTaskSession({
       kind: "new",
       projectId: options.projectId,
@@ -1206,7 +1212,8 @@ function getAgentTaskMitra(options) {
       agentId: options.agentId,
       transport: options.transport,
       reasoningEffort: options.reasoningEffort,
-      userId: options.userId
+      userId: options.userId,
+      autonomous: options.autonomous
     });
   }
   throw new Error("getAgentTaskMitra: passe { create: true } ou { taskId }.");