mitra-interactions-sdk 1.0.60-beta.31 → 1.0.60-beta.32

package/README.md

@@ -297,7 +297,7 @@ await existing.loadHistory({ limit: 50 });
 | `task` | `AgentChat \| null` | Metadados do chat |
 | `isNew` | `boolean` | Se foi aberto via `{ create: true }` |
 | `status` | `AgentTaskStatus` | `opening` · `idle` · `streaming` · `cancelled` · `error` · `closed` |
-| `history` | `AgentMessage[]` | Histórico carregado (`{ id, sender, type, content, createdAt }`) |
+| `history` | `AgentTimelineItem[]` | Linha do tempo canônica — `{ id, kind: 'user' \| 'agent', text, at }` ou `{ id, kind: 'tool', tool: AgentToolEvent, at }` (tool já desempacotada, mesmo shape do evento do streaming) |
 | `content` | `string` | Conteúdo acumulado do turno atual |
 | `queue` | `QueuedItem[]` | Mensagens enfileiradas (enviadas enquanto streamava) |
 
@@ -306,7 +306,7 @@ await existing.loadHistory({ limit: 50 });
 - `send(prompt)` → `void` — dispara um turno (WS `message`). Se já está streamando, **enfileira** (FIFO, máx 10).
 - `cancel()` → `Promise<void>` — interrompe o turno atual (WS `interrupt`, safety net de 10s).
 - `respondApproval(approved)` → `void` — responde um pedido de aprovação do agente (WS `approval_response`).
-- `loadHistory({ limit? })` → `Promise<AgentMessage[]>` — histórico persistido via REST.
+- `loadHistory({ limit? })` → `Promise<AgentTimelineItem[]>` — histórico persistido via REST, já no formato canônico da timeline (renderizou o streaming, renderizou o histórico).
 - `editQueueItem(id, text)` / `removeQueueItem(id)` / `clearQueue()` — manipulam a fila.
 - `on(event, handler)` → função de unsubscribe — assina eventos da session.
 - `close()` — encerra a session, fecha o WS e libera os listeners.

package/dist/index.d.mts

@@ -211,20 +211,31 @@ interface AgentChat {
     createdAt: string;
     updatedAt: string;
 }
-/** Mensagem persistida (MessageResponse do copilot). */
+/** Mensagem persistida (MessageResponse do copilot), como chega do BFF. */
 interface AgentMessage {
     id: string;
     sender: 'USER' | 'AGENT' | (string & {});
     type: string;
     content: string;
     createdAt: string;
-    /**
-     * Presente só em mensagens TOOL_USE: o payload do `content` já desempacotado,
-     * no MESMO formato do evento `tool` do streaming — histórico e stream ficam
-     * iguais pra quem desenha a UI (card ao vivo e pós-F5 idênticos).
-     */
-    tool?: AgentToolEvent;
 }
