@ancplua/qyl-api-schema 0.5.1 → 0.5.2

package/generated/json-schema/qyl-api-schema.json

@@ -3513,10 +3513,35 @@
           "format": "int64",
           "minimum": 0
         },
+        "icons": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Runner.Mcp.RunnerMcpIcon"
+          }
+        },
         "resource": {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpResourceContent"
+        },
+        "id": {
+          "type": "string"
+        },
+        "input": {},
+        "toolUseId": {
+          "type": "string"
+        },
+        "content": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Runner.Mcp.RunnerMcpContent"
+          }
+        },
+        "structuredContent": {
           "type": "object",
           "unevaluatedProperties": {}
         },
+        "isError": {
+          "type": "boolean"
+        },
         "annotations": {
           "type": "object",
           "unevaluatedProperties": {}
@@ -3526,7 +3551,31 @@
           "unevaluatedProperties": {}
         }
       },
-      "description": "One MCP content item projected onto a stable qyl JSON shape."
+      "description": "One MCP content item projected onto a stable qyl JSON shape. Variant-specific required fields follow its type discriminator."
+    },
+    "Runner.Mcp.RunnerMcpIcon": {
+      "type": "object",
+      "required": [
+        "src"
+      ],
+      "properties": {
+        "src": {
+          "type": "string"
+        },
+        "mimeType": {
+          "type": "string"
+        },
+        "sizes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "theme": {
+          "type": "string"
+        }
+      },
+      "description": "Icon metadata carried by MCP tools and resource links."
     },
     "Runner.Mcp.RunnerMcpResourceContent": {
       "type": "object",
@@ -3563,6 +3612,10 @@
         "uri": {
           "type": "string",
           "format": "uri"
+        },
+        "_meta": {
+          "type": "object",
+          "unevaluatedProperties": {}
         }
       },
       "description": "Resource URI accepted by the runner's MCP projection."
@@ -3586,6 +3639,64 @@
       },
       "description": "Stable qyl projection of an MCP resources/read result."
     },
+    "Runner.Mcp.RunnerMcpTask": {
+      "type": "object",
+      "required": [
+        "taskId",
+        "status",
+        "createdAt",
+        "lastUpdatedAt"
+      ],
+      "properties": {
+        "taskId": {
+          "type": "string"
+        },
+        "status": {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpTaskStatus"
+        },
+        "statusMessage": {
+          "type": "string"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "lastUpdatedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "ttl": {
+          "type": "number",
+          "format": "double"
+        },
+        "pollInterval": {
+          "type": "number",
+          "format": "double"
+        }
+      },
+      "description": "Task returned by an MCP task-augmented tool call. ttl and pollInterval are encoded as milliseconds."
+    },
+    "Runner.Mcp.RunnerMcpTaskMetadata": {
+      "type": "object",
+      "properties": {
+        "ttl": {
+          "type": "number",
+          "format": "double"
+        }
+      },
+      "description": "Task-augmentation metadata accepted on an MCP tool call. ttl is encoded as milliseconds."
+    },
+    "Runner.Mcp.RunnerMcpTaskStatus": {
+      "type": "string",
+      "enum": [
+        "working",
+        "input_required",
+        "completed",
+        "failed",
+        "cancelled"
+      ],
+      "description": "Lifecycle state of an MCP task returned by a task-augmented tool call."
+    },
     "Runner.Mcp.RunnerMcpTool": {
       "type": "object",
       "required": [
@@ -3614,6 +3725,15 @@
           "type": "object",
           "unevaluatedProperties": {}
         },
+        "execution": {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpToolExecution"
+        },
+        "icons": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Runner.Mcp.RunnerMcpIcon"
+          }
+        },
         "_meta": {
           "type": "object",
           "unevaluatedProperties": {}
@@ -3633,6 +3753,13 @@
         "arguments": {
           "type": "object",
           "unevaluatedProperties": {}
+        },
+        "task": {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpTaskMetadata"
+        },
+        "_meta": {
+          "type": "object",
+          "unevaluatedProperties": {}
         }
       },
       "description": "Tool call accepted by the runner's MCP projection."
@@ -3657,6 +3784,9 @@
         "isError": {
           "type": "boolean"
         },
+        "task": {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpTask"
+        },
         "_meta": {
           "type": "object",
           "unevaluatedProperties": {}
@@ -3664,6 +3794,24 @@
       },
       "description": "Stable qyl projection of an MCP tool-call result."
     },
