@boostecom/provider 0.0.1

package/docs/content/README.md

@@ -0,0 +1,337 @@
+# Documentation MDX — AI SDK Provider Claude Code
+
+Cette documentation complete est structuree pour etre integree dans une plateforme SaaS moderne (Docusaurus, Nextra, GitBook, etc.).
+
+## Structure de la documentation
+
+### Pages principales
+
+1. **[index.mdx](./index.mdx)** — Page d'accueil et introduction
+   - Apercu du provider
+   - Installation rapide
+   - Compatibilite des versions
+   - Premiers pas
+
+2. **[installation.mdx](./installation.mdx)** — Guide d'installation detaille
+   - Prerequis
+   - Installation du CLI
+   - Configuration
+   - Environnements specifiques (Docker, CI/CD, monorepo)
+   - Depannage installation
+
+3. **[guide.mdx](./guide.mdx)** — Guide d'utilisation complet
+   - Utilisation basique
+   - Streaming
+   - Conversations multi-tours
+   - Structured outputs
+   - Images
+   - Configuration avancee
+   - Gestion des outils
+   - Erreurs et timeouts
+
+4. **[api.mdx](./api.mdx)** — Reference API complete
+   - Documentation de `claudeCode()`
+   - Toutes les options de `ClaudeCodeSettings`
+   - Types exportes
+   - Metadonnees et valeurs de retour
+
+5. **[examples.mdx](./examples.mdx)** — Exemples pratiques
+   - Applications web (Express, Next.js)
+   - Outils et scripts
+   - Traitement par lots
+   - Integration bases de donnees
+   - Services tiers (Slack, etc.)
+
+6. **[skills.mdx](./skills.mdx)** — Competences personnalisees
+   - Qu'est-ce qu'une Skill
+   - Configuration
+   - Creation de Skills
+   - Exemples de Skills utiles
+   - Bonnes pratiques
+
+7. **[troubleshooting.mdx](./troubleshooting.mdx)** — Depannage
+   - Problemes d'installation
+   - Problemes d'execution
+   - Structured outputs
+   - Outils et sessions
+   - Performance
+   - Docker et CI/CD
+
+8. **[best-practices.mdx](./best-practices.mdx)** — Bonnes pratiques
+   - Choix du modele
+   - Gestion du contexte
+   - Securite
+   - Performance
+   - Logging et monitoring
+   - Testing
+   - Production
+
+9. **[agent-teams.mdx](./agent-teams.mdx)** — Agent Teams
+   - Equipes d'agents specialises
+   - Configuration et coordination
+   - Cas d'usage pratiques
+   - Integration avec Skills
+   - Bonnes pratiques pour teams
+
+## Integration dans une plateforme
+
+### Docusaurus
+
+```javascript
+// docusaurus.config.js
+module.exports = {
+  // ...
+  presets: [
+    [
+      '@docusaurus/preset-classic',
+      {
+        docs: {
+          path: 'docs/content',
+          routeBasePath: 'docs',
+          sidebarPath: require.resolve('./sidebars.js'),
+        },
+      },
+    ],
+  ],
+};
+```
+
+```javascript
+// sidebars.js
+module.exports = {
+  docs: [
+    {
+      type: 'doc',
+      id: 'index',
+      label: 'Introduction',
+    },
+    {
+      type: 'category',
+      label: 'Pour commencer',
+      items: ['installation', 'guide'],
+    },
+    {
+      type: 'category',
+      label: 'Reference',
+      items: ['api', 'examples'],
+    },
+    {
+      type: 'category',
+      label: 'Avance',
+      items: ['skills', 'best-practices'],
+    },
+    {
+      type: 'doc',
+      id: 'troubleshooting',
+      label: 'Depannage',
+    },
+  ],
+};
+```
+
+### Nextra (Next.js)
+
+```javascript
+// next.config.js
+const withNextra = require('nextra')({
+  theme: 'nextra-theme-docs',
+  themeConfig: './theme.config.tsx',
+});
+
+module.exports = withNextra({
+  // ...
+});
+```
+
+```javascript
+// theme.config.tsx
+export default {
+  logo: <span>Claude Code Provider</span>,
+  project: {
+    link: 'https://github.com/BoostEcom/ThemeCopilotAI',
+  },
+  docsRepositoryBase: 'https://github.com/BoostEcom/ThemeCopilotAI/tree/main/docs/content',
+  sidebar: {
+    defaultMenuCollapseLevel: 1,
+  },
+  // ...
+};
+```
+
+Structure pour Nextra :
+```
+pages/
+  docs/
+    index.mdx
+    installation.mdx
+    guide.mdx
+    api.mdx
+    examples.mdx
+    skills.mdx
+    troubleshooting.mdx
+    best-practices.mdx
+    _meta.json
+```
+
+```json
+// pages/docs/_meta.json
+{
+  "index": "Introduction",
+  "installation": "Installation",
+  "guide": "Guide d'utilisation",
+  "api": "Reference API",
+  "examples": "Exemples",
+  "skills": "Skills",
+  "troubleshooting": "Depannage",
+  "best-practices": "Bonnes pratiques"
+}
+```
+
+### GitBook
+
+Importez directement les fichiers MDX dans votre espace GitBook ou utilisez la synchronisation GitHub.
+
+### VitePress
+
+```javascript
+// .vitepress/config.ts
+export default {
+  title: 'Claude Code Provider',
+  description: 'AI SDK Provider pour Claude Code',
+  themeConfig: {
+    nav: [
+      { text: 'Guide', link: '/guide' },
+      { text: 'API', link: '/api' },
+    ],
+    sidebar: [
+      {
+        text: 'Introduction',
+        items: [
+          { text: 'Pour commencer', link: '/index' },
+          { text: 'Installation', link: '/installation' },
+        ],
+      },
+      {
+        text: 'Utilisation',
+        items: [
+          { text: 'Guide', link: '/guide' },
+          { text: 'Exemples', link: '/examples' },
+        ],
+      },
+      {
+        text: 'Reference',
+        items: [
+          { text: 'API', link: '/api' },
+          { text: 'Skills', link: '/skills' },
+        ],
+      },
+      {
+        text: 'Aide',
+        items: [
+          { text: 'Depannage', link: '/troubleshooting' },
+          { text: 'Bonnes pratiques', link: '/best-practices' },
+        ],
+      },
+    ],
+  },
+};
+```
+
+## Personnalisation
+
+### Composants personnalises
+
+Les fichiers MDX utilisent des composants standard :
+
+- `<Note>` — Notes colorees (info, warning, danger, tip)
+- `<Accordion>` — Contenu pliable
+- `<CardGroup>` et `<Card>` — Cartes de navigation
+- `<Tabs>` et `<Tab>` — Onglets
+
+Adaptez-les selon votre plateforme :
+
+#### Docusaurus
+```jsx
+import Admonition from '@theme/Admonition';
+// <Note type="info"> → <Admonition type="info">
+```
+
+#### Nextra
+```jsx
+import { Callout } from 'nextra-theme-docs';
+// <Note type="info"> → <Callout type="info">
+```
+
+### Theme et couleurs
+
+Les exemples de code utilisent la syntaxe standard. Configurez votre theme de coloration syntaxique :
+
+```javascript
+// Prism pour Docusaurus
+prism: {
+  theme: lightCodeTheme,
+  darkTheme: darkCodeTheme,
+  additionalLanguages: ['bash', 'typescript', 'javascript', 'json', 'docker'],
+}
+```
+
+## Recherche
+
+Pour activer la recherche :
+
+### Algolia (Docusaurus)
+```javascript
+themeConfig: {
+  algolia: {
+    apiKey: 'your-api-key',
+    indexName: 'claude-code-provider',
+    appId: 'your-app-id',
+  },
+}
+```
+
+### Recherche locale (VitePress)
+```javascript
+themeConfig: {
+  search: {
+    provider: 'local',
+  },
+}
+```
+
+## Contribution
+
+Pour contribuer a la documentation :
+
+1. Modifier les fichiers `.mdx`
+2. Tester localement avec votre plateforme
+3. Soumettre une PR
+
+## Structure recommandee finale
+
+```
+docs/
+  content/
+    index.mdx              # Introduction
+    installation.mdx       # Installation
+    guide.mdx             # Guide d'utilisation
+    api.mdx               # Reference API
+    examples.mdx          # Exemples pratiques
+    skills.mdx            # Skills personnalisees
+    troubleshooting.mdx   # Depannage
+    best-practices.mdx    # Bonnes pratiques
+    README.md             # Ce fichier
+    _meta.json            # Metadonnees (Nextra)
+    sidebars.js           # Sidebar (Docusaurus)
+```
+
+## Liens utiles
+
+- [Repository GitHub](https://github.com/BoostEcom/ThemeCopilotAI)
+- [Vercel AI SDK](https://sdk.vercel.ai/docs)
+- [Claude Agent SDK](https://docs.anthropic.com/claude/docs)
+- [Package NPM](https://www.npmjs.com/package/@boostecom/provider)
+
+## License
+
+MIT — Voir le fichier LICENSE du projet principal

package/docs/content/agent-teams.mdx

@@ -0,0 +1,324 @@
+---
+title: "Agent Teams"
+description: "Créer des équipes d'agents spécialisés avec Claude Opus 4.6"
+---
+
+# Agent Teams
+
+Guide complet pour créer et coordonner des équipes d'agents spécialisés avec Claude Code Provider.
+
+## Introduction
+
+**Agent Teams** est une fonctionnalité puissante introduite dans **Claude Opus 4.6** qui permet de créer plusieurs agents spécialisés travaillant ensemble pour accomplir des tâches complexes.
+
+### Avantages des Agent Teams
+
+- **Spécialisation** : Chaque agent excelle dans son domaine
+- **Isolation** : Outils et permissions séparés par agent
+- **Efficacité** : Modèles optimisés par tâche (Opus pour complexe, Haiku pour simple)
+- **Coordination** : Les agents se passent automatiquement les tâches
+
+## Configuration de base
+
+```typescript
+import { claudeCode } from '@boostecom/provider';
+import { generateText } from 'ai';
+
+const model = claudeCode('opus', {
+  agents: {
+    // Agent de recherche
+    researcher: {
+      description: 'Expert en recherche et analyse d\'information',
+      tools: ['Read', 'Grep', 'Glob', 'WebSearch'],
+      disallowedTools: ['Write', 'Edit'],
+      prompt: 'Tu es un expert en recherche. Ton rôle est de trouver et analyser l\'information.',
+      model: 'sonnet', // Modèle rapide pour la recherche
+    },
+    
+    // Agent de développement
+    developer: {
+      description: 'Expert en écriture et refactoring de code',
+      tools: ['Read', 'Write', 'Edit', 'Grep'],
+      prompt: 'Tu es un développeur senior. Écris du code propre et maintenable.',
+      model: 'opus', // Modèle le plus capable
+    },
+    
+    // Agent de test
+    tester: {
+      description: 'Expert en tests et assurance qualité',
+      tools: ['Read', 'Write', 'Bash'],
+      prompt: 'Tu es un QA engineer. Écris des tests complets.',
+      model: 'haiku', // Modèle rapide pour les tests
+    },
+  },
+});
+
+const { text } = await generateText({
+  model,
+  prompt: 'Crée un système d\'auth complet avec tests',
+});
+```
+
+## Propriétés d'un Agent
+
+### `description` (requis)
+
+Description en langage naturel de quand utiliser cet agent. Claude l'utilise pour router les tâches.
+
+```typescript
+description: 'Expert at finding bugs and writing comprehensive test suites'
+```
+
+### `tools` (optionnel)
+
+Liste des outils autorisés pour cet agent. Si omis, hérite tous les outils du parent.
+
+```typescript
+tools: ['Read', 'Write', 'Bash', 'Grep']
+```
+
+### `disallowedTools` (optionnel)
+
+Liste des outils explicitement interdits.
+
+```typescript
+disallowedTools: ['Bash(rm:*)', 'Bash(sudo:*)'] // Interdire commandes dangereuses
+```
+
+### `prompt` (requis)
+
+System prompt de l'agent définissant son rôle et comportement.
+
+```typescript
+prompt: `Tu es un expert en sécurité. Ton rôle est de :
+- Identifier les vulnérabilités
+- Proposer des solutions sécurisées
+- Suivre les best practices OWASP`
+```
+
+### `model` (optionnel)
+
+Modèle à utiliser pour cet agent. Si omis ou `'inherit'`, utilise le modèle principal.
+
+```typescript
+model: 'sonnet' | 'opus' | 'haiku' | 'inherit'
+```
+
+- **Opus** : Tâches complexes, raisonnement avancé
+- **Sonnet** : Équilibre performance/coût
+- **Haiku** : Tâches simples et rapides
+
+### `mcpServers` (optionnel)
+
+Serveurs MCP disponibles pour cet agent.
+
+```typescript
+mcpServers: ['filesystem', 'github']
+```
+
+## Cas d'usage
+
+### 1. Équipe de développement full-stack
+
+```typescript
+const model = claudeCode('opus', {
+  agents: {
+    frontend: {
+      description: 'Expert React/TypeScript pour interfaces utilisateur',
+      tools: ['Read', 'Write', 'Edit'],
+      prompt: 'Tu crées des composants React accessibles et performants.',
+      model: 'opus',
+    },
+    
+    backend: {
+      description: 'Expert Node.js/Express pour APIs REST',
+      tools: ['Read', 'Write', 'Edit', 'Bash'],
+      prompt: 'Tu construis des APIs sécurisées et scalables.',
+      model: 'opus',
+    },
+    
+    database: {
+      description: 'Expert PostgreSQL pour schémas et requêtes',
+      tools: ['Read', 'Write', 'Bash'],
+      prompt: 'Tu conçois des schémas de bases de données optimisés.',
+      model: 'sonnet',
+    },
+  },
+});
+```
+
+### 2. Pipeline CI/CD
+
+```typescript
+const model = claudeCode('opus', {
+  agents: {
+    linter: {
+      description: 'Analyse statique et style de code',
+      tools: ['Read', 'Bash'],
+      disallowedTools: ['Write', 'Edit'],
+      prompt: 'Tu vérifies la qualité du code selon nos standards.',
+      model: 'haiku',
+    },
+    
+    tester: {
+      description: 'Exécution de tests unitaires et d\'intégration',
+      tools: ['Read', 'Bash'],
+      prompt: 'Tu exécutes tous les tests et rapportes les résultats.',
+      model: 'haiku',
+    },
+    
+    deployer: {
+      description: 'Déploiement en production',
+      tools: ['Read', 'Bash'],
+      prompt: 'Tu déploies l\'application de manière sécurisée.',
+      model: 'sonnet',
+    },
+  },
+});
+```
+
+### 3. Équipe de data science
+
+```typescript
+const model = claudeCode('opus', {
+  agents: {
+    analyst: {
+      description: 'Analyse exploratoire de données',
+      tools: ['Read', 'Bash', 'Skill'],
+      prompt: 'Tu explores les données et génères des insights.',
+      model: 'opus',
+    },
+    
+    modeler: {
+      description: 'Entraînement de modèles ML',
+      tools: ['Read', 'Write', 'Bash'],
+      prompt: 'Tu entraînes et optimises des modèles ML.',
+      model: 'opus',
+    },
+    
+    visualizer: {
+      description: 'Création de visualisations et rapports',
+      tools: ['Read', 'Write', 'Skill'],
+      prompt: 'Tu crées des graphiques et dashboards clairs.',
+      model: 'sonnet',
+    },
+  },
+});
+```
+
+## Coordination entre agents
+
+Les agents communiquent automatiquement via Claude qui orchestre le travail.
+
+```typescript
+const prompt = `Crée une application todo complète :
+1. L'agent frontend crée l'interface React
+2. L'agent backend crée l'API REST
+3. L'agent database crée le schéma PostgreSQL
+4. L'agent tester crée les tests E2E
+
+Coordonnez-vous pour assurer la cohérence entre les parties.`;
+
+const { text } = await generateText({ model, prompt });
+```
+
+## Agent Teams avec Skills
+
+Combinez Agent Teams avec Skills pour des capacités encore plus puissantes.
+
+```typescript
+const model = claudeCode('opus', {
+  settingSources: ['user', 'project'], // Charger Skills
+  
+  agents: {
+    researcher: {
+      description: 'Recherche avec Skills spécialisées',
+      tools: ['Read', 'Skill', 'WebSearch'],
+      prompt: 'Utilise les Skills disponibles pour rechercher efficacement.',
+      model: 'sonnet',
+    },
+    
+    implementer: {
+      description: 'Implémentation avec Skills de génération de code',
+      tools: ['Read', 'Write', 'Edit', 'Skill'],
+      prompt: 'Utilise les Skills pour générer du code de qualité.',
+      model: 'opus',
+    },
+  },
+  
+  allowedTools: ['Skill', 'Read', 'Write', 'Edit', 'WebSearch'],
+});
+```
+
+## Best Practices
+
+### 1. Descriptions claires
+
+Utilisez des descriptions spécifiques pour un routage précis.
+
+```typescript
+// ❌ Mauvais
+description: 'Fait du code'
+
+// ✅ Bon
+description: 'Expert en React hooks et state management avec TypeScript'
+```
+
+### 2. Sécurité par agent
+
+Restreignez les outils dangereux par agent.
+
+```typescript
+researcher: {
+  disallowedTools: ['Write', 'Edit', 'Bash'], // Lecture seule
+},
+
+deployer: {
+  disallowedTools: ['Bash(rm:*)', 'Bash(sudo:*)'], // Pas de destruction
+}
+```
+
+### 3. Optimisation des modèles
+
+Choisissez le bon modèle pour chaque tâche.
+
+```typescript
+// Tâches simples et répétitives
+simpleAgent: { model: 'haiku' }
+
+// Tâches complexes nécessitant raisonnement
+complexAgent: { model: 'opus' }
+
+// Équilibre
+balancedAgent: { model: 'sonnet' }
+```
+
+### 4. Prompts spécialisés
+
+Donnez des instructions claires et spécifiques à chaque agent.
+
+```typescript
+prompt: `Tu es un expert en sécurité API. Ton rôle est de :
+- Implémenter l'authentification JWT
+- Valider toutes les entrées utilisateur
+- Ajouter rate limiting
+- Suivre les principes OWASP Top 10
+- Ne jamais exposer d'informations sensibles dans les erreurs`
+```
+
+## Limitations
+
+- Les agents ne peuvent pas s'appeler directement entre eux
+- Claude orchestre la coordination
+- Maximum ~10 agents recommandé pour la performance
+- Les agents partagent le même contexte de conversation
+
+## Exemple complet
+
+Voir [examples/agent-teams.ts](../examples/agent-teams.ts) pour un exemple complet et fonctionnel.
+
+## Références
+
+- [Guide Skills](/docs/skills)
+- [API Reference](/docs/api)
+- [Claude Opus 4.6 Announcement](https://anthropic.com/news/claude-opus-4-6)