2565133af3
implemented（除 4 篇超长文档随后补）、proposed、rejected 全树配对； 同一流水线 + 二遍校验（paraphrase-back + 仓库上下文一致性）产出。 docs/rfc/implemented/AGENTS.md 与其 CLAUDE.md 符号链接列入排除 （agent 指令文件，与根 AGENTS.md 同策略）。
2.5 KiB
2.5 KiB
RFC：模型边界处的运行时参数校验
Status: implemented
English | 中文
问题
defineTool（自定义 schema DSL）通过 InferArgs<S> 映射为工具作者提供了类型化的 execute(args)。但该类型只是编译期对一个运行时值的声明：这个值以模型生成的 JSON 形式到达，没有任何机制强制模型遵守 schema。因此，一次格式错误的调用（缺少必填键、声明为数字的位置传入字符串、枚举值超出集合）会以「仅有类型之名」的状态抵达 execute。工具体要么在错误形状上崩溃（产生一条模型无法据以行动的通用堆栈跟踪），要么更糟：静默地行为异常。与此同时，转换器已经编码了校验器遍历所需的完整结构。
决策
validateArgs(spec, args): string[] 对一个运行时值解释 SchemaSpec，返回人类可读的违规列表（空 = 合法），且是全函数（从不抛出异常）。defineTool 在调用类型化的工具体之前运行它；如果存在违规，则抛出 ToolArgsError（code: 'INVALID_ARGS'，消息列出违规项），注册表既有的 execute-waterfall catch 将其转为模型可读取并据以自我修正的 isError 结果。
校验器严格镜像 schemaSpecToJsonSchema 的语义：遍历相同的结构、执行相同的规则：顶层必须是非数组对象；必填键仅来自 required: true；允许额外键（不设 additionalProperties: false）；不应用 default；没有 properties/items 的 object/array 属性仅做类型检查；enum 是成员判定。原始注册的（MCP）工具不受影响：它们自行校验输入。
后果
- 模型在自身格式错误的调用上获得可操作的反馈，而非不透明的崩溃，弥合了
InferArgs的承诺与运行时现实之间的鸿沟。 - 校验器与
InferArgs必须保持一致；一组属性测试会生成满足 spec 的参数并断言它们通过validateArgs（同时断言定向破坏的参数被拒绝），以机械方式封堵漂移风险。 ToolArgsError目前是一个带code字段的普通Error；如果日后引入 harness 级别的错误分类体系，它将变为子类，而不影响读取.message的调用方。- 校验开销相对于一次模型调用可忽略不计。