mitra-interactions-sdk 1.0.60-beta.43 → 1.0.60-beta.45

package/README.md

@@ -301,7 +301,7 @@ 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?, userId? })`.
+`getAgentTaskMitra({ create: true, agentType?, name?, agentId?, reasoningEffort?, transport?, userId? })` 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 })`).
 
@@ -313,11 +313,11 @@ await existing.loadHistory({ limit: 50 });
 ```typescript
 // SF reagindo a webhook: continua a thread da pessoa atendida
 const task = getAgentTaskMitra({ create: true, agentId, userId: 'uuid-do-usuario' }); // chat nasce DELE
-const dela = await manageAgentChatMitra({ action: 'list', userId: 'uuid-do-usuario' }); // chats DELA
-const mesma = getAgentTaskMitra({ taskId, userId: 'uuid-do-usuario' }); // defensivo: 404 se o chat não for dela
+const dela = await manageAgentChatMitra({ action: 'list', userId: 'uuid-do-usuario' }); // chats DELA (debug/observabilidade)
+const mesma = getAgentTaskMitra({ taskId }); // depois do create, SÓ taskId — o dono é inferido dele
 ```
 
-Erros nomeados: `403` sem `AGENT_WRITE`; `400 AUTONOMOUS_TASK_HAS_NO_OWNER` (userId + agente autônomo é contradição); `404` quando o `userId` defensivo não bate com o dono real. Nunca invente `userId` de texto do usuário — use o id do vínculo canal→usuário da sua aplicação.
+**`userId` é atributo do CHAT, não argumento das operações**: só o `create` (e o `list`, pra observabilidade) aceitam — prompt, histórico, eventos e `readChat` continuam só com `taskId`, e o backend não aceita `userId` neles. Erros nomeados: `403` sem `AGENT_WRITE`; `400 AUTONOMOUS_TASK_HAS_NO_OWNER` (userId + agente autônomo é contradição); `400 ANONYMOUS_CALLER_REQUIRES_OWNER` (contexto anônimo criando chat de agente normal exige userId). Nunca invente `userId` de texto do usuário — use o id do vínculo canal→usuário da sua aplicação.
 
 #### Propriedades (somente leitura)
 

package/dist/index.d.mts

