@ancplua/qyl-api-schema 0.5.5 → 0.5.6

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

@@ -289,12 +289,21 @@ export declare const FetchTelemetryViewValues: {
     readonly mcpStats: "mcp_stats";
 };
 export type FetchTelemetryView = typeof FetchTelemetryViewValues[keyof typeof FetchTelemetryViewValues];
-export type AttributeValue = string | boolean | number | string[] | boolean[] | number[];
+export type AttributeValue = string | boolean | number | AttributeBytesValue | AttributeValue[] | AttributeKeyValueListValue;
 export type ApiError = NotFoundError | ValidationError | UnauthorizedError | ForbiddenError | ConflictError | RateLimitError | InternalServerError | BadGatewayError | ServiceUnavailableError;
 export type LogBody = LogBodyString | LogBodyKvList | LogBodyArray | LogBodyBytes;
+export type RunnerMcpResourceContent = RunnerMcpTextResourceContent | RunnerMcpBlobResourceContent;
+export type RunnerMcpContent = RunnerMcpTextContent | RunnerMcpImageContent | RunnerMcpAudioContent | RunnerMcpEmbeddedResourceContent | RunnerMcpResourceLinkContent | RunnerMcpToolUseContent | RunnerMcpToolResultContent;
 export type RunnerResourceEvents = RunnerResourceState;
 export type RunnerLogEvents = RunnerLogLine;
 export type LogEvents = LogStreamEvent | HeartbeatEvent;
