@ancplua/qyl-api-schema 11.6.0 → 12.1.0

package/generated/ts-runtime/api.d.ts

@@ -42,21 +42,57 @@ export type WorkbenchEvaluationExportId = string & {
 };
 export declare const ProblemDetailsMediaType: "application/problem+json";
 export type ProblemDetailsMediaType = typeof ProblemDetailsMediaType;
-export declare const SortOrderValues: {
-    readonly asc: "asc";
-    readonly desc: "desc";
-};
-export type SortOrder = typeof SortOrderValues[keyof typeof SortOrderValues];
-export declare const TimeBucketValues: {
-    readonly minute: "1m";
-    readonly fiveMinutes: "5m";
-    readonly fifteenMinutes: "15m";
-    readonly hour: "1h";
-    readonly day: "1d";
-    readonly week: "1w";
-    readonly auto: "auto";
-};
-export type TimeBucket = typeof TimeBucketValues[keyof typeof TimeBucketValues];
+export declare const ProblemTypeValues: {
+    readonly validationFailed: "https://qyl.at/problems/validation-failed";
+    readonly unauthorized: "https://qyl.at/problems/unauthorized";
+    readonly forbidden: "https://qyl.at/problems/forbidden";
+    readonly notFound: "https://qyl.at/problems/not-found";
+    readonly conflict: "https://qyl.at/problems/conflict";
+    readonly preconditionFailed: "https://qyl.at/problems/precondition-failed";
+    readonly preconditionRequired: "https://qyl.at/problems/precondition-required";
+    readonly internalError: "https://qyl.at/problems/internal-error";
+    readonly badGateway: "https://qyl.at/problems/bad-gateway";
+    readonly serviceUnavailable: "https://qyl.at/problems/service-unavailable";
+};
+export type ProblemType = typeof ProblemTypeValues[keyof typeof ProblemTypeValues];
+export declare const ProblemCodeValues: {
+    readonly validationFailed: "validation_failed";
+    readonly unauthorized: "unauthorized";
+    readonly forbidden: "forbidden";
+    readonly notFound: "not_found";
+    readonly conflict: "conflict";
+    readonly preconditionFailed: "precondition_failed";
+    readonly preconditionRequired: "precondition_required";
+    readonly internalError: "internal_error";
+    readonly badGateway: "bad_gateway";
+    readonly serviceUnavailable: "service_unavailable";
+};
+export type ProblemCode = typeof ProblemCodeValues[keyof typeof ProblemCodeValues];
+export declare const FailureStatusValues: {
+    readonly open: "open";
+    readonly resolved: "resolved";
+    readonly ignored: "ignored";
+};
+export type FailureStatus = typeof FailureStatusValues[keyof typeof FailureStatusValues];
+export declare const MatcherOpValues: {
+    readonly eq: "eq";
+    readonly neq: "neq";
+    readonly in: "in";
+    readonly prefix: "prefix";
+    readonly contains: "contains";
+    readonly exists: "exists";
+    readonly gt: "gt";
+    readonly gte: "gte";
+    readonly lt: "lt";
+    readonly lte: "lte";
+};
+export type MatcherOp = typeof MatcherOpValues[keyof typeof MatcherOpValues];
+export declare const MatcherScopeValues: {
+    readonly span: "span";
+    readonly resource: "resource";
+    readonly log: "log";
+};
+export type MatcherScope = typeof MatcherScopeValues[keyof typeof MatcherScopeValues];
 export declare const CollectorKeyRoleValues: {
     readonly ingest: "ingest";
     readonly read: "read";
@@ -196,19 +232,6 @@ export declare const OsTypeValues: {
     readonly zOs: "z_os";
 };
 export type OsType = typeof OsTypeValues[keyof typeof OsTypeValues];
-export declare const MetricKindValues: {
-    readonly gauge: "gauge";
-    readonly sum: "sum";
-    readonly histogram: "histogram";
-    readonly exponential_histogram: "exponential_histogram";
-};
-export type MetricKind = typeof MetricKindValues[keyof typeof MetricKindValues];
-export declare const MetricTemporalityValues: {
-    readonly unspecified: "unspecified";
-    readonly delta: "delta";
-    readonly cumulative: "cumulative";
-};
-export type MetricTemporality = typeof MetricTemporalityValues[keyof typeof MetricTemporalityValues];
 export declare const MetricAggregationValues: {
     readonly avg: "avg";
     readonly min: "min";
@@ -222,9 +245,30 @@ export declare const MetricAggregationValues: {
     readonly p99: "p99";
 };
 export type MetricAggregation = typeof MetricAggregationValues[keyof typeof MetricAggregationValues];
+export declare const MetricKindValues: {
+    readonly gauge: "gauge";
+    readonly sum: "sum";
+    readonly histogram: "histogram";
+    readonly exponential_histogram: "exponential_histogram";
+};
+export type MetricKind = typeof MetricKindValues[keyof typeof MetricKindValues];
+export declare const MetricTemporalityValues: {
+    readonly unspecified: "unspecified";
+    readonly delta: "delta";
+    readonly cumulative: "cumulative";
+};
+export type MetricTemporality = typeof MetricTemporalityValues[keyof typeof MetricTemporalityValues];
 export declare const MetricMatcherOpValues: {
     readonly eq: "eq";
+    readonly neq: "neq";
+    readonly in: "in";
     readonly prefix: "prefix";
+    readonly contains: "contains";
+    readonly exists: "exists";
+    readonly gt: "gt";
+    readonly gte: "gte";
+    readonly lt: "lt";
+    readonly lte: "lte";
 };
 export type MetricMatcherOp = typeof MetricMatcherOpValues[keyof typeof MetricMatcherOpValues];
 export declare const SessionEventNameValues: {
@@ -395,11 +439,27 @@ export declare const WorkbenchTransportKindValues: {
     readonly builtin: "builtin";
 };
 export type WorkbenchTransportKind = typeof WorkbenchTransportKindValues[keyof typeof WorkbenchTransportKindValues];
+export declare const McpFailureClassValues: {
+    readonly transport: "transport";
+    readonly protocol: "protocol";
+    readonly tool_result: "tool_result";
+    readonly authentication: "authentication";
+    readonly cancellation: "cancellation";
+    readonly timeout: "timeout";
+};
+export type McpFailureClass = typeof McpFailureClassValues[keyof typeof McpFailureClassValues];
 export declare const McpDataModeValues: {
     readonly live: "live";
     readonly demo: "demo";
 };
 export type McpDataMode = typeof McpDataModeValues[keyof typeof McpDataModeValues];
+export declare const AnnotationClassificationValues: {
+    readonly note: "note";
+    readonly hypothesis: "hypothesis";
+    readonly finding: "finding";
+    readonly rejected: "rejected";
+};
+export type AnnotationClassification = typeof AnnotationClassificationValues[keyof typeof AnnotationClassificationValues];
 export declare const CiPhaseStatusValues: {
     readonly ok: "ok";
     readonly error: "error";
@@ -417,6 +477,14 @@ export declare const DeletableKindValues: {
     readonly savedQuery: "saved_query";
 };
 export type DeletableKind = typeof DeletableKindValues[keyof typeof DeletableKindValues];
+export declare const FailureChangeValues: {
+    readonly new: "new";
+    readonly worsening: "worsening";
+    readonly ongoing: "ongoing";
+    readonly recovering: "recovering";
+    readonly regressed: "regressed";
+};
+export type FailureChange = typeof FailureChangeValues[keyof typeof FailureChangeValues];
 export declare const McpScopeValues: {
     readonly read: "qyl:read";
     readonly write: "qyl:write";
@@ -428,12 +496,13 @@ export declare const FetchTelemetryViewValues: {
     readonly trace: "trace";
     readonly logs: "logs";
     readonly mcpStats: "mcp_stats";
+    readonly compare: "compare";
 };
 export type FetchTelemetryView = typeof FetchTelemetryViewValues[keyof typeof FetchTelemetryViewValues];
 export type AttributeDouble = number | "NaN" | "Infinity" | "-Infinity";
 export type AttributeValue = null | string | boolean | AttributeValue[] | AttributeObjectValue;
 export type AttributeObjectValue = AttributeIntValue | AttributeDoubleValue | AttributeBytesValue | AttributeKeyValueListValue;
-export type ApiError = NotFoundError | ValidationError | UnauthorizedError | ForbiddenError | ConflictError | PreconditionFailedError | PreconditionRequiredError | RateLimitError | InternalServerError | BadGatewayError | ServiceUnavailableError;
+export type MatcherValue = string | number | boolean;
 export type RunnerResourceEvents = RunnerResourceState;
 export type RunnerLogEvents = RunnerLogLine;
 export type WorkbenchServerConfiguration = WorkbenchStdioServerConfiguration | WorkbenchStreamableHttpServerConfiguration | WorkbenchBuiltinServerConfiguration;
@@ -442,11 +511,33 @@ export type WorkbenchEvaluationExportPayload = WorkbenchEvaluationJsonExportPayl
 export type WorkbenchProtocolEvents = WorkbenchProtocolEvent;
 export type WorkbenchExecutionUpdateEvents = WorkbenchExecutionRecord;
 export type ToolErrorCode = "invalid_argument" | "not_found" | "no_project_access" | "collector_unreachable" | "collector_timeout" | "cancelled" | "collector_unauthorized" | "collector_rate_limited" | "collector_rejected" | "collector_error" | "contract_mismatch" | "insufficient_scope" | "conflict" | "precondition_failed" | "precondition_required" | "internal";
-export type AnnotationTarget = TraceAnnotationTarget | SpanAnnotationTarget | SessionAnnotationTarget;
+export type McpStatsComparison = "previous_window" | McpComparisonOffset | McpComparisonVersion | string;
+export type AnnotationTarget = TraceAnnotationTarget | SpanAnnotationTarget | SessionAnnotationTarget | FailureAnnotationTarget;
+export type MetricComparison = "previous_window" | MetricComparisonOffset;
 export type SavedQueryFilter = SavedTraceQueryFilter | SavedLogQueryFilter | SavedMetricQueryFilter;
 export type SavedQueryRunResult = SavedTraceQueryRun | SavedLogQueryRun | SavedMetricQueryRun;
-export type FetchTelemetryInput = FetchTelemetryTracesInput | FetchTelemetryTraceInput | FetchTelemetryLogsInput | FetchTelemetryMcpStatsInput;
+export type AnalysisBaseline = "previous_window" | ToolWindow | BaselineOffset;
+export type FailureStatusFilter = FailureStatus | "all";
+export type FetchTelemetryInput = FetchTelemetryTracesInput | FetchTelemetryTraceInput | FetchTelemetryLogsInput | FetchTelemetryMcpStatsInput | FetchTelemetryCompareInput;
 export type LogEvents = LogStreamEvent | HeartbeatEvent;
+export interface InternalServerError extends ProblemDetails {
+    "type": "https://qyl.at/problems/internal-error";
+    "code": "internal_error";
+    "title": "Internal Server Error";
+}
+export interface ProblemDetails {
+    "type": ProblemType;
+    "title": string;
+    "status": number;
+    "detail"?: string;
+    "instance"?: string;
+    "code": ProblemCode;
+}
+export interface UpdateFailureStatusRequest {
+    "status": FailureStatus;
+    "ignore_until"?: string;
+    "assignee"?: string;
+}
 export interface AttributeBytesValue {
     "type": "bytes";
     "base64": string;
@@ -482,26 +573,38 @@ export interface InstrumentationScope {
     "attributes"?: Attribute[];
     "dropped_attributes_count"?: number;
 }
+export interface TelemetryMatcher {
+    "key": string;
+    "op": MatcherOp;
+    "value"?: MatcherValue;
+    "values"?: MatcherValue[];
+    "scope"?: MatcherScope;
+}
+export interface ToolWindow {
+    "start_time": string;
+    "end_time": string;
+}
+export interface ToolCoverage {
+    "examined": number | null;
+    "matched": number | null;
+    "returned": number | null;
+    "truncated": boolean;
+    "scan_complete": boolean;
+    "as_of": string;
+}
+export interface ToolReadContext {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+}
 export interface ResourceBase {
     "id": string;
     "created_at": string;
     "updated_at": string;
     "etag": string;
 }
-export interface ProblemDetails {
-    "type": string;
-    "title": string;
-    "status": number;
-    "detail"?: string;
-    "instance"?: string;
-    "timestamp"?: string;
-}
-export interface NotFoundError extends ProblemDetails {
-    "title": "Not Found";
-    "resource_type"?: string;
-    "resource_id"?: string;
-}
 export interface ValidationError extends ProblemDetails {
+    "type": "https://qyl.at/problems/validation-failed";
+    "code": "validation_failed";
     "title": "Validation Failed";
     "errors": ValidationErrorDetail[];
 }
@@ -512,64 +615,53 @@ export interface ValidationErrorDetail {
     "rejected_value"?: string;
 }
 export interface UnauthorizedError extends ProblemDetails {
+    "type": "https://qyl.at/problems/unauthorized";
+    "code": "unauthorized";
     "title": "Unauthorized";
 }
 export interface ForbiddenError extends ProblemDetails {
+    "type": "https://qyl.at/problems/forbidden";
+    "code": "forbidden";
     "title": "Forbidden";
     "required_permission"?: string;
 }
+export interface NotFoundError extends ProblemDetails {
+    "type": "https://qyl.at/problems/not-found";
+    "code": "not_found";
+    "title": "Not Found";
+    "resource_type"?: string;
+    "resource_id"?: string;
+}
 export interface ConflictError extends ProblemDetails {
+    "type": "https://qyl.at/problems/conflict";
+    "code": "conflict";
     "title": "Conflict";
     "conflicting_resource"?: string;
 }
 export interface PreconditionFailedError extends ProblemDetails {
+    "type": "https://qyl.at/problems/precondition-failed";
+    "code": "precondition_failed";
     "title": "Precondition Failed";
     "current_etag"?: string;
 }
 export interface PreconditionRequiredError extends ProblemDetails {
+    "type": "https://qyl.at/problems/precondition-required";
+    "code": "precondition_required";
     "title": "Precondition Required";
     "required_header"?: "If-Match";
 }
-export interface RateLimitError extends ProblemDetails {
-    "title": "Too Many Requests";
-}
-export interface InternalServerError extends ProblemDetails {
-    "title": "Internal Server Error";
-    "error_code"?: string;
-}
 export interface BadGatewayError extends ProblemDetails {
+    "type": "https://qyl.at/problems/bad-gateway";
+    "code": "bad_gateway";
     "title": "Bad Gateway";
     "dependency"?: string;
 }
 export interface ServiceUnavailableError extends ProblemDetails {
+    "type": "https://qyl.at/problems/service-unavailable";
+    "code": "service_unavailable";
     "title": "Service Unavailable";
     "reason"?: "maintenance" | "overloaded" | "dependency_failure";
 }
-export interface CursorPaginationParams {
-    "cursor"?: string;
-    "limit"?: number;
-    "order"?: SortOrder;
-}
-export interface OffsetPaginationParams {
-    "page"?: number;
-    "page_size"?: number;
-}
-export interface TimeRangeParams {
-    "start_time"?: string;
-    "end_time"?: string;
-    "limit"?: number;
-}
-export interface StreamParams {
-    "since"?: string;
-    "trace_id"?: TraceId;
-    "service_name"?: string;
-    "max_events_per_second"?: number;
-}
-export interface AggregationParams {
-    "bucket"?: TimeBucket;
-    "group_by"?: string[];
-    "filter"?: string;
-}
 export interface Resource {
     "service_name": string;
     "service_namespace"?: string;
@@ -661,17 +753,6 @@ export interface TraceSummary {
 export interface Trace extends TraceSummary {
     "spans": Span[];
 }
-export interface SpanQueryFilters {
-    "trace_id"?: TraceId;
-    "parent_span_id"?: SpanId;
-    "name"?: string;
-    "kind"?: SpanKind;
-    "service_name"?: string;
-    "status_code"?: SpanStatusCode;
-    "min_duration_ns"?: string;
-    "max_duration_ns"?: string;
-    "attribute"?: string;
-}
 export interface SpanStats {
     "total_count": number;
     "error_count": number;
@@ -713,6 +794,9 @@ export interface LogTemplate {
     "rendered_message"?: string;
 }
 export interface MetricDescriptor {
+    "supported_aggregations"?: MetricAggregation[];
+    "services"?: string[];
+    "conflicts"?: MetricDescriptorConflict[];
     "name": string;
     "kind": MetricKind;
     "temporality": MetricTemporality;
@@ -722,7 +806,14 @@ export interface MetricDescriptor {
     "series_count": number;
     "last_seen": string;
 }
+export interface MetricDescriptorConflict {
+    "kind": MetricKind;
+    "unit"?: string;
+    "services": string[];
+}
 export interface MetricSeries {
+    "new"?: boolean;
+    "stale"?: boolean;
     "series_id": string;
     "name": string;
     "kind": MetricKind;
@@ -754,8 +845,10 @@ export interface MetricQueryResult {
 }
 export interface MetricAttributeMatcher {
     "key": string;
-    "op": MetricMatcherOp;
-    "value": string;
+    "op": MatcherOp;
+    "value"?: MatcherValue;
+    "values"?: MatcherValue[];
+    "scope"?: MatcherScope;
 }
 export interface SessionAttributes {
     "session_id": SessionId;
@@ -1338,6 +1431,8 @@ export interface WorkbenchEvaluationExportAccepted {
     "export": WorkbenchEvaluationExport;
 }
 export interface ToolError {
+    "fields"?: ValidationErrorDetail[];
+    "problem_type"?: ProblemType;
     "code": ToolErrorCode;
     "message": string;
     "retryable": boolean;
@@ -1347,28 +1442,115 @@ export interface ToolPage {
     "next_cursor"?: string;
 }
 export interface ToolTimeRange {
+    "lookback_minutes"?: number;
     "start_time"?: string;
     "end_time"?: string;
 }
 export interface DisplayTracesInput {
+    "failure_class"?: McpFailureClass;
+    "server_name"?: string;
+    "tool_name"?: string;
+    "transport"?: string;
+    "failure_id"?: string;
+    "compare_to"?: TraceId;
+    "selected_span_id"?: SpanId;
+    "cursor"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
     "trace_id"?: TraceId;
     "session_id"?: SessionId;
     "limit"?: number;
 }
 export interface DisplayTracesOutput {
-    "traces": Trace[];
+    "selected_span_id"?: SpanId;
+    "comparison"?: CompareTracesOutput;
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "traces": ToolTrace[];
     "selected_trace_id"?: TraceId;
     "mode": McpDataMode;
     "error"?: ToolError;
 }
+export interface CompareTracesOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "first_divergence": TraceDivergence | null;
+    "aligned": AlignedSpans[];
+    "after_divergence": TraceDivergence[];
+    "unmatched": EvidenceSpan[];
+    "comparable": boolean;
+    "reason"?: string;
+    "error"?: ToolError;
+}
+export interface TraceDivergence {
+    "a_span": EvidenceSpan | null;
+    "b_span": EvidenceSpan | null;
+    "kind": "missing" | "extra" | "status" | "attribute" | "duration";
+    "attribute"?: string;
+}
+export interface EvidenceSpan {
+    "start_time"?: string;
+    "end_time"?: string;
+    "trace_id": TraceId;
+    "span_id": SpanId;
+    "parent_span_id"?: SpanId;
+    "session_id"?: SessionId;
+    "service": string;
+    "name": string;
+    "status": string;
+    "status_message"?: string;
+    "exception"?: RecordedException;
+    "key_attributes": Attribute[];
+    "duration_ms": number;
+    "role": "matched" | "context";
+}
+export interface RecordedException {
+    "type"?: string;
+    "message"?: string;
+    "stacktrace"?: string;
+}
+export interface AlignedSpans {
+    "a_span": EvidenceSpan;
+    "b_span": EvidenceSpan;
+    "differences": TraceDivergence[];
+}
+export interface ToolTrace extends TraceSummary {
+    "spans": ToolSpan[];
+}
+export interface ToolSpan extends Span {
+    "role": "matched" | "context";
+    "self_time_ms"?: number;
+    "self_time_share"?: number;
+}
 export interface DisplayMcpDashboardInput {
+    "server_name"?: string;
+    "tool_name"?: string;
+    "transport"?: string;
+    "compare_to"?: McpStatsComparison;
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
     "hours"?: number;
 }
+export interface McpComparisonOffset {
+    "offset_minutes": number;
+}
+export interface McpComparisonVersion {
+    "server_version": string;
+}
 export interface DisplayMcpDashboardOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
     "stats": McpDashboardStats;
     "error"?: ToolError;
 }
 export interface McpDashboardStats {
+    "groups"?: McpTrafficGroup[];
+    "failure_classes"?: McpFailureClasses;
+    "comparison"?: McpStatsComparisonResult;
+    "coverage"?: ToolCoverage;
     "window": McpDashboardWindow;
     "buckets": McpDashboardBucket[];
     "totals": McpDashboardTotals;
@@ -1380,6 +1562,38 @@ export interface McpDashboardStats {
     "truncated": boolean;
     "mode": McpDataMode;
 }
+export interface McpTrafficGroup {
+    "requests": number;
+    "errors": number;
+    "error_rate": number;
+    "p50_ms": number | null;
+    "p95_ms": number | null;
+    "unit": "requests";
+    "name": string;
+    "example_trace_ids": TraceId[];
+}
+export interface McpFailureClasses {
+    "transport": number;
+    "protocol": number;
+    "tool_result": number;
+    "authentication": number;
+    "cancellation": number;
+    "timeout": number;
+}
+export interface McpStatsComparisonResult {
+    "window": ToolWindow;
+    "totals": McpTrafficTotals;
+    "groups": McpTrafficGroup[];
+    "failure_classes": McpFailureClasses;
+}
+export interface McpTrafficTotals {
+    "requests": number;
+    "errors": number;
+    "error_rate": number;
+    "p50_ms": number | null;
+    "p95_ms": number | null;
+    "unit": "requests";
+}
 export interface McpDashboardWindow {
     "start": string;
     "end": string;
@@ -1391,6 +1605,8 @@ export interface McpDashboardBucket {
     "errors": number;
 }
 export interface McpDashboardTotals {
+    "p50_ms"?: number;
+    "p95_ms"?: number;
     "requests": number;
     "errors": number;
     "error_rate": number;
@@ -1408,7 +1624,23 @@ export interface McpToolStats {
     "p95_ms": number;
 }
 export interface ListTracesInput {
+    "failure_class"?: McpFailureClass;
+    "server_name"?: string;
+    "tool_name"?: string;
+    "transport"?: string;
+    "session_id"?: SessionId;
+    "root_span_name"?: string;
+    "min_duration_ms"?: number;
+    "max_duration_ms"?: number;
+    "release"?: string;
+    "failure_id"?: string;
+    "error_scope"?: "any" | "root";
+    "annotation_label"?: string;
+    "group_by"?: "failure_id" | "root_span" | "service";
+    "sort_by"?: "start_time" | "duration" | "errors";
+    "matchers"?: TelemetryMatcher[];
     "limit"?: number;
+    "lookback_minutes"?: number;
     "start_time"?: string;
     "end_time"?: string;
     "service_name"?: string;
@@ -1416,25 +1648,78 @@ export interface ListTracesInput {
     "cursor"?: string;
 }
 export interface ListTracesOutput {
-    "traces": TraceSummary[];
+    "groups"?: TraceGroup[];
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "traces": ToolTraceSummary[];
     "mode": McpDataMode;
     "has_more": boolean;
     "next_cursor"?: string;
     "error"?: ToolError;
 }
+export interface TraceGroup {
+    "key": string;
+    "count": number;
+    "example_trace_ids": TraceId[];
+}
+export interface ToolTraceSummary {
+    "trace_id": TraceId;
+    "root_span"?: Span;
+    "span_count": number;
+    "duration_ns": string;
+    "start_time": string;
+    "end_time": string;
+    "services": string[];
+    "has_error": boolean;
+    "root_error": boolean;
+    "contained_error": boolean;
+    "failure_ids": string[];
+    "annotation_labels": string[];
+}
 export interface GetTraceInput {
+    "selection"?: "all" | "errors" | "errors_with_ancestors" | "critical_path";
+    "attributes"?: string[];
+    "include_logs"?: number;
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
     "trace_id": TraceId;
     "errors_only"?: boolean;
     "max_spans"?: number;
     "include_attributes"?: boolean;
 }
 export interface GetTraceOutput {
-    "trace": Trace;
+    "span_roles"?: SpanEvidenceRole[];
+    "omitted"?: TraceOmitted;
+    "missing_parent_span_ids"?: SpanId[];
+    "links"?: TraceLinkAvailability[];
+    "logs"?: LogRecord[];
+    "settled"?: boolean;
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "trace": ToolTrace;
     "mode": McpDataMode;
     "annotations"?: Annotation[];
     "error"?: ToolError;
 }
+export interface SpanEvidenceRole {
+    "span_id": SpanId;
+    "role": "matched" | "context";
+    "self_time_ms"?: number;
+    "self_time_share"?: number;
+}
+export interface TraceOmitted {
+    "matched": number;
+    "context": number;
+}
+export interface TraceLinkAvailability {
+    "trace_id": TraceId;
+    "span_id": SpanId;
+    "available": boolean;
+}
 export interface Annotation extends ResourceBase {
+    "labels"?: string[];
+    "classification"?: AnnotationClassification;
     "target": AnnotationTarget;
     "text": string;
 }
@@ -1451,45 +1736,123 @@ export interface SessionAnnotationTarget {
     "kind": "session";
     "session_id": SessionId;
 }
+export interface FailureAnnotationTarget {
+    "kind": "failure";
+    "failure_id": string;
+}
 export interface ListSessionsInput {
+    "has_error"?: boolean;
+    "min_errors"?: number;
+    "service_name"?: string;
+    "agent_name"?: string;
+    "model"?: string;
+    "min_tokens"?: number;
+    "min_duration_ms"?: number;
+    "annotation_label"?: string;
+    "sort_by"?: "last_activity" | "errors" | "duration" | "tokens";
+    "matchers"?: TelemetryMatcher[];
     "limit"?: number;
     "active_only"?: boolean;
+    "lookback_minutes"?: number;
     "start_time"?: string;
     "end_time"?: string;
     "cursor"?: string;
 }
 export interface ListSessionsOutput {
-    "sessions": SessionEntity[];
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "sessions": ToolSession[];
     "mode": McpDataMode;
     "has_more": boolean;
     "next_cursor"?: string;
     "annotations"?: Annotation[];
     "error"?: ToolError;
 }
+export interface ToolSession {
+    "session_id": SessionId;
+    "user_id"?: UserId;
+    "start_time": string;
+    "end_time"?: string;
+    "duration_ms"?: number;
+    "trace_count": number;
+    "span_count": number;
+    "error_count": number;
+    "services": string[];
+    "state": SessionState;
+    "client"?: SessionClientInfo;
+    "geo"?: SessionGeoInfo;
+    "genai_usage"?: SessionGenAiUsage;
+    "failure_ids"?: string[];
+    "agent_name"?: string;
+    "models"?: string[];
+    "tokens_by_model"?: Record<string, AgentTokens>;
+    "annotations"?: Annotation[];
+}
+export interface AgentTokens {
+    "input": number | null;
+    "output": number | null;
+    "cache_read": number | null;
+    "cache_write": number | null;
+    "reasoning": number | null;
+}
 export interface SearchLogsInput {
+    "span_id"?: SpanId;
+    "group_by"?: "pattern";
+    "context"?: number;
+    "matchers"?: TelemetryMatcher[];
     "trace_id"?: TraceId;
     "service_name"?: string;
     "severity_min"?: number;
     "query"?: string;
     "limit"?: number;
     "session_id"?: SessionId;
+    "lookback_minutes"?: number;
     "start_time"?: string;
     "end_time"?: string;
     "cursor"?: string;
 }
 export interface SearchLogsOutput {
+    "total_matched"?: number;
+    "patterns"?: LogPattern[];
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
     "logs": LogRecord[];
     "mode": McpDataMode;
     "has_more": boolean;
     "next_cursor"?: string;
     "error"?: ToolError;
 }
+export interface LogPattern {
+    "template": string;
+    "count": number;
+    "severity": number;
+    "first_seen": string;
+    "last_seen": string;
+    "example_ids": string[];
+}
 export interface CiLogInput {
+    "cursor"?: string;
+    "branch"?: string;
+    "commit"?: string;
+    "leg"?: string;
+    "phase"?: string;
+    "phase_cursor"?: string;
+    "outcome"?: "failed" | "passed" | "all";
+    "compare_to"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
     "run_id"?: SessionId;
     "service_prefix"?: string;
     "limit"?: number;
 }
 export interface CiRunSummary {
+    "session_id"?: SessionId;
+    "provider_run_id"?: string;
+    "provider_run_url"?: string;
+    "attempt"?: number;
+    "attempts"?: CiAttempt[];
     "run_id": SessionId;
     "state": SessionState;
     "start_time": string;
@@ -1497,30 +1860,95 @@ export interface CiRunSummary {
     "error_count": number;
     "services": string[];
 }
+export interface CiAttempt {
+    "run_id": SessionId;
+    "attempt": number;
+    "provider_run_id"?: string;
+    "provider_run_url"?: string;
+}
 export interface CiPhase {
+    "span_id"?: SpanId;
+    "trace_ids"?: TraceId[];
+    "error_log_count"?: number;
+    "error_logs"?: CiErrorExcerpt[];
     "leg": string;
     "phase": string;
     "status": CiPhaseStatus;
     "duration_ms": number;
     "message"?: string;
 }
+export interface CiErrorExcerpt {
+    "id": string;
+    "body": string;
+    "trace_id"?: TraceId;
+    "span_id"?: SpanId;
+}
 export interface CiLogOutput {
+    "has_more": boolean;
+    "next_cursor"?: string;
+    "comparison"?: CiComparison;
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
     "runs"?: CiRunSummary[];
     "run_id"?: SessionId;
     "phases"?: CiPhase[];
     "mode": McpDataMode;
     "error"?: ToolError;
 }
+export interface CiComparison {
+    "baseline_run_id"?: SessionId;
+    "new_failures": CiPhaseChange[];
+    "fixed": CiPhaseChange[];
+    "duration_regressions": CiPhaseChange[];
+}
+export interface CiPhaseChange {
+    "leg": string;
+    "phase": string;
+    "current_duration_ms"?: number;
+    "baseline_duration_ms"?: number;
+    "ratio"?: number;
+    "trace_ids"?: TraceId[];
+}
 export interface FetchTelemetryTracesInput {
+    "failure_class"?: McpFailureClass;
+    "server_name"?: string;
+    "tool_name"?: string;
+    "transport"?: string;
+    "session_id"?: SessionId;
+    "failure_id"?: string;
+    "compare_to"?: TraceId;
+    "selected_span_id"?: SpanId;
+    "cursor"?: string;
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "since_cursor"?: string;
+    "fields"?: string[];
+    "matchers"?: TelemetryMatcher[];
     "view": "traces";
     "trace_id"?: TraceId;
     "limit"?: number;
 }
 export interface FetchTelemetryTraceInput {
+    "selection"?: "all" | "errors" | "errors_with_ancestors" | "critical_path";
+    "attributes"?: string[];
+    "include_logs"?: number;
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "since_cursor"?: string;
+    "fields"?: string[];
+    "matchers"?: TelemetryMatcher[];
     "view": "trace";
     "trace_id": TraceId;
 }
 export interface FetchTelemetryLogsInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "since_cursor"?: string;
+    "fields"?: string[];
+    "matchers"?: TelemetryMatcher[];
     "view": "logs";
     "trace_id"?: TraceId;
     "service_name"?: string;
@@ -1529,51 +1957,148 @@ export interface FetchTelemetryLogsInput {
     "limit"?: number;
 }
 export interface FetchTelemetryMcpStatsInput {
+    "server_name"?: string;
+    "tool_name"?: string;
+    "transport"?: string;
+    "compare_to"?: McpStatsComparison;
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "since_cursor"?: string;
+    "fields"?: string[];
+    "matchers"?: TelemetryMatcher[];
     "view": "mcp_stats";
     "hours"?: number;
 }
+export interface AnalysisInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+}
+export interface CompareTracesInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "a": ExecutionReference;
+    "b": ExecutionReference;
+}
+export interface ExecutionReference {
+    "trace_id"?: TraceId;
+    "session_id"?: SessionId;
+}
+export interface FetchTelemetryCompareInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "a": ExecutionReference;
+    "b": ExecutionReference;
+    "view": "compare";
+    "since_cursor"?: string;
+    "fields"?: string[];
+}
 export interface FetchTelemetryOutput {
-    "traces"?: Trace[];
-    "trace"?: Trace;
+    "comparison"?: CompareTracesOutput;
+    "since_cursor"?: string;
+    "next_cursor"?: string;
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "traces"?: ToolTrace[];
+    "trace"?: ToolTrace;
     "logs"?: LogRecord[];
     "stats"?: McpDashboardStats;
     "mode": McpDataMode;
     "error"?: ToolError;
 }
 export interface ListMetricsInput {
+    "text"?: string;
+    "service_name"?: string;
+    "kind"?: MetricKind;
+    "unit"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
     "name_prefix"?: string;
     "limit"?: number;
     "cursor"?: string;
 }
 export interface ListMetricsOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
     "items": MetricDescriptor[];
     "has_more": boolean;
     "next_cursor"?: string;
     "error"?: ToolError;
 }
 export interface GetMetricSeriesInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
     "metric_name": string;
     "matchers"?: MetricAttributeMatcher[];
     "limit"?: number;
     "cursor"?: string;
 }
 export interface GetMetricSeriesOutput {
+    "keys"?: MetricKeySummary[];
+    "suggested_group_by"?: string[];
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
     "items": MetricSeries[];
     "has_more": boolean;
     "next_cursor"?: string;
     "error"?: ToolError;
 }
+export interface MetricKeySummary {
+    "key": string;
+    "cardinality": number;
+    "cardinality_exact": boolean;
+    "top_values": AttributeValueCount[];
+    "coverage_share": number;
+}
+export interface AttributeValueCount {
+    "value": MatcherValue;
+    "count": number;
+    "share": number;
+}
 export interface QueryMetricInput {
+    "lookback_minutes"?: number;
+    "function"?: "none" | "rate" | "increase" | "delta";
+    "compare_to"?: MetricComparison;
+    "ratio_of"?: MetricRatio;
     "metric_name": string;
-    "start_time": string;
-    "end_time": string;
+    "start_time"?: string;
+    "end_time"?: string;
     "step_ms"?: number;
     "aggregation"?: MetricAggregation;
     "group_by"?: string[];
     "matchers"?: MetricAttributeMatcher[];
     "series_limit"?: number;
 }
+export interface MetricComparisonOffset {
+    "offset_ms": number;
+}
+export interface MetricRatio {
+    "metric_name": string;
+    "aggregation"?: MetricAggregation;
+    "matchers"?: TelemetryMatcher[];
+}
 export interface QueryMetricOutput {
+    "method"?: string;
+    "approximate"?: boolean;
+    "exemplar_trace_ids"?: TraceId[];
+    "comparison"?: MetricComparisonResult;
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
     "name": string;
     "kind": MetricKind;
     "unit"?: string;
@@ -1585,31 +2110,43 @@ export interface QueryMetricOutput {
     "truncated": boolean;
     "error"?: ToolError;
 }
+export interface MetricComparisonResult {
+    "window": ToolWindow;
+    "series": MetricSeriesResult[];
+}
 export interface CreateAnnotationInput {
+    "idempotency_key"?: string;
+    "labels"?: string[];
+    "classification"?: AnnotationClassification;
     "target": AnnotationTarget;
     "text": string;
 }
 export interface UpdateAnnotationInput {
     "id": string;
     "etag": string;
-    "text": string;
+    "labels"?: string[];
+    "classification"?: AnnotationClassification;
+    "text"?: string;
 }
 export interface AnnotationOutput {
     "annotation"?: Annotation;
     "error"?: ToolError;
 }
 export interface CreateSavedQueryInput {
+    "idempotency_key"?: string;
     "name": string;
     "description"?: string;
     "filter": SavedQueryFilter;
 }
 export interface SavedTraceQueryFilter {
+    "matchers"?: TelemetryMatcher[];
     "signal": "traces";
     "lookback_minutes"?: number;
     "service_name"?: string;
     "errors_only"?: boolean;
 }
 export interface SavedLogQueryFilter {
+    "matchers"?: TelemetryMatcher[];
     "signal": "logs";
     "lookback_minutes"?: number;
     "service_name"?: string;
@@ -1644,17 +2181,24 @@ export interface SavedQuery extends ResourceBase {
     "filter": SavedQueryFilter;
 }
 export interface ListSavedQueriesInput {
+    "matchers"?: TelemetryMatcher[];
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
     "signal"?: SavedQuerySignal;
     "limit"?: number;
     "cursor"?: string;
 }
 export interface ListSavedQueriesOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
     "saved_queries": SavedQuery[];
     "has_more": boolean;
     "next_cursor"?: string;
     "error"?: ToolError;
 }
 export interface RunSavedQueryInput {
+    "lookback_minutes"?: number;
     "id": string;
     "start_time"?: string;
     "end_time"?: string;
@@ -1662,6 +2206,8 @@ export interface RunSavedQueryInput {
     "cursor"?: string;
 }
 export interface RunSavedQueryOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
     "result"?: SavedQueryRunResult;
     "mode"?: McpDataMode;
     "error"?: ToolError;
@@ -1691,12 +2237,594 @@ export interface DeleteOutput {
     "deleted": boolean;
     "error"?: ToolError;
 }
+export interface BaselineOffset {
+    "offset_minutes": number;
+}
+export interface ServiceAnalysisInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "service_name"?: string;
+    "environment"?: string;
+}
+export interface FailureRelease {
+    "service": string;
+    "version": string;
+    "first_seen": string;
+    "revision"?: string;
+}
+export interface FailureOccurrence {
+    "trace_id": TraceId;
+    "span_id": SpanId;
+    "session_id"?: SessionId;
+    "timestamp": string;
+    "message"?: string;
+    "release"?: string;
+}
+export interface FailureReleaseCount {
+    "release": string;
+    "count": number;
+}
+export interface AttributeAssociation {
+    "key": string;
+    "value": MatcherValue;
+    "share_a": number;
+    "share_b": number;
+    "count_a": number;
+    "count_b": number;
+    "lift": number | null;
+}
+export interface FailureSummary {
+    "failure_id": string;
+    "etag": string;
+    "signature": string;
+    "exception_type"?: string;
+    "normalized_message": string;
+    "operation": string;
+    "service": string;
+    "first_seen": string;
+    "last_seen": string;
+    "count": number;
+    "affected_traces": number;
+    "affected_sessions": number;
+    "releases_seen": string[];
+    "status": FailureStatus;
+    "ignore_until"?: string;
+    "assignee"?: string;
+    "annotation_count": number;
+    "example_trace_ids": TraceId[];
+}
+export interface FailureDetail {
+    "failure_id": string;
+    "etag": string;
+    "signature": string;
+    "exception_type"?: string;
+    "normalized_message": string;
+    "operation": string;
+    "service": string;
+    "first_seen": string;
+    "last_seen": string;
+    "count": number;
+    "affected_traces": number;
+    "affected_sessions": number;
+    "releases_seen": string[];
+    "status": FailureStatus;
+    "ignore_until"?: string;
+    "assignee"?: string;
+    "annotation_count": number;
+    "example_trace_ids": TraceId[];
+    "counts_per_release"?: FailureReleaseCount[];
+    "discriminators"?: AttributeAssociation[];
+    "recent_occurrences"?: FailureOccurrence[];
+    "raw_messages"?: string[];
+}
+export interface TriageInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "service_name"?: string;
+    "environment"?: string;
+    "baseline"?: AnalysisBaseline;
+}
+export interface TriageFailure {
+    "failure_id": string;
+    "signature": string;
+    "change": FailureChange;
+    "count": number;
+    "baseline_count": number;
+    "affected_traces": number;
+    "services": string[];
+    "first_seen": string;
+    "example_trace_id"?: TraceId;
+    "coinciding_release"?: FailureRelease;
+}
+export interface TriageRegression {
+    "service": string;
+    "operation": string;
+    "measure": "error_rate" | "p95_ms" | "throughput";
+    "value": number;
+    "baseline_value": number;
+    "denominator": number;
+    "unit": string;
+}
+export interface SilentService {
+    "service": string;
+    "last_seen": string;
+    "usual_rate": number | null;
+    "unit": string;
+}
+export interface TriageOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "failures": TriageFailure[];
+    "regressions": TriageRegression[];
+    "releases": FailureRelease[];
+    "silent_services": SilentService[];
+    "error"?: ToolError;
+}
+export interface ListFailuresInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "service_name"?: string;
+    "environment"?: string;
+    "release"?: string;
+    "status"?: FailureStatusFilter;
+    "sort_by"?: "count" | "last_seen" | "first_seen" | "affected_traces";
+    "failure_id"?: string;
+}
+export interface ListFailuresOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "has_more": boolean;
+    "next_cursor"?: string;
+    "failures": FailureDetail[];
+    "error"?: ToolError;
+}
+export interface GetFailureContextInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "trace_id"?: TraceId;
+    "session_id"?: SessionId;
+    "failure_id"?: string;
+    "ci_run_id"?: SessionId;
+    "max_spans"?: number;
+    "max_logs"?: number;
+}
+export interface FailurePropagation {
+    "from": EvidenceSpan;
+    "to": EvidenceSpan;
+}
+export interface RetryEvidence {
+    "name": string;
+    "attempts": number;
+    "spans": EvidenceSpan[];
+}
+export interface FanoutEvidence {
+    "name": string;
+    "count": number;
+    "parent_span_id"?: SpanId;
+    "trace_id": TraceId;
+}
+export interface FailureObserved {
+    "root_cause_span": EvidenceSpan | null;
+    "error_spans": EvidenceSpan[];
+    "propagation": FailurePropagation[];
+    "logs": LogRecord[];
+    "retries": RetryEvidence[];
+    "fanout": FanoutEvidence[];
+}
+export interface FailureComparison {
+    "nearest_success_trace_id"?: TraceId;
+    "first_divergence": TraceDivergence | null;
+}
+export interface SimilarFailure {
+    "failure_id": string;
+    "count": number;
+    "first_seen": string;
+    "releases": string[];
+}
+export interface FailureContext {
+    "similar_failures": SimilarFailure[];
+    "changes": TriageRegression[];
+    "annotations": Annotation[];
+}
+export interface GetFailureContextOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "observed": FailureObserved;
+    "comparison": FailureComparison;
+    "context": FailureContext;
+    "settled": boolean;
+    "unknowns": string[];
+    "error"?: ToolError;
+}
+export interface CompareGroup {
+    "matchers"?: TelemetryMatcher[];
+    "window"?: ToolWindow;
+    "failure_id"?: string;
+}
+export interface CompareGroupsInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "signal": "spans" | "logs";
+    "group_a": CompareGroup;
+    "group_b": CompareGroup | "rest" | "before";
+    "attribute_scope"?: "span" | "resource" | "both";
+}
+export interface GroupStructure {
+    "name": string;
+    "share_a": number;
+    "share_b": number;
+}
+export interface DurationPercentiles {
+    "p50_ms": number | null;
+    "p95_ms": number | null;
+    "p99_ms": number | null;
+}
+export interface GroupDurations {
+    "a": DurationPercentiles;
+    "b": DurationPercentiles;
+}
+export interface GroupComposition {
+    "changed": boolean;
+    "traffic_mix_changed": boolean;
+    "same_traffic_changed": boolean;
+    "summary": string;
+}
+export interface CompareGroupsOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "discriminators": AttributeAssociation[];
+    "structural": GroupStructure[];
+    "durations": GroupDurations;
+    "composition": GroupComposition;
+    "size_a": number;
+    "size_b": number;
+    "excluded_keys": string[];
+    "error"?: ToolError;
+}
+export interface VerifyFixInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "failure_id"?: string;
+    "since"?: string;
+    "release"?: string;
+    "min_requests"?: number;
+    "min_minutes"?: number;
+    "verify_id"?: string;
+}
+export interface VerificationPeriod {
+    "window": ToolWindow;
+    "occurrences": number;
+    "requests": number;
+    "rate": number | null;
+    "unit": "requests";
+}
+export interface VerificationNeeds {
+    "requests": number;
+    "minutes": number;
+}
+export interface VerifyFixOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "verdict": "passed" | "failed" | "pending" | "inconclusive";
+    "before": VerificationPeriod;
+    "after": VerificationPeriod;
+    "needs"?: VerificationNeeds;
+    "recurrences": TraceId[];
+    "guardrails": TriageFailure[];
+    "verify_id": string;
+    "error"?: ToolError;
+}
+export interface AggregateTelemetryInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "signal": "spans" | "logs";
+    "group_by"?: string[];
+    "measures": string[];
+    "step_ms"?: number;
+    "order_by"?: string;
+}
+export interface AggregateBucket {
+    "start_time": string;
+    "measures": Record<string, number | null>;
+}
+export interface AggregateGroup {
+    "key": Record<string, MatcherValue>;
+    "measures": Record<string, number | null>;
+    "buckets"?: AggregateBucket[];
+}
+export interface AggregateOther {
+    "groups": number;
+    "count": number;
+}
+export interface AggregateTelemetryOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "groups": AggregateGroup[];
+    "other": AggregateOther;
+    "units": Record<string, string>;
+    "error"?: ToolError;
+}
+export interface DiscoverAttributesInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "signal": "spans" | "logs" | "resources";
+    "key_prefix"?: string;
+    "key"?: string;
+}
+export interface AttributeSemconv {
+    "brief": string;
+    "stability": string;
+    "requirement_level": string;
+}
+export interface DiscoveredAttribute {
+    "key": string;
+    "scope": MatcherScope;
+    "type": string;
+    "coverage_share": number;
+    "cardinality": number;
+    "cardinality_exact": boolean;
+    "top_values": AttributeValueCount[];
+    "semconv": AttributeSemconv | null;
+}
+export interface DiscoverAttributesOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "attributes": DiscoveredAttribute[];
+    "error"?: ToolError;
+}
+export interface GetAgentRunInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "session_id"?: SessionId;
+    "trace_id"?: TraceId;
+    "max_steps"?: number;
+}
+export interface AgentRun {
+    "agent_name"?: string;
+    "models": string[];
+    "started": string;
+    "duration_ms": number;
+    "tokens": AgentTokens;
+    "errors": number;
+    "session_id"?: SessionId;
+    "trace_id"?: TraceId;
+}
+export interface AgentStep {
+    "index": number;
+    "kind": "llm_call" | "tool_call" | "agent" | "retrieval";
+    "name": string;
+    "mcp_method"?: string;
+    "mcp_server"?: string;
+    "duration_ms": number;
+    "tokens": AgentTokens;
+    "status": string;
+    "error"?: string;
+    "trace_id": TraceId;
+    "span_id": SpanId;
+}
+export interface RepeatedCall {
+    "tool": string;
+    "argument_hash": string;
+    "count": number;
+}
+export interface AgentTokenShare {
+    "name": string;
+    "tokens": number;
+    "share": number;
+}
+export interface AgentFindings {
+    "repeated_calls": RepeatedCall[];
+    "failed_tool_calls": AgentStep[];
+    "slowest_steps": AgentStep[];
+    "token_share": AgentTokenShare[];
+}
+export interface GetAgentRunOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "run": AgentRun;
+    "steps": AgentStep[];
+    "findings": AgentFindings;
+    "unknowns": string[];
+    "error"?: ToolError;
+}
+export interface ListReleasesInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "service_name"?: string;
+    "environment"?: string;
+}
+export interface ReleasePerformance {
+    "error_rate": number | null;
+    "p95_ms": number | null;
+}
+export interface ReleaseSummary {
+    "service": string;
+    "environment"?: string;
+    "version": string;
+    "revision"?: string;
+    "first_seen": string;
+    "last_seen": string;
+    "current": boolean;
+    "concurrent": boolean;
+    "traffic_share": number;
+    "before": ReleasePerformance;
+    "after": ReleasePerformance;
+    "new_failure_ids": string[];
+}
+export interface ListReleasesOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "has_more": boolean;
+    "next_cursor"?: string;
+    "releases": ReleaseSummary[];
+    "error"?: ToolError;
+}
+export interface GetServiceMapInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "service_name"?: string;
+    "environment"?: string;
+    "depth"?: number;
+    "include_external"?: boolean;
+}
+export interface ServiceMapNode {
+    "name": string;
+    "kind": "service" | "database" | "external" | "messaging";
+    "calls": number;
+    "error_rate": number;
+    "p95_ms": number | null;
+    "unit": "spans";
+}
+export interface ServiceMapEdge {
+    "from": string;
+    "to": string;
+    "calls": number;
+    "error_rate": number;
+    "p95_ms": number | null;
+    "example_operations": string[];
+    "unit": "spans";
+}
+export interface GetServiceMapOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "nodes": ServiceMapNode[];
+    "edges": ServiceMapEdge[];
+    "unknown_callers": number;
+    "error"?: ToolError;
+}
+export interface CheckTelemetryHealthInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "service_name"?: string;
+    "environment"?: string;
+}
+export interface OrphanSpans {
+    "count": number;
+    "share": number;
+    "services": string[];
+    "unit": "spans";
+}
+export interface SemconvGap {
+    "service": string;
+    "operation": string;
+    "attribute": string;
+    "requirement_level": string;
+    "missing_share": number;
+}
+export interface TelemetryRetention {
+    "oldest": string | null;
+    "days": number | null;
+}
+export interface CheckTelemetryHealthOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "silent_services": SilentService[];
+    "orphan_spans": OrphanSpans;
+    "semconv_gaps": SemconvGap[];
+    "unknown_service_share": number;
+    "schema_urls": string[];
+    "retention": TelemetryRetention;
+    "ingestion_lag_ms"?: number;
+    "error"?: ToolError;
+}
+export interface GetMcpStatsInput {
+    "lookback_minutes"?: number;
+    "start_time"?: string;
+    "end_time"?: string;
+    "matchers"?: TelemetryMatcher[];
+    "limit"?: number;
+    "cursor"?: string;
+    "server_name"?: string;
+    "server_version"?: string;
+    "tool_name"?: string;
+    "transport"?: string;
+    "compare_to"?: McpStatsComparison;
+    "group_by"?: "server" | "tool" | "method" | "transport" | "failure_class";
+}
+export interface GetMcpStatsOutput {
+    "window": ToolWindow;
+    "coverage": ToolCoverage;
+    "totals": McpTrafficTotals;
+    "groups": McpTrafficGroup[];
+    "failure_classes": McpFailureClasses;
+    "comparison"?: McpStatsComparisonResult;
+    "error"?: ToolError;
+}
+export interface UpdateFailureStatusInput {
+    "failure_id": string;
+    "etag": string;
+    "status": FailureStatus;
+    "ignore_until"?: string;
+    "assignee"?: string;
+}
+export interface UpdateFailureStatusOutput {
+    "failure": FailureSummary;
+    "error"?: ToolError;
+}
+export interface ToolFieldError {
+    "field": string;
+    "code": string;
+    "message": string;
+    "change": string;
+}
 export interface AnnotationCreateRequest {
+    "labels"?: string[];
+    "classification"?: AnnotationClassification;
     "target": AnnotationTarget;
     "text": string;
 }
 export interface AnnotationUpdateRequest {
-    "text": string;
+    "labels"?: string[];
+    "classification"?: AnnotationClassification;
+    "text"?: string;
 }
 export interface SavedQueryCreateRequest {
     "name": string;
@@ -1729,49 +2857,41 @@ export interface HeartbeatEvent {
 export interface CursorPageTrace {
     "items": Trace[];
     "next_cursor"?: string;
-    "prev_cursor"?: string;
     "has_more": boolean;
 }
 export interface CursorPageSpan {
     "items": Span[];
     "next_cursor"?: string;
-    "prev_cursor"?: string;
     "has_more": boolean;
 }
 export interface CursorPageLogRecord {
     "items": LogRecord[];
     "next_cursor"?: string;
-    "prev_cursor"?: string;
     "has_more": boolean;
 }
 export interface CursorPageMetricDescriptor {
     "items": MetricDescriptor[];
     "next_cursor"?: string;
-    "prev_cursor"?: string;
     "has_more": boolean;
 }
 export interface CursorPageMetricSeries {
     "items": MetricSeries[];
     "next_cursor"?: string;
-    "prev_cursor"?: string;
     "has_more": boolean;
 }
 export interface CursorPageSessionEntity {
     "items": SessionEntity[];
     "next_cursor"?: string;
-    "prev_cursor"?: string;
     "has_more": boolean;
 }
 export interface CursorPageAnnotation {
     "items": Annotation[];
     "next_cursor"?: string;
-    "prev_cursor"?: string;
     "has_more": boolean;
 }
 export interface CursorPageSavedQuery {
     "items": SavedQuery[];
     "next_cursor"?: string;
-    "prev_cursor"?: string;
     "has_more": boolean;
 }
 /** Revision of the API contract these types were emitted from; compare against HealthReport.contract_revision. */