+    "Runner.Mcp.RunnerMcpToolExecution": {
+      "type": "object",
+      "properties": {
+        "taskSupport": {
+          "$ref": "#/$defs/Runner.Mcp.RunnerMcpToolTaskSupport"
+        }
+      },
+      "description": "Execution metadata advertised for an MCP tool."
+    },
+    "Runner.Mcp.RunnerMcpToolTaskSupport": {
+      "type": "string",
+      "enum": [
+        "forbidden",
+        "optional",
+        "required"
+      ],
+      "description": "Task-augmentation support advertised for an MCP tool."
+    },
     "Runner.Mcp.RunnerMcpToolsResponse": {
       "type": "object",
       "required": [

package/generated/openapi/qyl.openapi.json

@@ -6556,10 +6556,35 @@
             "format": "int64",
             "minimum": 0
           },
+          "icons": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpIcon"
+            }
+          },
           "resource": {
+            "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpResourceContent"
+          },
+          "id": {
+            "type": "string"
+          },
+          "input": {},
+          "toolUseId": {
+            "type": "string"
+          },
+          "content": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpContent"
+            }
+          },
+          "structuredContent": {
             "type": "object",
             "unevaluatedProperties": {}
           },
+          "isError": {
+            "type": "boolean"
+          },
           "annotations": {
             "type": "object",
             "unevaluatedProperties": {}
@@ -6569,7 +6594,31 @@
             "unevaluatedProperties": {}
           }
         },
-        "description": "One MCP content item projected onto a stable qyl JSON shape."
+        "description": "One MCP content item projected onto a stable qyl JSON shape. Variant-specific required fields follow its type discriminator."
+      },
+      "Runner.Mcp.RunnerMcpIcon": {
+        "type": "object",
+        "required": [
+          "src"
+        ],
+        "properties": {
+          "src": {
+            "type": "string"
+          },
+          "mimeType": {
+            "type": "string"
+          },
+          "sizes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "theme": {
+            "type": "string"
+          }
+        },
+        "description": "Icon metadata carried by MCP tools and resource links."
       },
       "Runner.Mcp.RunnerMcpResourceContent": {
         "type": "object",
@@ -6606,6 +6655,10 @@
           "uri": {
             "type": "string",
             "format": "uri"
+          },
+          "_meta": {
+            "type": "object",
+            "unevaluatedProperties": {}
           }
         },
         "description": "Resource URI accepted by the runner's MCP projection."
@@ -6629,6 +6682,64 @@
         },
         "description": "Stable qyl projection of an MCP resources/read result."
       },
+      "Runner.Mcp.RunnerMcpTask": {
+        "type": "object",
+        "required": [
+          "taskId",
+          "status",
+          "createdAt",
+          "lastUpdatedAt"
+        ],
+        "properties": {
+          "taskId": {
+            "type": "string"
+          },
+          "status": {
+            "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpTaskStatus"
+          },
+          "statusMessage": {
+            "type": "string"
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "lastUpdatedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "ttl": {
+            "type": "number",
+            "format": "double"
+          },
+          "pollInterval": {
+            "type": "number",
+            "format": "double"
+          }
+        },
+        "description": "Task returned by an MCP task-augmented tool call. ttl and pollInterval are encoded as milliseconds."
+      },
+      "Runner.Mcp.RunnerMcpTaskMetadata": {
+        "type": "object",
+        "properties": {
+          "ttl": {
+            "type": "number",
+            "format": "double"
+          }
+        },
+        "description": "Task-augmentation metadata accepted on an MCP tool call. ttl is encoded as milliseconds."
+      },
+      "Runner.Mcp.RunnerMcpTaskStatus": {
+        "type": "string",
+        "enum": [
+          "working",
+          "input_required",
+          "completed",
+          "failed",
+          "cancelled"
+        ],
+        "description": "Lifecycle state of an MCP task returned by a task-augmented tool call."
+      },
       "Runner.Mcp.RunnerMcpTool": {
         "type": "object",
         "required": [
@@ -6657,6 +6768,15 @@
             "type": "object",
             "unevaluatedProperties": {}
           },
+          "execution": {
+            "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpToolExecution"
+          },
+          "icons": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpIcon"
+            }
+          },
           "_meta": {
             "type": "object",
             "unevaluatedProperties": {}
@@ -6676,6 +6796,13 @@
           "arguments": {
             "type": "object",
             "unevaluatedProperties": {}
+          },
+          "task": {
+            "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpTaskMetadata"
+          },
+          "_meta": {
+            "type": "object",
+            "unevaluatedProperties": {}
           }
         },
         "description": "Tool call accepted by the runner's MCP projection."
