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

package/src/resources/runs/usage.ts

@@ -0,0 +1,41 @@
+// 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 { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Usage extends APIResource {
+  /**
+   * Get usage statistics for a run.
+   */
+  retrieve(runID: string, options?: RequestOptions): APIPromise<UsageRetrieveResponse> {
+    return this._client.get(path`/v1/runs/${runID}/usage`, options);
+  }
+}
+
+export interface UsageRetrieveResponse {
+  completion_tokens?: number;
+
+  completion_tokens_details?: UsageRetrieveResponse.CompletionTokensDetails | null;
+
+  prompt_tokens?: number;
+
+  prompt_tokens_details?: UsageRetrieveResponse.PromptTokensDetails | null;
+
+  total_tokens?: number;
+}
+
+export namespace UsageRetrieveResponse {
+  export interface CompletionTokensDetails {
+    reasoning_tokens?: number;
+  }
+
+  export interface PromptTokensDetails {
+    cached_tokens?: number;
+  }
+}
+
+export declare namespace Usage {
+  export { type UsageRetrieveResponse as UsageRetrieveResponse };
+}

package/src/resources/runs.ts

@@ -1,284 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../core/resource';
-import * as StepsAPI from './steps';
-import * as MessagesAPI from './agents/messages';
-import { APIPromise } from '../core/api-promise';
-import { RequestOptions } from '../internal/request-options';
-import { path } from '../internal/utils/path';
-
-export class Runs extends APIResource {
-  /**
-   * Get the status of a run.
-   */
-  retrieve(runID: string, options?: RequestOptions): APIPromise<MessagesAPI.Run> {
-    return this._client.get(path`/v1/runs/${runID}`, options);
-  }
-
-  /**
-   * List all runs.
-   */
-  list(query: RunListParams | null | undefined = {}, options?: RequestOptions): APIPromise<RunListResponse> {
-    return this._client.get('/v1/runs/', { query, ...options });
-  }
-
-  /**
-   * Delete a run by its run_id.
-   */
-  delete(runID: string, options?: RequestOptions): APIPromise<MessagesAPI.Run> {
-    return this._client.delete(path`/v1/runs/${runID}`, options);
-  }
-
-  /**
-   * List all active runs.
-   *
-   * @deprecated
-   */
-  listActive(
-    query: RunListActiveParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<RunListActiveResponse> {
-    return this._client.get('/v1/runs/active', { query, ...options });
-  }
-
-  /**
-   * Get response messages associated with a run.
-   */
-  listMessages(
-    runID: string,
-    query: RunListMessagesParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<RunListMessagesResponse> {
-    return this._client.get(path`/v1/runs/${runID}/messages`, { query, ...options });
-  }
-
-  /**
-   * Get messages associated with a run with filtering options.
-   *
-   * Args: run_id: ID of the run before: A cursor for use in pagination. `before` is
-   * an object ID that defines your place in the list. For instance, if you make a
-   * list request and receive 100 objects, starting with obj_foo, your subsequent
-   * call can include before=obj_foo in order to fetch the previous page of the list.
-   * after: A cursor for use in pagination. `after` is an object ID that defines your
-   * place in the list. For instance, if you make a list request and receive 100
-   * objects, ending with obj_foo, your subsequent call can include after=obj_foo in
-   * order to fetch the next page of the list. limit: Maximum number of steps to
-   * return order: Sort order by the created_at timestamp of the objects. asc for
-   * ascending order and desc for descending order.
-   *
-   * Returns: A list of steps associated with the run.
-   */
-  listSteps(
-    runID: string,
-    query: RunListStepsParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<RunListStepsResponse> {
-    return this._client.get(path`/v1/runs/${runID}/steps`, { query, ...options });
-  }
-
-  /**
-   * Retrieve Stream
-   */
-  retrieveStream(
-    runID: string,
-    body: RunRetrieveStreamParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<unknown> {
-    return this._client.post(path`/v1/runs/${runID}/stream`, { body, ...options });
-  }
-
-  /**
-   * Get usage statistics for a run.
-   */
-  retrieveUsage(runID: string, options?: RequestOptions): APIPromise<RunRetrieveUsageResponse> {
-    return this._client.get(path`/v1/runs/${runID}/usage`, options);
-  }
-}
-
-export type StopReasonType =
-  | 'end_turn'
-  | 'error'
-  | 'llm_api_error'
-  | 'invalid_llm_response'
-  | 'invalid_tool_call'
-  | 'max_steps'
-  | 'no_tool_call'
-  | 'tool_rule'
-  | 'cancelled'
-  | 'requires_approval';
-
-export type RunListResponse = Array<MessagesAPI.Run>;
-
-export type RunListActiveResponse = Array<MessagesAPI.Run>;
-
-export type RunListMessagesResponse = Array<MessagesAPI.LettaMessageUnion>;
-
-export type RunListStepsResponse = Array<StepsAPI.Step>;
-
-export type RunRetrieveStreamResponse = unknown;
-
-export interface RunRetrieveUsageResponse {
-  completion_tokens?: number;
-
-  completion_tokens_details?: RunRetrieveUsageResponse.CompletionTokensDetails | null;
-
-  prompt_tokens?: number;
-
-  prompt_tokens_details?: RunRetrieveUsageResponse.PromptTokensDetails | null;
-
-  total_tokens?: number;
-}
-
-export namespace RunRetrieveUsageResponse {
-  export interface CompletionTokensDetails {
-    reasoning_tokens?: number;
-  }
-
-  export interface PromptTokensDetails {
-    cached_tokens?: number;
-  }
-}
-
-export interface RunListParams {
-  /**
-   * Filter for active runs.
-   */
-  active?: boolean;
-
-  /**
-   * Cursor for pagination
-   */
-  after?: string | null;
-
-  /**
-   * The unique identifier of the agent associated with the run.
-   */
-  agent_ids?: Array<string> | null;
-
-  /**
-   * Whether to sort agents oldest to newest (True) or newest to oldest (False,
-   * default)
-   */
-  ascending?: boolean;
-
-  /**
-   * If True, filters for runs that were created in background mode.
-   */
-  background?: boolean | null;
-
-  /**
-   * Cursor for pagination
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of runs to return
-   */
-  limit?: number | null;
-
-  /**
-   * Filter runs by stop reason.
-   */
-  stop_reason?: StopReasonType | null;
-}
-
-export interface RunListActiveParams {
-  /**
-   * The unique identifier of the agent associated with the run.
-   */
-  agent_ids?: Array<string> | null;
-
-  /**
-   * If True, filters for runs that were created in background mode.
-   */
-  background?: boolean | null;
-}
-
-export interface RunListMessagesParams {
-  /**
-   * 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';
-}
-
-export interface RunListStepsParams {
-  /**
-   * Cursor for pagination
-   */
-  after?: string | null;
-
-  /**
-   * Cursor for pagination
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of messages to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order by the created_at timestamp of the objects. asc for ascending order
-   * and desc for descending order.
-   */
-  order?: string;
-}
-
-export interface RunRetrieveStreamParams {
-  /**
-   * Number of entries to read per batch.
-   */
-  batch_size?: number | null;
-
-  /**
-   * Whether to include periodic keepalive ping messages in the stream to prevent
-   * connection timeouts.
-   */
-  include_pings?: boolean | null;
-
-  /**
-   * Seconds to wait between polls when no new data.
-   */
-  poll_interval?: number | null;
-
-  /**
-   * Sequence id to use as a cursor for pagination. Response will start streaming
-   * after this chunk sequence id
-   */
-  starting_after?: number;
-}
-
-export declare namespace Runs {
-  export {
-    type StopReasonType as StopReasonType,
-    type RunListResponse as RunListResponse,
-    type RunListActiveResponse as RunListActiveResponse,
-    type RunListMessagesResponse as RunListMessagesResponse,
-    type RunListStepsResponse as RunListStepsResponse,
-    type RunRetrieveStreamResponse as RunRetrieveStreamResponse,
-    type RunRetrieveUsageResponse as RunRetrieveUsageResponse,
-    type RunListParams as RunListParams,
-    type RunListActiveParams as RunListActiveParams,
-    type RunListMessagesParams as RunListMessagesParams,
-    type RunListStepsParams as RunListStepsParams,
-    type RunRetrieveStreamParams as RunRetrieveStreamParams,
-  };
-}
+export * from './runs/index';

package/src/resources/steps/feedback.ts

@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as StepsAPI from './steps';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Feedback extends APIResource {
+  /**
+   * Modify feedback for a given step.
+   */
+  create(stepID: string, body: FeedbackCreateParams, options?: RequestOptions): APIPromise<StepsAPI.Step> {
+    return this._client.patch(path`/v1/steps/${stepID}/feedback`, { body, ...options });
+  }
+}
+
+export interface FeedbackCreateParams {
+  /**
+   * 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 Feedback {
+  export { type FeedbackCreateParams as FeedbackCreateParams };
+}

package/src/resources/steps/index.ts

@@ -0,0 +1,7 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Feedback, type FeedbackCreateParams } from './feedback';
+export { Messages, type MessageListResponse, type MessageListParams } from './messages';
+export { Metrics, type MetricRetrieveResponse } from './metrics';
+export { Steps, type ProviderTrace, type Step, type StepListResponse, type StepListParams } from './steps';
+export { Trace } from './trace';

package/src/resources/steps/messages.ts

@@ -0,0 +1,67 @@
+// 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 MessagesAPI from '../agents/messages';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Messages extends APIResource {
+  /**
+   * List messages for a given step.
+   */
+  list(
+    stepID: string,
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MessageListResponse> {
+    return this._client.get(path`/v1/steps/${stepID}/messages`, { query, ...options });
+  }
+}
+
+export type MessageListResponse = Array<
+  | MessagesAPI.SystemMessage
+  | MessagesAPI.UserMessage
+  | MessagesAPI.ReasoningMessage
+  | MessagesAPI.HiddenReasoningMessage
+  | MessagesAPI.ToolCallMessage
+  | ToolsAPI.ToolReturnMessage
+  | MessagesAPI.AssistantMessage
+  | MessagesAPI.ApprovalRequestMessage
+  | MessagesAPI.ApprovalResponseMessage
+>;
+
+export interface MessageListParams {
+  /**
+   * 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 declare namespace Messages {
+  export { type MessageListResponse as MessageListResponse, type MessageListParams as MessageListParams };
+}

package/src/resources/steps/metrics.ts

@@ -0,0 +1,81 @@
+// 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 { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Metrics extends APIResource {
+  /**
+   * Get step metrics by step ID.
+   */
+  retrieve(stepID: string, options?: RequestOptions): APIPromise<MetricRetrieveResponse> {
+    return this._client.get(path`/v1/steps/${stepID}/metrics`, options);
+  }
+}
+
+export interface MetricRetrieveResponse {
+  /**
+   * 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;
+
+  /**
+   * 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;
+
+  /**
+   * The unique identifier of the run.
+   */
+  run_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 declare namespace Metrics {
+  export { type MetricRetrieveResponse as MetricRetrieveResponse };
+}