Commit f3d159d
fix: remove extraneous
## Why make this change?
`entities.*.source.description` existed in the JSON schema with
documentation claiming it drove MCP tool discovery — but it was never
wired to any C# model (`EntitySource` has no `Description` field) and
was silently ignored at runtime. Meanwhile, `entities.*.description` —
the field that *actually* surfaces in MCP — made no mention of MCP.
Users following the schema would configure the wrong field and get no
MCP output with no error.
## What is this change?
- **Removed** `entities.*.source.description` from
`schemas/dab.draft.schema.json`. The property never had a backing field
in `EntitySource` and was dead schema surface area.
- **Updated** the description of `entities.*.description` to explicitly
mention MCP:
```diff
- "Optional description for the entity. Will be surfaced in generated API documentation and GraphQL schema as comments."
+ "Optional description for the entity. Will be surfaced in MCP tool discovery, generated API documentation, and GraphQL schema as comments."
```
The correct config pattern for MCP-visible descriptions is:
```json
"Todo": {
"description": "Manages to-do items — surfaced in MCP, REST docs, and GraphQL schema.",
"source": {
"object": "dbo.Todos",
"type": "table"
}
}
```
## How was this tested?
- [ ] Integration Tests
- [ ] Unit Tests
Schema-only change; no runtime behavior altered. The removed property
had no backing model field and was never deserialized.
## Sample Request(s)
N/A — schema documentation fix only.
---------
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Aniruddh25 <3513779+Aniruddh25@users.noreply.github.com>
Co-authored-by: Aniruddh Munde <anmunde@microsoft.com>source.description schema property; clarify entity.description covers MCP (#3552)1 parent 99ba6cc commit f3d159d
1 file changed
Lines changed: 1 addition & 5 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1167 | 1167 | | |
1168 | 1168 | | |
1169 | 1169 | | |
1170 | | - | |
| 1170 | + | |
1171 | 1171 | | |
1172 | 1172 | | |
1173 | 1173 | | |
| |||
1258 | 1258 | | |
1259 | 1259 | | |
1260 | 1260 | | |
1261 | | - | |
1262 | | - | |
1263 | | - | |
1264 | | - | |
1265 | 1261 | | |
1266 | 1262 | | |
1267 | 1263 | | |
| |||
0 commit comments