@ancplua/qyl-api-schema 11.6.0 → 12.1.0

package/generated/ts-runtime/schemas.js

@@ -1,9 +1,12 @@
 /** The same names at runtime, so a consumer can prove the published surface is covered. */
 export const contractDefinitionKeys = [
     "Annotations.Annotation",
+    "Annotations.AnnotationClassification",
     "Annotations.AnnotationCreateRequest",
+    "Annotations.AnnotationLabel",
     "Annotations.AnnotationTarget",
     "Annotations.AnnotationUpdateRequest",
+    "Annotations.FailureAnnotationTarget",
     "Annotations.SessionAnnotationTarget",
     "Annotations.SpanAnnotationTarget",
     "Annotations.TraceAnnotationTarget",
@@ -30,7 +33,6 @@ export const contractDefinitionKeys = [
     "Common.ETag",
     "Common.EntityAttributeKey",
     "Common.EntityRef",
-    "Common.Errors.ApiError",
     "Common.Errors.BadGatewayError",
     "Common.Errors.ConflictError",
     "Common.Errors.ForbiddenError",
@@ -38,12 +40,14 @@ export const contractDefinitionKeys = [
     "Common.Errors.NotFoundError",
     "Common.Errors.PreconditionFailedError",
     "Common.Errors.PreconditionRequiredError",
+    "Common.Errors.ProblemCode",
     "Common.Errors.ProblemDetails",
-    "Common.Errors.RateLimitError",
+    "Common.Errors.ProblemType",
     "Common.Errors.ServiceUnavailableError",
     "Common.Errors.UnauthorizedError",
     "Common.Errors.ValidationError",
     "Common.Errors.ValidationErrorDetail",
+    "Common.FailureId",
     "Common.HttpMethod",
     "Common.IPv4Address",
     "Common.IPv6Address",
@@ -52,13 +56,10 @@ export const contractDefinitionKeys = [
     "Common.IsoDuration",
     "Common.LanguageCode",
     "Common.MacAddress",
-    "Common.Pagination.AggregationParams",
-    "Common.Pagination.CursorPaginationParams",
-    "Common.Pagination.OffsetPaginationParams",
-    "Common.Pagination.SortOrder",
-    "Common.Pagination.StreamParams",
-    "Common.Pagination.TimeBucket",
-    "Common.Pagination.TimeRangeParams",
+    "Common.MatcherOp",
+    "Common.MatcherScope",
+    "Common.MatcherValue",
+    "Common.Pagination.PageLimit",
     "Common.Percentage",
     "Common.Port",
     "Common.Ratio",
@@ -68,9 +69,13 @@ export const contractDefinitionKeys = [
     "Common.SessionId",
     "Common.Sha256Hash",
     "Common.SpanId",
+    "Common.TelemetryMatcher",
     "Common.Temperature",
     "Common.Timestamp",
     "Common.TokenCount",
+    "Common.ToolCoverage",
+    "Common.ToolReadContext",
+    "Common.ToolWindow",
     "Common.TraceId",
     "Common.TraceParent",
     "Common.TraceState",
@@ -80,6 +85,7 @@ export const contractDefinitionKeys = [
     "Common.UrlString",
     "Common.UserAgent",
     "Common.UserId",
+    "Common.VerifyId",
     "Domains.Observe.Session.DeviceType",
     "Domains.Observe.Session.SessionAttributes",
     "Domains.Observe.Session.SessionClientInfo",
@@ -93,21 +99,69 @@ export const contractDefinitionKeys = [
     "Health.HealthCheckEntry",
     "Health.HealthReport",
     "Health.HealthStatus",
+    "Mcp.Tools.AgentFindings",
+    "Mcp.Tools.AgentRun",
+    "Mcp.Tools.AgentStep",
+    "Mcp.Tools.AgentTokenShare",
+    "Mcp.Tools.AgentTokens",
+    "Mcp.Tools.AggregateBucket",
+    "Mcp.Tools.AggregateGroup",
+    "Mcp.Tools.AggregateOther",
+    "Mcp.Tools.AggregateTelemetryInput",
+    "Mcp.Tools.AggregateTelemetryOutput",
+    "Mcp.Tools.AlignedSpans",
+    "Mcp.Tools.AnalysisBaseline",
+    "Mcp.Tools.AnalysisInput",
     "Mcp.Tools.AnnotationOutput",
+    "Mcp.Tools.AttributeAssociation",
+    "Mcp.Tools.AttributeSemconv",
+    "Mcp.Tools.AttributeValueCount",
+    "Mcp.Tools.BaselineOffset",
+    "Mcp.Tools.CheckTelemetryHealthInput",
+    "Mcp.Tools.CheckTelemetryHealthOutput",
+    "Mcp.Tools.CiAttempt",
+    "Mcp.Tools.CiComparison",
+    "Mcp.Tools.CiErrorExcerpt",
     "Mcp.Tools.CiLogInput",
     "Mcp.Tools.CiLogOutput",
     "Mcp.Tools.CiPhase",
+    "Mcp.Tools.CiPhaseChange",
     "Mcp.Tools.CiPhaseStatus",
     "Mcp.Tools.CiRunSummary",
+    "Mcp.Tools.CompareGroup",
+    "Mcp.Tools.CompareGroupsInput",
+    "Mcp.Tools.CompareGroupsOutput",
+    "Mcp.Tools.CompareTracesInput",
+    "Mcp.Tools.CompareTracesOutput",
     "Mcp.Tools.CreateAnnotationInput",
     "Mcp.Tools.CreateSavedQueryInput",
     "Mcp.Tools.DeletableKind",
     "Mcp.Tools.DeleteInput",
     "Mcp.Tools.DeleteOutput",
+    "Mcp.Tools.DiscoverAttributesInput",
+    "Mcp.Tools.DiscoverAttributesOutput",
+    "Mcp.Tools.DiscoveredAttribute",
     "Mcp.Tools.DisplayMcpDashboardInput",
     "Mcp.Tools.DisplayMcpDashboardOutput",
     "Mcp.Tools.DisplayTracesInput",
     "Mcp.Tools.DisplayTracesOutput",
+    "Mcp.Tools.DurationPercentiles",
+    "Mcp.Tools.EvidenceSpan",
+    "Mcp.Tools.ExecutionReference",
+    "Mcp.Tools.FailureChange",
+    "Mcp.Tools.FailureComparison",
+    "Mcp.Tools.FailureContext",
+    "Mcp.Tools.FailureDetail",
+    "Mcp.Tools.FailureObserved",
+    "Mcp.Tools.FailureOccurrence",
+    "Mcp.Tools.FailurePropagation",
+    "Mcp.Tools.FailureRelease",
+    "Mcp.Tools.FailureReleaseCount",
+    "Mcp.Tools.FailureStatus",
+    "Mcp.Tools.FailureStatusFilter",
+    "Mcp.Tools.FailureSummary",
+    "Mcp.Tools.FanoutEvidence",
+    "Mcp.Tools.FetchTelemetryCompareInput",
     "Mcp.Tools.FetchTelemetryInput",
     "Mcp.Tools.FetchTelemetryLogsInput",
     "Mcp.Tools.FetchTelemetryMcpStatsInput",
@@ -115,39 +169,101 @@ export const contractDefinitionKeys = [
     "Mcp.Tools.FetchTelemetryTraceInput",
     "Mcp.Tools.FetchTelemetryTracesInput",
     "Mcp.Tools.FetchTelemetryView",
+    "Mcp.Tools.GetAgentRunInput",
+    "Mcp.Tools.GetAgentRunOutput",
+    "Mcp.Tools.GetFailureContextInput",
+    "Mcp.Tools.GetFailureContextOutput",
+    "Mcp.Tools.GetMcpStatsInput",
+    "Mcp.Tools.GetMcpStatsOutput",
     "Mcp.Tools.GetMetricSeriesInput",
     "Mcp.Tools.GetMetricSeriesOutput",
+    "Mcp.Tools.GetServiceMapInput",
+    "Mcp.Tools.GetServiceMapOutput",
     "Mcp.Tools.GetTraceInput",
     "Mcp.Tools.GetTraceOutput",
+    "Mcp.Tools.GroupComposition",
+    "Mcp.Tools.GroupDurations",
+    "Mcp.Tools.GroupStructure",
+    "Mcp.Tools.ListFailuresInput",
+    "Mcp.Tools.ListFailuresOutput",
     "Mcp.Tools.ListMetricsInput",
     "Mcp.Tools.ListMetricsOutput",
+    "Mcp.Tools.ListReleasesInput",
+    "Mcp.Tools.ListReleasesOutput",
     "Mcp.Tools.ListSavedQueriesInput",
     "Mcp.Tools.ListSavedQueriesOutput",
     "Mcp.Tools.ListSessionsInput",
     "Mcp.Tools.ListSessionsOutput",
     "Mcp.Tools.ListTracesInput",
     "Mcp.Tools.ListTracesOutput",
+    "Mcp.Tools.LogPattern",
+    "Mcp.Tools.McpComparisonOffset",
+    "Mcp.Tools.McpComparisonVersion",
     "Mcp.Tools.McpDashboardBucket",
     "Mcp.Tools.McpDashboardStats",
     "Mcp.Tools.McpDashboardTotals",
     "Mcp.Tools.McpDashboardWindow",
     "Mcp.Tools.McpDataMode",
+    "Mcp.Tools.McpFailureClass",
+    "Mcp.Tools.McpFailureClasses",
     "Mcp.Tools.McpNameRequestCount",
     "Mcp.Tools.McpScope",
+    "Mcp.Tools.McpStatsComparison",
+    "Mcp.Tools.McpStatsComparisonResult",
     "Mcp.Tools.McpToolStats",
+    "Mcp.Tools.McpTrafficGroup",
+    "Mcp.Tools.McpTrafficTotals",
+    "Mcp.Tools.MetricComparison",
+    "Mcp.Tools.MetricComparisonOffset",
+    "Mcp.Tools.MetricComparisonResult",
+    "Mcp.Tools.MetricKeySummary",
+    "Mcp.Tools.MetricRatio",
+    "Mcp.Tools.OrphanSpans",
     "Mcp.Tools.QueryMetricInput",
     "Mcp.Tools.QueryMetricOutput",
+    "Mcp.Tools.RecordedException",
+    "Mcp.Tools.ReleasePerformance",
+    "Mcp.Tools.ReleaseSummary",
+    "Mcp.Tools.RepeatedCall",
+    "Mcp.Tools.RetryEvidence",
     "Mcp.Tools.RunSavedQueryInput",
     "Mcp.Tools.RunSavedQueryOutput",
     "Mcp.Tools.SavedQueryOutput",
     "Mcp.Tools.SearchLogsInput",
     "Mcp.Tools.SearchLogsOutput",
+    "Mcp.Tools.SemconvGap",
+    "Mcp.Tools.ServiceAnalysisInput",
+    "Mcp.Tools.ServiceMapEdge",
+    "Mcp.Tools.ServiceMapNode",
+    "Mcp.Tools.SilentService",
+    "Mcp.Tools.SimilarFailure",
+    "Mcp.Tools.SpanEvidenceRole",
+    "Mcp.Tools.TelemetryRetention",
     "Mcp.Tools.ToolError",
     "Mcp.Tools.ToolErrorCode",
+    "Mcp.Tools.ToolFieldError",
     "Mcp.Tools.ToolPage",
+    "Mcp.Tools.ToolSession",
+    "Mcp.Tools.ToolSpan",
     "Mcp.Tools.ToolTimeRange",
+    "Mcp.Tools.ToolTrace",
+    "Mcp.Tools.ToolTraceSummary",
+    "Mcp.Tools.TraceDivergence",
+    "Mcp.Tools.TraceGroup",
+    "Mcp.Tools.TraceLinkAvailability",
+    "Mcp.Tools.TraceOmitted",
+    "Mcp.Tools.TriageFailure",
+    "Mcp.Tools.TriageInput",
+    "Mcp.Tools.TriageOutput",
+    "Mcp.Tools.TriageRegression",
     "Mcp.Tools.UpdateAnnotationInput",
+    "Mcp.Tools.UpdateFailureStatusInput",
+    "Mcp.Tools.UpdateFailureStatusOutput",
     "Mcp.Tools.UpdateSavedQueryInput",
+    "Mcp.Tools.VerificationNeeds",
+    "Mcp.Tools.VerificationPeriod",
+    "Mcp.Tools.VerifyFixInput",
+    "Mcp.Tools.VerifyFixOutput",
     "OTel.Enums.ErrorType",
     "OTel.Enums.EventDomain",
     "OTel.Enums.SeverityNumber",
@@ -162,6 +278,7 @@ export const contractDefinitionKeys = [
     "OTel.Metrics.MetricAttributeMatcher",
     "OTel.Metrics.MetricBucket",
     "OTel.Metrics.MetricDescriptor",
+    "OTel.Metrics.MetricDescriptorConflict",
     "OTel.Metrics.MetricKind",
     "OTel.Metrics.MetricMatcherOp",
     "OTel.Metrics.MetricQueryResult",
@@ -175,7 +292,6 @@ export const contractDefinitionKeys = [
     "OTel.Traces.Span",
     "OTel.Traces.SpanEvent",
     "OTel.Traces.SpanLink",
-    "OTel.Traces.SpanQueryFilters",
     "OTel.Traces.SpanStats",
     "OTel.Traces.SpanStatsByDimension",
     "OTel.Traces.SpanStatus",
@@ -212,6 +328,15 @@ export const contractDefinitionKeys = [
     "Operations.AnnotationsApi_update.Response.412",
     "Operations.AnnotationsApi_update.Response.428",
     "Operations.AnnotationsApi_update.Response.500",
+    "Operations.FailuresApi_update.Request",
+    "Operations.FailuresApi_update.Response.200",
+    "Operations.FailuresApi_update.Response.400",
+    "Operations.FailuresApi_update.Response.401",
+    "Operations.FailuresApi_update.Response.403",
+    "Operations.FailuresApi_update.Response.404",
+    "Operations.FailuresApi_update.Response.412",
+    "Operations.FailuresApi_update.Response.428",
+    "Operations.FailuresApi_update.Response.500",
     "Operations.LogsApi_list.Response.200",
     "Operations.LogsApi_list.Response.400",
     "Operations.LogsApi_list.Response.401",
@@ -652,6 +777,162 @@ export const contractDefinitionKeys = [
     "Operations.WorkbenchWorkspacesApi_updatePreferences.Response.404",
     "Operations.WorkbenchWorkspacesApi_updatePreferences.Response.500",
     "Operations.WorkbenchWorkspacesApi_updatePreferences.Response.503",
+    "Operations.analysis_aggregate_telemetry.Request",
+    "Operations.analysis_aggregate_telemetry.Response.200",
+    "Operations.analysis_aggregate_telemetry.Response.400",
+    "Operations.analysis_aggregate_telemetry.Response.401",
+    "Operations.analysis_aggregate_telemetry.Response.404",
+    "Operations.analysis_aggregate_telemetry.Response.500",
+    "Operations.analysis_check_telemetry_health.Request",
+    "Operations.analysis_check_telemetry_health.Response.200",
+    "Operations.analysis_check_telemetry_health.Response.400",
+    "Operations.analysis_check_telemetry_health.Response.401",
+    "Operations.analysis_check_telemetry_health.Response.404",
+    "Operations.analysis_check_telemetry_health.Response.500",
+    "Operations.analysis_ci_log.Request",
+    "Operations.analysis_ci_log.Response.200",
+    "Operations.analysis_ci_log.Response.400",
+    "Operations.analysis_ci_log.Response.401",
+    "Operations.analysis_ci_log.Response.404",
+    "Operations.analysis_ci_log.Response.500",
+    "Operations.analysis_compare_groups.Request",
+    "Operations.analysis_compare_groups.Response.200",
+    "Operations.analysis_compare_groups.Response.400",
+    "Operations.analysis_compare_groups.Response.401",
+    "Operations.analysis_compare_groups.Response.404",
+    "Operations.analysis_compare_groups.Response.500",
+    "Operations.analysis_compare_traces.Request",
+    "Operations.analysis_compare_traces.Response.200",
+    "Operations.analysis_compare_traces.Response.400",
+    "Operations.analysis_compare_traces.Response.401",
+    "Operations.analysis_compare_traces.Response.404",
+    "Operations.analysis_compare_traces.Response.500",
+    "Operations.analysis_discover_attributes.Request",
+    "Operations.analysis_discover_attributes.Response.200",
+    "Operations.analysis_discover_attributes.Response.400",
+    "Operations.analysis_discover_attributes.Response.401",
+    "Operations.analysis_discover_attributes.Response.404",
+    "Operations.analysis_discover_attributes.Response.500",
+    "Operations.analysis_display_mcp_dashboard.Request",
+    "Operations.analysis_display_mcp_dashboard.Response.200",
+    "Operations.analysis_display_mcp_dashboard.Response.400",
+    "Operations.analysis_display_mcp_dashboard.Response.401",
+    "Operations.analysis_display_mcp_dashboard.Response.404",
+    "Operations.analysis_display_mcp_dashboard.Response.500",
+    "Operations.analysis_display_traces.Request",
+    "Operations.analysis_display_traces.Response.200",
+    "Operations.analysis_display_traces.Response.400",
+    "Operations.analysis_display_traces.Response.401",
+    "Operations.analysis_display_traces.Response.404",
+    "Operations.analysis_display_traces.Response.500",
+    "Operations.analysis_fetch_telemetry.Request",
+    "Operations.analysis_fetch_telemetry.Response.200",
+    "Operations.analysis_fetch_telemetry.Response.400",
+    "Operations.analysis_fetch_telemetry.Response.401",
+    "Operations.analysis_fetch_telemetry.Response.404",
+    "Operations.analysis_fetch_telemetry.Response.500",
+    "Operations.analysis_get_agent_run.Request",
+    "Operations.analysis_get_agent_run.Response.200",
+    "Operations.analysis_get_agent_run.Response.400",
+    "Operations.analysis_get_agent_run.Response.401",
+    "Operations.analysis_get_agent_run.Response.404",
+    "Operations.analysis_get_agent_run.Response.500",
+    "Operations.analysis_get_failure_context.Request",
+    "Operations.analysis_get_failure_context.Response.200",
+    "Operations.analysis_get_failure_context.Response.400",
+    "Operations.analysis_get_failure_context.Response.401",
+    "Operations.analysis_get_failure_context.Response.404",
+    "Operations.analysis_get_failure_context.Response.500",
+    "Operations.analysis_get_mcp_stats.Request",
+    "Operations.analysis_get_mcp_stats.Response.200",
+    "Operations.analysis_get_mcp_stats.Response.400",
+    "Operations.analysis_get_mcp_stats.Response.401",
+    "Operations.analysis_get_mcp_stats.Response.404",
+    "Operations.analysis_get_mcp_stats.Response.500",
+    "Operations.analysis_get_metric_series.Request",
+    "Operations.analysis_get_metric_series.Response.200",
+    "Operations.analysis_get_metric_series.Response.400",
+    "Operations.analysis_get_metric_series.Response.401",
+    "Operations.analysis_get_metric_series.Response.404",
+    "Operations.analysis_get_metric_series.Response.500",
+    "Operations.analysis_get_service_map.Request",
+    "Operations.analysis_get_service_map.Response.200",
+    "Operations.analysis_get_service_map.Response.400",
+    "Operations.analysis_get_service_map.Response.401",
+    "Operations.analysis_get_service_map.Response.404",
+    "Operations.analysis_get_service_map.Response.500",
+    "Operations.analysis_get_trace.Request",
+    "Operations.analysis_get_trace.Response.200",
+    "Operations.analysis_get_trace.Response.400",
+    "Operations.analysis_get_trace.Response.401",
+    "Operations.analysis_get_trace.Response.404",
+    "Operations.analysis_get_trace.Response.500",
+    "Operations.analysis_list_failures.Request",
+    "Operations.analysis_list_failures.Response.200",
+    "Operations.analysis_list_failures.Response.400",
+    "Operations.analysis_list_failures.Response.401",
+    "Operations.analysis_list_failures.Response.404",
+    "Operations.analysis_list_failures.Response.500",
+    "Operations.analysis_list_metrics.Request",
+    "Operations.analysis_list_metrics.Response.200",
+    "Operations.analysis_list_metrics.Response.400",
+    "Operations.analysis_list_metrics.Response.401",
+    "Operations.analysis_list_metrics.Response.404",
+    "Operations.analysis_list_metrics.Response.500",
+    "Operations.analysis_list_releases.Request",
+    "Operations.analysis_list_releases.Response.200",
+    "Operations.analysis_list_releases.Response.400",
+    "Operations.analysis_list_releases.Response.401",
+    "Operations.analysis_list_releases.Response.404",
+    "Operations.analysis_list_releases.Response.500",
+    "Operations.analysis_list_saved_queries.Request",
+    "Operations.analysis_list_saved_queries.Response.200",
+    "Operations.analysis_list_saved_queries.Response.400",
+    "Operations.analysis_list_saved_queries.Response.401",
+    "Operations.analysis_list_saved_queries.Response.404",
+    "Operations.analysis_list_saved_queries.Response.500",
+    "Operations.analysis_list_sessions.Request",
+    "Operations.analysis_list_sessions.Response.200",
+    "Operations.analysis_list_sessions.Response.400",
+    "Operations.analysis_list_sessions.Response.401",
+    "Operations.analysis_list_sessions.Response.404",
+    "Operations.analysis_list_sessions.Response.500",
+    "Operations.analysis_list_traces.Request",
+    "Operations.analysis_list_traces.Response.200",
+    "Operations.analysis_list_traces.Response.400",
+    "Operations.analysis_list_traces.Response.401",
+    "Operations.analysis_list_traces.Response.404",
+    "Operations.analysis_list_traces.Response.500",
+    "Operations.analysis_query_metric.Request",
+    "Operations.analysis_query_metric.Response.200",
+    "Operations.analysis_query_metric.Response.400",
+    "Operations.analysis_query_metric.Response.401",
+    "Operations.analysis_query_metric.Response.404",
+    "Operations.analysis_query_metric.Response.500",
+    "Operations.analysis_run_saved_query.Request",
+    "Operations.analysis_run_saved_query.Response.200",
+    "Operations.analysis_run_saved_query.Response.400",
+    "Operations.analysis_run_saved_query.Response.401",
+    "Operations.analysis_run_saved_query.Response.404",
+    "Operations.analysis_run_saved_query.Response.500",
+    "Operations.analysis_search_logs.Request",
+    "Operations.analysis_search_logs.Response.200",
+    "Operations.analysis_search_logs.Response.400",
+    "Operations.analysis_search_logs.Response.401",
+    "Operations.analysis_search_logs.Response.404",
+    "Operations.analysis_search_logs.Response.500",
+    "Operations.analysis_triage.Request",
+    "Operations.analysis_triage.Response.200",
+    "Operations.analysis_triage.Response.400",
+    "Operations.analysis_triage.Response.401",
+    "Operations.analysis_triage.Response.404",
+    "Operations.analysis_triage.Response.500",
+    "Operations.analysis_verify_fix.Request",
+    "Operations.analysis_verify_fix.Response.200",
+    "Operations.analysis_verify_fix.Response.400",
+    "Operations.analysis_verify_fix.Response.401",
+    "Operations.analysis_verify_fix.Response.404",
+    "Operations.analysis_verify_fix.Response.500",
     "Operations.health_alive.Response.200",
     "Operations.health_alive.Response.503",
     "Operations.health_ready.Response.200",
@@ -680,6 +961,7 @@ export const contractDefinitionKeys = [
     "Streaming.HeartbeatEvent",
     "Streaming.LogEvents",
     "Streaming.LogStreamEvent",
+    "UpdateFailureStatusRequest",
     "Workbench.WorkbenchAssertionResult",
     "Workbench.WorkbenchAssertionStatus",
     "Workbench.WorkbenchBuiltinServerConfiguration",

package/index.tsp

@@ -26,3 +26,5 @@ import "./api/routes.tsp";
 import "./api/streaming.tsp";
 import "./api/runner.tsp";
 import "./api/workbench.tsp";
+
+import "./api/analysis.tsp";

package/models/annotations.tsp

@@ -1,3 +1,4 @@
+import "../common/telemetry-query.tsp";
 // =============================================================================
 // Annotations: user notes on a trace, span or session
 // =============================================================================
@@ -49,10 +50,15 @@ union AnnotationTarget {
   trace: TraceAnnotationTarget,
   span: SpanAnnotationTarget,
   session: SessionAnnotationTarget,
+  failure: FailureAnnotationTarget,
 }
 
 @doc("A user note attached to a trace, span or session.")
 model Annotation extends ResourceBase {
+  @maxItems(10)
+  labels?: AnnotationLabel[];
+  classification?: AnnotationClassification;
+
   @doc("What the note is attached to. Fixed at creation.")
   @visibility(Lifecycle.Read, Lifecycle.Create)
   target: AnnotationTarget;
@@ -65,6 +71,10 @@ model Annotation extends ResourceBase {
 
 @doc("Body of POST /api/v1/annotations: the `Lifecycle.Create` members of Annotation.")
 model AnnotationCreateRequest {
+  @maxItems(10)
+  labels?: AnnotationLabel[];
+  classification?: AnnotationClassification;
+
   @doc("What the note is attached to. Fixed at creation.")
   target: AnnotationTarget;
 
@@ -76,8 +86,28 @@ model AnnotationCreateRequest {
 
 @doc("Body of PATCH /api/v1/annotations/{annotation_id}: the `Lifecycle.Update` members of Annotation.")
 model AnnotationUpdateRequest {
+  @maxItems(10)
+  labels?: AnnotationLabel[];
+  classification?: AnnotationClassification;
+
   @doc("The new note, plain text, at most 2000 characters.")
   @minLength(1)
   @maxLength(2000)
-  text: string;
+  text?: string;
 }
+
+@doc("FailureAnnotationTarget contract.")
+model FailureAnnotationTarget {
+  kind: "failure";
+  @encodedName("application/json", "failure_id")
+  failureId: FailureId;
+}
+
+
+@doc("Classification of the human annotation.")
+enum AnnotationClassification { note, hypothesis, finding, rejected }
+
+@doc("A short user-defined annotation label.")
+@minLength(1)
+@maxLength(64)
+scalar AnnotationLabel extends string;