feat: add EventMessage and SummaryMessage

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 116
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-5e2b43d01a648728988fce726a3216e62d8b73da57e1c22e50a139f77e082138.yml
-openapi_spec_hash: c68331ebc8bf79542c86beb7f255733a
-config_hash: 02919e952ec8fd38c627a7a6f05bfba6
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/letta-ai%2Fletta-sdk-5cedce898d7fbee9a207d77316f5a96e83bd2c632c8fca648a3183cbbf02c366.yml
+openapi_spec_hash: 1443e121d7511c03181017322a0d486a
+config_hash: 914d2d19bdd46d60eeaf03a4c52992e6

api.md

@@ -198,6 +198,7 @@ Types:
 - <code><a href="./src/resources/agents/messages.ts">ApprovalRequestMessage</a></code>
 - <code><a href="./src/resources/agents/messages.ts">ApprovalResponseMessage</a></code>
 - <code><a href="./src/resources/agents/messages.ts">AssistantMessage</a></code>
+- <code><a href="./src/resources/agents/messages.ts">EventMessage</a></code>
 - <code><a href="./src/resources/agents/messages.ts">HiddenReasoningMessage</a></code>
 - <code><a href="./src/resources/agents/messages.ts">ImageContent</a></code>
 - <code><a href="./src/resources/agents/messages.ts">JobStatus</a></code>
@@ -217,6 +218,7 @@ Types:
 - <code><a href="./src/resources/agents/messages.ts">ReasoningMessage</a></code>
 - <code><a href="./src/resources/agents/messages.ts">RedactedReasoningContent</a></code>
 - <code><a href="./src/resources/agents/messages.ts">Run</a></code>
+- <code><a href="./src/resources/agents/messages.ts">SummaryMessage</a></code>
 - <code><a href="./src/resources/agents/messages.ts">SystemMessage</a></code>
 - <code><a href="./src/resources/agents/messages.ts">TextContent</a></code>
 - <code><a href="./src/resources/agents/messages.ts">ToolCall</a></code>

src/resources/agents/agents.ts

