@letta-ai/letta-client 1.6.4 → 1.6.6

package/src/resources/runs/runs.ts

@@ -7,6 +7,8 @@ import * as RunsMessagesAPI from './messages';
 import { MessageListParams, MessageStreamParams, MessageStreamResponse, Messages } from './messages';
 import * as StepsAPI from './steps';
 import { StepListParams, Steps } from './steps';
+import * as TraceAPI from './trace';
+import { Trace, TraceRetrieveParams, TraceRetrieveResponse } from './trace';
 import * as UsageAPI from './usage';
 import { Usage, UsageRetrieveResponse } from './usage';
 import { APIPromise } from '../../core/api-promise';
@@ -18,6 +20,7 @@ export class Runs extends APIResource {
   messages: RunsMessagesAPI.Messages = new RunsMessagesAPI.Messages(this._client);
   usage: UsageAPI.Usage = new UsageAPI.Usage(this._client);
   steps: StepsAPI.Steps = new StepsAPI.Steps(this._client);
+  trace: TraceAPI.Trace = new TraceAPI.Trace(this._client);
 
   /**
    * Get the status of a run.
@@ -175,6 +178,11 @@ export interface RunListParams extends ArrayPageParams {
    */
   background?: boolean | null;
 
+  /**
+   * Filter runs by conversation ID.
+   */
+  conversation_id?: string | null;
+
   /**
    * Filter runs by status. Can specify multiple statuses.
    */
@@ -189,6 +197,7 @@ export interface RunListParams extends ArrayPageParams {
 Runs.Messages = Messages;
 Runs.Usage = Usage;
 Runs.Steps = Steps;
+Runs.Trace = Trace;
 
 export declare namespace Runs {
   export { type Job as Job, type StopReasonType as StopReasonType, type RunListParams as RunListParams };
@@ -203,6 +212,12 @@ export declare namespace Runs {
   export { Usage as Usage, type UsageRetrieveResponse as UsageRetrieveResponse };
 
   export { Steps as Steps, type StepListParams as StepListParams };
+
+  export {
+    Trace as Trace,
+    type TraceRetrieveResponse as TraceRetrieveResponse,
+    type TraceRetrieveParams as TraceRetrieveParams,
+  };
 }
 
 export { type RunsArrayPage };

package/src/resources/runs/trace.ts

@@ -0,0 +1,44 @@
+// 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 Trace extends APIResource {
+  /**
+   * Retrieve OTEL trace spans for a run.
+   *
+   * Returns a filtered set of spans relevant for observability:
+   *
+   * - agent_step: Individual agent reasoning steps
+   * - tool executions: Tool call spans
+   * - Root span: The top-level request span
+   * - time_to_first_token: TTFT measurement span
+   *
+   * Requires ClickHouse to be configured for trace storage.
+   */
+  retrieve(
+    runID: string,
+    query: TraceRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TraceRetrieveResponse> {
+    return this._client.get(path`/v1/runs/${runID}/trace`, { query, ...options });
+  }
+}
+
+export type TraceRetrieveResponse = Array<{ [key: string]: unknown }>;
+
+export interface TraceRetrieveParams {
+  /**
+   * Maximum number of spans to return
+   */
+  limit?: number;
+}
+
+export declare namespace Trace {
+  export {
+    type TraceRetrieveResponse as TraceRetrieveResponse,
+    type TraceRetrieveParams as TraceRetrieveParams,
+  };
+}

package/src/resources/tags.ts

@@ -6,7 +6,7 @@ import { RequestOptions } from '../internal/request-options';
 
 export class Tags extends APIResource {
   /**
-   * Get the list of all agent tags that have been created.
+   * Get the list of all tags (from agents and blocks) that have been created.
    */
   list(query: TagListParams | null | undefined = {}, options?: RequestOptions): APIPromise<TagListResponse> {
     return this._client.get('/v1/tags/', { query, ...options });

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.6.4'; // x-release-please-version
+export const VERSION = '1.6.6'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.6.4";
+export declare const VERSION = "1.6.6";
 //# 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.6.4'; // x-release-please-version
+exports.VERSION = '1.6.6'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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