diff --git a/.changeset/correct-newtype-decoding.md b/.changeset/correct-newtype-decoding.md
new file mode 100644
index 00000000000..decb1970074
--- /dev/null
+++ b/.changeset/correct-newtype-decoding.md
@@ -0,0 +1,5 @@
+---
+"@opencode-ai/core": patch
+---
+
+Correct the published Newtype documentation to recommend `Schema.decodeUnknownSync` for schema-based synchronous decoding.
diff --git a/packages/core/src/schema.ts b/packages/core/src/schema.ts
index 19796c4dfd5..24c2c68baf7 100644
--- a/packages/core/src/schema.ts
+++ b/packages/core/src/schema.ts
@@ -41,7 +41,7 @@ export type DeepMutable<T> = T extends string | number | boolean | bigint | symb
 
 /**
  * Nominal wrapper for scalar types. The class itself is a valid schema —
- * pass it directly to `Schema.decode`, `Schema.decodeEffect`, etc.
+ * pass it directly to `Schema.decodeUnknownSync`, `Schema.decodeEffect`, etc.
  *
  * The runtime value remains an unwrapped primitive. `Schema.brand` supplies
  * the primitive schema behavior and constructor validation, while the class