@ancplua/qyl-api-schema 11.6.0 → 12.0.0

package/models/saved-queries.tsp

@@ -9,6 +9,7 @@
 import "@typespec/http";
 import "@typespec/openapi";
 import "../common/types.tsp";
+import "../common/pagination.tsp";
 import "../common/resource.tsp";
 import "../otel/enums.tsp";
 import "../otel/span.tsp";
@@ -17,6 +18,7 @@ import "./metrics.tsp";
 
 using TypeSpec.OpenAPI;
 using Qyl.Api.Contracts.Common;
+using Qyl.Api.Contracts.Common.Pagination;
 using Qyl.Api.Contracts.OTel.Enums;
 using Qyl.Api.Contracts.OTel.Logs;
 using Qyl.Api.Contracts.OTel.Metrics;
@@ -164,10 +166,8 @@ model SavedQueryRunRequest {
   @encodedName("application/json", "end_time")
   endTime?: utcDateTime;
 
-  @doc("Page size for trace and log runs.")
-  @minValue(1)
-  @maxValue(1000)
-  limit?: int32 = 100;
+  @doc("Page size for trace and log runs; 100 when omitted.")
+  limit?: PageLimit = 100;
 
   @doc("`next_cursor` of a previous run of the same saved query.")
   cursor?: Cursor;
@@ -178,9 +178,11 @@ model SavedTraceQueryRun {
   signal: "traces";
   items: TraceSummary[];
 
+  @doc("Pass back as `cursor` for the next page of the same run. Absent on the last page.")
   @encodedName("application/json", "next_cursor")
   nextCursor?: Cursor;
 
+  @doc("Whether more items follow this page. `next_cursor` is present exactly when this is true.")
   @encodedName("application/json", "has_more")
   hasMore: boolean;
 }
@@ -190,9 +192,11 @@ model SavedLogQueryRun {
   signal: "logs";
   items: LogRecord[];
 
+  @doc("Pass back as `cursor` for the next page of the same run. Absent on the last page.")
   @encodedName("application/json", "next_cursor")
   nextCursor?: Cursor;
 
+  @doc("Whether more items follow this page. `next_cursor` is present exactly when this is true.")
   @encodedName("application/json", "has_more")
   hasMore: boolean;
 }

package/models/workbench.tsp

@@ -460,9 +460,12 @@ model WorkbenchProtocolEvent {
 
 @doc("Cursor page of chronological MCP protocol diagnostic events.")
 model WorkbenchProtocolEventPage {
+  @pageItems
   events: WorkbenchProtocolEvent[];
+  @doc("Cursor of the next page, passed back as the `cursor` query parameter. Absent on the last page.")
   @encodedName("application/json", "next_cursor")
-  nextCursor?: string;
+  @continuationToken
+  nextCursor?: Cursor;
 }
 
 @doc("How consequential the workbench considers an MCP tool invocation.")
@@ -617,9 +620,12 @@ model WorkbenchExecutionCancelRequest {
 
 @doc("Cursor page of MCP execution records.")
 model WorkbenchExecutionPage {
+  @pageItems
   executions: WorkbenchExecutionRecord[];
+  @doc("Cursor of the next page, passed back as the `cursor` query parameter. Absent on the last page.")
   @encodedName("application/json", "next_cursor")
-  nextCursor?: string;
+  @continuationToken
+  nextCursor?: Cursor;
 }
 
 @doc("Whether correlated Qyl observability evidence was available.")
@@ -820,10 +826,13 @@ model WorkbenchTestCaseUpdateRequest {
 
 @doc("Cursor page of reusable MCP test cases.")
 model WorkbenchTestCasePage {
+  @pageItems
   @encodedName("application/json", "test_cases")
   testCases: WorkbenchTestCase[];
+  @doc("Cursor of the next page, passed back as the `cursor` query parameter. Absent on the last page.")
   @encodedName("application/json", "next_cursor")
-  nextCursor?: string;
+  @continuationToken
+  nextCursor?: Cursor;
 }
 
 @doc("Reusable ordered group of MCP test cases.")
@@ -879,9 +888,12 @@ model WorkbenchTestSuiteUpdateRequest {
 
 @doc("Cursor page of reusable MCP test suites.")
 model WorkbenchTestSuitePage {
+  @pageItems
   suites: WorkbenchTestSuite[];
+  @doc("Cursor of the next page, passed back as the `cursor` query parameter. Absent on the last page.")
   @encodedName("application/json", "next_cursor")
-  nextCursor?: string;
+  @continuationToken
+  nextCursor?: Cursor;
 }
 
 @doc("Request to execute one test case or suite asynchronously.")
@@ -1044,9 +1056,12 @@ model WorkbenchEvaluationRunAccepted {
 
 @doc("Cursor page of MCP evaluation runs.")
 model WorkbenchEvaluationRunPage {
+  @pageItems
   runs: WorkbenchEvaluationRun[];
+  @doc("Cursor of the next page, passed back as the `cursor` query parameter. Absent on the last page.")
   @encodedName("application/json", "next_cursor")
-  nextCursor?: string;
+  @continuationToken
+  nextCursor?: Cursor;
 }
 
 @doc("Request to compare a baseline MCP evaluation run with a candidate run.")

package/otel/span.tsp

@@ -188,55 +188,6 @@ model Trace extends TraceSummary {
   spans: Span[];
 }
 
-// =============================================================================
-// Span Query Filters
-// =============================================================================
-
-@doc("Filter parameters for querying spans")
-model SpanQueryFilters {
-  @doc("Filter by trace ID")
-  @query("trace_id")
-  @encodedName("application/json", "trace_id")
-  traceId?: TraceId;
-
-  @doc("Filter by parent span ID")
-  @query("parent_span_id")
-  @encodedName("application/json", "parent_span_id")
-  parentSpanId?: SpanId;
-
-  @doc("Filter by span name (supports wildcards)")
-  @query
-  name?: string;
-
-  @doc("Filter by span kind")
-  @query
-  kind?: SpanKind;
-
-  @doc("Filter by service name")
-  @query("service_name")
-  @encodedName("application/json", "service_name")
-  serviceName?: string;
-
-  @doc("Filter by status code")
-  @query("status_code")
-  @encodedName("application/json", "status_code")
-  statusCode?: SpanStatusCode;
-
-  @doc("Minimum duration in nanoseconds")
-  @query("min_duration_ns")
-  @encodedName("application/json", "min_duration_ns")
-  minDurationNs?: DurationNs;
-
-  @doc("Maximum duration in nanoseconds")
-  @query("max_duration_ns")
-  @encodedName("application/json", "max_duration_ns")
-  maxDurationNs?: DurationNs;
-
-  @doc("Filter by attribute key-value pair")
-  @query
-  attribute?: string;
-}
-
 // =============================================================================
 // Span Aggregations
 // =============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "11.6.0",
+  "version": "12.0.0",
   "description": "TypeSpec source of truth for qyl API contracts. Emits OpenAPI, JSON Schema, Qyl.Api.Contracts DTOs, and TypeScript contract types; not an OpenTelemetry package, storage schema, or server implementation.",
   "license": "Apache-2.0",
   "workspaces": [
@@ -110,7 +110,8 @@
     "build:json-schema": "node scripts/openapi-to-json-schema.mjs",
     "emit:contract-revision": "node scripts/emit-contract-revision.mjs",
     "prepare": "bun run build:emitters",
-    "prepack": "bun run compile",
+    "prepack": "bun run compile && node scripts/stamp-openapi-version.mjs",
+    "postpack": "node scripts/stamp-openapi-version.mjs --reset",
     "compile": "bun run clean:generated && bun run build:emitters && tsp compile main.tsp && bun run emit:contract-revision && bun run build:json-schema && bun run build:ts-runtime && bun run build:runtime && bun run build:zod-runtime",
     "format": "tsp format **/*.tsp",
     "lint": "bun run build:emitters && tsp compile main.tsp --no-emit --warn-as-error",