ai-sdk-provider-claude-code 3.3.0 → 3.3.1

package/README.md

@@ -225,7 +225,7 @@ If you're upgrading from version 1.x:
 
 ## Structured Outputs
 
-This provider supports **native structured outputs** via the Claude Agent SDK (v0.1.45+). When using `generateObject()` or `streamObject()`, the SDK guarantees schema-compliant JSON responses through constrained decoding.
+This provider supports **native structured outputs** via the Claude Agent SDK (v0.1.45+). When using `generateObject()` or `streamObject()`, the SDK returns schema-compliant JSON for **supported** JSON Schema features via constrained decoding.
 
 ```typescript
 import { generateObject } from 'ai';
@@ -237,30 +237,32 @@ const result = await generateObject({
   schema: z.object({
     name: z.string(),
     age: z.number(),
-    email: z.string().email(),
+    email: z.string().describe('Email address (validate client-side)'),
   }),
   prompt: 'Generate a user profile for a software developer',
 });
 
-console.log(result.object); // Guaranteed to match schema
+console.log(result.object); // Matches the schema above
 // { name: "Alex Chen", age: 28, email: "alex@example.com" }
 ```
 
 **Benefits:**
 
-- ✅ **Guaranteed schema compliance** - Constrained decoding ensures valid output
+- ✅ **Schema compliance (supported features)** - Constrained decoding ensures valid output
 - ✅ **No JSON parsing errors** - SDK handles all validation
 - ✅ **No prompt engineering** - Schema enforcement is native to the SDK
 - ✅ **Better performance** - No retry/extraction logic needed
 
-> **Note:** A schema is required for JSON output. Using `responseFormat: { type: 'json' }` without a schema is not supported by Claude Code (matching Anthropic's official provider behavior). An `unsupported-setting` warning will be emitted and the call will be treated as plain text. Always use `generateObject()` or `streamObject()` with a Zod schema for guaranteed JSON output.
+> **Note:** A schema is required for JSON output. Using `responseFormat: { type: 'json' }` without a schema is not supported by Claude Code (matching Anthropic's official provider behavior). An `unsupported-setting` warning will be emitted and the call will be treated as plain text.
+>
+> **Current CLI limitation:** Some JSON Schema features can cause the Claude Code CLI to silently fall back to prose (no `structured_output`). This includes `format` constraints (e.g., `email`, `uri`) and complex regex patterns (lookaheads/backreferences). Workaround: keep the generation schema simple, then validate with a stricter schema client-side. See `examples/structured-output-repro.ts` and `examples/limitations.ts`.
 
 ## Core Features
 
 - 🚀 Vercel AI SDK compatibility
 - 🔄 Streaming support
 - 💬 Multi-turn conversations
-- 🎯 Native structured outputs with guaranteed schema compliance
+- 🎯 Native structured outputs with schema compliance for supported features
 - 🛑 AbortSignal support
 - 🔧 Tool management (MCP servers, permissions)
 - 🧩 Callbacks (hooks, canUseTool)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sdk-provider-claude-code",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "AI SDK v6 provider for Claude via Claude Agent SDK (use Pro/Max subscription)",
   "keywords": [
     "ai-sdk",
@@ -67,12 +67,13 @@
     "example:tools": "npm run build && npx tsx examples/tool-management.ts",
     "example:timeout": "npm run build && npx tsx examples/long-running-tasks.ts",
     "example:zod4": "npm run build && npx tsx examples/zod4-compatibility-test.ts",
+    "example:structured-repro": "npx tsx examples/structured-output-repro.ts",
     "example:all": "npm run build && npm run example:basic && npm run example:streaming && npm run example:conversation && npm run example:config && npm run example:object:basic && npm run example:object:nested && npm run example:object:constraints && npm run example:tools && npm run example:timeout"
   },
   "dependencies": {
     "@ai-sdk/provider": "^3.0.0",
     "@ai-sdk/provider-utils": "^4.0.1",
-    "@anthropic-ai/claude-agent-sdk": "^0.2.1"
+    "@anthropic-ai/claude-agent-sdk": "^0.2.9"
   },
   "devDependencies": {
     "@edge-runtime/vm": "5.0.0",