@ancplua/qyl-api-schema 11.6.0 → 12.1.0

package/README.md

@@ -27,8 +27,9 @@ The contract covers every client-visible surface of a qyl collector and runner:
   (`api/workbench.tsp`, `models/workbench.tsp`).
 - **Runner** — the local runner's loopback-only `/runner/resources` snapshot, SSE
   streams, logs and restart/stop actions (`api/runner.tsp`, `models/runner.tsp`).
-- **Shared** — `ProblemDetails` errors, cursor pagination and the common scalars
-  (`common/`), plus the OTel resource, span and log projections (`otel/`).
+- **Shared** — RFC 9457 problem details (`common/errors.tsp`), cursor pagination
+  (`common/pagination.tsp`) and the common scalars (`common/`), plus the OTel
+  resource, span and log projections (`otel/`).
 
 Telemetry itself is never changed or deleted through this contract; retention
 removes it. The only writable resources are the ones a user creates:
@@ -41,6 +42,21 @@ extend the shared write base in `common/resource.tsp`: server-assigned `id`,
 missing and `412` when stale. Collector keys carry the roles `ingest`, `read`,
 `write` and `delete` (`CollectorKeyRole`); writes need `write`, deletes `delete`.
 
+## Errors and pages
+
+Every error body is an RFC 9457 problem served as `application/problem+json`: `type`,
+`title`, `status`, `detail` and `instance`, plus the extension member `code`. Each
+problem type fixes its `type` URI (`https://qyl.at/problems/<name>`) and its `code`
+(`not_found`, `validation_failed`, …), so a client branches on either and never on
+`title` or `detail`. Problem bodies carry no headers. A response header is declared on
+the operations whose server sends it: `X-Trace-Id` on the collector's 500 responses,
+`WWW-Authenticate` on the workbench's 401 responses.
+
+Every list operation pages forward with an opaque cursor. It takes `limit`
+(`PageLimit`: 1 to 1000, 100 when omitted) and `cursor`, and its page carries
+`has_more` and, on every page but the last, `next_cursor`, which the next request
+sends back as `cursor`.
+
 ## Contract pipeline
 
 ```text
@@ -130,6 +146,11 @@ contract instead of discovering the mismatch one malformed field at a time. Read
 current value from a running collector or the generated artifacts; it is derived, never
 hand-maintained.
 
+The OpenAPI `info.version` is the release version: `prepack` stamps it into the packed
+document from the release tag, and the tracked document keeps TypeSpec's `0.0.0`. The
+digest excludes `info.version`, so a release that changes nothing but its version keeps
+the revision.
+
 ## Contributing
 
 How to build, lint, regenerate and publish is in [CONTRIBUTING.md](CONTRIBUTING.md).
@@ -137,3 +158,11 @@ How to build, lint, regenerate and publish is in [CONTRIBUTING.md](CONTRIBUTING.
 ## License
 
 Apache-2.0
+
+## Investigation contracts
+
+The generated `Mcp.Tools` surface covers the 32-tool qyl MCP set. Each of the 26 read tools has a distinct, typed `POST /api/v1/analysis/<tool_name>` operation. Structured predicates support the shared matcher operators; read results carry the absolute `window` and `coverage` with nullable unknown counts. Existing trace, log, metric and session REST routes remain available.
+
+Failure status is updated through `PATCH /api/v1/failures/{failure_id}` with `If-Match`. Failure handles, verification tokens and cursors are scoped and validated by the collector. Annotation contracts support failure targets, labels, classifications and retry keys. These contracts carry product data only; telemetry runtime dependencies remain in their producer repositories.
+
+The schema gate checks all read operation/type pairs, answer-key result shapes and invalid inputs, then verifies the packed npm and NuGet consumers. Collector behavior and the seeded live tool answers are tested by the collector and MCP suites against the same generated contracts.

package/api/analysis.tsp

@@ -0,0 +1,165 @@
+import "./routes.tsp";
+import "../models/mcp-tools.tsp";
+import "../models/mcp-analysis.tsp";
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+using Qyl.Api.Contracts.Common;
+using Qyl.Api.Contracts.Common.Errors;
+using Qyl.Api.Contracts.Mcp.Tools;
+namespace Qyl.Api.Contracts;
+
+@route("/api/v1/analysis")
+@tag("Analysis")
+@useAuth(QylApiKeyHeaderAuth)
+interface AnalysisApi {
+  @doc("Read triage evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/triage")
+  @operationId("analysis_triage")
+  triage(...ProjectScopeHeader, @body request: TriageInput): TriageOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read list_failures evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/list_failures")
+  @operationId("analysis_list_failures")
+  list_failures(...ProjectScopeHeader, @body request: ListFailuresInput): ListFailuresOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read get_failure_context evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/get_failure_context")
+  @operationId("analysis_get_failure_context")
+  get_failure_context(...ProjectScopeHeader, @body request: GetFailureContextInput): GetFailureContextOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read compare_groups evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/compare_groups")
+  @operationId("analysis_compare_groups")
+  compare_groups(...ProjectScopeHeader, @body request: CompareGroupsInput): CompareGroupsOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read compare_traces evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/compare_traces")
+  @operationId("analysis_compare_traces")
+  compare_traces(...ProjectScopeHeader, @body request: CompareTracesInput): CompareTracesOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read verify_fix evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/verify_fix")
+  @operationId("analysis_verify_fix")
+  verify_fix(...ProjectScopeHeader, @body request: VerifyFixInput): VerifyFixOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read aggregate_telemetry evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/aggregate_telemetry")
+  @operationId("analysis_aggregate_telemetry")
+  aggregate_telemetry(...ProjectScopeHeader, @body request: AggregateTelemetryInput): AggregateTelemetryOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read discover_attributes evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/discover_attributes")
+  @operationId("analysis_discover_attributes")
+  discover_attributes(...ProjectScopeHeader, @body request: DiscoverAttributesInput): DiscoverAttributesOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read get_agent_run evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/get_agent_run")
+  @operationId("analysis_get_agent_run")
+  get_agent_run(...ProjectScopeHeader, @body request: GetAgentRunInput): GetAgentRunOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read list_releases evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/list_releases")
+  @operationId("analysis_list_releases")
+  list_releases(...ProjectScopeHeader, @body request: ListReleasesInput): ListReleasesOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read get_service_map evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/get_service_map")
+  @operationId("analysis_get_service_map")
+  get_service_map(...ProjectScopeHeader, @body request: GetServiceMapInput): GetServiceMapOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read check_telemetry_health evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/check_telemetry_health")
+  @operationId("analysis_check_telemetry_health")
+  check_telemetry_health(...ProjectScopeHeader, @body request: CheckTelemetryHealthInput): CheckTelemetryHealthOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read get_mcp_stats evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/get_mcp_stats")
+  @operationId("analysis_get_mcp_stats")
+  get_mcp_stats(...ProjectScopeHeader, @body request: GetMcpStatsInput): GetMcpStatsOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read list_sessions evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/list_sessions")
+  @operationId("analysis_list_sessions")
+  list_sessions(...ProjectScopeHeader, @body request: ListSessionsInput): ListSessionsOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read list_traces evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/list_traces")
+  @operationId("analysis_list_traces")
+  list_traces(...ProjectScopeHeader, @body request: ListTracesInput): ListTracesOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read get_trace evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/get_trace")
+  @operationId("analysis_get_trace")
+  get_trace(...ProjectScopeHeader, @body request: GetTraceInput): GetTraceOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read search_logs evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/search_logs")
+  @operationId("analysis_search_logs")
+  search_logs(...ProjectScopeHeader, @body request: SearchLogsInput): SearchLogsOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read list_metrics evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/list_metrics")
+  @operationId("analysis_list_metrics")
+  list_metrics(...ProjectScopeHeader, @body request: ListMetricsInput): ListMetricsOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read get_metric_series evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/get_metric_series")
+  @operationId("analysis_get_metric_series")
+  get_metric_series(...ProjectScopeHeader, @body request: GetMetricSeriesInput): GetMetricSeriesOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read query_metric evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/query_metric")
+  @operationId("analysis_query_metric")
+  query_metric(...ProjectScopeHeader, @body request: QueryMetricInput): QueryMetricOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read ci_log evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/ci_log")
+  @operationId("analysis_ci_log")
+  ci_log(...ProjectScopeHeader, @body request: CiLogInput): CiLogOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read list_saved_queries evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/list_saved_queries")
+  @operationId("analysis_list_saved_queries")
+  list_saved_queries(...ProjectScopeHeader, @body request: ListSavedQueriesInput): ListSavedQueriesOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read run_saved_query evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/run_saved_query")
+  @operationId("analysis_run_saved_query")
+  run_saved_query(...ProjectScopeHeader, @body request: RunSavedQueryInput): RunSavedQueryOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read display_traces evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/display_traces")
+  @operationId("analysis_display_traces")
+  display_traces(...ProjectScopeHeader, @body request: DisplayTracesInput): DisplayTracesOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read display_mcp_dashboard evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/display_mcp_dashboard")
+  @operationId("analysis_display_mcp_dashboard")
+  display_mcp_dashboard(...ProjectScopeHeader, @body request: DisplayMcpDashboardInput): DisplayMcpDashboardOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+  @doc("Read fetch_telemetry evidence in the authenticated project without changing telemetry or user resources.")
+  @post
+  @route("/fetch_telemetry")
+  @operationId("analysis_fetch_telemetry")
+  fetch_telemetry(...ProjectScopeHeader, @body request: FetchTelemetryInput): FetchTelemetryOutput | ValidationError | NotFoundError | UnauthorizedError | CollectorServerErrorResponse;
+}
+
+@doc("Mutable status and assignee of a failure; its telemetry fingerprint never changes.")
+model UpdateFailureStatusRequest {
+  status: FailureStatus;
+  @encodedName("application/json", "ignore_until")
+  ignoreUntil?: utcDateTime;
+  @maxLength(256)
+  assignee?: string;
+}
+
+@route("/api/v1/failures")
+@tag("Failures")
+interface FailuresApi {
+  @doc("Set a project's failure status or assignee using the version returned by list_failures.")
+  @useAuth(QylWriteKeyAuth)
+  @patch(#{ implicitOptionality: false })
+  @route("/{failure_id}")
+  update(...ProjectScopeHeader, ...IfMatchHeader, @path("failure_id") failureId: FailureId, @body request: UpdateFailureStatusRequest):
+    UpdateFailureStatusOutput | ValidationError | UnauthorizedError | ForbiddenError | NotFoundError | PreconditionFailedError | PreconditionRequiredError | CollectorServerErrorResponse;
+}

package/api/routes.tsp

@@ -41,6 +41,20 @@ model ProjectScopeHeader {
   projectId?: string;
 }
 
+// Problem bodies carry no headers (common/errors.tsp). The one header a
+// collector error response carries is declared here, on the collector's own
+// operations: its unhandled-exception handler names the trace of the failed
+// request.
+@doc("The collector failed while handling the request (500). `X-Trace-Id` names the collector's own trace of the failed request.")
+@error
+model CollectorServerErrorResponse {
+  @doc("Trace id of the collector's own trace of the failed request, for finding it in the collector's telemetry.")
+  @header("X-Trace-Id")
+  traceId?: TraceId;
+
+  @bodyRoot problem: InternalServerError;
+}
+
 // -----------------------------------------------------------------------------
 // Traces
 // -----------------------------------------------------------------------------
@@ -49,6 +63,7 @@ model ProjectScopeHeader {
 @tag("Traces")
 @useAuth(QylApiKeyHeaderAuth)
 interface TracesApi {
+  @list
   @get
   list(
     ...ProjectScopeHeader,
@@ -69,17 +84,12 @@ interface TracesApi {
     @query("errors_only")
     errorsOnly?: boolean,
 
-    @query
-    @minValue(1)
-    @maxValue(1000)
-    limit?: int32 = 100,
-
-    @query cursor?: Cursor,
+    ...CursorPageQuery,
   ):
     | CursorPage<Trace>
     | ValidationError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @get
   @route("/{trace_id}")
@@ -87,27 +97,23 @@ interface TracesApi {
     | Trace
     | NotFoundError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
+  @doc("Page through the spans of one trace. `GET /api/v1/traces/{trace_id}` returns the whole trace at once.")
+  @list
   @get
   @route("/{trace_id}/spans")
   getSpans(
     ...ProjectScopeHeader,
     @path("trace_id") traceId: TraceId,
 
-    @doc("Page size. Omitted, every span of the trace is returned in one page.")
-    @query
-    @minValue(1)
-    @maxValue(10000)
-    limit?: int32,
-
-    @query cursor?: Cursor,
+    ...CursorPageQuery,
   ):
     | CursorPage<Span>
     | ValidationError
     | NotFoundError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 }
 
 // -----------------------------------------------------------------------------
@@ -118,6 +124,7 @@ interface TracesApi {
 @tag("Logs")
 @useAuth(QylApiKeyHeaderAuth)
 interface LogsApi {
+  @list
   @get
   list(
     ...ProjectScopeHeader,
@@ -130,17 +137,12 @@ interface LogsApi {
     @query("end_time") endTime?: utcDateTime,
     @query query?: string,
 
-    @query
-    @minValue(1)
-    @maxValue(10000)
-    limit?: int32 = 100,
-
-    @query cursor?: Cursor,
+    ...CursorPageQuery,
   ):
     | CursorPage<LogRecord>
     | ValidationError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 }
 
 // -----------------------------------------------------------------------------
@@ -157,6 +159,7 @@ interface LogsApi {
 @useAuth(QylApiKeyHeaderAuth)
 interface MetricsApi {
   @doc("List the metric names recorded for a project.")
+  @list
   @get
   list(
     ...ProjectScopeHeader,
@@ -165,19 +168,15 @@ interface MetricsApi {
     @query("name_prefix")
     namePrefix?: string,
 
-    @query
-    @minValue(1)
-    @maxValue(1000)
-    limit?: int32 = 200,
-
-    @query cursor?: Cursor,
+    ...CursorPageQuery,
   ):
     | CursorPage<MetricDescriptor>
     | ValidationError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @doc("List the distinct attribute streams recorded under one metric name.")
+  @list
   @get
   @route("/{metric_name}/series")
   listSeries(
@@ -195,18 +194,13 @@ interface MetricsApi {
     @query(#{ name: "attr_prefix", explode: true })
     attrPrefix?: string[],
 
-    @query
-    @minValue(1)
-    @maxValue(1000)
-    limit?: int32 = 200,
-
-    @query cursor?: Cursor,
+    ...CursorPageQuery,
   ):
     | CursorPage<MetricSeries>
     | ValidationError
     | NotFoundError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @doc("""
     Aggregate one metric over a time range into buckets of `step_ms`.
@@ -250,7 +244,7 @@ interface MetricsApi {
     | ValidationError
     | NotFoundError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 }
 
 // -----------------------------------------------------------------------------
@@ -261,6 +255,7 @@ interface MetricsApi {
 @tag("Sessions")
 @useAuth(QylApiKeyHeaderAuth)
 interface SessionsApi {
+  @list
   @get
   list(
     ...ProjectScopeHeader,
@@ -268,17 +263,12 @@ interface SessionsApi {
     @query("start_time") startTime?: utcDateTime,
     @query("end_time") endTime?: utcDateTime,
 
-    @query
-    @minValue(1)
-    @maxValue(1000)
-    limit?: int32 = 100,
-
-    @query cursor?: Cursor,
+    ...CursorPageQuery,
   ):
     | CursorPage<SessionEntity>
     | ValidationError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @get
   @route("/{session_id}")
@@ -286,27 +276,22 @@ interface SessionsApi {
     | SessionEntity
     | NotFoundError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
+  @list
   @get
   @route("/{session_id}/traces")
   getTraces(
     ...ProjectScopeHeader,
     @path("session_id") sessionId: SessionId,
 
-    @doc("Page size; the response is bounded even when omitted.")
-    @query
-    @minValue(1)
-    @maxValue(1000)
-    limit?: int32 = 100,
-
-    @query cursor?: Cursor,
+    ...CursorPageQuery,
   ):
     | CursorPage<Trace>
     | ValidationError
     | NotFoundError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @get
   @route("/stats")
@@ -314,7 +299,7 @@ interface SessionsApi {
     ...ProjectScopeHeader,
     @query("start_time") startTime?: utcDateTime,
     @query("end_time") endTime?: utcDateTime,
-  ): SessionStats | ValidationError | UnauthorizedError | InternalServerError;
+  ): SessionStats | ValidationError | UnauthorizedError | CollectorServerErrorResponse;
 }
 
 // -----------------------------------------------------------------------------
@@ -350,10 +335,11 @@ interface AnnotationsApi {
     | ForbiddenError
     | NotFoundError
     | ConflictError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @doc("List annotations, newest first, optionally only those attached to one trace, span or session.")
   @useAuth(QylApiKeyHeaderAuth)
+  @list
   @get
   list(
     ...ProjectScopeHeader,
@@ -368,17 +354,12 @@ interface AnnotationsApi {
 
     @query("session_id") sessionId?: SessionId,
 
-    @query
-    @minValue(1)
-    @maxValue(1000)
-    limit?: int32 = 100,
-
-    @query cursor?: Cursor,
+    ...CursorPageQuery,
   ):
     | CursorPage<Annotation>
     | ValidationError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @useAuth(QylApiKeyHeaderAuth)
   @get
@@ -390,7 +371,7 @@ interface AnnotationsApi {
       }
     | NotFoundError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @doc("Replace the text of an annotation. The target is fixed at creation.")
   @useAuth(QylWriteKeyAuth)
@@ -412,7 +393,7 @@ interface AnnotationsApi {
     | NotFoundError
     | PreconditionFailedError
     | PreconditionRequiredError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @doc("Delete one annotation. Telemetry is never deleted.")
   @useAuth(QylDeleteKeyAuth)
@@ -429,7 +410,7 @@ interface AnnotationsApi {
     | NotFoundError
     | PreconditionFailedError
     | PreconditionRequiredError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 }
 
 // -----------------------------------------------------------------------------
@@ -464,26 +445,22 @@ interface SavedQueriesApi {
     | UnauthorizedError
     | ForbiddenError
     | ConflictError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @doc("List the project's saved queries by name.")
   @useAuth(QylApiKeyHeaderAuth)
+  @list
   @get
   list(
     ...ProjectScopeHeader,
     @query signal?: SavedQuerySignal,
 
-    @query
-    @minValue(1)
-    @maxValue(1000)
-    limit?: int32 = 100,
-
-    @query cursor?: Cursor,
+    ...CursorPageQuery,
   ):
     | CursorPage<SavedQuery>
     | ValidationError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @useAuth(QylApiKeyHeaderAuth)
   @get
@@ -495,7 +472,7 @@ interface SavedQueriesApi {
       }
     | NotFoundError
     | UnauthorizedError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @doc("Change a saved query. Renaming onto a name already used in the project is refused with 409.")
   @useAuth(QylWriteKeyAuth)
@@ -518,7 +495,7 @@ interface SavedQueriesApi {
     | ConflictError
     | PreconditionFailedError
     | PreconditionRequiredError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @doc("Delete one saved query.")
   @useAuth(QylDeleteKeyAuth)
@@ -535,7 +512,7 @@ interface SavedQueriesApi {
     | NotFoundError
     | PreconditionFailedError
     | PreconditionRequiredError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 
   @doc("Evaluate a saved query against current telemetry. Read-only.")
   @useAuth(QylApiKeyHeaderAuth)
@@ -550,7 +527,7 @@ interface SavedQueriesApi {
     | ValidationError
     | UnauthorizedError
     | NotFoundError
-    | InternalServerError;
+    | CollectorServerErrorResponse;
 }
 
 // -----------------------------------------------------------------------------

package/api/streaming.tsp

@@ -46,5 +46,10 @@ interface StreamingApi {
     @query("service_name") serviceName?: string,
     @query("min_severity") @minValue(1) @maxValue(24) minSeverity?: int32,
     @query query?: string,
-  ): SSEStream<LogEvents> | ValidationError | UnauthorizedError | ServiceUnavailableError | InternalServerError;
+  ):
+    | SSEStream<LogEvents>
+    | ValidationError
+    | UnauthorizedError
+    | ServiceUnavailableError
+    | Qyl.Api.Contracts.CollectorServerErrorResponse;
 }