anomalyco/opencode
1
0
Fork 0
mirror of https://github.com/anomalyco/opencode.git synced 2026-07-22 10:15:31 -04:00
Code Issues 5.9k Packages Projects Releases 19 Wiki Activity

[PR #13619] fix: sanitize tool JSON schemas for Claude API compatibility #14740

New Issue
Open
opened 2026-02-16 18:19:30 -05:00 by yindo · 0 comments
yindo commented 2026-02-16 18:19:30 -05:00
Owner
Copy Link
Copy Source

Original Pull Request: https://github.com/anomalyco/opencode/pull/13619

State: open
Merged: No

Summary

Fixes #13618

Claude API (especially thinking models like claude-opus-4-6-thinking) rejects tool schemas that have properties without a required field, returning:

***.custom.input_schema: JSON schema is invalid. It must match JSON Schema draft 2020-12

This affects users who use plugins like oh-my-opencode that generate tool schemas without explicit required arrays (e.g., the session_list tool).

Changes

Added two sanitization steps at the top of ProviderTransform.schema() in packages/opencode/src/provider/transform.ts:

  1. Strip $schema meta field — Zod 4's toJSONSchema() adds "$schema": "https://json-schema.org/draft/2020-12/schema" to every output. The codebase already handles this for createStructuredOutputTool but not in the general schema transform.

  2. Add required: [] when missing — When a schema has properties but no required field, automatically add an empty required array. This is the primary fix.

Verification

Tested by intercepting OpenCode's API requests with a proxy, isolating all 33 tools, and testing each individually against Claude API:

Test Result
session_list original schema (no required) ❌ 400 error
session_list with "required": [] added ✅ 200 OK
All 33 tools together after fix ✅ 200 OK

Tested with both claude-opus-4-6 and claude-opus-4-6-thinking models through new-api (OpenAI-compatible proxy).

Related

**Original Pull Request:** https://github.com/anomalyco/opencode/pull/13619 **State:** open **Merged:** No --- ## Summary Fixes #13618 Claude API (especially thinking models like `claude-opus-4-6-thinking`) rejects tool schemas that have `properties` without a `required` field, returning: ``` ***.custom.input_schema: JSON schema is invalid. It must match JSON Schema draft 2020-12 ``` This affects users who use plugins like oh-my-opencode that generate tool schemas without explicit `required` arrays (e.g., the `session_list` tool). ## Changes Added two sanitization steps at the top of `ProviderTransform.schema()` in `packages/opencode/src/provider/transform.ts`: 1. **Strip `$schema` meta field** — Zod 4's `toJSONSchema()` adds `"$schema": "https://json-schema.org/draft/2020-12/schema"` to every output. The codebase already handles this for `createStructuredOutputTool` but not in the general schema transform. 2. **Add `required: []` when missing** — When a schema has `properties` but no `required` field, automatically add an empty `required` array. This is the primary fix. ## Verification Tested by intercepting OpenCode's API requests with a proxy, isolating all 33 tools, and testing each individually against Claude API: | Test | Result | |------|--------| | `session_list` original schema (no `required`) | ❌ 400 error | | `session_list` with `"required": []` added | ✅ 200 OK | | All 33 tools together after fix | ✅ 200 OK | Tested with both `claude-opus-4-6` and `claude-opus-4-6-thinking` models through new-api (OpenAI-compatible proxy). ## Related - Similar issue in Claude Code: https://github.com/anthropics/claude-code/issues/586
yindo added the pull-request label 2026-02-16 18:19:30 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
acp
bad
bug
discussion
docs
documentation
enhancement
extension
good first issue
growth
help-wanted
mcp
model-problem
needs:compliance
nix
opentui
perf
pull-request
Mirrored from GitHub Pull Request
 tui
web
windows
zen
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#14740
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?