@@ -327,6 +327,10 @@ interface GetAgentTaskCreateOptions {
      * texto — use o id que a aplicação já tem no vínculo canal→usuário.
      * Omitido = chat do caller, byte a byte como sempre.
      * Com agente AUTÔNOMO é contradição: 400 AUTONOMOUS_TASK_HAS_NO_OWNER.
+     * Em contexto ANÔNIMO (SF sem identidade própria, ex.: SF pública), criar
+     * chat de agente NORMAL EXIGE userId: 400 ANONYMOUS_CALLER_REQUIRES_OWNER
+     * sem ele — a execução anônima não tem identidade própria, nomeie por quem
+     * ela age.
      */
     userId?: string;
     /** Transporte do prompt (default 'ws'). */
@@ -339,12 +343,6 @@ interface GetAgentTaskOpenOptions {
     projectId?: number | string;
     /** Transporte do prompt (default 'ws'). */
     transport?: AgentTaskTransport;
-    /**
-     * Validação defensiva ao agir em nome do dono (AGENT_WRITE): viaja no
-     * readChat e nos inputs — o backend devolve 404 se o chat não pertencer a
-     * esse usuário. Omitido = contexto do caller.
-     */
-    userId?: string;
 }
 type GetAgentTaskOptions = GetAgentTaskCreateOptions | GetAgentTaskOpenOptions;
 type AgentTaskStatus = 'opening' | 'idle' | 'streaming' | 'cancelled' | 'error' | 'closed';

package/dist/index.d.ts

@@ -327,6 +327,10 @@ interface GetAgentTaskCreateOptions {
      * texto — use o id que a aplicação já tem no vínculo canal→usuário.
      * Omitido = chat do caller, byte a byte como sempre.
      * Com agente AUTÔNOMO é contradição: 400 AUTONOMOUS_TASK_HAS_NO_OWNER.
+     * Em contexto ANÔNIMO (SF sem identidade própria, ex.: SF pública), criar
+     * chat de agente NORMAL EXIGE userId: 400 ANONYMOUS_CALLER_REQUIRES_OWNER
+     * sem ele — a execução anônima não tem identidade própria, nomeie por quem
+     * ela age.
      */
     userId?: string;
     /** Transporte do prompt (default 'ws'). */
@@ -339,12 +343,6 @@ interface GetAgentTaskOpenOptions {
     projectId?: number | string;
     /** Transporte do prompt (default 'ws'). */
     transport?: AgentTaskTransport;
-    /**
-     * Validação defensiva ao agir em nome do dono (AGENT_WRITE): viaja no
-     * readChat e nos inputs — o backend devolve 404 se o chat não pertencer a
-     * esse usuário. Omitido = contexto do caller.
-     */
-    userId?: string;
 }
 type GetAgentTaskOptions = GetAgentTaskCreateOptions | GetAgentTaskOpenOptions;
 type AgentTaskStatus = 'opening' | 'idle' | 'streaming' | 'cancelled' | 'error' | 'closed';

package/dist/index.js

@@ -360,14 +360,15 @@ async function tryRefreshToken() {
   }
 }
 async function handleResponse(response) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e;
   const text = await response.text();
   const { data, isJson } = parseBody(text);
   if (!response.ok) {
     const fallback = !isJson && text ? `HTTP ${response.status} \u2014 ${text}` : `HTTP ${response.status}`;
-    const base = isJson && ((data == null ? void 0 : data.message) || ((_a = data == null ? void 0 : data.error) == null ? void 0 : _a.message) || (data == null ? void 0 : data.error)) || fallback;
+    const rawMsg = data == null ? void 0 : data.message;
+    const base = isJson && (typeof rawMsg === "string" && rawMsg || rawMsg && typeof rawMsg === "object" && typeof rawMsg.message === "string" && rawMsg.message || typeof ((_a = data == null ? void 0 : data.error) == null ? void 0 : _a.message) === "string" && data.error.message || typeof (data == null ? void 0 : data.error) === "string" && data.error) || fallback;
     const msg = isJson && (data == null ? void 0 : data.hint) ? `${base} \u2014 ${data.hint}` : base;
-    const code = isJson && ((_d = (_c = data == null ? void 0 : data.error_code) != null ? _c : (_b = data == null ? void 0 : data.error) == null ? void 0 : _b.code) != null ? _d : data == null ? void 0 : data.code) || void 0;
+    const code = isJson && ((_e = (_d = (_c = data == null ? void 0 : data.error_code) != null ? _c : (_b = data == null ? void 0 : data.error) == null ? void 0 : _b.code) != null ? _d : data == null ? void 0 : data.code) != null ? _e : rawMsg && typeof rawMsg === "object" ? rawMsg.code : void 0) || void 0;
     throw {
       message: typeof msg === "string" ? msg : fallback,
       status: response.status,
@@ -504,8 +505,8 @@ var AgentTaskSession = class {
     this._isNew = init.kind === "new";
     this._transport = (_a = init.transport) != null ? _a : "ws";
     this._projectId = init.projectId;
-    this._userId = init.userId;
     if (init.kind === "new") {
+      this._userId = init.userId;
       this._agentType = (_b = init.agentType) != null ? _b : DEFAULT_AGENT_TYPE;
       this._initialName = init.name;
       this._agentId = init.agentId;
@@ -543,14 +544,14 @@ var AgentTaskSession = class {
   // ── Abertura de chat existente ─────────
   async _openExisting(taskId) {
     try {
-      const t = await readChatTask(taskId, this._projectId, this._userId);
+      const t = await readChatTask(taskId, this._projectId);
       this._task = toAgentChat(t);
       this._agentType = this._task.agentType;
       if (this._status === "opening") this._setStatus("idle");
       if (this._transport === "http") await this._ensureSse();
       else await this._ensureWs();
     } catch (err) {
-      this._emit("error", { error: `Falha ao abrir chat: ${errMsg(err)}` });
+      this._emit("error", { ...errCode(err) ? { code: errCode(err) } : {}, error: `Falha ao abrir chat: ${errMsg(err)}` });
       this._setStatus("error");
     }
   }
@@ -624,7 +625,7 @@ var AgentTaskSession = class {
         ws.send(JSON.stringify(input));
       }
     } catch (err) {
-      this._emit("error", { error: `Falha ao enviar prompt: ${errMsg(err)}` });
+      this._emit("error", { ...errCode(err) ? { code: errCode(err) } : {}, error: `Falha ao enviar prompt: ${errMsg(err)}` });
       if (this._status === "streaming") this._setStatus("idle");
     }
   }
@@ -645,13 +646,13 @@ var AgentTaskSession = class {
         if (this._status === "cancelled") this._setStatus("idle");
       }, CANCEL_SAFETY_MS);
     } catch (err) {
-      this._emit("error", { error: `Falha ao cancelar: ${errMsg(err)}` });
+      this._emit("error", { ...errCode(err) ? { code: errCode(err) } : {}, error: `Falha ao cancelar: ${errMsg(err)}` });
     }
   }
   respondApproval(approved) {
     if (this._transport === "http") {
       void this._postInput({ type: "approval_response", approved }).catch((err) => {
-        this._emit("error", { error: `Falha ao aprovar: ${errMsg(err)}` });
+        this._emit("error", { ...errCode(err) ? { code: errCode(err) } : {}, error: `Falha ao aprovar: ${errMsg(err)}` });
       });
       return;
     }
@@ -747,7 +748,6 @@ var AgentTaskSession = class {
       throw new Error("AgentTaskSession: sem taskId \u2014 task ainda n\xE3o criada.");
     }
     if (isTokenExpiring()) await tryRefreshToken();
-    const payload = this._userId ? { ...body, userId: this._userId } : body;
     const doPost = async () => fetch(
       `${getTaskHttpBase()}/${encodeURIComponent(this._taskId)}/inputs`,
       {
@@ -756,7 +756,7 @@ var AgentTaskSession = class {
           "Content-Type": "application/json",
           Authorization: `Bearer ${getRawToken()}`
         },
-        body: JSON.stringify(payload)
+        body: JSON.stringify(body)
       }
     );
     let res = await doPost();
@@ -997,9 +997,27 @@ var AgentTaskSession = class {
 };
 function errMsg(err) {
   if (err instanceof Error) return err.message;
-  if (err && typeof err === "object" && "message" in err) return String(err.message);
+  if (err && typeof err === "object" && "message" in err) {
+    const m = err.message;
+    if (typeof m === "string") return m;
+    if (m && typeof m === "object") {
+      if (typeof m.message === "string") return m.code ? `${m.code}: ${m.message}` : m.message;
+      try {
+        return JSON.stringify(m);
+      } catch (e) {
+        return String(m);
+      }
+    }
+    return String(m);
+  }
   return String(err);
 }
+function errCode(err) {
+  var _a, _b, _c, _d, _e, _f, _g;
+  if (!err || typeof err !== "object") return void 0;
+  const e = err;
+  return (_g = (_f = (_d = (_b = e.code) != null ? _b : (_a = e.message) == null ? void 0 : _a.code) != null ? _d : (_c = e.details) == null ? void 0 : _c.code) != null ? _f : (_e = e.details) == null ? void 0 : _e.error_code) != null ? _g : void 0;
+}
 function toTimelineItem(message) {
   const tool = message.type === "TOOL_USE" ? toToolEvent(message) : null;
   if (tool) return { id: message.id, kind: "tool", tool, at: message.createdAt };
@@ -1088,13 +1106,10 @@ async function createChatTask(options) {
   });
   return env.result;
 }
-async function readChatTask(taskId, projectId, userId) {
+async function readChatTask(taskId, projectId) {
   const env = await http.get("/agentAiShortcut/readChat", {
     projectId: resolveProjectId(projectId),
-    taskId,
-    // Validação defensiva: com userId, o backend devolve 404 se o chat não
-    // pertencer àquele dono.
-    ...userId ? { userId } : {}
+    taskId
   });
   return env.result;
 }
@@ -1159,8 +1174,7 @@ function getAgentTaskMitra(options) {
       kind: "existing",
       taskId: options.taskId,
       projectId: options.projectId,
-      transport: options.transport,
-      userId: options.userId
+      transport: options.transport
     });
   }
   if ("create" in options && options.create) {