@ancplua/qyl-api-schema 0.5.0 → 0.5.2

package/models/runner.tsp

@@ -1,3 +1,7 @@
+import "@typespec/http";
+
+using TypeSpec.Http;
+
 namespace Qyl.Api.Contracts.Runner;
 
 @doc("Lifecycle state of a resource supervised by the local qyl runner.")
@@ -10,17 +14,43 @@ enum RunnerResourceLifecycle {
   failed: "failed",
 }
 
+@doc("Kind of process or connection supervised by the local qyl runner.")
+enum RunnerResourceKind {
+  collector: "collector",
+  project: "project",
+  command: "command",
+  stdio: "stdio",
+  http: "http",
+  inproc: "inproc",
+}
+
+@doc("Identity reported by a connected MCP server during initialization.")
+model RunnerMcpServerInfo {
+  name: string;
+  version: string;
+}
+
 @doc("Current client-visible state of one runner resource.")
 model RunnerResourceState {
   name: string;
   lifecycle: RunnerResourceLifecycle;
   timestamp: utcDateTime;
-  kind?: string;
+  kind?: RunnerResourceKind;
   @minValue(1)
   @maxValue(65535)
   allocatedPort?: int32;
   endpoint?: url;
   lastError?: string;
+  serverInfo?: RunnerMcpServerInfo;
+  @minValue(0)
+  toolCount?: int32;
+  @minValue(0)
+  restarts?: int32;
+}
+
+@doc("A runner lifecycle action was accepted and continues asynchronously.")
+model RunnerActionAccepted {
+  @statusCode statusCode: 202;
 }
 
 @doc("Origin stream for one captured child-process log line.")

package/otel/span.tsp

@@ -147,16 +147,13 @@ model SpanLink {
 // Trace Model (Collection of Spans)
 // =============================================================================
 
-@doc("Complete trace containing all related spans")
-model Trace {
+@doc("Trace summary without the full span collection")
+model TraceSummary {
   @doc("Trace identifier")
   @key
   @encodedName("application/json", "trace_id")
   traceId: TraceId;
 
-  @doc("All spans in this trace")
-  spans: Span[];
-
   @doc("Root span of the trace")
   @encodedName("application/json", "root_span")
   rootSpan?: Span;
@@ -185,6 +182,12 @@ model Trace {
   hasError: boolean;
 }
 
+@doc("Complete trace containing all related spans")
+model Trace extends TraceSummary {
+  @doc("All spans in this trace")
+  spans: Span[];
+}
+
 // =============================================================================
 // Span Query Filters
 // =============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "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",
   "repository": {
@@ -37,6 +37,12 @@
       "types": "./generated/ts-runtime/api.d.ts",
       "import": "./generated/ts-runtime/api.js",
       "default": "./generated/ts-runtime/api.js"
+    },
+    "./openapi": {
+      "default": "./generated/openapi/qyl.openapi.json"
+    },
+    "./json-schema": {
+      "default": "./generated/json-schema/qyl-api-schema.json"
     }
   },
   "files": [
@@ -50,6 +56,7 @@
     "models/health.tsp",
     "models/runner-mcp.tsp",
     "models/runner.tsp",
+    "models/mcp-tools.tsp",
     "models/session.tsp",
     "otel/enums.tsp",
     "otel/logs.tsp",
@@ -60,6 +67,8 @@
     "generated/otel-keys.gen.tsp",
     "generated/ts-runtime/api.d.ts",
     "generated/ts-runtime/api.js",
+    "generated/openapi/qyl.openapi.json",
+    "generated/json-schema/qyl-api-schema.json",
     "README.md",
     "LICENSE"
   ],
@@ -72,9 +81,10 @@
     "clean:generated": "node scripts/clean-generated.mjs",
     "build:emitters": "tsc -p emitters/csharp && tsc -p emitters/ts-types",
     "build:ts-runtime": "tsc -p tsconfig.contracts.json",
+    "build:json-schema": "node scripts/openapi-to-json-schema.mjs",
     "prepare": "npm run build:emitters",
     "prepack": "npm run compile",
-    "compile": "npm run clean:generated && npm run build:emitters && tsp compile main.tsp && npm run build:ts-runtime",
+    "compile": "npm run clean:generated && npm run build:emitters && tsp compile main.tsp && npm run build:json-schema && npm run build:ts-runtime",
     "watch": "tsp compile main.tsp --watch",
     "format": "tsp format **/*.tsp",
     "lint": "npm run build:emitters && tsp compile main.tsp --no-emit --warn-as-error",
@@ -84,7 +94,6 @@
     "@typespec/compiler": "^1.13.0 || >=1.13.0-dev.0",
     "@typespec/events": "^0.83.0",
     "@typespec/http": "^1.13.0",
-    "@typespec/json-schema": "^1.13.0",
     "@typespec/openapi": "^1.13.0",
     "@typespec/sse": "^0.83.0"
   },
@@ -95,7 +104,6 @@
     "@typespec/compiler": "1.13.0",
     "@typespec/events": "0.83.0",
     "@typespec/http": "1.13.0",
-    "@typespec/json-schema": "1.13.0",
     "@typespec/openapi": "1.13.0",
     "@typespec/openapi3": "1.13.0",
     "@typespec/sse": "0.83.0",