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

package/src/resources/steps.ts

@@ -1,457 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../core/resource';
-import * as RunsAPI from './runs';
-import * as MessagesAPI from './agents/messages';
-import * as ToolsAPI from './tools/tools';
-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 Steps extends APIResource {
-  /**
-   * Get a step by ID.
-   */
-  retrieve(stepID: string, options?: RequestOptions): APIPromise<Step> {
-    return this._client.get(path`/v1/steps/${stepID}`, options);
-  }
-
-  /**
-   * List steps with optional pagination and date filters.
-   */
-  list(
-    params: 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,
-      ]),
-    });
-  }
-
-  /**
-   * List messages for a given step.
-   */
-  listMessages(
-    stepID: string,
-    query: StepListMessagesParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<StepListMessagesResponse> {
-    return this._client.get(path`/v1/steps/${stepID}/messages`, { query, ...options });
-  }
-
-  /**
-   * Get step metrics by step ID.
-   */
-  retrieveMetrics(stepID: string, options?: RequestOptions): APIPromise<StepRetrieveMetricsResponse> {
-    return this._client.get(path`/v1/steps/${stepID}/metrics`, options);
-  }
-
-  /**
-   * Retrieve Trace For Step
-   */
-  retrieveTrace(stepID: string, options?: RequestOptions): APIPromise<ProviderTrace | null> {
-    return this._client.get(path`/v1/steps/${stepID}/trace`, options);
-  }
-
-  /**
-   * Modify feedback for a given step.
-   */
-  updateFeedback(stepID: string, body: StepUpdateFeedbackParams, options?: RequestOptions): APIPromise<Step> {
-    return this._client.patch(path`/v1/steps/${stepID}/feedback`, { body, ...options });
-  }
-}
-
-/**
- * Letta's internal representation of a provider trace.
- *
- * Attributes: id (str): The unique identifier of the provider trace. request_json
- * (Dict[str, Any]): JSON content of the provider request. response_json (Dict[str,
- * Any]): JSON content of the provider response. step_id (str): ID of the step that
- * this trace is associated with. organization_id (str): The unique identifier of
- * the organization. created_at (datetime): The timestamp when the object was
- * created.
- */
-export interface ProviderTrace {
-  /**
-   * JSON content of the provider request
-   */
-  request_json: { [key: string]: unknown };
-
-  /**
-   * JSON content of the provider response
-   */
-  response_json: { [key: string]: unknown };
-
-  /**
-   * The human-friendly ID of the Provider_trace
-   */
-  id?: string;
-
-  /**
-   * The timestamp when the object was created.
-   */
-  created_at?: string;
-
-  /**
-   * The id of the user that made this object.
-   */
-  created_by_id?: string | null;
-
-  /**
-   * The id of the user that made this object.
-   */
-  last_updated_by_id?: string | null;
-
-  /**
-   * ID of the step that this trace is associated with
-   */
-  step_id?: string | null;
-
-  /**
-   * The timestamp when the object was last updated.
-   */
-  updated_at?: string | null;
-}
-
-export interface Step {
-  /**
-   * The id of the step. Assigned by the database.
-   */
-  id: string;
-
-  /**
-   * The ID of the agent that performed the step.
-   */
-  agent_id?: string | null;
-
-  /**
-   * The number of tokens generated by the agent during this step.
-   */
-  completion_tokens?: number | null;
-
-  /**
-   * Metadata for the agent.
-   */
-  completion_tokens_details?: { [key: string]: unknown } | null;
-
-  /**
-   * The context window limit configured for this step.
-   */
-  context_window_limit?: number | null;
-
-  /**
-   * Error details including message, traceback, and additional context
-   */
-  error_data?: { [key: string]: unknown } | null;
-
-  /**
-   * The type/class of the error that occurred
-   */
-  error_type?: string | null;
-
-  /**
-   * The feedback for this step. Must be either 'positive' or 'negative'.
-   */
-  feedback?: 'positive' | 'negative' | null;
-
-  /**
-   * The unique identifier of the job that this step belongs to. Only included for
-   * async calls.
-   */
-  job_id?: string | null;
-
-  /**
-   * @deprecated The messages generated during this step. Deprecated: use
-   * `GET /v1/steps/{step_id}/messages` endpoint instead
-   */
-  messages?: Array<MessagesAPI.Message>;
-
-  /**
-   * The name of the model used for this step.
-   */
-  model?: string | null;
-
-  /**
-   * The model endpoint url used for this step.
-   */
-  model_endpoint?: string | null;
-
-  /**
-   * The surface that this agent step was initiated from.
-   */
-  origin?: string | null;
-
-  /**
-   * The project that the agent that executed this step belongs to (cloud only).
-   */
-  project_id?: string | null;
-
-  /**
-   * The number of tokens in the prompt during this step.
-   */
-  prompt_tokens?: number | null;
-
-  /**
-   * The category of the provider used for this step.
-   */
-  provider_category?: string | null;
-
-  /**
-   * The unique identifier of the provider that was configured for this step
-   */
-  provider_id?: string | null;
-
-  /**
-   * The name of the provider used for this step.
-   */
-  provider_name?: string | null;
-
-  /**
-   * Status of a step execution
-   */
-  status?: 'pending' | 'success' | 'failed' | 'cancelled' | null;
-
-  /**
-   * The stop reason associated with the step.
-   */
-  stop_reason?: RunsAPI.StopReasonType | null;
-
-  /**
-   * Metadata tags.
-   */
-  tags?: Array<string>;
-
-  /**
-   * The unique identifier of the transaction that processed this step.
-   */
-  tid?: string | null;
-
-  /**
-   * The total number of tokens processed by the agent during this step.
-   */
-  total_tokens?: number | null;
-
-  /**
-   * The trace id of the agent step.
-   */
-  trace_id?: string | null;
-}
-
-export type StepListResponse = Array<Step>;
-
-export type StepListMessagesResponse = Array<
-  | MessagesAPI.SystemMessage
-  | MessagesAPI.UserMessage
-  | MessagesAPI.ReasoningMessage
-  | MessagesAPI.HiddenReasoningMessage
-  | MessagesAPI.ToolCallMessage
-  | ToolsAPI.ToolReturnMessage
-  | MessagesAPI.AssistantMessage
-  | MessagesAPI.ApprovalRequestMessage
-  | MessagesAPI.ApprovalResponseMessage
->;
-
-export interface StepRetrieveMetricsResponse {
-  /**
-   * The id of the step this metric belongs to (matches steps.id).
-   */
-  id: string;
-
-  /**
-   * The unique identifier of the agent.
-   */
-  agent_id?: string | null;
-
-  /**
-   * The base template ID that the step belongs to (cloud only).
-   */
-  base_template_id?: string | null;
-
-  /**
-   * The unique identifier of the job.
-   */
-  job_id?: string | null;
-
-  /**
-   * Time spent on LLM requests in nanoseconds.
-   */
-  llm_request_ns?: number | null;
-
-  /**
-   * The timestamp of the start of the llm request in nanoseconds.
-   */
-  llm_request_start_ns?: number | null;
-
-  /**
-   * The project that the step belongs to (cloud only).
-   */
-  project_id?: string | null;
-
-  /**
-   * The unique identifier of the provider.
-   */
-  provider_id?: string | null;
-
-  /**
-   * Total time for the step in nanoseconds.
-   */
-  step_ns?: number | null;
-
-  /**
-   * The timestamp of the start of the step in nanoseconds.
-   */
-  step_start_ns?: number | null;
-
-  /**
-   * The template ID that the step belongs to (cloud only).
-   */
-  template_id?: string | null;
-
-  /**
-   * Time spent on tool execution in nanoseconds.
-   */
-  tool_execution_ns?: number | null;
-}
-
-export interface StepListParams {
-  /**
-   * Query param: Return steps after this step ID
-   */
-  after?: string | null;
-
-  /**
-   * Query param: 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")
-   */
-  end_date?: string | null;
-
-  /**
-   * Query param: Filter by feedback
-   */
-  feedback?: 'positive' | 'negative' | null;
-
-  /**
-   * Query param: 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
-   */
-  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).
-   */
-  project_id?: string | null;
-
-  /**
-   * Query param: Return steps after this ISO datetime (e.g.
-   * "2025-01-29T15:01:19-08:00")
-   */
-  start_date?: string | null;
-
-  /**
-   * Query param: Filter by tags
-   */
-  tags?: Array<string> | null;
-
-  /**
-   * Query param: 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;
-}
-
-export interface StepListMessagesParams {
-  /**
-   * Message ID cursor for pagination. Returns messages that come after this message
-   * ID in the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Message ID cursor for pagination. Returns messages that come before this message
-   * ID in the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of messages to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Sort by field
-   */
-  order_by?: 'created_at';
-}
-
-export interface StepUpdateFeedbackParams {
-  /**
-   * Whether this feedback is positive or negative
-   */
-  feedback?: 'positive' | 'negative' | null;
-
-  /**
-   * Feedback tags to add to the step
-   */
-  tags?: Array<string> | null;
-}
-
-export declare namespace Steps {
-  export {
-    type ProviderTrace as ProviderTrace,
-    type Step as Step,
-    type StepListResponse as StepListResponse,
-    type StepListMessagesResponse as StepListMessagesResponse,
-    type StepRetrieveMetricsResponse as StepRetrieveMetricsResponse,
-    type StepListParams as StepListParams,
-    type StepListMessagesParams as StepListMessagesParams,
-    type StepUpdateFeedbackParams as StepUpdateFeedbackParams,
-  };
-}
+export * from './steps/index';

