docs: fold useful simplification RFCs from pr 74

2026-06-20 19:23:05 +08:00
parent ea3f138ae9
commit 552612622c
8 changed files with 166 additions and 3 deletions
--- a/packages/tools/src/schema.ts
+++ b/packages/tools/src/schema.ts
@@ -39,7 +39,14 @@ export interface SchemaProp {
  description?: string
  /** Enum of allowed values (strings only). */
  enum?: string[]
-  /** Default value. */
+  /**
+   * Default value, emitted into the JSON Schema only (validation never applies
+   * it — see the validator note below).
+   *
+   * XXX(unused-default): no tool definition in the repo sets `default`; it rides
+   * into the wire schema for a model that no tool surfaces it to. Drop the field
+   * and its converter line unless a real tool needs a model-visible default.
+   */
  default?: unknown
  /** Nested properties for type: 'object'. */
  properties?: SchemaSpec