@rustrak/client 0.14.2 → 0.14.4

package/dist/index.d.cts

@@ -121,24 +121,61 @@ declare const agentTraceSummarySchema: z.ZodObject<{
     duration_ms: z.ZodNullable<z.ZodNumber>;
     total_tokens: z.ZodNumber;
     tool_call_count: z.ZodNumber;
+    llm_call_count: z.ZodNumber;
+    error_count: z.ZodNumber;
     started_at: z.ZodString;
 }, z.core.$strip>;
+declare const agentSummarySchema: z.ZodObject<{
+    agent_runs: z.ZodNumber;
+    llm_calls: z.ZodNumber;
+    tool_calls: z.ZodNumber;
+    error_count: z.ZodNumber;
+    total_tokens: z.ZodNumber;
+    avg_duration_ms: z.ZodNumber;
+    p95_duration_ms: z.ZodNumber;
+}, z.core.$strip>;
+declare const agentModelRowSchema: z.ZodObject<{
+    model: z.ZodString;
+    requests: z.ZodNumber;
+    errors: z.ZodNumber;
+    avg_ms: z.ZodNumber;
+    p95_ms: z.ZodNumber;
+    input_tokens: z.ZodNumber;
+    cached_input_tokens: z.ZodNumber;
+    output_tokens: z.ZodNumber;
+    reasoning_output_tokens: z.ZodNumber;
+    total_tokens: z.ZodNumber;
+}, z.core.$strip>;
+declare const agentToolRowSchema: z.ZodObject<{
+    tool: z.ZodString;
+    calls: z.ZodNumber;
+    errors: z.ZodNumber;
+    avg_ms: z.ZodNumber;
+    p95_ms: z.ZodNumber;
+}, z.core.$strip>;
 
 type AgentTimeseriesPoint = z.infer<typeof agentTimeseriesPointSchema>;
 type AgentDurationPoint = z.infer<typeof agentDurationPointSchema>;
 type GenAiBreakdownRow = z.infer<typeof genAiBreakdownRowSchema>;
 type AgentTraceSummary = z.infer<typeof agentTraceSummarySchema>;
