@letta-ai/letta-client 1.0.0-alpha.17 → 1.0.0-alpha.19

package/src/resources/archives/archives.ts

@@ -0,0 +1,165 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as PassagesAPI from './passages';
+import { PassageCreateParams, PassageCreateResponse, PassageDeleteParams, Passages } from './passages';
+import * as ModelsAPI from '../models/models';
+import { APIPromise } from '../../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Archives extends APIResource {
+  passages: PassagesAPI.Passages = new PassagesAPI.Passages(this._client);
+
+  /**
+   * Create a new archive.
+   */
+  create(body: ArchiveCreateParams, options?: RequestOptions): APIPromise<Archive> {
+    return this._client.post('/v1/archives/', { body, ...options });
+  }
+
+  /**
+   * Get a single archive by its ID.
+   */
+  retrieve(archiveID: string, options?: RequestOptions): APIPromise<Archive> {
+    return this._client.get(path`/v1/archives/${archiveID}`, options);
+  }
+
+  /**
+   * Get a list of all archives for the current organization with optional filters
+   * and pagination.
+   */
+  list(
+    query: ArchiveListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ArchivesArrayPage, Archive> {
+    return this._client.getAPIList('/v1/archives/', ArrayPage<Archive>, { query, ...options });
+  }
+
+  /**
+   * Delete an archive by its ID.
+   */
+  delete(archiveID: string, options?: RequestOptions): APIPromise<Archive> {
+    return this._client.delete(path`/v1/archives/${archiveID}`, options);
+  }
+
+  /**
+   * Update an existing archive's name and/or description.
+   */
+  modify(archiveID: string, body: ArchiveModifyParams, options?: RequestOptions): APIPromise<Archive> {
+    return this._client.patch(path`/v1/archives/${archiveID}`, { body, ...options });
+  }
+}
+
+export type ArchivesArrayPage = ArrayPage<Archive>;
+
+/**
+ * Representation of an archive - a collection of archival passages that can be
+ * shared between agents.
+ */
+export interface Archive {
+  /**
+   * The human-friendly ID of the Archive
+   */
+  id: string;
+
+  /**
+   * The creation date of the archive
+   */
+  created_at: string;
+
+  /**
+   * Embedding configuration for passages in this archive
+   */
+  embedding_config: ModelsAPI.EmbeddingConfig;
+
+  /**
+   * The name of the archive
+   */
+  name: string;
+
+  /**
+   * The id of the user that made this object.
+   */
+  created_by_id?: string | null;
+
+  /**
+   * A description of the archive
+   */
+  description?: string | null;
+
+  /**
+   * The id of the user that made this object.
+   */
+  last_updated_by_id?: string | null;
+
+  /**
+   * Additional metadata
+   */
+  metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * The timestamp when the object was last updated.
+   */
+  updated_at?: string | null;
+
+  /**
+   * The vector database provider used for this archive's passages
+   */
+  vector_db_provider?: VectorDBProvider;
+}
+
+/**
+ * Supported vector database providers for archival memory
+ */
+export type VectorDBProvider = 'native' | 'tpuf' | 'pinecone';
+
+export interface ArchiveCreateParams {
+  /**
+   * Embedding configuration for the archive
+   */
+  embedding_config: ModelsAPI.EmbeddingConfig;
+
+  name: string;
+
+  description?: string | null;
+}
+
+export interface ArchiveListParams extends ArrayPageParams {
+  /**
+   * Only archives attached to this agent ID
+   */
+  agent_id?: string | null;
+
+  /**
+   * Filter by archive name (exact match)
+   */
+  name?: string | null;
+}
+
+export interface ArchiveModifyParams {
+  description?: string | null;
+
+  name?: string | null;
+}
+
+Archives.Passages = Passages;
+
+export declare namespace Archives {
+  export {
+    type Archive as Archive,
+    type VectorDBProvider as VectorDBProvider,
+    type ArchivesArrayPage as ArchivesArrayPage,
+    type ArchiveCreateParams as ArchiveCreateParams,
+    type ArchiveListParams as ArchiveListParams,
+    type ArchiveModifyParams as ArchiveModifyParams,
+  };
+
+  export {
+    Passages as Passages,
+    type PassageCreateResponse as PassageCreateResponse,
+    type PassageCreateParams as PassageCreateParams,
+    type PassageDeleteParams as PassageDeleteParams,
+  };
+}

package/src/resources/archives/index.ts

