feat(context): add typed tool schemas and outputs (#3377)

* feat(context): add typed tool schemas and outputs

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

* fix(context): preserve legacy input acceptance

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

* test(context): preserve input schema roots and optionality

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

* fix(context): validate direct team member calls

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

* test(context): pin structured output and legacy text fixtures

Describe profile timestamps and validate null and empty team outputs against modern schemas while retaining exact legacy text.

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

* fix(context): emit structured empty team collections

Keep legacy null text while returning nonnil typed slices so modern clients receive structured content for empty successful results.

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

* fix(context): preserve legacy team input schemas

Keep empty identifier rejection in the handler without tightening the published input schema. Pin modern text to structured output and preserve the legacy formatter fixtures.

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

* fix(context): preserve advertised input schema compatibility

Keep legacy-visible schemas byte-compatible while applying unknown-field acceptance only to the cached runtime validation schema. Verify modern DTO text parity and preserve legacy formatted text.

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

* fix(context): reject explicit null team user arguments

Preserve the legacy optional user type error before typed decoding, without changing omitted or empty user fallback.

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

* fix(context): preserve exact routing argument keys

Ignore case-variant routing aliases before typed decoding while retaining canonical fields and unrelated unknown arguments. Cover direct handlers and legacy/modern registered calls, authenticated fallback, canonical null rejection, and missing identifiers.

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

---------

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

Author: SamMorrowDrums

pkg/github/__toolsnaps__/get_me.snap

@@ -18,5 +18,96 @@
     "properties": {},
     "type": "object"
   },
-  "name": "get_me"
+  "name": "get_me",
+  "outputSchema": {
+    "additionalProperties": false,
+    "properties": {
+      "avatar_url": {
+        "type": "string"
+      },
+      "details": {
+        "additionalProperties": false,
+        "properties": {
+          "bio": {
+            "type": "string"
+          },
+          "blog": {
+            "type": "string"
+          },
+          "company": {
+            "type": "string"
+          },
+          "created_at": {
+            "description": "Account creation time in RFC3339 format.",
+            "type": "string"
+          },
+          "email": {
+            "type": "string"
+          },
+          "followers": {
+            "type": "integer"
+          },
+          "following": {
+            "type": "integer"
+          },
+          "hireable": {
+            "type": "boolean"
+          },
+          "location": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "owned_private_repos": {
+            "type": "integer"
+          },
+          "private_gists": {
+            "type": "integer"
+          },
+          "public_gists": {
+            "type": "integer"
+          },
+          "public_repos": {
+            "type": "integer"
+          },
+          "total_private_repos": {
+            "type": "integer"
+          },
+          "twitter_username": {
+            "type": "string"
+          },
+          "updated_at": {
+            "description": "Last profile update time in RFC3339 format.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "public_repos",
+          "public_gists",
+          "followers",
+          "following",
+          "created_at",
+          "updated_at"
+        ],
+        "type": [
+          "null",
+          "object"
+        ]
+      },
+      "id": {
+        "type": "integer"
+      },
+      "login": {
+        "type": "string"
+      },
+      "profile_url": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "login"
+    ],
+    "type": "object"
+  }
 }

pkg/github/__toolsnaps__/get_team_members.snap

@@ -22,5 +22,14 @@
     ],
     "type": "object"
   },
-  "name": "get_team_members"
+  "name": "get_team_members",
+  "outputSchema": {
+    "items": {
+      "type": "string"
+    },
+    "type": [
+      "null",
+      "array"
+    ]
+  }
 }

pkg/github/__toolsnaps__/get_teams.snap

@@ -14,5 +14,50 @@
     },
     "type": "object"
   },
-  "name": "get_teams"
+  "name": "get_teams",
+  "outputSchema": {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "org": {
+          "type": "string"
+        },
+        "teams": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "description": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string"
+              },
+              "slug": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name",
+              "slug",
+              "description"
+            ],
+            "type": "object"
+          },
+          "type": [
+            "null",
+            "array"
+          ]
+        }
+      },
+      "required": [
+        "org",
+        "teams"
+      ],
+      "type": "object"
+    },
+    "type": [
+      "null",
+      "array"
+    ]
+  }
 }