chore(ai): add AGENTS.md and CLAUDE.md to npm package

.changeset/popular-dingos-doubt.md

@@ -0,0 +1,5 @@
+---
+'ai': patch
+---
+
+chore(ai): add AGENTS.md and CLAUDE.md to npm package

.gitignore

@@ -16,3 +16,7 @@ tsconfig.vitest-temp.json
 *.log
 *.local
 *.tsbuildinfo
+
+# Generated files
+packages/ai/AGENTS.md
+packages/ai/CLAUDE.md

packages/ai/USAGE-AGENTS.md

@@ -0,0 +1,57 @@
+# AI SDK Usage
+
+## Use Cases
+
+### Generating Text
+
+#### text prompt
+
+```ts
+import { generateText } from 'ai';
+
+const result = await generateText({
+  model: 'openai/gpt-5',
+  prompt: 'Invent a new holiday.', // text prompt
+});
+
+const text = result.text; // access generated text
+```
+
+#### Specifying the maximum number of tokens to generate
+
+```ts
+import { generateText } from 'ai';
+
+const result = await generateText({
+  model: 'openai/gpt-5',
+  prompt: 'Invent a new holiday.',
+  maxOutputTokens: 100, // maximum number of tokens to generate
+});
+```
+
+### Streaming Text
+
+#### text prompt and text stream
+
+```ts
+import { streamText } from 'ai';
+
+const result = streamText({
+  model: 'openai/gpt-5',
+  prompt: 'Invent a new holiday.', // text prompt
+});
+
+const textStream = result.textStream; // access text stream
+```
+
+#### Specifying the maximum number of tokens to generate
+
+```ts
+import { streamText } from 'ai';
+
+const result = await streamText({
+  model: 'openai/gpt-5',
+  prompt: 'Invent a new holiday.',
+  maxOutputTokens: 100, // maximum number of tokens to generate
+});
+```

packages/ai/package.json

@@ -9,7 +9,9 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist/**/*",
+    "AGENTS.md",
     "CHANGELOG.md",
+    "CLAUDE.md",
     "internal.d.ts",
     "README.md",
     "test.d.ts"

packages/ai/tsup.config.ts

@@ -1,3 +1,4 @@
+import { copyFileSync } from 'node:fs';
 import { defineConfig } from 'tsup';
 
 export default defineConfig([
@@ -16,6 +17,11 @@ export default defineConfig([
           .version,
       ),
     },
+    onSuccess: async () => {
+      // Copy USAGE-AGENTS.md to AGENTS.md and CLAUDE.md for inclusion in the published package
+      copyFileSync('USAGE-AGENTS.md', 'AGENTS.md');
+      copyFileSync('USAGE-AGENTS.md', 'CLAUDE.md');
+    },
   },
   // Internal APIs
   {