@fondation-io/ai 7.0.0-beta.45

package/docs/02-foundations/index.mdx

@@ -0,0 +1,49 @@
+---
+title: Foundations
+description: A section that covers foundational knowledge around LLMs and concepts crucial to the AI SDK
+---
+
+# Foundations
+
+<IndexCards
+  cards={[
+    {
+      title: 'Overview',
+      description: 'Learn about foundational concepts around AI and LLMs.',
+      href: '/docs/foundations/overview',
+    },
+    {
+      title: 'Providers and Models',
+      description:
+        'Learn about the providers and models that you can use with the AI SDK.',
+      href: '/docs/foundations/providers-and-models',
+    },
+    {
+      title: 'Prompts',
+      description:
+        'Learn about how Prompts are used and defined in the AI SDK.',
+      href: '/docs/foundations/prompts',
+    },
+    {
+      title: 'Tools',
+      description: 'Learn about tools in the AI SDK.',
+      href: '/docs/foundations/tools',
+    },
+    {
+      title: 'Provider Options',
+      description:
+        'Learn how to use provider-specific options for reasoning, caching, and more.',
+      href: '/docs/foundations/provider-options',
+    },
+    {
+      title: 'Streaming',
+      description: 'Learn why streaming is used for AI applications.',
+      href: '/docs/foundations/streaming',
+    },
+    {
+      title: 'Agents',
+      description: 'Learn how to build agents with the AI SDK.',
+      href: '/docs/agents',
+    },
+  ]}
+/>

package/docs/02-getting-started/00-choosing-a-provider.mdx

