test(github): strengthen typed Copilot and UI outputs

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: SamMorrowDrums

docs/typed-tool-schemas.md

@@ -58,4 +58,7 @@ request-scoped server.
 If a handler intentionally returns non-JSON text or content blocks, set
 `PreserveHandlerContent` in `TypedSchemaOptions`, or call
 `inventory.PreserveToolHandlerContent(ctx)` from the handler middleware for
-request-dependent output such as CSV.
+request-dependent output such as CSV. This is for intentional non-DTO responses
+such as resources, errors, or CSV; ordinary declared structured success must
+retain shared DTO serialization, with modern JSON text equal to
+`structuredContent`, even when legacy handler text was a plain mutation message.

pkg/github/__toolsnaps__/assign_copilot_to_issue.snap

@@ -47,5 +47,60 @@
     ],
     "type": "object"
   },
-  "name": "assign_copilot_to_issue"
+  "name": "assign_copilot_to_issue",
+  "outputSchema": {
+    "additionalProperties": false,
+    "properties": {
+      "issue_number": {
+        "description": "The assigned issue's number.",
+        "type": "integer"
+      },
+      "message": {
+        "description": "Assignment outcome or tool error message.",
+        "type": "string"
+      },
+      "note": {
+        "description": "Additional status detail when Copilot has not created a pull request yet.",
+        "type": "string"
+      },
+      "owner": {
+        "type": "string"
+      },
+      "pull_request": {
+        "additionalProperties": false,
+        "properties": {
+          "number": {
+            "type": "integer"
+          },
+          "state": {
+            "enum": [
+              "OPEN",
+              "CLOSED",
+              "MERGED"
+            ],
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "number",
+          "state",
+          "title"
+        ],
+        "type": "object"
+      },
+      "repo": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "issue_number",
+      "message",
+      "owner",
+      "repo"
+    ],
+    "type": "object"
+  }
 }

pkg/github/__toolsnaps__/assign_copilot_to_issue_typed.snap

@@ -68,5 +68,64 @@
     ],
     "type": "object"
   },
-  "name": "assign_copilot_to_issue_with_intent"
+  "name": "assign_copilot_to_issue_with_intent",
+  "outputSchema": {
+    "additionalProperties": false,
+    "properties": {
+      "is_suggestion": {
+        "type": "boolean"
+      },
+      "issue_number": {
+        "description": "The assigned issue's number.",
+        "type": "integer"
+      },
+      "message": {
+        "description": "Assignment outcome or tool error message.",
+        "type": "string"
+      },
+      "note": {
+        "description": "Additional status detail when Copilot has not created a pull request yet.",
+        "type": "string"
+      },
+      "owner": {
+        "type": "string"
+      },
+      "pull_request": {
+        "additionalProperties": false,
+        "properties": {
+          "number": {
+            "type": "integer"
+          },
+          "state": {
+            "enum": [
+              "OPEN",
+              "CLOSED",
+              "MERGED"
+            ],
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "number",
+          "state",
+          "title"
+        ],
+        "type": "object"
+      },
+      "repo": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "is_suggestion",
+      "issue_number",
+      "message",
+      "owner",
+      "repo"
+    ],
+    "type": "object"
+  }
 }