+/**
+ * Item da linha do tempo do chat — o formato canônico, o MESMO que o streaming produz:
+ * um item de ferramenta carrega exatamente o payload do evento `tool`. O histórico sai
+ * da SDK já neste formato, então a UI desenha os dois com o mesmo código e não existe
+ * tradução para o app errar. Renderizou o streaming, renderizou o histórico.
+ */
+type AgentTimelineItem = {
+    id: string;
+    kind: 'user' | 'agent';
+    text: string;
+    at: string;
+} | {
+    id: string;
+    kind: 'tool';
+    tool: AgentToolEvent;
+    at: string;
+};
 type ChatManageAction = 'list' | 'rename' | 'delete';
 interface ManageAgentChatListOptions {
     action: 'list';
@@ -351,7 +362,7 @@ interface AgentRawEvent {
 interface AgentTaskEventMap {
     statusChange: AgentStatusChangeEvent;
     historyLoaded: {
-        history: AgentMessage[];
+        history: AgentTimelineItem[];
     };
     taskCreated: AgentTaskCreatedEvent;
     turnStart: Record<string, never>;
@@ -369,7 +380,7 @@ interface AgentTaskSession {
     readonly task: AgentChat | null;
     readonly isNew: boolean;
     readonly status: AgentTaskStatus;
-    readonly history: AgentMessage[];
+    readonly history: AgentTimelineItem[];
     readonly content: string;
     readonly queue: QueuedItem[];
     /** Dispara um turno (fire-and-forget; resultado via eventos). Se streaming, enfileira. */
@@ -381,7 +392,7 @@ interface AgentTaskSession {
     /** Carrega o histórico persistido (REST GET messages). */
     loadHistory(options?: {
         limit?: number;
-    }): Promise<AgentMessage[]>;
+    }): Promise<AgentTimelineItem[]>;
     editQueueItem(id: string, text: string): void;
     removeQueueItem(id: string): void;
     clearQueue(): void;
@@ -725,4 +736,4 @@ declare function patchRecordMitra(options: PatchRecordOptions): Promise<Record<s
 declare function deleteRecordMitra(options: DeleteRecordOptions): Promise<void>;
 declare function createRecordsBatchMitra(options: CreateRecordsBatchOptions): Promise<Record<string, any>[]>;
 
-export { type AgentChat, type AgentCredentialStatus, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModel, type AgentProvider, type AgentQueueChangeEvent, type AgentRawEvent, type AgentStatusChangeEvent, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentTaskTransport, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialResult, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialResult, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAction, type DeleteAgentChatResult, type DeleteRecordOptions, type DeviceAuthAgentCredentialResult, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type MitraConfig, type MitraInstance, type PatchRecordOptions, type QueuedItem, type RenameAgentChatResult, type SendOptions, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, exchangeSsoCodeMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getPublicServerFunctionExecutionMitra, getRecordMitra, listIntegrationsMitra, listRecordsMitra, loginMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, patchRecordMitra, refreshTokenSilently, resolveProjectId, stopServerFunctionExecutionMitra, updateRecordMitra };
+export { type AgentChat, type AgentCredentialStatus, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModel, type AgentProvider, type AgentQueueChangeEvent, type AgentRawEvent, type AgentStatusChangeEvent, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentTaskTransport, type AgentTimelineItem, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialResult, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialResult, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAction, type DeleteAgentChatResult, type DeleteRecordOptions, type DeviceAuthAgentCredentialResult, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type MitraConfig, type MitraInstance, type PatchRecordOptions, type QueuedItem, type RenameAgentChatResult, type SendOptions, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, exchangeSsoCodeMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getPublicServerFunctionExecutionMitra, getRecordMitra, listIntegrationsMitra, listRecordsMitra, loginMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, patchRecordMitra, refreshTokenSilently, resolveProjectId, stopServerFunctionExecutionMitra, updateRecordMitra };

package/dist/index.d.ts

@@ -211,20 +211,31 @@ interface AgentChat {
     createdAt: string;
     updatedAt: string;
 }
-/** Mensagem persistida (MessageResponse do copilot). */
+/** Mensagem persistida (MessageResponse do copilot), como chega do BFF. */
 interface AgentMessage {
     id: string;
     sender: 'USER' | 'AGENT' | (string & {});
     type: string;
     content: string;
     createdAt: string;
-    /**
-     * Presente só em mensagens TOOL_USE: o payload do `content` já desempacotado,
-     * no MESMO formato do evento `tool` do streaming — histórico e stream ficam
-     * iguais pra quem desenha a UI (card ao vivo e pós-F5 idênticos).
-     */
-    tool?: AgentToolEvent;
 }
+/**
+ * Item da linha do tempo do chat — o formato canônico, o MESMO que o streaming produz:
+ * um item de ferramenta carrega exatamente o payload do evento `tool`. O histórico sai
+ * da SDK já neste formato, então a UI desenha os dois com o mesmo código e não existe
+ * tradução para o app errar. Renderizou o streaming, renderizou o histórico.
+ */
+type AgentTimelineItem = {
+    id: string;
+    kind: 'user' | 'agent';
+    text: string;
+    at: string;
+} | {
+    id: string;
+    kind: 'tool';
+    tool: AgentToolEvent;
+    at: string;
+};
 type ChatManageAction = 'list' | 'rename' | 'delete';
 interface ManageAgentChatListOptions {
     action: 'list';
@@ -351,7 +362,7 @@ interface AgentRawEvent {
 interface AgentTaskEventMap {
     statusChange: AgentStatusChangeEvent;
     historyLoaded: {
-        history: AgentMessage[];
+        history: AgentTimelineItem[];
     };
     taskCreated: AgentTaskCreatedEvent;
     turnStart: Record<string, never>;
@@ -369,7 +380,7 @@ interface AgentTaskSession {
     readonly task: AgentChat | null;
     readonly isNew: boolean;
     readonly status: AgentTaskStatus;
-    readonly history: AgentMessage[];
+    readonly history: AgentTimelineItem[];
     readonly content: string;
     readonly queue: QueuedItem[];
     /** Dispara um turno (fire-and-forget; resultado via eventos). Se streaming, enfileira. */
@@ -381,7 +392,7 @@ interface AgentTaskSession {
     /** Carrega o histórico persistido (REST GET messages). */
     loadHistory(options?: {
         limit?: number;
-    }): Promise<AgentMessage[]>;
+    }): Promise<AgentTimelineItem[]>;
     editQueueItem(id: string, text: string): void;
     removeQueueItem(id: string): void;
     clearQueue(): void;
@@ -725,4 +736,4 @@ declare function patchRecordMitra(options: PatchRecordOptions): Promise<Record<s
 declare function deleteRecordMitra(options: DeleteRecordOptions): Promise<void>;
 declare function createRecordsBatchMitra(options: CreateRecordsBatchOptions): Promise<Record<string, any>[]>;
 
-export { type AgentChat, type AgentCredentialStatus, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModel, type AgentProvider, type AgentQueueChangeEvent, type AgentRawEvent, type AgentStatusChangeEvent, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentTaskTransport, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialResult, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialResult, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAction, type DeleteAgentChatResult, type DeleteRecordOptions, type DeviceAuthAgentCredentialResult, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type MitraConfig, type MitraInstance, type PatchRecordOptions, type QueuedItem, type RenameAgentChatResult, type SendOptions, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, exchangeSsoCodeMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getPublicServerFunctionExecutionMitra, getRecordMitra, listIntegrationsMitra, listRecordsMitra, loginMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, patchRecordMitra, refreshTokenSilently, resolveProjectId, stopServerFunctionExecutionMitra, updateRecordMitra };
+export { type AgentChat, type AgentCredentialStatus, type AgentDeltaEvent, type AgentErrorEvent, type AgentMessage, type AgentModel, type AgentProvider, type AgentQueueChangeEvent, type AgentRawEvent, type AgentStatusChangeEvent, type AgentTaskCreatedEvent, type AgentTaskEventMap, type AgentTaskEventName, type AgentTaskSession, type AgentTaskStatus, type AgentTaskTransport, type AgentTimelineItem, type AgentToolEvent, type AgentTurnEndEvent, type AgentType, type AuthAgentCredentialResult, type CallIntegrationOptions, type CallIntegrationResponse, type ChatManageAction, type ConnectAgentCredentialResult, type CreateRecordOptions, type CreateRecordsBatchOptions, type CredentialAction, type DeleteAgentChatResult, type DeleteRecordOptions, type DeviceAuthAgentCredentialResult, type ExecutePublicServerFunctionAsyncResponse, type ExecutePublicServerFunctionOptions, type ExecutePublicServerFunctionResponse, type ExecuteServerFunctionAsyncOptions, type ExecuteServerFunctionAsyncResponse, type ExecuteServerFunctionOptions, type ExecuteServerFunctionResponse, type GetAgentTaskCreateOptions, type GetAgentTaskOpenOptions, type GetAgentTaskOptions, type GetPublicServerFunctionExecutionOptions, type GetPublicServerFunctionExecutionResponse, type GetRecordOptions, type IntegrationResponse, type ListAgentModelsResult, type ListAgentProvidersResult, type ListIntegrationsOptions, type ListRecordsOptions, type ListRecordsResponse, type LoginOptions, type LoginResponse, type ManageAgentChatDeleteOptions, type ManageAgentChatListOptions, type ManageAgentChatOptions, type ManageAgentChatRenameOptions, type ManageAgentCredentialOptions, type MitraConfig, type MitraInstance, type PatchRecordOptions, type QueuedItem, type RenameAgentChatResult, type SendOptions, type StopServerFunctionExecutionOptions, type StopServerFunctionExecutionResponse, type UpdateRecordOptions, callIntegrationMitra, configureSdkMitra, createMitraInstance, createRecordMitra, createRecordsBatchMitra, deleteRecordMitra, exchangeSsoCodeMitra, executePublicServerFunctionAsyncMitra, executePublicServerFunctionMitra, executeServerFunctionAsyncMitra, executeServerFunctionMitra, getAgentTaskMitra, getConfig, getPublicServerFunctionExecutionMitra, getRecordMitra, listIntegrationsMitra, listRecordsMitra, loginMitra, loginWithGoogleMitra, loginWithMicrosoftMitra, manageAgentChatMitra, manageAgentCredentialMitra, patchRecordMitra, refreshTokenSilently, resolveProjectId, stopServerFunctionExecutionMitra, updateRecordMitra };

package/dist/index.js

@@ -593,11 +593,8 @@ var AgentTaskSession = class {
   }
   async loadHistory(options) {
     if (!this._taskId) return [];
-    const history = await listChatMessages(this._taskId, this._projectId, { size: options == null ? void 0 : options.limit });
-    this._history = history.map((message) => {
-      const tool = toToolEvent(message);
-      return tool ? { ...message, tool } : message;
-    });
+    const messages = await listChatMessages(this._taskId, this._projectId, { size: options == null ? void 0 : options.limit });
+    this._history = messages.map((message) => toTimelineItem(message));
     this._emit("historyLoaded", { history: this._history });
     return this._history;
   }
@@ -828,9 +825,18 @@ function errMsg(err) {
   if (err && typeof err === "object" && "message" in err) return String(err.message);
   return String(err);
 }
+function toTimelineItem(message) {
+  const tool = message.type === "TOOL_USE" ? toToolEvent(message) : null;
+  if (tool) return { id: message.id, kind: "tool", tool, at: message.createdAt };
+  return {
+    id: message.id,
+    kind: message.sender === "USER" ? "user" : "agent",
+    text: message.content,
+    at: message.createdAt
+  };
+}
 function toToolEvent(message) {
   var _a, _b;
-  if (message.type !== "TOOL_USE") return null;
   let payload;
   try {
     payload = JSON.parse(message.content);