@letta-ai/letta-client 1.0.0-alpha.6 → 1.0.0-alpha.7

package/src/resources/groups/messages.ts

@@ -1,9 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as ToolsAPI from '../tools';
 import * as AgentsAPI from '../agents/agents';
 import * as MessagesAPI from '../agents/messages';
-import * as ToolsAPI from '../tools/tools';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -32,6 +32,13 @@ export class Messages extends APIResource {
     return this._client.get(path`/v1/groups/${groupID}/messages`, { query, ...options });
   }
 
+  /**
+   * Delete the group messages for all agents that are part of the multi-agent group.
+   */
+  reset(groupID: string, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.patch(path`/v1/groups/${groupID}/reset-messages`, options);
+  }
+
   /**
    * Process a user message and return the group's response. This endpoint accepts a
    * message from a user and processes it through through agents in the group based
@@ -51,7 +58,7 @@ export class Messages extends APIResource {
    * specified pattern. It will stream the steps of the response always, and stream
    * the tokens if 'stream_tokens' is set to True.
    */
-  sendStream(groupID: string, body: MessageSendStreamParams, options?: RequestOptions): APIPromise<unknown> {
+  stream(groupID: string, body: MessageStreamParams, options?: RequestOptions): APIPromise<unknown> {
     return this._client.post(path`/v1/groups/${groupID}/messages/stream`, { body, ...options });
   }
 }
@@ -77,7 +84,9 @@ export type MessageUpdateResponse =
 
 export type MessageListResponse = Array<MessagesAPI.LettaMessageUnion>;
 
-export type MessageSendStreamResponse = unknown;
+export type MessageResetResponse = unknown;
+
+export type MessageStreamResponse = unknown;
 
 export type MessageUpdateParams =
   | MessageUpdateParams.UpdateSystemMessage
