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

package/resources/steps/metrics.d.mts

@@ -0,0 +1,63 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Metrics extends APIResource {
+    /**
+     * Get step metrics by step ID.
+     */
+    retrieve(stepID: string, options?: RequestOptions): APIPromise<MetricRetrieveResponse>;
+}
+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 };
+}
+//# sourceMappingURL=metrics.d.mts.map

package/resources/steps/metrics.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.mts","sourceRoot":"","sources":["../../src/resources/steps/metrics.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;CAGvF;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EAAE,KAAK,sBAAsB,IAAI,sBAAsB,EAAE,CAAC;CAClE"}

package/resources/steps/metrics.d.ts

@@ -0,0 +1,63 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Metrics extends APIResource {
+    /**
+     * Get step metrics by step ID.
+     */
+    retrieve(stepID: string, options?: RequestOptions): APIPromise<MetricRetrieveResponse>;
+}
+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 };
+}
+//# sourceMappingURL=metrics.d.ts.map

package/resources/steps/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/resources/steps/metrics.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,sBAAsB,CAAC;CAGvF;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EAAE,KAAK,sBAAsB,IAAI,sBAAsB,EAAE,CAAC;CAClE"}

package/resources/steps/metrics.js

@@ -0,0 +1,16 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Metrics = void 0;
+const resource_1 = require("../../core/resource.js");
+const path_1 = require("../../internal/utils/path.js");
+class Metrics extends resource_1.APIResource {
+    /**
+     * Get step metrics by step ID.
+     */
+    retrieve(stepID, options) {
+        return this._client.get((0, path_1.path) `/v1/steps/${stepID}/metrics`, options);
+    }
+}
+exports.Metrics = Metrics;
+//# sourceMappingURL=metrics.js.map

package/resources/steps/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/resources/steps/metrics.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;OAEG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,UAAU,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF;AAPD,0BAOC"}

package/resources/steps/metrics.mjs

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Metrics extends APIResource {
+    /**
+     * Get step metrics by step ID.
+     */
+    retrieve(stepID, options) {
+        return this._client.get(path `/v1/steps/${stepID}/metrics`, options);
+    }
+}
+//# sourceMappingURL=metrics.mjs.map

package/resources/steps/metrics.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.mjs","sourceRoot":"","sources":["../../src/resources/steps/metrics.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,MAAM,UAAU,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACF"}

package/resources/steps/steps.d.mts

@@ -0,0 +1,227 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as MessagesAPI from "../agents/messages.mjs";
+import * as RunsAPI from "../runs/runs.mjs";
+import * as FeedbackAPI from "./feedback.mjs";
+import { Feedback, FeedbackCreateParams } from "./feedback.mjs";
+import * as StepsMessagesAPI from "./messages.mjs";
+import { MessageListParams, MessageListResponse, MessageListResponsesArrayPage, Messages } from "./messages.mjs";
+import * as MetricsAPI from "./metrics.mjs";
+import { MetricRetrieveResponse, Metrics } from "./metrics.mjs";
+import * as TraceAPI from "./trace.mjs";
+import { Trace } from "./trace.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { ArrayPage, type ArrayPageParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Steps extends APIResource {
+    metrics: MetricsAPI.Metrics;
+    trace: TraceAPI.Trace;
+    feedback: FeedbackAPI.Feedback;
+    messages: StepsMessagesAPI.Messages;
+    /**
+     * Get a step by ID.
+     */
+    retrieve(stepID: string, options?: RequestOptions): APIPromise<Step>;
+    /**
+     * List steps with optional pagination and date filters.
+     */
+    list(query?: StepListParams | null | undefined, options?: RequestOptions): PagePromise<StepsArrayPage, Step>;
+}
+export type StepsArrayPage = ArrayPage<Step>;
+/**
+ * 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;
+    /**
+     * @deprecated The messages generated during this step. Deprecated: use
+     * `GET /v1/steps/{step_id}/messages` endpoint instead
+     */
+    messages?: Array<MessagesAPI.InternalMessage>;
+    /**
+     * 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;
+    /**
+     * The unique identifier of the run that this step belongs to. Only included for
+     * async calls.
+     */
+    run_id?: 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 interface StepListParams extends ArrayPageParams {
+    /**
+     * Filter by the ID of the agent that performed the step
+     */
+    agent_id?: string | null;
+    /**
+     * Return steps before this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")
+     */
+    end_date?: string | null;
+    /**
+     * Filter by feedback
+     */
+    feedback?: 'positive' | 'negative' | null;
+    /**
+     * Filter by whether steps have feedback (true) or not (false)
+     */
+    has_feedback?: boolean | null;
+    /**
+     * Filter by the name of the model used for the step
+     */
+    model?: string | null;
+    /**
+     * Filter by the project ID that is associated with the step (cloud only).
+     */
+    project_id?: string | null;
+    /**
+     * Return steps after this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")
+     */
+    start_date?: string | null;
+    /**
+     * Filter by tags
+     */
+    tags?: Array<string> | null;
+    /**
+     * Filter by trace ids returned by the server
+     */
+    trace_ids?: Array<string> | null;
+}
+export declare namespace Steps {
+    export { type ProviderTrace as ProviderTrace, type Step as Step, type StepsArrayPage as StepsArrayPage, type StepListParams as StepListParams, };
+    export { Metrics as Metrics, type MetricRetrieveResponse as MetricRetrieveResponse };
+    export { Trace as Trace };
+    export { Feedback as Feedback, type FeedbackCreateParams as FeedbackCreateParams };
+    export { Messages as Messages, type MessageListResponse as MessageListResponse, type MessageListResponsesArrayPage as MessageListResponsesArrayPage, type MessageListParams as MessageListParams, };
+}
+//# sourceMappingURL=steps.d.mts.map