@@ -6700,6 +6827,9 @@
           "isError": {
             "type": "boolean"
           },
+          "task": {
+            "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpTask"
+          },
           "_meta": {
             "type": "object",
             "unevaluatedProperties": {}
@@ -6707,6 +6837,24 @@
         },
         "description": "Stable qyl projection of an MCP tool-call result."
       },
+      "Runner.Mcp.RunnerMcpToolExecution": {
+        "type": "object",
+        "properties": {
+          "taskSupport": {
+            "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpToolTaskSupport"
+          }
+        },
+        "description": "Execution metadata advertised for an MCP tool."
+      },
+      "Runner.Mcp.RunnerMcpToolTaskSupport": {
+        "type": "string",
+        "enum": [
+          "forbidden",
+          "optional",
+          "required"
+        ],
+        "description": "Task-augmentation support advertised for an MCP tool."
+      },
       "Runner.Mcp.RunnerMcpToolsResponse": {
         "type": "object",
         "required": [

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

@@ -261,6 +261,20 @@ export declare const RunnerLogStreamValues: {
     readonly stderr: "err";
 };
 export type RunnerLogStream = typeof RunnerLogStreamValues[keyof typeof RunnerLogStreamValues];
+export declare const RunnerMcpToolTaskSupportValues: {
+    readonly forbidden: "forbidden";
+    readonly optional: "optional";
+    readonly required: "required";
+};
+export type RunnerMcpToolTaskSupport = typeof RunnerMcpToolTaskSupportValues[keyof typeof RunnerMcpToolTaskSupportValues];
+export declare const RunnerMcpTaskStatusValues: {
+    readonly working: "working";
+    readonly inputRequired: "input_required";
+    readonly completed: "completed";
+    readonly failed: "failed";
+    readonly cancelled: "cancelled";
+};
+export type RunnerMcpTaskStatus = typeof RunnerMcpTaskStatusValues[keyof typeof RunnerMcpTaskStatusValues];
 export declare const McpDataModeValues: {
     readonly live: "live";
     readonly demo: "demo";
@@ -695,6 +709,15 @@ export interface RunnerLogLine {
     "stream": RunnerLogStream;
     "line": string;
 }
+export interface RunnerMcpIcon {
+    "src": string;
+    "mimeType"?: string;
+    "sizes"?: string[];
+    "theme"?: string;
+}
+export interface RunnerMcpToolExecution {
+    "taskSupport"?: RunnerMcpToolTaskSupport;
+}
 export interface RunnerMcpTool {
     "name": string;
     "title"?: string;
@@ -702,6 +725,8 @@ export interface RunnerMcpTool {
     "inputSchema": Record<string, unknown>;
     "outputSchema"?: Record<string, unknown>;
     "annotations"?: Record<string, unknown>;
+    "execution"?: RunnerMcpToolExecution;
+    "icons"?: RunnerMcpIcon[];
     "_meta"?: Record<string, unknown>;
 }
 export interface RunnerMcpToolsResponse {
@@ -712,6 +737,11 @@ export interface RunnerMcpToolsResponse {
 export interface RunnerMcpToolCallRequest {
     "name": string;
     "arguments"?: Record<string, unknown>;
+    "task"?: RunnerMcpTaskMetadata;
+    "_meta"?: Record<string, unknown>;
+}
+export interface RunnerMcpTaskMetadata {
+    "ttl"?: number;
 }
 export interface RunnerMcpContent {
     "type": string;
@@ -723,24 +753,42 @@ export interface RunnerMcpContent {
     "title"?: string;
     "description"?: string;
     "size"?: number;
-    "resource"?: Record<string, unknown>;
+    "icons"?: RunnerMcpIcon[];
+    "resource"?: RunnerMcpResourceContent;
+    "id"?: string;
+    "input"?: unknown;
+    "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;
+    "status": RunnerMcpTaskStatus;
+    "statusMessage"?: string;
+    "createdAt": string;
+    "lastUpdatedAt": string;
+    "ttl"?: number;
+    "pollInterval"?: number;
+}
 export interface RunnerMcpToolCallResponse {
     "content": RunnerMcpContent[];
     "structuredContent"?: Record<string, unknown>;
     "isError": boolean;
+    "task"?: RunnerMcpTask;
     "_meta"?: Record<string, unknown>;
 }
 export interface RunnerMcpResourceReadRequest {
     "uri": string;
-}
-export interface RunnerMcpResourceContent {
-    "uri": string;
-    "mimeType"?: string;
-    "text"?: string;
-    "blob"?: string;
     "_meta"?: Record<string, unknown>;
 }
 export interface RunnerMcpResourceReadResponse {

package/generated/ts-runtime/api.js

@@ -225,6 +225,18 @@ export const RunnerLogStreamValues = {
     "stdout": "out",
     "stderr": "err",
 };
+export const RunnerMcpToolTaskSupportValues = {
+    "forbidden": "forbidden",
+    "optional": "optional",
+    "required": "required",
+};
+export const RunnerMcpTaskStatusValues = {
+    "working": "working",
+    "inputRequired": "input_required",
+    "completed": "completed",
+    "failed": "failed",
+    "cancelled": "cancelled",
+};
 export const McpDataModeValues = {
     "live": "live",
     "demo": "demo",

package/models/runner-mcp.tsp

@@ -1,5 +1,25 @@
 namespace Qyl.Api.Contracts.Runner.Mcp;
 
+@doc("Icon metadata carried by MCP tools and resource links.")
+model RunnerMcpIcon {
+  src: string;
+  mimeType?: string;
+  sizes?: string[];
+  theme?: string;
+}
+
+@doc("Task-augmentation support advertised for an MCP tool.")
+enum RunnerMcpToolTaskSupport {
+  forbidden: "forbidden",
+  optional: "optional",
+  required: "required",
+}
+
+@doc("Execution metadata advertised for an MCP tool.")
+model RunnerMcpToolExecution {
+  taskSupport?: RunnerMcpToolTaskSupport;
+}
+
 @doc("Stable qyl projection of an MCP tool advertised by a runner resource.")
 model RunnerMcpTool {
   name: string;
@@ -8,6 +28,8 @@ model RunnerMcpTool {
   inputSchema: Record<unknown>;
   outputSchema?: Record<unknown>;
   annotations?: Record<unknown>;
+  execution?: RunnerMcpToolExecution;
+  icons?: RunnerMcpIcon[];
   @encodedName("application/json", "_meta")
   metadata?: Record<unknown>;
 }
@@ -24,9 +46,17 @@ model RunnerMcpToolsResponse {
 model RunnerMcpToolCallRequest {
   name: string;
   arguments?: Record<unknown>;
+  task?: RunnerMcpTaskMetadata;
+  @encodedName("application/json", "_meta")
+  metadata?: Record<unknown>;
 }
 
-@doc("One MCP content item projected onto a stable qyl JSON shape.")
+@doc("Task-augmentation metadata accepted on an MCP tool call. ttl is encoded as milliseconds.")
+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;
@@ -38,17 +68,45 @@ model RunnerMcpContent {
   description?: string;
   @minValue(0)
   size?: int64;
-  resource?: Record<unknown>;
+  icons?: RunnerMcpIcon[];
+  resource?: RunnerMcpResourceContent;
+  id?: string;
+  input?: unknown;
+  toolUseId?: string;
+  content?: RunnerMcpContent[];
+  structuredContent?: Record<unknown>;
+  isError?: boolean;
   annotations?: Record<unknown>;
   @encodedName("application/json", "_meta")
   metadata?: Record<unknown>;
 }
 
+@doc("Lifecycle state of an MCP task returned by a task-augmented tool call.")
+enum RunnerMcpTaskStatus {
+  working: "working",
+  inputRequired: "input_required",
+  completed: "completed",
+  failed: "failed",
+  cancelled: "cancelled",
+}
+
+@doc("Task returned by an MCP task-augmented tool call. ttl and pollInterval are encoded as milliseconds.")
+model RunnerMcpTask {
+  taskId: string;
+  status: RunnerMcpTaskStatus;
+  statusMessage?: string;
+  createdAt: utcDateTime;
+  lastUpdatedAt: utcDateTime;
+  ttl?: float64;
+  pollInterval?: float64;
+}
+
 @doc("Stable qyl projection of an MCP tool-call result.")
 model RunnerMcpToolCallResponse {
   content: RunnerMcpContent[];
   structuredContent?: Record<unknown>;
   isError: boolean;
+  task?: RunnerMcpTask;
   @encodedName("application/json", "_meta")
   metadata?: Record<unknown>;
 }
@@ -56,6 +114,8 @@ model RunnerMcpToolCallResponse {
 @doc("Resource URI accepted by the runner's MCP projection.")
 model RunnerMcpResourceReadRequest {
   uri: url;
+  @encodedName("application/json", "_meta")
+  metadata?: Record<unknown>;
 }
 
 @doc("Text or base64 resource content returned by an MCP server. Exactly one of text or blob is present.")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ancplua/qyl-api-schema",
-  "version": "0.5.1",
+  "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": {