@@ -43,6 +43,7 @@ import {
   ApprovalRequestMessage,
   ApprovalResponseMessage,
   AssistantMessage,
+  EventMessage,
   HiddenReasoningMessage,
   ImageContent,
   JobStatus,
@@ -73,6 +74,7 @@ import {
   ReasoningMessage,
   RedactedReasoningContent,
   Run,
+  SummaryMessage,
   SystemMessage,
   TextContent,
   ToolCall,
@@ -1735,6 +1737,7 @@ export declare namespace Agents {
     type ApprovalRequestMessage as ApprovalRequestMessage,
     type ApprovalResponseMessage as ApprovalResponseMessage,
     type AssistantMessage as AssistantMessage,
+    type EventMessage as EventMessage,
     type HiddenReasoningMessage as HiddenReasoningMessage,
     type ImageContent as ImageContent,
     type JobStatus as JobStatus,
@@ -1754,6 +1757,7 @@ export declare namespace Agents {
     type ReasoningMessage as ReasoningMessage,
     type RedactedReasoningContent as RedactedReasoningContent,
     type Run as Run,
+    type SummaryMessage as SummaryMessage,
     type SystemMessage as SystemMessage,
     type TextContent as TextContent,
     type ToolCall as ToolCall,

src/resources/agents/index.ts

@@ -66,6 +66,7 @@ export {
   type ApprovalRequestMessage,
   type ApprovalResponseMessage,
   type AssistantMessage,
+  type EventMessage,
   type HiddenReasoningMessage,
   type ImageContent,
   type JobStatus,
@@ -85,6 +86,7 @@ export {
   type ReasoningMessage,
   type RedactedReasoningContent,
   type Run,
+  type SummaryMessage,
   type SystemMessage,
   type TextContent,
   type ToolCall,

src/resources/agents/messages.ts

@@ -330,6 +330,36 @@ export interface AssistantMessage {
   step_id?: string | null;
 }
 
+/**
+ * A message for notifying the developer that an event that has occured (e.g. a
+ * compaction). Events are NOT part of the context window.
+ */
+export interface EventMessage {
+  id: string;
+
+  date: string;
+
+  event_data: { [key: string]: unknown };
+
+  event_type: 'compaction';
+
+  is_err?: boolean | null;
+
+  message_type?: 'event';
+
+  name?: string | null;
+
+  otid?: string | null;
+
+  run_id?: string | null;
+
+  sender_id?: string | null;
+
+  seq_id?: number | null;
+
+  step_id?: string | null;
+}
+
 /**
  * Representation of an agent's internal reasoning where reasoning content has been
  * hidden from the response.
@@ -487,7 +517,9 @@ export type LettaMessageUnion =
   | ToolsAPI.ToolReturnMessage
   | AssistantMessage
   | ApprovalRequestMessage
-  | ApprovalResponseMessage;
+  | ApprovalResponseMessage
+  | SummaryMessage
+  | EventMessage;
 
 export interface LettaRequest {
   /**
@@ -1283,6 +1315,34 @@ export namespace Run {
   }
 }
 
+/**
+ * A message representing a summary of the conversation. Sent to the LLM as a user
+ * or system message depending on the provider.
+ */
+export interface SummaryMessage {
+  id: string;
+
+  date: string;
+
+  summary: string;
+
+  is_err?: boolean | null;
+
+  message_type?: 'summary';
+
+  name?: string | null;
+
+  otid?: string | null;
+
+  run_id?: string | null;
+
+  sender_id?: string | null;
+
+  seq_id?: number | null;
+
+  step_id?: string | null;
+}
+
 /**
  * A message generated by the system. Never streamed back on a response, only used
  * for cursor pagination.
@@ -1557,7 +1617,9 @@ export type MessageModifyResponse =
   | ToolsAPI.ToolReturnMessage
   | AssistantMessage
   | ApprovalRequestMessage
-  | ApprovalResponseMessage;
+  | ApprovalResponseMessage
+  | SummaryMessage
+  | EventMessage;
 
 export interface MessageListParams extends ArrayPageParams {
   /**
@@ -1840,6 +1902,7 @@ export declare namespace Messages {
     type ApprovalRequestMessage as ApprovalRequestMessage,
     type ApprovalResponseMessage as ApprovalResponseMessage,
     type AssistantMessage as AssistantMessage,
+    type EventMessage as EventMessage,
     type HiddenReasoningMessage as HiddenReasoningMessage,
     type ImageContent as ImageContent,
     type JobStatus as JobStatus,
@@ -1859,6 +1922,7 @@ export declare namespace Messages {
     type ReasoningMessage as ReasoningMessage,
     type RedactedReasoningContent as RedactedReasoningContent,
     type Run as Run,
+    type SummaryMessage as SummaryMessage,
     type SystemMessage as SystemMessage,
     type TextContent as TextContent,
     type ToolCall as ToolCall,

src/resources/groups/messages.ts

@@ -95,7 +95,9 @@ export type MessageModifyResponse =
   | ToolsAPI.ToolReturnMessage
   | MessagesAPI.AssistantMessage
   | MessagesAPI.ApprovalRequestMessage
-  | MessagesAPI.ApprovalResponseMessage;
+  | MessagesAPI.ApprovalResponseMessage
+  | MessagesAPI.SummaryMessage
+  | MessagesAPI.EventMessage;
 
 export type MessageResetResponse = unknown;
 

src/resources/steps/messages.ts

@@ -42,7 +42,9 @@ export type MessageListResponse =
   | ToolsAPI.ToolReturnMessage
   | MessagesAPI.AssistantMessage
   | MessagesAPI.ApprovalRequestMessage
-  | MessagesAPI.ApprovalResponseMessage;
+  | MessagesAPI.ApprovalResponseMessage
+  | MessagesAPI.SummaryMessage
+  | MessagesAPI.EventMessage;
 
 export interface MessageListParams extends ArrayPageParams {}