+type AgentSummary = z.infer<typeof agentSummarySchema>;
+type AgentModelRow = z.infer<typeof agentModelRowSchema>;
+type AgentToolRow = z.infer<typeof agentToolRowSchema>;
 interface AgentTimeseriesOptions {
     period_hours?: number;
     interval_hours?: number;
+    environment?: string;
 }
 interface AgentBreakdownOptions {
     period_hours?: number;
     limit?: number;
+    environment?: string;
 }
 interface AgentTracesOptions {
     page?: number;
     per_page?: number;
+    period_hours?: number;
+    environment?: string;
 }
 
 declare const providerTypeSchema: z.ZodEnum<{
@@ -979,6 +1016,36 @@ declare const spanSchema: z.ZodObject<{
     gen_ai_usage_output_tokens: z.ZodNullable<z.ZodNumber>;
     gen_ai_usage_total_tokens: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
+declare const spanDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+    transaction_id: z.ZodNullable<z.ZodString>;
+    span_id: z.ZodNullable<z.ZodString>;
+    trace_id: z.ZodNullable<z.ZodString>;
+    parent_span_id: z.ZodNullable<z.ZodString>;
+    op: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodString>;
+    start_timestamp: z.ZodNullable<z.ZodString>;
+    timestamp: z.ZodNullable<z.ZodString>;
+    duration_ms: z.ZodNullable<z.ZodNumber>;
+    exclusive_time_ms: z.ZodNullable<z.ZodNumber>;
+    is_segment: z.ZodBoolean;
+    segment_id: z.ZodNullable<z.ZodString>;
+    platform: z.ZodNullable<z.ZodString>;
+    release: z.ZodNullable<z.ZodString>;
+    environment: z.ZodNullable<z.ZodString>;
+    gen_ai_operation_type: z.ZodNullable<z.ZodString>;
+    gen_ai_agent_name: z.ZodNullable<z.ZodString>;
+    gen_ai_request_model: z.ZodNullable<z.ZodString>;
+    gen_ai_response_model: z.ZodNullable<z.ZodString>;
+    gen_ai_tool_name: z.ZodNullable<z.ZodString>;
+    gen_ai_conversation_id: z.ZodNullable<z.ZodString>;
+    gen_ai_usage_input_tokens: z.ZodNullable<z.ZodNumber>;
+    gen_ai_usage_output_tokens: z.ZodNullable<z.ZodNumber>;
+    gen_ai_usage_total_tokens: z.ZodNullable<z.ZodNumber>;
+    attributes: z.ZodRecord<z.ZodString, z.ZodAny>;
+    tags: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+}, z.core.$strip>;
 declare const transactionStatsSchema: z.ZodObject<{
     transaction_name: z.ZodString;
     op: z.ZodNullable<z.ZodString>;
@@ -992,6 +1059,7 @@ declare const transactionStatsSchema: z.ZodObject<{
 type Transaction = z.infer<typeof transactionSchema>;
 type TransactionDetail = z.infer<typeof transactionDetailSchema>;
 type Span = z.infer<typeof spanSchema>;
+type SpanDetail = z.infer<typeof spanDetailSchema>;
 type TransactionStats = z.infer<typeof transactionStatsSchema>;
 interface ListSpansOptions {
     page?: number;
@@ -1010,6 +1078,12 @@ declare const userSchema: z.ZodObject<{
         member: "member";
     }>;
     is_admin: z.ZodBoolean;
+    language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+declare const updatePreferencesRequestSchema: z.ZodObject<{
+    language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 declare const authResponseSchema: z.ZodObject<{
     user: z.ZodObject<{
@@ -1020,6 +1094,8 @@ declare const authResponseSchema: z.ZodObject<{
             member: "member";
         }>;
         is_admin: z.ZodBoolean;
+        language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 declare const loginResultSchema: z.ZodObject<{
@@ -1031,6 +1107,8 @@ declare const loginResultSchema: z.ZodObject<{
             member: "member";
         }>;
         is_admin: z.ZodBoolean;
+        language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
     cookies: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
@@ -1044,6 +1122,7 @@ declare const registerRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 
 type User = z.infer<typeof userSchema>;
+type UpdatePreferencesRequest = z.infer<typeof updatePreferencesRequestSchema>;
 type AuthResponse = z.infer<typeof authResponseSchema>;
 type LoginResult = z.infer<typeof loginResultSchema>;
 type LoginRequest = z.infer<typeof loginRequestSchema>;
@@ -1067,6 +1146,10 @@ declare class AgentsResource extends BaseResource {
     getModelsByTokens(projectId: number, options?: AgentBreakdownOptions): Promise<Result<GenAiBreakdownRow[], RustrakError>>;
     getTools(projectId: number, options?: AgentBreakdownOptions): Promise<Result<GenAiBreakdownRow[], RustrakError>>;
     getTraces(projectId: number, options?: AgentTracesOptions): Promise<Result<OffsetPaginatedResponse<AgentTraceSummary>, RustrakError>>;
+    getSummary(projectId: number, options?: AgentBreakdownOptions): Promise<Result<AgentSummary, RustrakError>>;
+    getModelsTable(projectId: number, options?: AgentBreakdownOptions): Promise<Result<AgentModelRow[], RustrakError>>;
+    getToolsTable(projectId: number, options?: AgentBreakdownOptions): Promise<Result<AgentToolRow[], RustrakError>>;
+    getEnvironments(projectId: number): Promise<Result<string[], RustrakError>>;
 }
 
 declare class AlertIntegrationsResource extends BaseResource {
@@ -1092,6 +1175,7 @@ declare class AuthResource extends BaseResource {
     login(credentials: LoginRequest): Promise<Result<LoginResult, RustrakError>>;
     logout(): Promise<Result<string[], RustrakError>>;
     getCurrentUser(): Promise<Result<User, RustrakError>>;
+    updatePreferences(preferences: UpdatePreferencesRequest): Promise<Result<User, RustrakError>>;
     getInvitation(token: string): Promise<Result<InvitationInfo, RustrakError>>;
     acceptInvitation(input: AcceptInvitation): Promise<Result<LoginResult, RustrakError>>;
     private readLoginResult;
@@ -1183,6 +1267,7 @@ declare class SourceMapsResource extends BaseResource {
 
 declare class SpansResource extends BaseResource {
     list(projectId: number, options?: ListSpansOptions): Promise<Result<OffsetPaginatedResponse<Span>, RustrakError>>;
+    get(projectId: number, spanId: string): Promise<Result<SpanDetail, RustrakError>>;
 }
 
 declare class StatsResource extends BaseResource {
@@ -1248,4 +1333,4 @@ declare class RustrakClient {
     constructor(config: ClientConfig);
 }
 
-export { type AcceptInvitation, type ActivityEntry, type AgentBreakdownOptions, type AgentDurationPoint, type AgentTimeseriesOptions, type AgentTimeseriesPoint, type AgentTraceSummary, type AgentTracesOptions, type AlertHistory, type AlertIntegration, type AlertRule, type AlertRuleChannelInput, type AlertStatus, type AlertType, type ApiError, type AssembleInput, type AssembleResponse, type AuthResponse, type AuthToken, type AuthTokenCreated, type BulkDeleteIssues, type BulkUpdateIssues, type ChunkUploadCapability, type CleanupCounts, type CleanupOptions, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateComment, type CreateInvitation, type CreateProject, type CreateUserReport, Err, type Event, type EventDetail, type EventTimeseries, type EventTimeseriesPoint, FIELD_ERROR_CODES, type FieldError, type FieldErrorCode, type GenAiBreakdownRow, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueAggregates, type IssueFilter, type IssueHash, type IssuePriority, type IssueSort, type IssueStats, type IssueStatsWindow, type IssueStatus, type IssueTagValue, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListLogsOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListSpansOptions, type ListTransactionsOptions, type Log, type LoginRequest, type LoginResult, type MetricDelta, NETWORK_ERROR_MESSAGE, type OffsetPaginatedResponse, Ok, type PaginatedResponse, type Project, type ProjectListStats, type ProjectMember, type ProjectRole, type ProjectStatsSummary, type ProjectStorage, type ProviderType, type RegisterRequest, type ReleaseHealthRow, type ReleaseHealthStatsOptions, type Result, type RoutingOverride, RustrakClient, type RustrakError, type RustrakErrorKind, SERVER_ERROR_MESSAGE, type ServerVersion, type SessionSummary, type SessionTimeseries, type SessionTimeseriesPoint, type SortOrder, type SourceMapFile, type SourceMapGcResult, type SourceMapStorage, type Span, type StorageSummary, TIMEOUT_ERROR_MESSAGE, type TagSummary, type TagValueCount, type TeamMember, type TestChannelResponse, type TestIntegrationBody, type Transaction, type TransactionDetail, type TransactionStats, type UpdateAlertIntegration, type UpdateAlertRule, type UpdateIssueState, type UpdateProject, type UpdateUserRole, type UpsertProjectMember, type User, type UserReport, isRetryable, mapResult, unwrap, unwrapOr };
+export { type AcceptInvitation, type ActivityEntry, type AgentBreakdownOptions, type AgentDurationPoint, type AgentModelRow, type AgentSummary, type AgentTimeseriesOptions, type AgentTimeseriesPoint, type AgentToolRow, type AgentTraceSummary, type AgentTracesOptions, type AlertHistory, type AlertIntegration, type AlertRule, type AlertRuleChannelInput, type AlertStatus, type AlertType, type ApiError, type AssembleInput, type AssembleResponse, type AuthResponse, type AuthToken, type AuthTokenCreated, type BulkDeleteIssues, type BulkUpdateIssues, type ChunkUploadCapability, type CleanupCounts, type CleanupOptions, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateComment, type CreateInvitation, type CreateProject, type CreateUserReport, Err, type Event, type EventDetail, type EventTimeseries, type EventTimeseriesPoint, FIELD_ERROR_CODES, type FieldError, type FieldErrorCode, type GenAiBreakdownRow, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueAggregates, type IssueFilter, type IssueHash, type IssuePriority, type IssueSort, type IssueStats, type IssueStatsWindow, type IssueStatus, type IssueTagValue, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListLogsOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListSpansOptions, type ListTransactionsOptions, type Log, type LoginRequest, type LoginResult, type MetricDelta, NETWORK_ERROR_MESSAGE, type OffsetPaginatedResponse, Ok, type PaginatedResponse, type Project, type ProjectListStats, type ProjectMember, type ProjectRole, type ProjectStatsSummary, type ProjectStorage, type ProviderType, type RegisterRequest, type ReleaseHealthRow, type ReleaseHealthStatsOptions, type Result, type RoutingOverride, RustrakClient, type RustrakError, type RustrakErrorKind, SERVER_ERROR_MESSAGE, type ServerVersion, type SessionSummary, type SessionTimeseries, type SessionTimeseriesPoint, type SortOrder, type SourceMapFile, type SourceMapGcResult, type SourceMapStorage, type Span, type SpanDetail, type StorageSummary, TIMEOUT_ERROR_MESSAGE, type TagSummary, type TagValueCount, type TeamMember, type TestChannelResponse, type TestIntegrationBody, type Transaction, type TransactionDetail, type TransactionStats, type UpdateAlertIntegration, type UpdateAlertRule, type UpdateIssueState, type UpdateProject, type UpdateUserRole, type UpsertProjectMember, type User, type UserReport, isRetryable, mapResult, unwrap, unwrapOr };

package/dist/index.d.ts

@@ -121,24 +121,61 @@ declare const agentTraceSummarySchema: z.ZodObject<{
     duration_ms: z.ZodNullable<z.ZodNumber>;
     total_tokens: z.ZodNumber;
     tool_call_count: z.ZodNumber;
+    llm_call_count: z.ZodNumber;
+    error_count: z.ZodNumber;
     started_at: z.ZodString;
 }, z.core.$strip>;
+declare const agentSummarySchema: z.ZodObject<{
+    agent_runs: z.ZodNumber;
+    llm_calls: z.ZodNumber;
+    tool_calls: z.ZodNumber;
+    error_count: z.ZodNumber;
+    total_tokens: z.ZodNumber;
+    avg_duration_ms: z.ZodNumber;
+    p95_duration_ms: z.ZodNumber;
+}, z.core.$strip>;
+declare const agentModelRowSchema: z.ZodObject<{
+    model: z.ZodString;
+    requests: z.ZodNumber;
+    errors: z.ZodNumber;
+    avg_ms: z.ZodNumber;
+    p95_ms: z.ZodNumber;
+    input_tokens: z.ZodNumber;
+    cached_input_tokens: z.ZodNumber;
+    output_tokens: z.ZodNumber;
+    reasoning_output_tokens: z.ZodNumber;
+    total_tokens: z.ZodNumber;
+}, z.core.$strip>;
+declare const agentToolRowSchema: z.ZodObject<{
+    tool: z.ZodString;
+    calls: z.ZodNumber;
+    errors: z.ZodNumber;
+    avg_ms: z.ZodNumber;
+    p95_ms: z.ZodNumber;
+}, z.core.$strip>;
 
 type AgentTimeseriesPoint = z.infer<typeof agentTimeseriesPointSchema>;
 type AgentDurationPoint = z.infer<typeof agentDurationPointSchema>;
 type GenAiBreakdownRow = z.infer<typeof genAiBreakdownRowSchema>;
 type AgentTraceSummary = z.infer<typeof agentTraceSummarySchema>;
+type AgentSummary = z.infer<typeof agentSummarySchema>;
+type AgentModelRow = z.infer<typeof agentModelRowSchema>;
+type AgentToolRow = z.infer<typeof agentToolRowSchema>;
 interface AgentTimeseriesOptions {
     period_hours?: number;
     interval_hours?: number;
+    environment?: string;
 }
 interface AgentBreakdownOptions {
     period_hours?: number;
     limit?: number;
+    environment?: string;
 }
 interface AgentTracesOptions {
     page?: number;
     per_page?: number;
+    period_hours?: number;
+    environment?: string;
 }
 
 declare const providerTypeSchema: z.ZodEnum<{
@@ -979,6 +1016,36 @@ declare const spanSchema: z.ZodObject<{
     gen_ai_usage_output_tokens: z.ZodNullable<z.ZodNumber>;
     gen_ai_usage_total_tokens: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
+declare const spanDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+    transaction_id: z.ZodNullable<z.ZodString>;
+    span_id: z.ZodNullable<z.ZodString>;
+    trace_id: z.ZodNullable<z.ZodString>;
+    parent_span_id: z.ZodNullable<z.ZodString>;
+    op: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodString>;
+    start_timestamp: z.ZodNullable<z.ZodString>;
+    timestamp: z.ZodNullable<z.ZodString>;
+    duration_ms: z.ZodNullable<z.ZodNumber>;
+    exclusive_time_ms: z.ZodNullable<z.ZodNumber>;
+    is_segment: z.ZodBoolean;
+    segment_id: z.ZodNullable<z.ZodString>;
+    platform: z.ZodNullable<z.ZodString>;
+    release: z.ZodNullable<z.ZodString>;
+    environment: z.ZodNullable<z.ZodString>;
+    gen_ai_operation_type: z.ZodNullable<z.ZodString>;
+    gen_ai_agent_name: z.ZodNullable<z.ZodString>;
+    gen_ai_request_model: z.ZodNullable<z.ZodString>;
+    gen_ai_response_model: z.ZodNullable<z.ZodString>;
+    gen_ai_tool_name: z.ZodNullable<z.ZodString>;
+    gen_ai_conversation_id: z.ZodNullable<z.ZodString>;
+    gen_ai_usage_input_tokens: z.ZodNullable<z.ZodNumber>;
+    gen_ai_usage_output_tokens: z.ZodNullable<z.ZodNumber>;
+    gen_ai_usage_total_tokens: z.ZodNullable<z.ZodNumber>;
+    attributes: z.ZodRecord<z.ZodString, z.ZodAny>;
+    tags: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+}, z.core.$strip>;
 declare const transactionStatsSchema: z.ZodObject<{
     transaction_name: z.ZodString;
     op: z.ZodNullable<z.ZodString>;
@@ -992,6 +1059,7 @@ declare const transactionStatsSchema: z.ZodObject<{
 type Transaction = z.infer<typeof transactionSchema>;
 type TransactionDetail = z.infer<typeof transactionDetailSchema>;
 type Span = z.infer<typeof spanSchema>;
+type SpanDetail = z.infer<typeof spanDetailSchema>;
 type TransactionStats = z.infer<typeof transactionStatsSchema>;
 interface ListSpansOptions {
     page?: number;
@@ -1010,6 +1078,12 @@ declare const userSchema: z.ZodObject<{
         member: "member";
     }>;
     is_admin: z.ZodBoolean;
+    language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+declare const updatePreferencesRequestSchema: z.ZodObject<{
+    language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 declare const authResponseSchema: z.ZodObject<{
     user: z.ZodObject<{
@@ -1020,6 +1094,8 @@ declare const authResponseSchema: z.ZodObject<{
             member: "member";
         }>;
         is_admin: z.ZodBoolean;
+        language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 declare const loginResultSchema: z.ZodObject<{
@@ -1031,6 +1107,8 @@ declare const loginResultSchema: z.ZodObject<{
             member: "member";
         }>;
         is_admin: z.ZodBoolean;
+        language: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
     cookies: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
@@ -1044,6 +1122,7 @@ declare const registerRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 
 type User = z.infer<typeof userSchema>;
+type UpdatePreferencesRequest = z.infer<typeof updatePreferencesRequestSchema>;
 type AuthResponse = z.infer<typeof authResponseSchema>;
 type LoginResult = z.infer<typeof loginResultSchema>;
 type LoginRequest = z.infer<typeof loginRequestSchema>;
@@ -1067,6 +1146,10 @@ declare class AgentsResource extends BaseResource {
     getModelsByTokens(projectId: number, options?: AgentBreakdownOptions): Promise<Result<GenAiBreakdownRow[], RustrakError>>;
     getTools(projectId: number, options?: AgentBreakdownOptions): Promise<Result<GenAiBreakdownRow[], RustrakError>>;
     getTraces(projectId: number, options?: AgentTracesOptions): Promise<Result<OffsetPaginatedResponse<AgentTraceSummary>, RustrakError>>;
+    getSummary(projectId: number, options?: AgentBreakdownOptions): Promise<Result<AgentSummary, RustrakError>>;
+    getModelsTable(projectId: number, options?: AgentBreakdownOptions): Promise<Result<AgentModelRow[], RustrakError>>;
+    getToolsTable(projectId: number, options?: AgentBreakdownOptions): Promise<Result<AgentToolRow[], RustrakError>>;
+    getEnvironments(projectId: number): Promise<Result<string[], RustrakError>>;
 }
 
 declare class AlertIntegrationsResource extends BaseResource {
@@ -1092,6 +1175,7 @@ declare class AuthResource extends BaseResource {
     login(credentials: LoginRequest): Promise<Result<LoginResult, RustrakError>>;
     logout(): Promise<Result<string[], RustrakError>>;
     getCurrentUser(): Promise<Result<User, RustrakError>>;
+    updatePreferences(preferences: UpdatePreferencesRequest): Promise<Result<User, RustrakError>>;
     getInvitation(token: string): Promise<Result<InvitationInfo, RustrakError>>;
     acceptInvitation(input: AcceptInvitation): Promise<Result<LoginResult, RustrakError>>;
     private readLoginResult;
@@ -1183,6 +1267,7 @@ declare class SourceMapsResource extends BaseResource {
 
 declare class SpansResource extends BaseResource {
     list(projectId: number, options?: ListSpansOptions): Promise<Result<OffsetPaginatedResponse<Span>, RustrakError>>;
+    get(projectId: number, spanId: string): Promise<Result<SpanDetail, RustrakError>>;
 }
 
 declare class StatsResource extends BaseResource {
@@ -1248,4 +1333,4 @@ declare class RustrakClient {
     constructor(config: ClientConfig);
 }
 
-export { type AcceptInvitation, type ActivityEntry, type AgentBreakdownOptions, type AgentDurationPoint, type AgentTimeseriesOptions, type AgentTimeseriesPoint, type AgentTraceSummary, type AgentTracesOptions, type AlertHistory, type AlertIntegration, type AlertRule, type AlertRuleChannelInput, type AlertStatus, type AlertType, type ApiError, type AssembleInput, type AssembleResponse, type AuthResponse, type AuthToken, type AuthTokenCreated, type BulkDeleteIssues, type BulkUpdateIssues, type ChunkUploadCapability, type CleanupCounts, type CleanupOptions, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateComment, type CreateInvitation, type CreateProject, type CreateUserReport, Err, type Event, type EventDetail, type EventTimeseries, type EventTimeseriesPoint, FIELD_ERROR_CODES, type FieldError, type FieldErrorCode, type GenAiBreakdownRow, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueAggregates, type IssueFilter, type IssueHash, type IssuePriority, type IssueSort, type IssueStats, type IssueStatsWindow, type IssueStatus, type IssueTagValue, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListLogsOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListSpansOptions, type ListTransactionsOptions, type Log, type LoginRequest, type LoginResult, type MetricDelta, NETWORK_ERROR_MESSAGE, type OffsetPaginatedResponse, Ok, type PaginatedResponse, type Project, type ProjectListStats, type ProjectMember, type ProjectRole, type ProjectStatsSummary, type ProjectStorage, type ProviderType, type RegisterRequest, type ReleaseHealthRow, type ReleaseHealthStatsOptions, type Result, type RoutingOverride, RustrakClient, type RustrakError, type RustrakErrorKind, SERVER_ERROR_MESSAGE, type ServerVersion, type SessionSummary, type SessionTimeseries, type SessionTimeseriesPoint, type SortOrder, type SourceMapFile, type SourceMapGcResult, type SourceMapStorage, type Span, type StorageSummary, TIMEOUT_ERROR_MESSAGE, type TagSummary, type TagValueCount, type TeamMember, type TestChannelResponse, type TestIntegrationBody, type Transaction, type TransactionDetail, type TransactionStats, type UpdateAlertIntegration, type UpdateAlertRule, type UpdateIssueState, type UpdateProject, type UpdateUserRole, type UpsertProjectMember, type User, type UserReport, isRetryable, mapResult, unwrap, unwrapOr };
+export { type AcceptInvitation, type ActivityEntry, type AgentBreakdownOptions, type AgentDurationPoint, type AgentModelRow, type AgentSummary, type AgentTimeseriesOptions, type AgentTimeseriesPoint, type AgentToolRow, type AgentTraceSummary, type AgentTracesOptions, type AlertHistory, type AlertIntegration, type AlertRule, type AlertRuleChannelInput, type AlertStatus, type AlertType, type ApiError, type AssembleInput, type AssembleResponse, type AuthResponse, type AuthToken, type AuthTokenCreated, type BulkDeleteIssues, type BulkUpdateIssues, type ChunkUploadCapability, type CleanupCounts, type CleanupOptions, type ClientConfig, type CreateAlertIntegration, type CreateAlertRule, type CreateAuthToken, type CreateComment, type CreateInvitation, type CreateProject, type CreateUserReport, Err, type Event, type EventDetail, type EventTimeseries, type EventTimeseriesPoint, FIELD_ERROR_CODES, type FieldError, type FieldErrorCode, type GenAiBreakdownRow, type GlobalRole, type Invitation, type InvitationInfo, type Issue, type IssueAggregates, type IssueFilter, type IssueHash, type IssuePriority, type IssueSort, type IssueStats, type IssueStatsWindow, type IssueStatus, type IssueTagValue, type ListAlertHistoryOptions, type ListEventsOptions, type ListIssuesOptions, type ListLogsOptions, type ListProjectsOptions, type ListSourceMapsResponse, type ListSpansOptions, type ListTransactionsOptions, type Log, type LoginRequest, type LoginResult, type MetricDelta, NETWORK_ERROR_MESSAGE, type OffsetPaginatedResponse, Ok, type PaginatedResponse, type Project, type ProjectListStats, type ProjectMember, type ProjectRole, type ProjectStatsSummary, type ProjectStorage, type ProviderType, type RegisterRequest, type ReleaseHealthRow, type ReleaseHealthStatsOptions, type Result, type RoutingOverride, RustrakClient, type RustrakError, type RustrakErrorKind, SERVER_ERROR_MESSAGE, type ServerVersion, type SessionSummary, type SessionTimeseries, type SessionTimeseriesPoint, type SortOrder, type SourceMapFile, type SourceMapGcResult, type SourceMapStorage, type Span, type SpanDetail, type StorageSummary, TIMEOUT_ERROR_MESSAGE, type TagSummary, type TagValueCount, type TeamMember, type TestChannelResponse, type TestIntegrationBody, type Transaction, type TransactionDetail, type TransactionStats, type UpdateAlertIntegration, type UpdateAlertRule, type UpdateIssueState, type UpdateProject, type UpdateUserRole, type UpsertProjectMember, type User, type UserReport, isRetryable, mapResult, unwrap, unwrapOr };

package/dist/index.js

@@ -53,8 +53,40 @@ var agentTraceSummarySchema = z.object({
   duration_ms: z.number().nullable(),
   total_tokens: z.number(),
   tool_call_count: z.number().int(),
+  /** `ai_client` spans: how many times a model was actually called. */
+  llm_call_count: z.number().int(),
+  /** AI spans in this trace whose status is set and not `ok`. */
+  error_count: z.number().int(),
   started_at: dateTimeSchema
 });
+var agentSummarySchema = z.object({
+  agent_runs: z.number().int(),
+  llm_calls: z.number().int(),
+  tool_calls: z.number().int(),
+  error_count: z.number().int(),
+  total_tokens: z.number(),
+  avg_duration_ms: z.number(),
+  p95_duration_ms: z.number()
+});
+var agentModelRowSchema = z.object({
+  model: z.string(),
+  requests: z.number().int(),
+  errors: z.number().int(),
+  avg_ms: z.number(),
+  p95_ms: z.number(),
+  input_tokens: z.number(),
+  cached_input_tokens: z.number(),
+  output_tokens: z.number(),
+  reasoning_output_tokens: z.number(),
+  total_tokens: z.number()
+});
+var agentToolRowSchema = z.object({
+  tool: z.string(),
+  calls: z.number().int(),
+  errors: z.number().int(),
+  avg_ms: z.number(),
+  p95_ms: z.number()
+});
 var providerTypeSchema = z.enum(["webhook", "email", "slack"]);
 var alertTypeSchema = z.enum(["new_issue", "regression", "unmute"]);
 var alertStatusSchema = z.enum([
@@ -592,7 +624,7 @@ var spanSchema = z.object({
   exclusive_time_ms: z.number().nullable(),
   is_segment: z.boolean(),
   segment_id: z.string().nullable(),
-  /** Only ever set for standalone spans — a transaction-embedded span has no parent row to inherit these from. */
+  /** Reported by the span itself, or stamped from its parent transaction. Null only for rows ingested before that stamping existed. */
   platform: z.string().nullable(),
   release: z.string().nullable(),
   environment: z.string().nullable(),
@@ -607,6 +639,11 @@ var spanSchema = z.object({
   gen_ai_usage_output_tokens: z.number().nullable(),
   gen_ai_usage_total_tokens: z.number().nullable()
 });
+var spanDetailSchema = spanSchema.extend({
+  attributes: z.record(z.string(), z.any()),
+  /** Always absent for a Spans Protocol v2 span: v2 has no tags concept. */
+  tags: z.record(z.string(), z.any()).nullish()
+});
 var transactionStatsSchema = z.object({
   transaction_name: z.string(),
   op: z.string().nullable(),
@@ -620,7 +657,21 @@ var userSchema = z.object({
   id: z.number().int().positive(),
   email: z.string().email(),
   role: globalRoleSchema,
-  is_admin: z.boolean()
+  is_admin: z.boolean(),
+  /**
+   * The dashboard language this user chose.
+   *
+   * `null` means they never chose one, which a consumer should treat as
+   * "infer it" rather than as English. Optional as well as nullable so a
+   * client stays compatible with a server predating the column.
+   */
+  language: z.string().nullable().optional(),
+  /** The IANA timezone this user chose, `null` when they never chose one. */
+  timezone: z.string().nullable().optional()
+});
+var updatePreferencesRequestSchema = z.object({
+  language: z.string().nullable().optional(),
+  timezone: z.string().nullable().optional()
 });
 var authResponseSchema = z.object({
   user: userSchema
@@ -985,6 +1036,9 @@ function timeseriesSearchParams(options) {
   if (options?.interval_hours) {
     searchParams.interval_hours = String(options.interval_hours);
   }
+  if (options?.environment) {
+    searchParams.environment = options.environment;
+  }
   return searchParams;
 }
 function breakdownSearchParams(options) {
@@ -995,6 +1049,9 @@ function breakdownSearchParams(options) {
   if (options?.limit) {
     searchParams.limit = String(options.limit);
   }
+  if (options?.environment) {
+    searchParams.environment = options.environment;
+  }
   return searchParams;
 }
 var AgentsResource = class extends BaseResource {
@@ -1065,6 +1122,12 @@ var AgentsResource = class extends BaseResource {
     if (options?.per_page) {
       searchParams.per_page = String(options.per_page);
     }
+    if (options?.period_hours) {
+      searchParams.period_hours = String(options.period_hours);
+    }
+    if (options?.environment) {
+      searchParams.environment = options.environment;
+    }
     return this.request(
       () => this.http.get(`api/projects/${projectId}/agents/traces`, {
         searchParams
@@ -1072,6 +1135,50 @@ var AgentsResource = class extends BaseResource {
       offsetPaginatedResponseSchema(agentTraceSummarySchema)
     );
   }
+  /**
+   * Headline totals over the selected window — the numbers the charts show
+   * the shape of but cannot state.
+   */
+  async getSummary(projectId, options) {
+    return this.request(
+      () => this.http.get(`api/projects/${projectId}/agents/summary`, {
+        searchParams: breakdownSearchParams(options)
+      }),
+      agentSummarySchema
+    );
+  }
+  /**
+   * Per-model table: volume, failures, latency and the full token split.
+   */
+  async getModelsTable(projectId, options) {
+    return this.request(
+      () => this.http.get(`api/projects/${projectId}/agents/models`, {
+        searchParams: breakdownSearchParams(options)
+      }),
+      z.array(agentModelRowSchema)
+    );
+  }
+  /**
+   * Per-tool table: call volume, failures and latency.
+   */
+  async getToolsTable(projectId, options) {
+    return this.request(
+      () => this.http.get(`api/projects/${projectId}/agents/tools/stats`, {
+        searchParams: breakdownSearchParams(options)
+      }),
+      z.array(agentToolRowSchema)
+    );
+  }
+  /**
+   * Environments present in this project's AI spans — the options the filter
+   * offers, read from the data rather than hardcoded.
+   */
+  async getEnvironments(projectId) {
+    return this.request(
+      () => this.http.get(`api/projects/${projectId}/agents/environments`),
+      z.array(z.string())
+    );
+  }
 };
 var AlertIntegrationsResource = class extends BaseResource {
   /**
@@ -1301,6 +1408,24 @@ var AuthResource = class extends BaseResource {
   async getCurrentUser() {
     return this.request(() => this.http.get("auth/me"), userSchema);
   }
+  /**
+   * Stores how this reader wants the dashboard presented to them.
+   *
+   * A key left out is left alone; a key sent as `null` is cleared. That is why
+   * the request type is optional *and* nullable rather than one or the other:
+   * "do not touch" and "forget my choice" are different instructions.
+   */
+  async updatePreferences(preferences) {
+    const validatedInput = this.validateInput(
+      preferences,
+      updatePreferencesRequestSchema
+    );
+    if (!validatedInput.success) return validatedInput;
+    return this.request(
+      () => this.http.patch("auth/me", { json: validatedInput.data }),
+      userSchema
+    );
+  }
   /**
    * Get the details of a pending invitation by its token (public endpoint)
    * Used by the accept-invitation page before the user has an account
@@ -1986,6 +2111,20 @@ var SpansResource = class extends BaseResource {
       offsetPaginatedResponseSchema(spanSchema)
     );
   }
+  /**
+   * Fetch one span together with its raw attribute bag — the `gen_ai.*`
+   * payload (prompts, responses, tool arguments and results) that `list()`
+   * omits so a trace's worth of spans stays cheap to load.
+   *
+   * `spanId` is the row id from a list item's `id`, not the SDK's 16-hex
+   * `span_id`.
+   */
+  async get(projectId, spanId) {
+    return this.request(
+      () => this.http.get(`api/projects/${projectId}/spans/${spanId}`),
+      spanDetailSchema
+    );
+  }
 };
 
 // src/resources/stats.ts