@mastra/claude 0.3.1-alpha.0 → 0.3.1

package/README.md

@@ -1,105 +1,44 @@
 # @mastra/claude
 
-`@mastra/claude` connects Mastra to the Claude Agent SDK. Use it when you want to register a Claude SDK agent with Mastra and call it through Mastra-compatible `generate()` and `stream()` methods.
+`@mastra/claude` connects Mastra to the Claude Agent SDK. Use it when you want Claude Code's agent loop, tools, permissions, and runtime configuration while exposing the agent through Mastra-compatible `generate()` and `stream()` methods.
 
 ## Installation
 
 ```bash
-npm install @mastra/claude @anthropic-ai/claude-agent-sdk
+npm install @mastra/claude
+npm install @anthropic-ai/claude-agent-sdk
 ```
 
-## Overview
+## Usage
 
-The package exports `ClaudeSDKAgent`, a Mastra `Agent` wrapper around the Claude Agent SDK run loop.
-
-`ClaudeSDKAgent` keeps the Claude SDK run loop in charge. Mastra receives compatible outputs, usage, cost estimates, and tracing data for the run.
-
-## Create a Claude SDK agent
-
-Pass Claude SDK configuration through `sdkOptions`.
+Set `ANTHROPIC_API_KEY` before creating the agent.
 
 ```typescript
 import { ClaudeSDKAgent } from '@mastra/claude';
+import { Mastra } from '@mastra/core/mastra';
 
 export const claudeAgent = new ClaudeSDKAgent({
   id: 'claude-sdk-agent',
   name: 'Claude SDK Agent',
   description: 'Use Claude Agent SDK through Mastra.',
   sdkOptions: {
-    model: process.env.CLAUDE_CODE_MODEL,
     cwd: process.cwd(),
   },
 });
-```
-
-You can register the wrapper anywhere Mastra accepts an `Agent`.
-
-```typescript
-import { Mastra } from '@mastra/core/mastra';
 
 export const mastra = new Mastra({
-  agents: {
-    claudeAgent,
-  },
+  agents: { claudeAgent },
 });
 ```
 
-## Run the agent
+## Documentation
 
-```typescript
-const result = await claudeAgent.generate('Summarize the latest changes in this repository.', {
-  runId: 'claude-run',
-});
+- [Claude Agent SDK integration](https://mastra.ai/docs/connections/sdk-agents#claude-agent-sdk)
 
-console.log(result.text);
-```
+## Changelog
 
-```typescript
-const stream = await claudeAgent.stream('Review this package for test gaps.');
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/agent-sdks/claude/CHANGELOG.md) for version history and release notes.
 
-for await (const chunk of stream.fullStream) {
-  if (chunk.type === 'text-delta') {
-    process.stdout.write(chunk.payload.text);
-  }
-}
-```
+## Support
 
-## Configure Claude
-
-`ClaudeSDKAgent` forwards `sdkOptions` to the Claude SDK `query()` call on every run.
-
-For custom tools, create a Claude SDK MCP server and pass it with `mcpServers`.
-
-```typescript
-import { createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk';
-import { ClaudeSDKAgent } from '@mastra/claude';
-import { z } from 'zod';
-
-const weatherServer = createSdkMcpServer({
-  name: 'weather',
-  version: '1.0.0',
-  tools: [
-    tool(
-      'get_temperature',
-      'Get the current temperature.',
-      {
-        location: z.string(),
-      },
-      async ({ location }) => ({
-        content: [{ type: 'text', text: `Temperature for ${location}: 72F` }],
-      }),
-    ),
-  ],
-});
-
-export const claudeAgent = new ClaudeSDKAgent({
-  id: 'claude-sdk-agent',
-  description: 'Use Claude with weather tools.',
-  sdkOptions: {
-    mcpServers: {
-      weather: weatherServer,
-    },
-    allowedTools: ['mcp__weather__get_temperature'],
-  },
-});
-```
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-claude
 description: Documentation for @mastra/claude. Use when working with @mastra/claude APIs, configuration, or implementation.
 metadata:
   package: "@mastra/claude"
-  version: "0.3.1-alpha.0"
+  version: "0.3.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.3.1-alpha.0",
+  "version": "0.3.1",
   "package": "@mastra/claude",
   "exports": {},
   "modules": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/claude",
-  "version": "0.3.1-alpha.0",
+  "version": "0.3.1",
   "description": "Claude SDK package for Mastra",
   "type": "module",
   "main": "dist/index.js",
@@ -34,9 +34,9 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/types-builder": "0.0.104",
-    "@internal/lint": "0.0.129",
-    "@mastra/core": "1.64.0-alpha.2"
+    "@internal/lint": "0.0.130",
+    "@mastra/core": "1.64.0",
+    "@internal/types-builder": "0.0.105"
   },
   "homepage": "https://mastra.ai",
   "repository": {