mitra-interactions-sdk 1.0.60-beta.34 → 1.0.60-beta.35

package/README.md

@@ -284,7 +284,9 @@ const existing = getAgentTaskMitra({ taskId: 'uuid-da-task' });
 await existing.loadHistory({ limit: 50 });
 ```
 
-`getAgentTaskMitra({ create: true, agentType?, name?, agentId?, transport? })` ou `getAgentTaskMitra({ taskId, transport? })`.
+`getAgentTaskMitra({ create: true, agentType?, name?, agentId?, reasoningEffort?, autonomous?, transport? })` ou `getAgentTaskMitra({ taskId, transport? })`.
+
+**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. Exige `agentId` (fail-fast no client) e o agente precisa ter uma **connection anexada** como credencial; 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). ⚠️ Depende do backend `impl-autonomous` — antes dele o servidor ignora o flag.
 
 - `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

@@ -305,6 +305,16 @@ interface GetAgentTaskCreateOptions {
      * único; na prática, sempre passe agentId.
      */
     agentId?: 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 (credencial);
+     * auth AGENT_WRITE (chave de SF ou token de app EDIT), senão 403.
+     * Omitido = chat com dono (o caller), comportamento de sempre.
+     * ATENÇÃO: depende do backend impl-autonomous — antes dele o servidor
+     * ignora o flag e cria chat com dono normalmente.
+     */
+    autonomous?: boolean;
     /** Transporte do prompt (default 'ws'). */
     transport?: AgentTaskTransport;
 }

package/dist/index.d.ts

@@ -305,6 +305,16 @@ interface GetAgentTaskCreateOptions {
      * único; na prática, sempre passe agentId.
      */
     agentId?: 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 (credencial);
+     * auth AGENT_WRITE (chave de SF ou token de app EDIT), senão 403.
+     * Omitido = chat com dono (o caller), comportamento de sempre.
+     * ATENÇÃO: depende do backend impl-autonomous — antes dele o servidor
+     * ignora o flag e cria chat com dono normalmente.
+     */
+    autonomous?: boolean;
     /** Transporte do prompt (default 'ws'). */
     transport?: AgentTaskTransport;
 }

package/dist/index.js

@@ -486,6 +486,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;
@@ -571,7 +572,8 @@ var AgentTaskSession = class {
             projectId: this._projectId,
             title: this._initialName,
             agentType: this._agentType,
-            agentId: this._agentId
+            agentId: this._agentId,
+            autonomous: this._autonomous
           });
           this._task = toAgentChat(t);
           this._taskId = this._task.id;
@@ -1045,7 +1047,10 @@ async function createChatTask(options) {
     projectId: resolveProjectId(options.projectId),
     ...options.title ? { title: options.title } : {},
     agentType: options.agentType,
-    ...options.agentId ? { agentId: options.agentId } : {}
+    ...options.agentId ? { agentId: options.agentId } : {},
+    // Chat autônomo (sem dono; exige agentId + connection no agente).
+    // Só entra no body quando informado — sem o flag, byte a byte como sempre.
+    ...options.autonomous ? { autonomous: true } : {}
   });
   return env.result;
 }
@@ -1119,6 +1124,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,
@@ -1126,7 +1134,8 @@ function getAgentTaskMitra(options) {
       name: options.name,
       agentId: options.agentId,
       transport: options.transport,
-      reasoningEffort: options.reasoningEffort
+      reasoningEffort: options.reasoningEffort,
+      autonomous: options.autonomous
     });
   }
   throw new Error("getAgentTaskMitra: passe { create: true } ou { taskId }.");