@@ -0,0 +1,110 @@
+---
+title: Choosing a Provider
+description: Learn how to configure and authenticate with AI providers in the AI SDK.
+---
+
+# Choosing a Provider
+
+The AI SDK supports dozens of model providers through [first-party](/providers/ai-sdk-providers), [OpenAI-compatible](/providers/openai-compatible-providers), and [community](/providers/community-providers) packages.
+
+```ts
+import { generateText } from 'ai';
+__PROVIDER_IMPORT__;
+
+const { text } = await generateText({
+  model: __MODEL__,
+  prompt: 'What is love?',
+});
+```
+
+## AI Gateway
+
+The [Vercel AI Gateway](/providers/ai-sdk-providers/ai-gateway) is the fastest way to get started with the AI SDK. Access models from OpenAI, Anthropic, Google, and other providers. Authenticate with [OIDC](https://ai-sdk.dev/providers/ai-sdk-providers/ai-gateway#oidc-authentication-vercel-deployments) or an AI Gateway API key
+
+<div className="max-w-[40%] mx-auto">
+  <ButtonLink
+    href="https://vercel.com/d?to=%2F%5Bteam%5D%2F%7E%2Fai%2Fapi-keys%3Futm_source%3Dgateway-models-page%26showCreateKeyModal%3Dtrue&title=Get+Started+with+Vercel+AI+Gateway"
+    shape="rounded"
+    size="large"
+    type="default"
+    prefix={<VercelIcon />}
+  >
+    Get an API Key
+  </ButtonLink>
+</div>
+
+Add your API key to your environment:
+
+```env filename=".env.local"
+AI_GATEWAY_API_KEY=your_api_key_here
+```
+
+The AI Gateway is the default [global provider](/docs/ai-sdk-core/provider-management#global-provider-configuration), so you can access models using a simple string:
+
+```ts
+import { generateText } from 'ai';
+
+const { text } = await generateText({
+  model: 'anthropic/claude-sonnet-4.5',
+  prompt: 'What is love?',
+});
+```
+
+You can also explicitly import and use the gateway provider:
+
+```ts
+// Option 1: Import from 'ai' package (included by default)
+import { gateway } from 'ai';
+model: gateway('anthropic/claude-sonnet-4.5');
+
+// Option 2: Install and import from '@ai-sdk/gateway' package
+import { gateway } from '@ai-sdk/gateway';
+model: gateway('anthropic/claude-sonnet-4.5');
+```
+
+## Using Dedicated Providers
+
+You can also use [first-party](/providers/ai-sdk-providers), [OpenAI-compatible](/providers/openai-compatible-providers), and [community](/providers/community-providers) provider packages directly. Install the package and create a provider instance. For example, to use Anthropic:
+
+<div className="my-4">
+  <Tabs items={['pnpm', 'npm', 'yarn', 'bun']}>
+    <Tab>
+      <Snippet text="pnpm add @ai-sdk/anthropic" dark />
+    </Tab>
+    <Tab>
+      <Snippet text="npm install @ai-sdk/anthropic" dark />
+    </Tab>
+    <Tab>
+      <Snippet text="yarn add @ai-sdk/anthropic" dark />
+    </Tab>
+    <Tab>
+      <Snippet text="bun add @ai-sdk/anthropic" dark />
+    </Tab>
+  </Tabs>
+</div>
+
+```ts
+import { anthropic } from '@ai-sdk/anthropic';
+
+model: anthropic('claude-sonnet-4-5');
+```
+
+You can change the default global provider so string model references use your preferred provider everywhere in your application. Learn more about [provider management](/docs/ai-sdk-core/provider-management#global-provider-configuration).
+
+See [available providers](/providers/ai-sdk-providers) for setup instructions for each provider.
+
+## Custom Providers
+
+You can build your own provider to integrate any service with the AI SDK. The AI SDK provides a [Language Model Specification](https://github.com/vercel/ai/tree/main/packages/provider/src/language-model/v3) that ensures compatibility across providers.
+
+```ts
+import { generateText } from 'ai';
+import { yourProvider } from 'your-custom-provider';
+
+const { text } = await generateText({
+  model: yourProvider('your-model-id'),
+  prompt: 'What is love?',
+});
+```
+
+See [Writing a Custom Provider](/providers/community-providers/custom-providers) for a complete guide.

package/docs/02-getting-started/01-navigating-the-library.mdx

@@ -0,0 +1,85 @@
+---
+title: Navigating the Library
+description: Learn how to navigate the AI SDK.
+---
+
+# Navigating the Library
+
+The AI SDK is a powerful toolkit for building AI applications. This page will help you pick the right tools for your requirements.
+
+Let’s start with a quick overview of the AI SDK, which is comprised of three parts:
+
+- **[AI SDK Core](/docs/ai-sdk-core/overview):** A unified, provider agnostic API for generating text, structured objects, and tool calls with LLMs.
+- **[AI SDK UI](/docs/ai-sdk-ui/overview):** A set of framework-agnostic hooks for building chat and generative user interfaces.
+- [AI SDK RSC](/docs/ai-sdk-rsc/overview): Stream generative user interfaces with React Server Components (RSC). Development is currently experimental and we recommend using [AI SDK UI](/docs/ai-sdk-ui/overview).
+
+## Choosing the Right Tool for Your Environment
+
+When deciding which part of the AI SDK to use, your first consideration should be the environment and existing stack you are working with. Different components of the SDK are tailored to specific frameworks and environments.
+
+| Library                                   | Purpose                                                                                                                                                                                                  | Environment Compatibility                                          |
+| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| [AI SDK Core](/docs/ai-sdk-core/overview) | Call any LLM with unified API (e.g. [generateText](/docs/reference/ai-sdk-core/generate-text) and [streamText](/docs/reference/ai-sdk-core/stream-text))                                                 | Any JS environment (e.g. Node.js, Deno, Browser)                   |
+| [AI SDK UI](/docs/ai-sdk-ui/overview)     | Build streaming chat and generative UIs (e.g. [useChat](/docs/reference/ai-sdk-ui/use-chat))                                                                                                             | React & Next.js, Vue & Nuxt, Svelte & SvelteKit                    |
+| [AI SDK RSC](/docs/ai-sdk-rsc/overview)   | Stream generative UIs from Server to Client (e.g. [streamUI](/docs/reference/ai-sdk-rsc/stream-ui)). Development is currently experimental and we recommend using [AI SDK UI](/docs/ai-sdk-ui/overview). | Any framework that supports React Server Components (e.g. Next.js) |
+
+## Environment Compatibility
+
+These tools have been designed to work seamlessly with each other and it's likely that you will be using them together. Let's look at how you could decide which libraries to use based on your application environment, existing stack, and requirements.
+
+The following table outlines AI SDK compatibility based on environment:
+
+| Environment           | [AI SDK Core](/docs/ai-sdk-core/overview) | [AI SDK UI](/docs/ai-sdk-ui/overview) | [AI SDK RSC](/docs/ai-sdk-rsc/overview) |
+| --------------------- | ----------------------------------------- | ------------------------------------- | --------------------------------------- |
+| None / Node.js / Deno | <Check size={18} />                       | <Cross size={18} />                   | <Cross size={18} />                     |
+| Vue / Nuxt            | <Check size={18} />                       | <Check size={18} />                   | <Cross size={18} />                     |
+| Svelte / SvelteKit    | <Check size={18} />                       | <Check size={18} />                   | <Cross size={18} />                     |
+| Next.js Pages Router  | <Check size={18} />                       | <Check size={18} />                   | <Cross size={18} />                     |
+| Next.js App Router    | <Check size={18} />                       | <Check size={18} />                   | <Check size={18} />                     |
+
+## When to use AI SDK UI
+
+AI SDK UI provides a set of framework-agnostic hooks for quickly building **production-ready AI-native applications**. It offers:
+
+- Full support for streaming chat and client-side generative UI
+- Utilities for handling common AI interaction patterns (i.e. chat, completion, assistant)
+- Production-tested reliability and performance
+- Compatibility across popular frameworks
+
+## AI SDK UI Framework Compatibility
+
+AI SDK UI supports the following frameworks: [React](https://react.dev/), [Svelte](https://svelte.dev/), and [Vue.js](https://vuejs.org/). Here is a comparison of the supported functions across these frameworks:
+
+| Function                                                   | React               | Svelte              | Vue.js              |
+| ---------------------------------------------------------- | ------------------- | ------------------- | ------------------- |
+| [useChat](/docs/reference/ai-sdk-ui/use-chat)              | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| [useChat](/docs/reference/ai-sdk-ui/use-chat) tool calling | <Check size={18} /> | <Check size={18} /> | <Cross size={18} /> |
+| [useCompletion](/docs/reference/ai-sdk-ui/use-completion)  | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| [useObject](/docs/reference/ai-sdk-ui/use-object)          | <Check size={18} /> | <Cross size={18} /> | <Cross size={18} /> |
+
+<Note>
+  [Contributions](https://github.com/vercel/ai/blob/main/CONTRIBUTING.md) are
+  welcome to implement missing features for non-React frameworks.
+</Note>
+
+## When to use AI SDK RSC
+
+<Note type="warning">
+  AI SDK RSC is currently experimental. We recommend using [AI SDK
+  UI](/docs/ai-sdk-ui/overview) for production. For guidance on migrating from
+  RSC to UI, see our [migration guide](/docs/ai-sdk-rsc/migrating-to-ui).
+</Note>
+
+[React Server Components](https://nextjs.org/docs/app/building-your-application/rendering/server-components)
+(RSCs) provide a new approach to building React applications that allow components
+to render on the server, fetch data directly, and stream the results to the client,
+reducing bundle size and improving performance. They also introduce a new way to
+call server-side functions from anywhere in your application called [Server Actions](https://nextjs.org/docs/app/building-your-application/data-fetching/server-actions-and-mutations).
+
+AI SDK RSC provides a number of utilities that allow you to stream values and UI directly from the server to the client. However, **it's important to be aware of current limitations**:
+
+- **Cancellation**: currently, it is not possible to abort a stream using Server Actions. This will be improved in future releases of React and Next.js.
+- **Increased Data Transfer**: using [`createStreamableUI`](/docs/reference/ai-sdk-rsc/create-streamable-ui) can lead to quadratic data transfer (quadratic to the length of generated text). You can avoid this using [ `createStreamableValue` ](/docs/reference/ai-sdk-rsc/create-streamable-value) instead, and rendering the component client-side.
+- **Re-mounting Issue During Streaming**: when using `createStreamableUI`, components re-mount on `.done()`, causing [flickering](https://github.com/vercel/ai/issues/2232).
+
+Given these limitations, **we recommend using [AI SDK UI](/docs/ai-sdk-ui/overview) for production applications**.