@@ -0,0 +1,17 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Archives,
+  type Archive,
+  type VectorDBProvider,
+  type ArchiveCreateParams,
+  type ArchiveListParams,
+  type ArchiveModifyParams,
+  type ArchivesArrayPage,
+} from './archives';
+export {
+  Passages,
+  type PassageCreateResponse,
+  type PassageCreateParams,
+  type PassageDeleteParams,
+} from './passages';

package/src/resources/archives/passages.ts

@@ -0,0 +1,149 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ModelsAPI from '../models/models';
+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 Passages extends APIResource {
+  /**
+   * Create a new passage in an archive.
+   *
+   * This adds a passage to the archive and creates embeddings for vector storage.
+   */
+  create(
+    archiveID: string,
+    body: PassageCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<PassageCreateResponse> {
+    return this._client.post(path`/v1/archives/${archiveID}/passages`, { body, ...options });
+  }
+
+  /**
+   * Delete a passage from an archive.
+   *
+   * This permanently removes the passage from both the database and vector storage
+   * (if applicable).
+   */
+  delete(passageID: string, params: PassageDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { archive_id } = params;
+    return this._client.delete(path`/v1/archives/${archive_id}/passages/${passageID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+/**
+ * Representation of a passage, which is stored in archival memory.
+ */
+export interface PassageCreateResponse {
+  /**
+   * The embedding of the passage.
+   */
+  embedding: Array<number> | null;
+
+  /**
+   * Configuration for embedding model connection and processing parameters.
+   */
+  embedding_config: ModelsAPI.EmbeddingConfig | null;
+
+  /**
+   * The text of the passage.
+   */
+  text: string;
+
+  /**
+   * The human-friendly ID of the Passage
+   */
+  id?: string;
+
+  /**
+   * The unique identifier of the archive containing this passage.
+   */
+  archive_id?: string | null;
+
+  /**
+   * The creation date of the passage.
+   */
+  created_at?: string;
+
+  /**
+   * The id of the user that made this object.
+   */
+  created_by_id?: string | null;
+
+  /**
+   * The unique identifier of the file associated with the passage.
+   */
+  file_id?: string | null;
+
+  /**
+   * The name of the file (only for source passages).
+   */
+  file_name?: string | null;
+
+  /**
+   * Whether this passage is deleted or not.
+   */
+  is_deleted?: boolean;
+
+  /**
+   * The id of the user that made this object.
+   */
+  last_updated_by_id?: string | null;
+
+  /**
+   * The metadata of the passage.
+   */
+  metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * The data source of the passage.
+   */
+  source_id?: string | null;
+
+  /**
+   * Tags associated with this passage.
+   */
+  tags?: Array<string> | null;
+
+  /**
+   * The timestamp when the object was last updated.
+   */
+  updated_at?: string | null;
+}
+
+export interface PassageCreateParams {
+  /**
+   * The text content of the passage
+   */
+  text: string;
+
+  /**
+   * Optional metadata for the passage
+   */
+  metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * Optional tags for categorizing the passage
+   */
+  tags?: Array<string> | null;
+}
+
+export interface PassageDeleteParams {
+  /**
+   * The ID of the archive in the format 'archive-<uuid4>'
+   */
+  archive_id: string;
+}
+
+export declare namespace Passages {
+  export {
+    type PassageCreateResponse as PassageCreateResponse,
+    type PassageCreateParams as PassageCreateParams,
+    type PassageDeleteParams as PassageDeleteParams,
+  };
+}

package/src/resources/archives.ts

@@ -1,152 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../core/resource';
-import * as ModelsAPI from './models/models';
-import { APIPromise } from '../core/api-promise';
-import { ArrayPage, type ArrayPageParams, PagePromise } from '../core/pagination';
-import { RequestOptions } from '../internal/request-options';
-import { path } from '../internal/utils/path';
-
-export class Archives extends APIResource {
-  /**
-   * Create a new archive.
-   */
-  create(body: ArchiveCreateParams, options?: RequestOptions): APIPromise<Archive> {
-    return this._client.post('/v1/archives/', { body, ...options });
-  }
-
-  /**
-   * Get a single archive by its ID.
-   */
-  retrieve(archiveID: string, options?: RequestOptions): APIPromise<Archive> {
-    return this._client.get(path`/v1/archives/${archiveID}`, options);
-  }
-
-  /**
-   * Get a list of all archives for the current organization with optional filters
-   * and pagination.
-   */
-  list(
-    query: ArchiveListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<ArchivesArrayPage, Archive> {
-    return this._client.getAPIList('/v1/archives/', ArrayPage<Archive>, { query, ...options });
-  }
-
-  /**
-   * Delete an archive by its ID.
-   */
-  delete(archiveID: string, options?: RequestOptions): APIPromise<Archive> {
-    return this._client.delete(path`/v1/archives/${archiveID}`, options);
-  }
-
-  /**
-   * Update an existing archive's name and/or description.
-   */
-  modify(archiveID: string, body: ArchiveModifyParams, options?: RequestOptions): APIPromise<Archive> {
-    return this._client.patch(path`/v1/archives/${archiveID}`, { body, ...options });
-  }
-}
-
-export type ArchivesArrayPage = ArrayPage<Archive>;
-
-/**
- * Representation of an archive - a collection of archival passages that can be
- * shared between agents.
- */
-export interface Archive {
-  /**
-   * The human-friendly ID of the Archive
-   */
-  id: string;
-
-  /**
-   * The creation date of the archive
-   */
-  created_at: string;
-
-  /**
-   * Embedding configuration for passages in this archive
-   */
-  embedding_config: ModelsAPI.EmbeddingConfig;
-
-  /**
-   * The name of the archive
-   */
-  name: string;
-
-  /**
-   * The id of the user that made this object.
-   */
-  created_by_id?: string | null;
-
-  /**
-   * A description of the archive
-   */
-  description?: string | null;
-
-  /**
-   * The id of the user that made this object.
-   */
-  last_updated_by_id?: string | null;
-
-  /**
-   * Additional metadata
-   */
-  metadata?: { [key: string]: unknown } | null;
-
-  /**
-   * The timestamp when the object was last updated.
-   */
-  updated_at?: string | null;
-
-  /**
-   * The vector database provider used for this archive's passages
-   */
-  vector_db_provider?: VectorDBProvider;
-}
-
-/**
- * Supported vector database providers for archival memory
- */
-export type VectorDBProvider = 'native' | 'tpuf' | 'pinecone';
-
-export interface ArchiveCreateParams {
-  /**
-   * Embedding configuration for the archive
-   */
-  embedding_config: ModelsAPI.EmbeddingConfig;
-
-  name: string;
-
-  description?: string | null;
-}
-
-export interface ArchiveListParams extends ArrayPageParams {
-  /**
-   * Only archives attached to this agent ID
-   */
-  agent_id?: string | null;
-
-  /**
-   * Filter by archive name (exact match)
-   */
-  name?: string | null;
-}
-
-export interface ArchiveModifyParams {
-  description?: string | null;
-
-  name?: string | null;
-}
-
-export declare namespace Archives {
-  export {
-    type Archive as Archive,
-    type VectorDBProvider as VectorDBProvider,
-    type ArchivesArrayPage as ArchivesArrayPage,
-    type ArchiveCreateParams as ArchiveCreateParams,
-    type ArchiveListParams as ArchiveListParams,
-    type ArchiveModifyParams as ArchiveModifyParams,
-  };
-}
+export * from './archives/index';

package/src/resources/batches/messages.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as MessagesAPI from '../agents/messages';
-import { MessagesObjectPage } from '../agents/messages';
+import { InternalMessagesObjectPage } from '../agents/messages';
 import { ObjectPage, type ObjectPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -15,10 +15,10 @@ export class Messages extends APIResource {
     batchID: string,
     query: MessageListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<MessagesObjectPage, MessagesAPI.Message> {
+  ): PagePromise<InternalMessagesObjectPage, MessagesAPI.InternalMessage> {
     return this._client.getAPIList(
       path`/v1/messages/batches/${batchID}/messages`,
-      ObjectPage<MessagesAPI.Message>,
+      ObjectPage<MessagesAPI.InternalMessage>,
       { query, ...options },
     );
   }
@@ -35,4 +35,4 @@ export declare namespace Messages {
   export { type MessageListParams as MessageListParams };
 }
 
-export { type MessagesObjectPage };
+export { type InternalMessagesObjectPage };

package/src/resources/groups/messages.ts

@@ -4,7 +4,7 @@ import { APIResource } from '../../core/resource';
 import * as ToolsAPI from '../tools';
 import * as AgentsAPI from '../agents/agents';
 import * as MessagesAPI from '../agents/messages';
-import { LettaMessageUnionsArrayPage } from '../agents/messages';
+import { MessagesArrayPage } from '../agents/messages';
 import { APIPromise } from '../../core/api-promise';
 import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { Stream } from '../../core/streaming';
@@ -19,12 +19,11 @@ export class Messages extends APIResource {
     groupID: string,
     query: MessageListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<LettaMessageUnionsArrayPage, MessagesAPI.LettaMessageUnion> {
-    return this._client.getAPIList(
-      path`/v1/groups/${groupID}/messages`,
-      ArrayPage<MessagesAPI.LettaMessageUnion>,
-      { query, ...options },
-    );
+  ): PagePromise<MessagesArrayPage, MessagesAPI.Message> {
+    return this._client.getAPIList(path`/v1/groups/${groupID}/messages`, ArrayPage<MessagesAPI.Message>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -441,4 +440,4 @@ export declare namespace Messages {
   };
 }
 
-export { type LettaMessageUnionsArrayPage };
+export { type MessagesArrayPage };

package/src/resources/index.ts

@@ -5,20 +5,30 @@ export {
   type AgentEnvironmentVariable,
   type AgentState,
   type AgentType,
+  type AnthropicModelSettings,
+  type AzureModelSettings,
+  type BedrockModelSettings,
   type ChildToolRule,
   type ConditionalToolRule,
   type ContinueToolRule,
+  type DeepseekModelSettings,
+  type GoogleAIModelSettings,
+  type GoogleVertexModelSettings,
+  type GroqModelSettings,
   type InitToolRule,
   type JsonObjectResponseFormat,
   type JsonSchemaResponseFormat,
   type LettaMessageContentUnion,
   type MaxCountPerStepToolRule,
   type MessageCreate,
+  type OpenAIModelSettings,
   type ParentToolRule,
   type RequiredBeforeExitToolRule,
   type RequiresApprovalToolRule,
   type TerminalToolRule,
   type TextResponseFormat,
+  type TogetherModelSettings,
+  type XaiModelSettings,
   type AgentDeleteResponse,
   type AgentExportFileResponse,
   type AgentImportFileResponse,
@@ -38,7 +48,7 @@ export {
   type ArchiveListParams,
   type ArchiveModifyParams,
   type ArchivesArrayPage,
-} from './archives';
+} from './archives/archives';
 export {
   Batches,
   type BatchJob,

package/src/resources/runs/messages.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as MessagesAPI from '../agents/messages';
-import { LettaMessageUnionsArrayPage } from '../agents/messages';
+import { MessagesArrayPage } from '../agents/messages';
 import { APIPromise } from '../../core/api-promise';
 import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { Stream } from '../../core/streaming';
@@ -17,12 +17,11 @@ export class Messages extends APIResource {
     runID: string,
     query: MessageListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<LettaMessageUnionsArrayPage, MessagesAPI.LettaMessageUnion> {
-    return this._client.getAPIList(
-      path`/v1/runs/${runID}/messages`,
-      ArrayPage<MessagesAPI.LettaMessageUnion>,
-      { query, ...options },
-    );
+  ): PagePromise<MessagesArrayPage, MessagesAPI.Message> {
+    return this._client.getAPIList(path`/v1/runs/${runID}/messages`, ArrayPage<MessagesAPI.Message>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -77,4 +76,4 @@ export declare namespace Messages {
   };
 }
 
-export { type LettaMessageUnionsArrayPage };
+export { type MessagesArrayPage };

package/src/resources/steps/steps.ts

@@ -139,7 +139,7 @@ export interface Step {
    * @deprecated The messages generated during this step. Deprecated: use
    * `GET /v1/steps/{step_id}/messages` endpoint instead
    */
-  messages?: Array<MessagesAPI.Message>;
+  messages?: Array<MessagesAPI.InternalMessage>;
 
   /**
    * The name of the model used for this step.

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.0.0-alpha.17'; // x-release-please-version
+export const VERSION = '1.0.0-alpha.19'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.0.0-alpha.17";
+export declare const VERSION = "1.0.0-alpha.19";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.0.0-alpha.17";
+export declare const VERSION = "1.0.0-alpha.19";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.0.0-alpha.17'; // x-release-please-version
+exports.VERSION = '1.0.0-alpha.19'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.0.0-alpha.17'; // x-release-please-version
+export const VERSION = '1.0.0-alpha.19'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map