package/resources/steps/steps.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.mts","sourceRoot":"","sources":["../../src/resources/steps/steps.ts"],"names":[],"mappings":"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"}

package/resources/steps/steps.d.ts

@@ -0,0 +1,227 @@
+import { APIResource } from "../../core/resource.js";
+import * as MessagesAPI from "../agents/messages.js";
+import * as RunsAPI from "../runs/runs.js";
+import * as FeedbackAPI from "./feedback.js";
+import { Feedback, FeedbackCreateParams } from "./feedback.js";
+import * as StepsMessagesAPI from "./messages.js";
+import { MessageListParams, MessageListResponse, MessageListResponsesArrayPage, Messages } from "./messages.js";
+import * as MetricsAPI from "./metrics.js";
+import { MetricRetrieveResponse, Metrics } from "./metrics.js";
+import * as TraceAPI from "./trace.js";
+import { Trace } from "./trace.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { ArrayPage, type ArrayPageParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Steps extends APIResource {
+    metrics: MetricsAPI.Metrics;
+    trace: TraceAPI.Trace;
+    feedback: FeedbackAPI.Feedback;
+    messages: StepsMessagesAPI.Messages;
+    /**
+     * Get a step by ID.
+     */
+    retrieve(stepID: string, options?: RequestOptions): APIPromise<Step>;
+    /**
+     * List steps with optional pagination and date filters.
+     */
+    list(query?: StepListParams | null | undefined, options?: RequestOptions): PagePromise<StepsArrayPage, Step>;
+}
+export type StepsArrayPage = ArrayPage<Step>;
+/**
+ * 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;
+    /**
+     * @deprecated The messages generated during this step. Deprecated: use
+     * `GET /v1/steps/{step_id}/messages` endpoint instead
+     */
+    messages?: Array<MessagesAPI.InternalMessage>;
+    /**
+     * 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;
+    /**
+     * The unique identifier of the run that this step belongs to. Only included for
+     * async calls.
+     */
+    run_id?: 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 interface StepListParams extends ArrayPageParams {
+    /**
+     * Filter by the ID of the agent that performed the step
+     */
+    agent_id?: string | null;
+    /**
+     * Return steps before this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")
+     */
+    end_date?: string | null;
+    /**
+     * Filter by feedback
+     */
+    feedback?: 'positive' | 'negative' | null;
+    /**
+     * Filter by whether steps have feedback (true) or not (false)
+     */
+    has_feedback?: boolean | null;
+    /**
+     * Filter by the name of the model used for the step
+     */
+    model?: string | null;
+    /**
+     * Filter by the project ID that is associated with the step (cloud only).
+     */
+    project_id?: string | null;
+    /**
+     * Return steps after this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")
+     */
+    start_date?: string | null;
+    /**
+     * Filter by tags
+     */
+    tags?: Array<string> | null;
+    /**
+     * Filter by trace ids returned by the server
+     */
+    trace_ids?: Array<string> | null;
+}
+export declare namespace Steps {
+    export { type ProviderTrace as ProviderTrace, type Step as Step, type StepsArrayPage as StepsArrayPage, type StepListParams as StepListParams, };
+    export { Metrics as Metrics, type MetricRetrieveResponse as MetricRetrieveResponse };
+    export { Trace as Trace };
+    export { Feedback as Feedback, type FeedbackCreateParams as FeedbackCreateParams };
+    export { Messages as Messages, type MessageListResponse as MessageListResponse, type MessageListResponsesArrayPage as MessageListResponsesArrayPage, type MessageListParams as MessageListParams, };
+}
+//# sourceMappingURL=steps.d.ts.map

package/resources/steps/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/resources/steps/steps.ts"],"names":[],"mappings":"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"}