fix(server): merged tool schemas say which fields each tag requires

apps/server/src/mcp/advertisedJsonSchema.test.ts

@@ -33,7 +33,11 @@ it("drops JSON noise, merges tagged unions, and keeps null where it is required"
       target: {
         type: "object",
         properties: {
-          kind: { type: "string", enum: ["url", "number"] },
+          kind: {
+            type: "string",
+            enum: ["url", "number"],
+            description: "`url` requires `url`. `number` requires `number`.",
+          },
           url: { type: "string" },
           number: { type: "integer" },
         },

apps/server/src/mcp/advertisedJsonSchema.ts

@@ -64,6 +64,18 @@ const mergeTaggedObjects = (branches: ReadonlyArray<Json>): JsonObject | undefin
   const requiredByAll = first.filter(
     (name) => name !== tag && others.every((required) => required.includes(name)),
   );
+  // Merging drops each tag's own required fields, so the tag says which they are.
+  const perTag = objects.flatMap((object, index) => {
+    const own = (index === 0 ? first : others[index - 1]!).filter(
+      (name) => name !== tag && !requiredByAll.includes(name),
+    );
+    return own.length === 0
+      ? []
+      : [
+          `\`${String(tagOf(object, tag))}\` requires ${own.map((name) => `\`${name}\``).join(", ")}.`,
+        ];
+  });
+  if (perTag.length > 0) (properties[tag] as JsonObject).description = perTag.join(" ");
   return { type: "object", properties, required: [tag, ...requiredByAll] };
 };
 

apps/server/src/provider/agentContextBudget.json

@@ -1,5 +1,5 @@
 {
   "claudeSystemAppendBytes": 5597,
   "codexAdditionalContextBytes": 7327,
-  "mcpToolListJsonBytes": 48217
+  "mcpToolListJsonBytes": 48682
 }