ai-pro-sdk 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ben Vargas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+<p align="center">
+  <img src="https://img.shields.io/badge/status-stable-00A79E" alt="stable status">
+  <a href="https://www.npmjs.com/package/ai-pro-sdk"><img src="https://img.shields.io/npm/v/ai-pro-sdk?color=00A79E" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/ai-pro-sdk"><img src="https://img.shields.io/npm/unpacked-size/ai-pro-sdk?color=00A79E" alt="install size" /></a>
+  <a href="https://www.npmjs.com/package/ai-pro-sdk"><img src="https://img.shields.io/npm/dy/ai-pro-sdk.svg?color=00A79E" alt="npm downloads" /></a>
+  <a href="https://nodejs.org/en/about/releases/"><img src="https://img.shields.io/badge/node-%3E%3D22-00A79E" alt="Node.js ≥ 22" /></a>
+  <a href="https://www.npmjs.com/package/ai-pro-sdk"><img src="https://img.shields.io/npm/l/ai-pro-sdk?color=00A79E" alt="License: MIT" /></a>
+</p>
+
+# AI Pro SDK
+
+AI Pro SDK is a Vercel AI SDK provider for Claude that uses the Claude Agent SDK and the Claude Code CLI. It is designed for Claude Pro and Max workflows and exposes the Claude Code experience through the standard AI SDK model interface.
+
+## Features
+
+- AI SDK v7 compatibility
+- Streaming responses with tool and session support
+- Structured output support via the AI SDK output API
+- Claude Agent SDK callbacks, hooks, MCP integration, and session controls
+- Support for Claude Code CLI authentication and configuration
+
+## Installation
+
+Install the package alongside the AI SDK and Zod:
+
+```bash
+npm install ai-pro-sdk ai zod@^4.1.8
+```
+
+Authenticate the Claude Code CLI:
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+claude auth login
+```
+
+## Quick start
+
+```ts
+import { streamText } from 'ai';
+import { claudeCode } from 'ai-pro-sdk';
+
+const result = streamText({
+  model: claudeCode('haiku'),
+  prompt: 'Hello from AI Pro SDK!',
+});
+
+console.log(await result.text);
+```
+
+## Configuration example
+
+You can pass Claude Code settings directly when you create the model:
+
+```ts
+import { streamText } from 'ai';
+import { claudeCode } from 'ai-pro-sdk';
+
+const result = streamText({
+  model: claudeCode('sonnet', {
+    persistSession: false,
+    settingSources: ['user', 'project'],
+  }),
+  prompt: 'Summarize the latest deployment log.',
+});
+
+console.log(await result.text);
+```
+
+## Documentation
+
+- [Session management](docs/sessions.md)
+- [AI SDK v5 migration notes](docs/ai-sdk-v5/V5_MIGRATION_SUMMARY.md)
+- [Development status](docs/ai-sdk-v5/DEVELOPMENT-STATUS.md)
+
+## Notes
+
+- Requires Node.js 22 or newer.
+- This package is unofficial and community-maintained; it is not affiliated with Anthropic or Vercel.
+- For advanced usage, refer to the Claude Code CLI documentation and the examples in the repository.
+
+## License
+
+MIT

package/docs/ai-sdk-v4/DEVELOPMENT-STATUS.md

@@ -0,0 +1,231 @@
+# Community Provider Status Analysis
+
+## Overview
+
+This document analyzes the requirements for ai-sdk-provider-claude-code to achieve community provider status in the Vercel AI SDK ecosystem.
+
+## Current Implementation Status
+
+### ✅ What We Have
+
+#### Core Functionality
+
+- **SDK Integration**: Uses official `@anthropic-ai/claude-code` SDK for all Claude interactions
+- **Text Generation**: Full support for both streaming and non-streaming text generation
+- **Object Generation**: Reliable JSON generation through prompt engineering and extraction
+- **Multi-turn Conversations**: Proper message history support (recommended AI SDK pattern)
+- **Provider Metadata**: Rich metadata including sessionId, costUsd, durationMs, and rawUsage
+- **Error Handling**: Comprehensive error handling with authentication detection
+- **AbortSignal Support**: Standard AI SDK pattern for timeouts and cancellation
+
+#### Build & Distribution
+
+- **TypeScript**: Full TypeScript support with proper type definitions
+- **Dual Formats**: Both CommonJS and ES Module builds via tsup
+- **Source Maps**: Generated for debugging support
+- **Package Structure**: Proper exports configuration for modern Node.js
+
+#### Testing
+
+- **Unit Tests**: Comprehensive test coverage with Vitest
+- **Integration Tests**: Full integration test suite
+- **Edge/Node Tests**: Separate configurations for different environments
+- **Examples**: Extensive example collection demonstrating all features
+
+#### Documentation
+
+- **README**: Comprehensive documentation with examples
+- **CHANGELOG**: Proper version history following Keep a Changelog format
+- **Examples README**: Detailed guide for all example files
+- **API Documentation**: Clear documentation of all configuration options
+
+### 🚀 Meeting AI SDK Standards
+
+Based on analysis of official providers (Mistral, OpenAI, etc.), we now meet all requirements:
+
+1. **Provider Pattern** ✅
+   - Factory function with provider instance
+   - Default export
+   - Proper settings interface
+   - Protection against `new` keyword misuse
+
+2. **Language Model Implementation** ✅
+   - `specificationVersion: 'v1'`
+   - Correct `doGenerate` and `doStream` methods
+   - Proper provider metadata
+   - Object generation support
+
+3. **Build System** ✅
+   - tsup for dual format builds
+   - Source maps
+   - Proper package.json configuration
+
+4. **Testing** ✅
+   - Separate edge/node configurations
+   - Unit and integration tests
+   - Example test coverage
+
+5. **Error Handling** ✅
+   - Standard AI SDK error classes
+   - Proper `isRetryable` flags
+   - AbortSignal support
+
+## 📁 Current Project Structure
+
+```
+ai-sdk-provider-claude-code/
+├── src/
+│   ├── index.ts                          # Main exports
+│   ├── claude-code-provider.ts           # Provider factory
+│   ├── claude-code-language-model.ts     # Language model implementation
+│   ├── convert-to-claude-code-messages.ts # Message formatting
+│   ├── extract-json.ts                   # JSON extraction (using jsonc-parser)
+│   ├── errors.ts                         # Error utilities
+│   └── types.ts                          # TypeScript definitions
+├── docs/
+│   ├── GUIDE.md                          # Comprehensive usage guide
+│   ├── TROUBLESHOOTING.md                # Common issues and solutions
+│   └── DEVELOPMENT-STATUS.md             # This document
+├── examples/
+│   ├── README.md                         # Examples guide
+│   ├── basic-usage.ts                    # Simple generation
+│   ├── streaming.ts                      # Streaming demo
+│   ├── conversation-history.ts           # Multi-turn conversations
+│   ├── custom-config.ts                  # Configuration options
+│   ├── generate-object-*.ts              # Object generation examples
+│   ├── tool-management.ts                # Tool access control
+│   ├── long-running-tasks.ts             # Timeout handling
+│   ├── abort-signal.ts                   # Cancellation
+│   ├── integration-test.ts               # Test suite
+│   └── check-cli.ts                      # Setup verification
+├── vitest.config.js                      # Test configuration
+├── vitest.edge.config.js                 # Edge runtime tests
+├── vitest.node.config.js                 # Node runtime tests
+├── tsup.config.ts                        # Build configuration
+├── package.json                          # Package metadata
+├── CHANGELOG.md                          # Version history
+├── README.md                             # Concise getting started guide
+└── LICENSE                               # MIT license
+```
+
+## 🎯 Ready for Community Status
+
+The provider now meets all requirements for community provider status:
+
+### Technical Requirements ✅
+
+- Implements LanguageModelV1 specification
+- Follows provider factory pattern
+- Uses standard error handling
+- Supports AbortSignal
+- Has proper TypeScript types
+- Includes comprehensive tests
+
+### Build Requirements ✅
+
+- Uses tsup for builds
+- Generates both CJS and ESM
+- Includes source maps
+- Has proper package.json configuration
+
+### Documentation Requirements ✅
+
+- Comprehensive README
+- CHANGELOG with version history
+- Extensive examples
+- Clear setup instructions
+
+## Next Steps for Community Submission
+
+1. **Publish to npm**
+
+   ```bash
+   npm publish
+   ```
+
+2. **Prepare MDX Documentation**
+   Create a documentation file following the community provider format (see example below)
+
+3. **Submit PR to AI SDK Repository**
+   - Add provider to community providers list
+   - Include MDX documentation
+   - Reference npm package
+
+## Example Community Provider MDX
+
+````mdx
+---
+title: Claude Code
+description: Use Claude via the official Claude Code SDK with your Pro/Max subscription
+---
+
+# Claude Code Provider
+
+[ben-vargas/ai-sdk-provider-claude-code](https://github.com/ben-vargas/ai-sdk-provider-claude-code)
+is a community provider that uses the official [Claude Code SDK](https://www.npmjs.com/package/@anthropic-ai/claude-code)
+to provide language model support for the AI SDK.
+
+## Setup
+
+The Claude Code provider is available in the `ai-sdk-provider-claude-code` module. You can install it with:
+
+<Tabs items={['pnpm', 'npm', 'yarn']}>
+  <Tab>
+    <Snippet text="pnpm add ai-sdk-provider-claude-code" dark />
+  </Tab>
+  <Tab>
+    <Snippet text="npm install ai-sdk-provider-claude-code" dark />
+  </Tab>
+  <Tab>
+    <Snippet text="yarn add ai-sdk-provider-claude-code" dark />
+  </Tab>
+</Tabs>
+
+### Prerequisites
+
+Install and authenticate the Claude Code SDK:
+
+```bash
+npm install -g @anthropic-ai/claude-code
+claude login
+```
+````
+
+## Provider Instance
+
+You can import the default provider instance `claudeCode` from `ai-sdk-provider-claude-code`:
+
+```ts
+import { claudeCode } from 'ai-sdk-provider-claude-code';
+```
+
+## Language Models
+
+The Claude Code provider supports the following models:
+
+- `sonnet` - Claude 4 Sonnet (balanced speed and capability)
+- `opus` - Claude 4 Opus (most capable)
+
+```ts
+import { generateText } from 'ai';
+import { claudeCode } from 'ai-sdk-provider-claude-code';
+
+const { text } = await generateText({
+  model: claudeCode('sonnet'),
+  prompt: 'Explain recursion in one sentence',
+});
+```
+
+### Model Capabilities
+
+| Model  | Text Generation | Object Generation | Image Input | AI SDK Tool Calling | MCP Tools |
+| ------ | --------------- | ----------------- | ----------- | ------------------- | --------- |
+| opus   | ✅              | ✅                | ❌          | ❌                  | ✅        |
+| sonnet | ✅              | ✅                | ❌          | ❌                  | ✅        |
+
+<Note>
+  The provider uses the official Claude Code SDK. While the models support tool use, this provider 
+  doesn't implement the AI SDK's tool calling interface. However, you can configure MCP servers 
+  for tool functionality, and Claude can use built-in tools (Bash, Read, Write, etc.) through 
+  the Claude Code SDK.
+</Note>