+export interface AttributeBytesValue {
+    "type": "bytes";
+    "base64": string;
+}
+export interface AttributeKeyValueListValue {
+    [key: string]: AttributeValue;
+}
 export interface Attribute {
     "key": string;
     "value": AttributeValue;
@@ -745,33 +754,61 @@ export interface RunnerMcpToolCallRequest {
 export interface RunnerMcpTaskMetadata {
     "ttl"?: number;
 }
-export interface RunnerMcpContent {
-    "type": string;
-    "text"?: string;
-    "data"?: string;
+export interface RunnerMcpContentMetadata {
+    "annotations"?: Record<string, unknown>;
+    "_meta"?: Record<string, unknown>;
+}
+export interface RunnerMcpTextContent extends RunnerMcpContentMetadata {
+    "type": "text";
+    "text": string;
+}
+export interface RunnerMcpImageContent extends RunnerMcpContentMetadata {
+    "type": "image";
+    "data": string;
+    "mimeType": string;
+}
+export interface RunnerMcpAudioContent extends RunnerMcpContentMetadata {
+    "type": "audio";
+    "data": string;
+    "mimeType": string;
+}
+export interface RunnerMcpEmbeddedResourceContent extends RunnerMcpContentMetadata {
+    "type": "resource";
+    "resource": RunnerMcpResourceContent;
+}
+export interface RunnerMcpTextResourceContent extends RunnerMcpResourceContentMetadata {
+    "text": string;
+}
+export interface RunnerMcpResourceContentMetadata {
+    "uri": string;
     "mimeType"?: string;
-    "uri"?: string;
-    "name"?: string;
+    "_meta"?: Record<string, unknown>;
+}
+export interface RunnerMcpBlobResourceContent extends RunnerMcpResourceContentMetadata {
+    "blob": string;
+}
+export interface RunnerMcpResourceLinkContent extends RunnerMcpContentMetadata {
+    "type": "resource_link";
+    "uri": string;
+    "name": string;
     "title"?: string;
     "description"?: string;
+    "mimeType"?: string;
     "size"?: number;
     "icons"?: RunnerMcpIcon[];
-    "resource"?: RunnerMcpResourceContent;
-    "id"?: string;
-    "input"?: unknown;
-    "toolUseId"?: string;
-    "content"?: RunnerMcpContent[];
+}
+export interface RunnerMcpToolUseContent extends RunnerMcpContentMetadata {
+    "type": "tool_use";
+    "id": string;
+    "name": string;
+    "input": unknown;
+}
+export interface RunnerMcpToolResultContent extends RunnerMcpContentMetadata {
+    "type": "tool_result";
+    "toolUseId": string;
+    "content": RunnerMcpContent[];
     "structuredContent"?: Record<string, unknown>;
     "isError"?: boolean;
-    "annotations"?: Record<string, unknown>;
-    "_meta"?: Record<string, unknown>;
-}
-export interface RunnerMcpResourceContent {
-    "uri": string;
-    "mimeType"?: string;
-    "text"?: string;
-    "blob"?: string;
-    "_meta"?: Record<string, unknown>;
 }
 export interface RunnerMcpTask {
     "taskId": string;

package/models/runner-mcp.tsp

@@ -1,3 +1,7 @@
+import "@typespec/openapi3";
+
+using TypeSpec.OpenAPI;
+
 namespace Qyl.Api.Contracts.Runner.Mcp;
 
 @doc("Icon metadata carried by MCP tools and resource links.")
@@ -56,29 +60,79 @@ model RunnerMcpTaskMetadata {
   ttl?: float64;
 }
 
-@doc("One MCP content item projected onto a stable qyl JSON shape. Variant-specific required fields follow its type discriminator.")
-model RunnerMcpContent {
-  type: string;
-  text?: string;
-  data?: string;
-  mimeType?: string;
-  uri?: url;
-  name?: string;
+@doc("Metadata shared by every MCP content variant.")
+model RunnerMcpContentMetadata {
+  annotations?: Record<unknown>;
+  @encodedName("application/json", "_meta")
+  metadata?: Record<unknown>;
+}
+
+@doc("Text provided to or returned by an MCP model or tool.")
+model RunnerMcpTextContent extends RunnerMcpContentMetadata {
+  type: "text";
+  text: string;
+}
+
+@doc("Base64-encoded image content.")
+model RunnerMcpImageContent extends RunnerMcpContentMetadata {
+  type: "image";
+  data: bytes;
+  mimeType: string;
+}
+
+@doc("Base64-encoded audio content.")
+model RunnerMcpAudioContent extends RunnerMcpContentMetadata {
+  type: "audio";
+  data: bytes;
+  mimeType: string;
+}
+
+@doc("A resource embedded in MCP content.")
+model RunnerMcpEmbeddedResourceContent extends RunnerMcpContentMetadata {
+  type: "resource";
+  resource: RunnerMcpResourceContent;
+}
+
+@doc("A link to a resource that an MCP server can read.")
+model RunnerMcpResourceLinkContent extends RunnerMcpContentMetadata {
+  type: "resource_link";
+  uri: url;
+  name: string;
   title?: string;
   description?: string;
+  mimeType?: string;
   @minValue(0)
   size?: int64;
   icons?: RunnerMcpIcon[];
-  resource?: RunnerMcpResourceContent;
-  id?: string;
-  input?: unknown;
-  toolUseId?: string;
-  content?: RunnerMcpContent[];
+}
+
+@doc("An MCP sampling request to invoke a tool.")
+model RunnerMcpToolUseContent extends RunnerMcpContentMetadata {
+  type: "tool_use";
+  id: string;
+  name: string;
+  input: unknown;
+}
+
+@doc("The result of an MCP sampling tool invocation.")
+model RunnerMcpToolResultContent extends RunnerMcpContentMetadata {
+  type: "tool_result";
+  toolUseId: string;
+  content: RunnerMcpContent[];
   structuredContent?: Record<unknown>;
   isError?: boolean;
-  annotations?: Record<unknown>;
-  @encodedName("application/json", "_meta")
-  metadata?: Record<unknown>;
+}
+
+@doc("One MCP content item. The type literal selects the required variant fields.")
+@oneOf
+union RunnerMcpContent {
+  text: RunnerMcpTextContent,
+  image: RunnerMcpImageContent,
+  audio: RunnerMcpAudioContent,
+  embeddedResource: RunnerMcpEmbeddedResourceContent,
+  resourceLink: RunnerMcpResourceLinkContent,
+  toolUse: RunnerMcpToolUseContent,
+  toolResult: RunnerMcpToolResultContent,
 }
 
 @doc("Lifecycle state of an MCP task returned by a task-augmented tool call.")
@@ -118,16 +172,31 @@ model RunnerMcpResourceReadRequest {
   metadata?: Record<unknown>;
 }
 
-@doc("Text or base64 resource content returned by an MCP server. Exactly one of text or blob is present.")
-model RunnerMcpResourceContent {
+@doc("Metadata shared by MCP text and blob resources.")
+model RunnerMcpResourceContentMetadata {
   uri: url;
   mimeType?: string;
-  text?: string;
-  blob?: string;
   @encodedName("application/json", "_meta")
   metadata?: Record<unknown>;
 }
 
+@doc("Text resource content returned by an MCP server.")
+model RunnerMcpTextResourceContent extends RunnerMcpResourceContentMetadata {
+  text: string;
+}
+
+@doc("Base64-encoded resource content returned by an MCP server.")
+model RunnerMcpBlobResourceContent extends RunnerMcpResourceContentMetadata {
+  blob: bytes;
+}
+
+@doc("Exactly one MCP text or blob resource variant.")
+@oneOf
+union RunnerMcpResourceContent {
+  text: RunnerMcpTextResourceContent,
+  blob: RunnerMcpBlobResourceContent,
+}
+
 @doc("Stable qyl projection of an MCP resources/read result.")
 model RunnerMcpResourceReadResponse {
   contents: RunnerMcpResourceContent[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "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": {
@@ -89,13 +89,15 @@
     "format": "tsp format **/*.tsp",
     "lint": "npm run build:emitters && tsp compile main.tsp --no-emit --warn-as-error",
     "lint:public": "tsp compile index.tsp --no-emit --warn-as-error",
-    "verify:routes": "node scripts/verify-route-contracts.mjs"
+    "verify:routes": "node scripts/verify-route-contracts.mjs",
+    "verify:contracts": "node scripts/verify-contract-fixtures.mjs"
   },
   "peerDependencies": {
     "@typespec/compiler": "^1.13.0 || >=1.13.0-dev.0",
     "@typespec/events": "^0.83.0",
     "@typespec/http": "^1.13.0",
     "@typespec/openapi": "^1.13.0",
+    "@typespec/openapi3": "^1.13.0",
     "@typespec/sse": "^0.83.0"
   },
   "devDependencies": {
@@ -108,6 +110,7 @@
     "@typespec/openapi": "1.13.0",
     "@typespec/openapi3": "1.13.0",
     "@typespec/sse": "0.83.0",
+    "ajv": "8.20.0",
     "typescript": "6.0.3"
   }
 }