@@ -88,7 +97,7 @@ export type MessageUpdateParams =
 export declare namespace MessageUpdateParams {
   export interface UpdateSystemMessage {
     /**
-     * Path param:
+     * Path param: The ID of the group in the format 'group-<uuid4>'
      */
     group_id: string;
 
@@ -106,7 +115,7 @@ export declare namespace MessageUpdateParams {
 
   export interface UpdateUserMessage {
     /**
-     * Path param:
+     * Path param: The ID of the group in the format 'group-<uuid4>'
      */
     group_id: string;
 
@@ -124,7 +133,7 @@ export declare namespace MessageUpdateParams {
 
   export interface UpdateReasoningMessage {
     /**
-     * Path param:
+     * Path param: The ID of the group in the format 'group-<uuid4>'
      */
     group_id: string;
 
@@ -141,7 +150,7 @@ export declare namespace MessageUpdateParams {
 
   export interface UpdateAssistantMessage {
     /**
-     * Path param:
+     * Path param: The ID of the group in the format 'group-<uuid4>'
      */
     group_id: string;
 
@@ -166,12 +175,12 @@ export interface MessageListParams {
   after?: string | null;
 
   /**
-   * The name of the message argument.
+   * @deprecated The name of the message argument.
    */
   assistant_message_tool_kwarg?: string;
 
   /**
-   * The name of the designated message tool.
+   * @deprecated The name of the designated message tool.
    */
   assistant_message_tool_name?: string;
 
@@ -198,7 +207,7 @@ export interface MessageListParams {
   order_by?: 'created_at';
 
   /**
-   * Whether to use assistant messages
+   * @deprecated Whether to use assistant messages
    */
   use_assistant_message?: boolean;
 }
@@ -210,17 +219,21 @@ export interface MessageSendParams {
   messages: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate>;
 
   /**
-   * The name of the message argument in the designated message tool.
+   * @deprecated The name of the message argument in the designated message tool.
+   * Still supported for legacy agent types, but deprecated for letta_v1_agent
+   * onward.
    */
   assistant_message_tool_kwarg?: string;
 
   /**
-   * The name of the designated message tool.
+   * @deprecated The name of the designated message tool. Still supported for legacy
+   * agent types, but deprecated for letta_v1_agent onward.
    */
   assistant_message_tool_name?: string;
 
   /**
-   * If set to True, enables reasoning before responses or tool calls from the agent.
+   * @deprecated If set to True, enables reasoning before responses or tool calls
+   * from the agent.
    */
   enable_thinking?: string;
 
@@ -236,25 +249,29 @@ export interface MessageSendParams {
   max_steps?: number;
 
   /**
-   * Whether the server should parse specific tool call arguments (default
-   * `send_message`) as `AssistantMessage` objects.
+   * @deprecated Whether the server should parse specific tool call arguments
+   * (default `send_message`) as `AssistantMessage` objects. Still supported for
+   * legacy agent types, but deprecated for letta_v1_agent onward.
    */
   use_assistant_message?: boolean;
 }
 
-export interface MessageSendStreamParams {
+export interface MessageStreamParams {
   /**
    * The messages to be sent to the agent.
    */
   messages: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate>;
 
   /**
-   * The name of the message argument in the designated message tool.
+   * @deprecated The name of the message argument in the designated message tool.
+   * Still supported for legacy agent types, but deprecated for letta_v1_agent
+   * onward.
    */
   assistant_message_tool_kwarg?: string;
 
   /**
-   * The name of the designated message tool.
+   * @deprecated The name of the designated message tool. Still supported for legacy
+   * agent types, but deprecated for letta_v1_agent onward.
    */
   assistant_message_tool_name?: string;
 
@@ -264,7 +281,8 @@ export interface MessageSendStreamParams {
   background?: boolean;
 
   /**
-   * If set to True, enables reasoning before responses or tool calls from the agent.
+   * @deprecated If set to True, enables reasoning before responses or tool calls
+   * from the agent.
    */
   enable_thinking?: string;
 
@@ -292,8 +310,9 @@ export interface MessageSendStreamParams {
   stream_tokens?: boolean;
 
   /**
-   * Whether the server should parse specific tool call arguments (default
-   * `send_message`) as `AssistantMessage` objects.
+   * @deprecated Whether the server should parse specific tool call arguments
+   * (default `send_message`) as `AssistantMessage` objects. Still supported for
+   * legacy agent types, but deprecated for letta_v1_agent onward.
    */
   use_assistant_message?: boolean;
 }
@@ -302,10 +321,11 @@ export declare namespace Messages {
   export {
     type MessageUpdateResponse as MessageUpdateResponse,
     type MessageListResponse as MessageListResponse,
-    type MessageSendStreamResponse as MessageSendStreamResponse,
+    type MessageResetResponse as MessageResetResponse,
+    type MessageStreamResponse as MessageStreamResponse,
     type MessageUpdateParams as MessageUpdateParams,
     type MessageListParams as MessageListParams,
     type MessageSendParams as MessageSendParams,
-    type MessageSendStreamParams as MessageSendStreamParams,
+    type MessageStreamParams as MessageStreamParams,
   };
 }

package/src/resources/identities/agents.ts

@@ -0,0 +1,70 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AgentsAPI from '../agents/agents';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Agents extends APIResource {
+  /**
+   * Get all agents associated with the specified identity.
+   */
+  list(
+    identityID: string,
+    query: AgentListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<AgentListResponse> {
+    return this._client.get(path`/v1/identities/${identityID}/agents`, { query, ...options });
+  }
+}
+
+export type AgentListResponse = Array<AgentsAPI.AgentState>;
+
+export interface AgentListParams {
+  /**
+   * Agent ID cursor for pagination. Returns agents that come after this agent ID in
+   * the specified sort order
+   */
+  after?: string | null;
+
+  /**
+   * Agent ID cursor for pagination. Returns agents that come before this agent ID in
+   * the specified sort order
+   */
+  before?: string | null;
+
+  /**
+   * Specify which relational fields to include in the response. No relationships are
+   * included by default.
+   */
+  include?: Array<
+    | 'agent.blocks'
+    | 'agent.identities'
+    | 'agent.managed_group'
+    | 'agent.secrets'
+    | 'agent.sources'
+    | 'agent.tags'
+    | 'agent.tools'
+  >;
+
+  /**
+   * Maximum number of agents to return
+   */
+  limit?: number | null;
+
+  /**
+   * Sort order for agents by creation time. 'asc' for oldest first, 'desc' for
+   * newest first
+   */
+  order?: 'asc' | 'desc';
+
+  /**
+   * Field to sort by
+   */
+  order_by?: 'created_at';
+}
+
+export declare namespace Agents {
+  export { type AgentListResponse as AgentListResponse, type AgentListParams as AgentListParams };
+}

package/src/resources/identities/blocks.ts

@@ -0,0 +1,56 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as BlocksAPI from '../agents/blocks';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Blocks extends APIResource {
+  /**
+   * Get all blocks associated with the specified identity.
+   */
+  list(
+    identityID: string,
+    query: BlockListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BlockListResponse> {
+    return this._client.get(path`/v1/identities/${identityID}/blocks`, { query, ...options });
+  }
+}
+
+export type BlockListResponse = Array<BlocksAPI.Block>;
+
+export interface BlockListParams {
+  /**
+   * Block ID cursor for pagination. Returns blocks that come after this block ID in
+   * the specified sort order
+   */
+  after?: string | null;
+
+  /**
+   * Block ID cursor for pagination. Returns blocks that come before this block ID in
+   * the specified sort order
+   */
+  before?: string | null;
+
+  /**
+   * Maximum number of blocks to return
+   */
+  limit?: number | null;
+
+  /**
+   * Sort order for blocks by creation time. 'asc' for oldest first, 'desc' for
+   * newest first
+   */
+  order?: 'asc' | 'desc';
+
+  /**
+   * Field to sort by
+   */
+  order_by?: 'created_at';
+}
+
+export declare namespace Blocks {
+  export { type BlockListResponse as BlockListResponse, type BlockListParams as BlockListParams };
+}

package/src/resources/identities/identities.ts

@@ -0,0 +1,354 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AgentsAPI from './agents';
+import { AgentListParams, AgentListResponse, Agents } from './agents';
+import * as BlocksAPI from './blocks';
+import { BlockListParams, BlockListResponse, Blocks } from './blocks';
+import * as PropertiesAPI from './properties';
+import { Properties, PropertyUpsertParams, PropertyUpsertResponse } from './properties';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Identities extends APIResource {
+  properties: PropertiesAPI.Properties = new PropertiesAPI.Properties(this._client);
+  agents: AgentsAPI.Agents = new AgentsAPI.Agents(this._client);
+  blocks: BlocksAPI.Blocks = new BlocksAPI.Blocks(this._client);
+
+  /**
+   * Create Identity
+   */
+  create(params: IdentityCreateParams, options?: RequestOptions): APIPromise<Identity> {
+    const { 'X-Project': xProject, ...body } = params;
+    return this._client.post('/v1/identities/', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(xProject != null ? { 'X-Project': xProject } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Retrieve Identity
+   */
+  retrieve(identityID: string, options?: RequestOptions): APIPromise<Identity> {
+    return this._client.get(path`/v1/identities/${identityID}`, options);
+  }
+
+  /**
+   * Modify Identity
+   */
+  update(identityID: string, body: IdentityUpdateParams, options?: RequestOptions): APIPromise<Identity> {
+    return this._client.patch(path`/v1/identities/${identityID}`, { body, ...options });
+  }
+
+  /**
+   * Get a list of all identities in the database
+   */
+  list(
+    query: IdentityListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<IdentityListResponse> {
+    return this._client.get('/v1/identities/', { query, ...options });
+  }
+
+  /**
+   * Delete an identity by its identifier key
+   */
+  delete(identityID: string, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.delete(path`/v1/identities/${identityID}`, options);
+  }
+
+  /**
+   * Get count of all identities for a user
+   */
+  count(options?: RequestOptions): APIPromise<IdentityCountResponse> {
+    return this._client.get('/v1/identities/count', options);
+  }
+
+  /**
+   * Upsert Identity
+   */
+  upsert(params: IdentityUpsertParams, options?: RequestOptions): APIPromise<Identity> {
+    const { 'X-Project': xProject, ...body } = params;
+    return this._client.put('/v1/identities/', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(xProject != null ? { 'X-Project': xProject } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface Identity {
+  /**
+   * @deprecated The IDs of the agents associated with the identity.
+   */
+  agent_ids: Array<string>;
+
+  /**
+   * @deprecated The IDs of the blocks associated with the identity.
+   */
+  block_ids: Array<string>;
+
+  /**
+   * External, user-generated identifier key of the identity.
+   */
+  identifier_key: string;
+
+  /**
+   * The type of the identity.
+   */
+  identity_type: IdentityType;
+
+  /**
+   * The name of the identity.
+   */
+  name: string;
+
+  /**
+   * The human-friendly ID of the Identity
+   */
+  id?: string;
+
+  /**
+   * The project id of the identity, if applicable.
+   */
+  project_id?: string | null;
+
+  /**
+   * List of properties associated with the identity
+   */
+  properties?: Array<IdentityProperty>;
+}
+
+/**
+ * A property of an identity
+ */
+export interface IdentityProperty {
+  /**
+   * The key of the property
+   */
+  key: string;
+
+  /**
+   * The type of the property
+   */
+  type: 'string' | 'number' | 'boolean' | 'json';
+
+  /**
+   * The value of the property
+   */
+  value: string | number | boolean | { [key: string]: unknown };
+}
+
+/**
+ * Enum to represent the type of the identity.
+ */
+export type IdentityType = 'org' | 'user' | 'other';
+
+export type IdentityListResponse = Array<Identity>;
+
+export type IdentityDeleteResponse = unknown;
+
+export type IdentityCountResponse = number;
+
+export interface IdentityCreateParams {
+  /**
+   * Body param: External, user-generated identifier key of the identity.
+   */
+  identifier_key: string;
+
+  /**
+   * Body param: The type of the identity.
+   */
+  identity_type: IdentityType;
+
+  /**
+   * Body param: The name of the identity.
+   */
+  name: string;
+
+  /**
+   * @deprecated Body param: The agent ids that are associated with the identity.
+   */
+  agent_ids?: Array<string> | null;
+
+  /**
+   * @deprecated Body param: The IDs of the blocks associated with the identity.
+   */
+  block_ids?: Array<string> | null;
+
+  /**
+   * Body param: The project id of the identity, if applicable.
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param: List of properties associated with the identity.
+   */
+  properties?: Array<IdentityProperty> | null;
+
+  /**
+   * Header param: The project slug to associate with the identity (cloud only).
+   */
+  'X-Project'?: string;
+}
+
+export interface IdentityUpdateParams {
+  /**
+   * @deprecated The agent ids that are associated with the identity.
+   */
+  agent_ids?: Array<string> | null;
+
+  /**
+   * @deprecated The IDs of the blocks associated with the identity.
+   */
+  block_ids?: Array<string> | null;
+
+  /**
+   * External, user-generated identifier key of the identity.
+   */
+  identifier_key?: string | null;
+
+  /**
+   * Enum to represent the type of the identity.
+   */
+  identity_type?: IdentityType | null;
+
+  /**
+   * The name of the identity.
+   */
+  name?: string | null;
+
+  /**
+   * List of properties associated with the identity.
+   */
+  properties?: Array<IdentityProperty> | null;
+}
+
+export interface IdentityListParams {
+  /**
+   * Identity ID cursor for pagination. Returns identities that come after this
+   * identity ID in the specified sort order
+   */
+  after?: string | null;
+
+  /**
+   * Identity ID cursor for pagination. Returns identities that come before this
+   * identity ID in the specified sort order
+   */
+  before?: string | null;
+
+  identifier_key?: string | null;
+
+  /**
+   * Enum to represent the type of the identity.
+   */
+  identity_type?: IdentityType | null;
+
+  /**
+   * Maximum number of identities to return
+   */
+  limit?: number | null;
+
+  name?: string | null;
+
+  /**
+   * Sort order for identities by creation time. 'asc' for oldest first, 'desc' for
+   * newest first
+   */
+  order?: 'asc' | 'desc';
+
+  /**
+   * Field to sort by
+   */
+  order_by?: 'created_at';
+
+  project_id?: string | null;
+}
+
+export interface IdentityUpsertParams {
+  /**
+   * Body param: External, user-generated identifier key of the identity.
+   */
+  identifier_key: string;
+
+  /**
+   * Body param: The type of the identity.
+   */
+  identity_type: IdentityType;
+
+  /**
+   * Body param: The name of the identity.
+   */
+  name: string;
+
+  /**
+   * @deprecated Body param: The agent ids that are associated with the identity.
+   */
+  agent_ids?: Array<string> | null;
+
+  /**
+   * @deprecated Body param: The IDs of the blocks associated with the identity.
+   */
+  block_ids?: Array<string> | null;
+
+  /**
+   * Body param: The project id of the identity, if applicable.
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param: List of properties associated with the identity.
+   */
+  properties?: Array<IdentityProperty> | null;
+
+  /**
+   * Header param: The project slug to associate with the identity (cloud only).
+   */
+  'X-Project'?: string;
+}
+
+Identities.Properties = Properties;
+Identities.Agents = Agents;
+Identities.Blocks = Blocks;
+
+export declare namespace Identities {
+  export {
+    type Identity as Identity,
+    type IdentityProperty as IdentityProperty,
+    type IdentityType as IdentityType,
+    type IdentityListResponse as IdentityListResponse,
+    type IdentityDeleteResponse as IdentityDeleteResponse,
+    type IdentityCountResponse as IdentityCountResponse,
+    type IdentityCreateParams as IdentityCreateParams,
+    type IdentityUpdateParams as IdentityUpdateParams,
+    type IdentityListParams as IdentityListParams,
+    type IdentityUpsertParams as IdentityUpsertParams,
+  };
+
+  export {
+    Properties as Properties,
+    type PropertyUpsertResponse as PropertyUpsertResponse,
+    type PropertyUpsertParams as PropertyUpsertParams,
+  };
+
+  export {
+    Agents as Agents,
+    type AgentListResponse as AgentListResponse,
+    type AgentListParams as AgentListParams,
+  };
+
+  export {
+    Blocks as Blocks,
+    type BlockListResponse as BlockListResponse,
+    type BlockListParams as BlockListParams,
+  };
+}

package/src/resources/identities/index.ts

@@ -0,0 +1,18 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Agents, type AgentListResponse, type AgentListParams } from './agents';
+export { Blocks, type BlockListResponse, type BlockListParams } from './blocks';
+export {
+  Identities,
+  type Identity,
+  type IdentityProperty,
+  type IdentityType,
+  type IdentityListResponse,
+  type IdentityDeleteResponse,
+  type IdentityCountResponse,
+  type IdentityCreateParams,
+  type IdentityUpdateParams,
+  type IdentityListParams,
+  type IdentityUpsertParams,
+} from './identities';
+export { Properties, type PropertyUpsertResponse, type PropertyUpsertParams } from './properties';