npm - @ancplua/qyl-api-schema - Versions diffs - 0.5.1 → 0.5.3 - Mend

@ancplua/qyl-api-schema 0.5.1 → 0.5.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/api/runner.tsp +2 -2
package/common/errors.tsp +3 -0
package/generated/json-schema/qyl-api-schema.json +149 -1
package/generated/openapi/qyl.openapi.json +218 -64
package/generated/ts-runtime/api.d.ts +57 -7
package/generated/ts-runtime/api.js +13 -0
package/models/runner-mcp.tsp +62 -2
package/package.json +1 -1

package/api/runner.tsp CHANGED Viewed

@@ -16,12 +16,12 @@ using Qyl.Api.Contracts.Runner.Mcp;
 namespace Qyl.Api.Contracts.Runner {
   @events
   union RunnerResourceEvents {
-    RunnerResourceState,
+    message: RunnerResourceState,
   }
   @events
   union RunnerLogEvents {
-    RunnerLogLine,
+    message: RunnerLogLine,
   }
   @route("/runner/resources")

package/common/errors.tsp CHANGED Viewed

@@ -17,6 +17,9 @@ namespace Qyl.Api.Contracts.Common.Errors;
 @doc("RFC 7807 Problem Details for HTTP APIs")
 @error
 model ProblemDetails {
+  @doc("RFC 7807 problem-details response media type")
+  @header contentType: "application/problem+json";
   @doc("A URI reference identifying the problem type")
   @encodedName("application/json", "type")
   problemType: url = "about:blank";

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

@@ -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 CHANGED Viewed

@@ -213,7 +213,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ValidationError"
                 }
@@ -246,7 +246,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -272,7 +272,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -380,7 +380,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ValidationError"
                 }
@@ -413,7 +413,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -439,7 +439,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -519,7 +519,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ValidationError"
                 }
@@ -552,7 +552,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -578,7 +578,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -658,7 +658,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ValidationError"
                 }
@@ -691,7 +691,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -717,7 +717,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -788,7 +788,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -814,7 +814,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -840,7 +840,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -973,7 +973,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ValidationError"
                 }
@@ -1006,7 +1006,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -1032,7 +1032,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -1115,7 +1115,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -1141,7 +1141,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -1212,7 +1212,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -1238,7 +1238,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -1264,7 +1264,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -1361,7 +1361,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -1387,7 +1387,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -1413,7 +1413,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -1545,7 +1545,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -1571,7 +1571,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -1666,7 +1666,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ValidationError"
                 }
@@ -1699,7 +1699,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -1725,7 +1725,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -1796,7 +1796,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -1822,7 +1822,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -1848,7 +1848,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -1945,7 +1945,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.UnauthorizedError"
                 }
@@ -1971,7 +1971,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -1997,7 +1997,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -2089,7 +2089,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ValidationError"
                 }
@@ -2115,7 +2115,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -2141,7 +2141,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ConflictError"
                 }
@@ -2167,7 +2167,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -2193,7 +2193,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.BadGatewayError"
                 }
@@ -2259,7 +2259,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -2285,7 +2285,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ConflictError"
                 }
@@ -2311,7 +2311,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -2337,7 +2337,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.BadGatewayError"
                 }
@@ -2393,7 +2393,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ValidationError"
                 }
@@ -2419,7 +2419,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -2445,7 +2445,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ConflictError"
                 }
@@ -2471,7 +2471,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -2497,7 +2497,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.BadGatewayError"
                 }
@@ -2557,7 +2557,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -2600,6 +2600,9 @@
                           "contentSchema": {
                             "$ref": "#/components/schemas/Runner.RunnerResourceState"
                           }
+                        },
+                        "event": {
+                          "const": "message"
                         }
                       }
                     }
@@ -2627,7 +2630,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -2686,7 +2689,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -2712,7 +2715,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -2764,6 +2767,9 @@
                           "contentSchema": {
                             "$ref": "#/components/schemas/Runner.RunnerLogLine"
                           }
+                        },
+                        "event": {
+                          "const": "message"
                         }
                       }
                     }
@@ -2791,7 +2797,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -2817,7 +2823,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -2866,7 +2872,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -2892,7 +2898,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ConflictError"
                 }
@@ -2918,7 +2924,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -2967,7 +2973,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.NotFoundError"
                 }
@@ -2993,7 +2999,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.ConflictError"
                 }
@@ -3019,7 +3025,7 @@
               }
             },
             "content": {
-              "application/json": {
+              "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/Common.Errors.InternalServerError"
                 }
@@ -6556,10 +6562,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 +6600,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 +6661,10 @@
           "uri": {
             "type": "string",
             "format": "uri"
+          },
+          "_meta": {
+            "type": "object",
+            "unevaluatedProperties": {}
           }
         },
         "description": "Resource URI accepted by the runner's MCP projection."
@@ -6629,6 +6688,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 +6774,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 +6802,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 +6833,9 @@
           "isError": {
             "type": "boolean"
           },
+          "task": {
+            "$ref": "#/components/schemas/Runner.Mcp.RunnerMcpTask"
+          },
           "_meta": {
             "type": "object",
             "unevaluatedProperties": {}
@@ -6707,6 +6843,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 CHANGED Viewed

@@ -10,6 +10,8 @@ export type SessionId = string & {
 export type UserId = string & {
     readonly __brand: "UserId";
 };
+export declare const ProblemDetailsMediaType: "application/problem+json";
+export type ProblemDetailsMediaType = typeof ProblemDetailsMediaType;
 export declare const SortOrderValues: {
     readonly asc: "asc";
     readonly desc: "desc";
@@ -261,6 +263,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 +711,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 +727,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 +739,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 +755,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 CHANGED Viewed

@@ -1,5 +1,6 @@
 // <auto-generated/>
 // Copyright (c) 2025-2026 ancplua
+export const ProblemDetailsMediaType = "application/problem+json";
 export const SortOrderValues = {
     "asc": "asc",
     "desc": "desc",
@@ -225,6 +226,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 CHANGED Viewed

@@ -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 CHANGED Viewed

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