package/src/resources/templates/agents.ts

@@ -0,0 +1,83 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+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 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`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+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
+   */
+  agent_name?: string;
+
+  /**
+   * Body param: 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
+   */
+  initial_message_sequence?: Array<AgentCreateParams.InitialMessageSequence>;
+
+  /**
+   * Body param: The memory variables to assign to the agent
+   */
+  memory_variables?: { [key: string]: string };
+
+  /**
+   * Body param: The tags to assign to the agent
+   */
+  tags?: Array<string>;
+
+  /**
+   * Body param: The tool variables to assign to the agent
+   */
+  tool_variables?: { [key: string]: string };
+}
+
+export namespace AgentCreateParams {
+  export interface InitialMessageSequence {
+    content: string;
+
+    role: 'user' | 'system' | 'assistant';
+
+    batch_item_id?: string | null;
+
+    group_id?: string | null;
+
+    name?: string | null;
+
+    otid?: string | null;
+
+    sender_id?: string | null;
+  }
+}
+
+export declare namespace Agents {
+  export { type AgentCreateParams as AgentCreateParams };
+}

package/src/resources/templates/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Agents, type AgentCreateParams } from './agents';
+export { Templates } from './templates';

package/src/resources/templates/templates.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AgentsAPI from './agents';
+import { AgentCreateParams, Agents } from './agents';
+
+export class Templates extends APIResource {
+  agents: AgentsAPI.Agents = new AgentsAPI.Agents(this._client);
+}
+
+Templates.Agents = Agents;
+
+export declare namespace Templates {
+  export { Agents as Agents, type AgentCreateParams as AgentCreateParams };
+}