diff --git a/docs/content/docs/packages/utils/reasoning.mdx b/docs/content/docs/packages/utils/reasoning.mdx
index b147fbc1..1876b9ef 100644
--- a/docs/content/docs/packages/utils/reasoning.mdx
+++ b/docs/content/docs/packages/utils/reasoning.mdx
@@ -11,6 +11,10 @@ import { PkgSizeBadge } from '@/components/pkg-size-badge'
 npm i @xsai/utils-reasoning
 ```
 
+<Callout type="warn">
+  This package has been deprecated.
+</Callout>
+
 ## Examples
 
 ### extractReasoning
diff --git a/packages/utils-reasoning/src/extract-reasoning-stream.ts b/packages/utils-reasoning/src/extract-reasoning-stream.ts
index 2ae245ea..6383f57e 100644
--- a/packages/utils-reasoning/src/extract-reasoning-stream.ts
+++ b/packages/utils-reasoning/src/extract-reasoning-stream.ts
@@ -7,6 +7,7 @@ export interface ExtractReasoningStreamResult {
   textStream: ReadableStream<string>
 }
 
+/** @deprecated use `streamText().reasoningTextStream` instead. */
 export const extractReasoningStream = (stream: ReadableStream<string>, options: ExtractReasoningOptions = {
   tagName: 'think',
 }): ExtractReasoningStreamResult => {
diff --git a/packages/utils-reasoning/src/extract-reasoning.ts b/packages/utils-reasoning/src/extract-reasoning.ts
index d47fe62c..a76b242d 100644
--- a/packages/utils-reasoning/src/extract-reasoning.ts
+++ b/packages/utils-reasoning/src/extract-reasoning.ts
@@ -12,6 +12,7 @@ export interface ExtractReasoningResult {
   text: string
 }
 
+/** @deprecated use `(await generateText()).reasoningText` instead. */
 export const extractReasoning = (text: string, options: ExtractReasoningOptions = {
   tagName: 'think',
 }) => {
diff --git a/packages/utils-reasoning/test/qwen3.test.ts b/packages/utils-reasoning/test/qwen3.test.ts
index aa2662bb..e5e7fa53 100644
--- a/packages/utils-reasoning/test/qwen3.test.ts
+++ b/packages/utils-reasoning/test/qwen3.test.ts
@@ -1,3 +1,4 @@
+/* eslint-disable sonarjs/deprecation */
 // import { generateText } from '@xsai/generate-text'
 // import { streamText } from '@xsai/stream-text'
 import { describe, expect, it } from 'vitest'