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

package/src/resources/steps/steps.ts

@@ -6,13 +6,13 @@ import * as RunsAPI from '../runs/runs';
 import * as FeedbackAPI from './feedback';
 import { Feedback, FeedbackCreateParams } from './feedback';
 import * as StepsMessagesAPI from './messages';
-import { MessageListParams, MessageListResponse, Messages } from './messages';
+import { MessageListParams, MessageListResponse, MessageListResponsesArrayPage, Messages } from './messages';
 import * as MetricsAPI from './metrics';
 import { MetricRetrieveResponse, Metrics } from './metrics';
 import * as TraceAPI from './trace';
 import { Trace } from './trace';
 import { APIPromise } from '../../core/api-promise';
-import { buildHeaders } from '../../internal/headers';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -33,21 +33,15 @@ export class Steps extends APIResource {
    * List steps with optional pagination and date filters.
    */
   list(
-    params: StepListParams | null | undefined = {},
+    query: StepListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<StepListResponse> {
-    const { 'X-Project': xProject, ...query } = params ?? {};
-    return this._client.get('/v1/steps/', {
-      query,
-      ...options,
-      headers: buildHeaders([
-        { ...(xProject != null ? { 'X-Project': xProject } : undefined) },
-        options?.headers,
-      ]),
-    });
+  ): PagePromise<StepsArrayPage, Step> {
+    return this._client.getAPIList('/v1/steps/', ArrayPage<Step>, { query, ...options });
   }
 }
 
+export type StepsArrayPage = ArrayPage<Step>;
+
 /**
  * Letta's internal representation of a provider trace.
  *
@@ -145,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.
@@ -224,87 +218,51 @@ export interface Step {
   trace_id?: string | null;
 }
 
-export type StepListResponse = Array<Step>;
-
-export interface StepListParams {
-  /**
-   * Query param: Return steps after this step ID
-   */
-  after?: string | null;
-
+export interface StepListParams extends ArrayPageParams {
   /**
-   * Query param: Filter by the ID of the agent that performed the step
+   * Filter by the ID of the agent that performed the step
    */
   agent_id?: string | null;
 
   /**
-   * Query param: Return steps before this step ID
-   */
-  before?: string | null;
-
-  /**
-   * Query param: Return steps before this ISO datetime (e.g.
-   * "2025-01-29T15:01:19-08:00")
+   * Return steps before this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")
    */
   end_date?: string | null;
 
   /**
-   * Query param: Filter by feedback
+   * Filter by feedback
    */
   feedback?: 'positive' | 'negative' | null;
 
   /**
-   * Query param: Filter by whether steps have feedback (true) or not (false)
+   * Filter by whether steps have feedback (true) or not (false)
    */
   has_feedback?: boolean | null;
 
   /**
-   * Query param: Maximum number of steps to return
-   */
-  limit?: number | null;
-
-  /**
-   * Query param: Filter by the name of the model used for the step
+   * Filter by the name of the model used for the step
    */
   model?: string | null;
 
   /**
-   * Query param: Sort order for steps by creation time. 'asc' for oldest first,
-   * 'desc' for newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Query param: Field to sort by
-   */
-  order_by?: 'created_at';
-
-  /**
-   * Query param: Filter by the project ID that is associated with the step (cloud
-   * only).
+   * Filter by the project ID that is associated with the step (cloud only).
    */
   project_id?: string | null;
 
   /**
-   * Query param: Return steps after this ISO datetime (e.g.
-   * "2025-01-29T15:01:19-08:00")
+   * Return steps after this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")
    */
   start_date?: string | null;
 
   /**
-   * Query param: Filter by tags
+   * Filter by tags
    */
   tags?: Array<string> | null;
 
   /**
-   * Query param: Filter by trace ids returned by the server
+   * Filter by trace ids returned by the server
    */
   trace_ids?: Array<string> | null;
-
-  /**
-   * Header param: Filter by project slug to associate with the group (cloud only).
-   */
-  'X-Project'?: string;
 }
 
 Steps.Metrics = Metrics;
@@ -316,7 +274,7 @@ export declare namespace Steps {
   export {
     type ProviderTrace as ProviderTrace,
     type Step as Step,
-    type StepListResponse as StepListResponse,
+    type StepsArrayPage as StepsArrayPage,
     type StepListParams as StepListParams,
   };
 
@@ -329,6 +287,7 @@ export declare namespace Steps {
   export {
     Messages as Messages,
     type MessageListResponse as MessageListResponse,
+    type MessageListResponsesArrayPage as MessageListResponsesArrayPage,
     type MessageListParams as MessageListParams,
   };
 }

package/src/resources/templates/agents.ts

@@ -10,9 +10,12 @@ export class Agents extends APIResource {
   /**
    * Creates an Agent or multiple Agents from a template
    */
-  create(templateVersion: string, params: AgentCreateParams, options?: RequestOptions): APIPromise<void> {
-    const { project_id, ...body } = params;
-    return this._client.post(path`/v1/templates/${project_id}/${templateVersion}/agents`, {
+  create(
+    templateVersion: string,
+    body: AgentCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.post(path`/v1/templates/${templateVersion}/agents`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -22,40 +25,34 @@ export class Agents extends APIResource {
 
 export interface AgentCreateParams {
   /**
-   * Path param: The project id
-   */
-  project_id: string;
-
-  /**
-   * Body param: The name of the agent, optional otherwise a random one will be
-   * assigned
+   * The name of the agent, optional otherwise a random one will be assigned
    */
   agent_name?: string;
 
   /**
-   * Body param: The identity ids to assign to the agent
+   * The identity ids to assign to the agent
    */
   identity_ids?: Array<string>;
 
   /**
-   * Body param: Set an initial sequence of messages, if not provided, the agent will
-   * start with the default message sequence, if an empty array is provided, the
-   * agent will start with no messages
+   * Set an initial sequence of messages, if not provided, the agent will start with
+   * the default message sequence, if an empty array is provided, the agent will
+   * start with no messages
    */
   initial_message_sequence?: Array<AgentCreateParams.InitialMessageSequence>;
 
   /**
-   * Body param: The memory variables to assign to the agent
+   * The memory variables to assign to the agent
    */
   memory_variables?: { [key: string]: string };
 
   /**
-   * Body param: The tags to assign to the agent
+   * The tags to assign to the agent
    */
   tags?: Array<string>;
 
   /**
-   * Body param: The tool variables to assign to the agent
+   * The tool variables to assign to the agent
    */
   tool_variables?: { [key: string]: string };
 }

package/src/resources/tools.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../core/resource';
 import * as MessagesAPI from './agents/messages';
 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';
 
@@ -34,8 +35,8 @@ export class Tools extends APIResource {
   list(
     query: ToolListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ToolListResponse> {
-    return this._client.get('/v1/tools/', { query, ...options });
+  ): PagePromise<ToolsArrayPage, Tool> {
+    return this._client.getAPIList('/v1/tools/', ArrayPage<Tool>, { query, ...options });
   }
 
   /**
@@ -45,16 +46,6 @@ export class Tools extends APIResource {
     return this._client.delete(path`/v1/tools/${toolID}`, options);
   }
 
-  /**
-   * Get a count of all tools available to agents belonging to the org of the user.
-   */
-  count(
-    query: ToolCountParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ToolCountResponse> {
-    return this._client.get('/v1/tools/count', { query, ...options });
-  }
-
   /**
    * Create or update a tool
    */
@@ -70,6 +61,8 @@ export class Tools extends APIResource {
   }
 }
 
+export type ToolsArrayPage = ArrayPage<Tool>;
+
 export interface NpmRequirement {
   /**
    * Name of the npm package.
@@ -96,16 +89,12 @@ export interface PipRequirement {
 
 /**
  * Representation of a tool, which is a function that can be called by the agent.
- *
- * Parameters: id (str): The unique identifier of the tool. name (str): The name of
- * the function. tags (List[str]): Metadata tags. source_code (str): The source
- * code of the function. json_schema (Dict): The JSON schema of the function.
  */
 export interface Tool {
   /**
    * The human-friendly ID of the Tool
    */
-  id?: string;
+  id: string;
 
   /**
    * The args JSON schema of the function.
@@ -328,12 +317,8 @@ export type ToolType =
   | 'external_composio'
   | 'external_mcp';
 
-export type ToolListResponse = Array<Tool>;
-
 export type ToolDeleteResponse = unknown;
 
-export type ToolCountResponse = number;
-
 export type ToolUpsertBaseToolsResponse = Array<Tool>;
 
 export interface ToolCreateParams {
@@ -459,29 +444,12 @@ export interface ToolUpdateParams {
   tags?: Array<string> | null;
 }
 
-export interface ToolListParams {
-  /**
-   * Tool ID cursor for pagination. Returns tools that come after this tool ID in the
-   * specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Tool ID cursor for pagination. Returns tools that come before this tool ID in
-   * the specified sort order
-   */
-  before?: string | null;
-
+export interface ToolListParams extends ArrayPageParams {
   /**
    * Tool type(s) to exclude - accepts repeated params or comma-separated values
    */
   exclude_tool_types?: Array<string> | null;
 
-  /**
-   * Maximum number of tools to return
-   */
-  limit?: number | null;
-
   /**
    * Filter by single tool name
    */
@@ -492,17 +460,6 @@ export interface ToolListParams {
    */
   names?: Array<string> | null;
 
-  /**
-   * Sort order for tools by creation time. 'asc' for oldest first, 'desc' for newest
-   * first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
-
   /**
    * Return only tools with tool*type starting with 'letta*'
    */
@@ -524,45 +481,6 @@ export interface ToolListParams {
   tool_types?: Array<string> | null;
 }
 
-export interface ToolCountParams {
-  /**
-   * Exclude built-in Letta tools from the count
-   */
-  exclude_letta_tools?: boolean | null;
-
-  /**
-   * Tool type(s) to exclude - accepts repeated params or comma-separated values
-   */
-  exclude_tool_types?: Array<string> | null;
-
-  name?: string | null;
-
-  /**
-   * Filter by specific tool names
-   */
-  names?: Array<string> | null;
-
-  /**
-   * Count only tools with tool*type starting with 'letta*'
-   */
-  return_only_letta_tools?: boolean | null;
-
-  /**
-   * Search tool names (case-insensitive partial match)
-   */
-  search?: string | null;
-
-  /**
-   * Filter by specific tool IDs - accepts repeated params or comma-separated values
-   */
-  tool_ids?: Array<string> | null;
-
-  /**
-   * Filter by tool type(s) - accepts repeated params or comma-separated values
-   */
-  tool_types?: Array<string> | null;
-}
-
 export interface ToolUpsertParams {
   /**
    * The source code of the function.
@@ -630,14 +548,12 @@ export declare namespace Tools {
     type ToolCreate as ToolCreate,
     type ToolReturnMessage as ToolReturnMessage,
     type ToolType as ToolType,
-    type ToolListResponse as ToolListResponse,
     type ToolDeleteResponse as ToolDeleteResponse,
-    type ToolCountResponse as ToolCountResponse,
     type ToolUpsertBaseToolsResponse as ToolUpsertBaseToolsResponse,
+    type ToolsArrayPage as ToolsArrayPage,
     type ToolCreateParams as ToolCreateParams,
     type ToolUpdateParams as ToolUpdateParams,
     type ToolListParams as ToolListParams,
-    type ToolCountParams as ToolCountParams,
     type ToolUpsertParams as ToolUpsertParams,
   };
 }

package/src/streaming.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/streaming instead */
+export * from './core/streaming';

package/src/version.ts

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

package/streaming.d.mts

@@ -0,0 +1,2 @@
+export * from "./core/streaming.mjs";
+//# sourceMappingURL=streaming.d.mts.map

package/streaming.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.mts","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":""}

package/streaming.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/streaming.js";
+//# sourceMappingURL=streaming.d.ts.map

package/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":""}

package/streaming.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+/** @deprecated Import from ./core/streaming instead */
+tslib_1.__exportStar(require("./core/streaming.js"), exports);
+//# sourceMappingURL=streaming.js.map

package/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AACvD,8DAAiC"}

package/streaming.mjs

@@ -0,0 +1,2 @@
+export * from "./core/streaming.mjs";
+//# sourceMappingURL=streaming.mjs.map

package/streaming.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.mjs","sourceRoot":"","sources":["src/streaming.ts"],"names":[],"mappings":""}

package/version.d.mts

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

package/version.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/version.d.ts

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

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,kBAAkB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

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.7'; // x-release-please-version
+exports.VERSION = '1.0.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,eAAe,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}

package/version.mjs

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

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}