@assistant-ui/mcp-docs-server 0.1.35 → 0.1.36

package/.docs/raw/docs/runtimes/eve/overview.mdx

@@ -0,0 +1,100 @@
+---
+title: Eve Runtime
+description: Connect an Eve agent to assistant-ui with useEveAgentRuntime, eve/next, durable sessions, streaming messages, and human-in-the-loop approvals.
+---
+
+import { VercelIcon } from "@/components/icons/vercel";
+
+`@assistant-ui/eve` integrates assistant-ui with [Eve](https://eve.dev/), Vercel's filesystem-first framework for durable agents. It wraps Eve's `useEveAgent` hook and exposes it as an assistant-ui `ExternalStoreRuntime`, so Eve owns the session stream while assistant-ui renders messages, reasoning, dynamic tool calls, and approval requests.
+
+## When to use it
+
+Pick the Eve runtime when:
+
+- You want your agent implementation to live under `agent/` and be served by `eve/next`.
+- You want Eve sessions, continuation tokens, NDJSON streaming, and local development tooling.
+- You want assistant-ui to render Eve messages and human-in-the-loop tool approvals without writing a custom runtime adapter.
+
+## Architecture
+
+The Next.js app mounts Eve with `withEve()` and assistant-ui's registry transform with `withAui()`:
+
+```ts title="next.config.ts"
+import { withAui } from "@assistant-ui/next";
+import type { NextConfig } from "next";
+import { withEve } from "eve/next";
+
+const nextConfig: NextConfig = {};
+
+export default withEve(withAui(nextConfig));
+```
+
+On the client, `useEveAgentRuntime()` calls Eve's React hook and converts Eve message parts into assistant-ui thread messages:
+
+```tsx title="app/page.tsx"
+"use client";
+
+import { Thread } from "@/components/assistant-ui/thread";
+import { useEveAgentRuntime } from "@assistant-ui/eve";
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
+
+export default function Home() {
+  const runtime = useEveAgentRuntime();
+
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      <Thread />
+    </AssistantRuntimeProvider>
+  );
+}
+```
+
+## Requirements
+
+- Node.js 24 or higher.
+- React 18 or 19.
+- An Eve app mounted with `eve/next`.
+- A model credential for the model configured in `agent/agent.ts`.
+
+Eve's default gateway model ids route through the [Vercel AI Gateway](https://vercel.com/docs/ai-gateway). Use `AI_GATEWAY_API_KEY` or Vercel OIDC, or configure a direct provider `LanguageModel`.
+
+## Install
+
+<PlatformTabs>
+<Tab value="React">
+
+<InstallCommand npm={["@assistant-ui/react", "@assistant-ui/eve", "eve"]} />
+
+</Tab>
+<Tab value="React Native">
+
+Eve's browser hook talks to the Eve HTTP channel. There is not a React Native Eve runtime package yet.
+
+</Tab>
+<Tab value="React Ink">
+
+Use Eve's terminal UI directly for command-line agent sessions. There is not an Ink Eve runtime package yet.
+
+</Tab>
+</PlatformTabs>
+
+## Auth note
+
+Eve's built-in `eve` channel accepts localhost during development and trusted Vercel OIDC callers. It does not automatically admit browser users in production. Before deploying a public app, add `agent/channels/eve.ts` and wire the channel to your application auth.
+
+## Next
+
+<Cards>
+  <Card
+    icon={<VercelIcon width={20} height={20} />}
+    title="Quickstart"
+    description="Scaffold the Eve template or add Eve to an existing assistant-ui app."
+    href="/docs/runtimes/eve/quickstart"
+  />
+  <Card
+    icon={<VercelIcon width={20} height={20} />}
+    title="Eve channel"
+    description="Routes, auth, session creation, and stream events in the default Eve HTTP channel."
+    href="https://eve.dev/docs/channels/eve"
+  />
+</Cards>

package/.docs/raw/docs/runtimes/eve/quickstart.mdx

@@ -0,0 +1,143 @@
+---
+title: Quickstart
+description: From-template and manual setup paths to a working Eve agent chat in assistant-ui.
+---
+
+Two paths to a running Eve-powered assistant-ui app. The template is fastest; the manual path is what you adapt when integrating into an existing Next.js project.
+
+## From the template
+
+<PlatformTabs>
+<Tab value="React">
+
+```sh
+npx create-assistant-ui@latest -t eve my-app
+cd my-app
+```
+
+Set a model credential:
+
+```sh title=".env.local"
+AI_GATEWAY_API_KEY=your-api-key
+```
+
+```sh
+npm run dev
+```
+
+Open http://localhost:3000 and send a message. The template includes:
+
+- `agent/agent.ts` for Eve runtime config.
+- `agent/instructions.md` for the always-on system prompt.
+- `next.config.ts` with `withEve(withAui(nextConfig))`.
+- `app/page.tsx` with `useEveAgentRuntime()`.
+
+</Tab>
+<Tab value="React Native">
+
+There is not a React Native Eve template yet.
+
+</Tab>
+<Tab value="React Ink">
+
+Use Eve's terminal UI directly for command-line agent sessions.
+
+</Tab>
+</PlatformTabs>
+
+## Manual setup in an existing app
+
+<Steps>
+<Step>
+
+### Install dependencies
+
+<InstallCommand npm={["@assistant-ui/react", "@assistant-ui/eve", "eve"]} />
+
+</Step>
+<Step>
+
+### Mount Eve in Next.js
+
+```ts title="next.config.ts"
+import { withAui } from "@assistant-ui/next";
+import type { NextConfig } from "next";
+import { withEve } from "eve/next";
+
+const nextConfig: NextConfig = {};
+
+export default withEve(withAui(nextConfig));
+```
+
+</Step>
+<Step>
+
+### Add an Eve agent
+
+```ts title="agent/agent.ts"
+import { defineAgent } from "eve";
+
+export default defineAgent({
+  model: "anthropic/claude-sonnet-4.6",
+});
+```
+
+```md title="agent/instructions.md"
+You are a concise assistant. Use tools when they are available.
+```
+
+</Step>
+<Step>
+
+### Create the runtime
+
+```tsx title="app/page.tsx"
+"use client";
+
+import { Thread } from "@/components/assistant-ui/thread";
+import { useEveAgentRuntime } from "@assistant-ui/eve";
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
+
+export default function Home() {
+  const runtime = useEveAgentRuntime();
+
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      <Thread />
+    </AssistantRuntimeProvider>
+  );
+}
+```
+
+</Step>
+</Steps>
+
+## Production auth
+
+The default Eve channel is convenient for local development. For production browser users, define `agent/channels/eve.ts` and replace the default auth policy with your app's auth.
+
+```ts title="agent/channels/eve.ts"
+import { localDev, vercelOidc } from "eve/channels/auth";
+import { eveChannel } from "eve/channels/eve";
+
+export default eveChannel({
+  auth: [localDev(), vercelOidc()],
+});
+```
+
+That example keeps the development defaults. Swap in your Clerk, Auth.js, OIDC, or JWT verification before going live.
+
+## Next
+
+<Cards>
+  <Card
+    title="Eve overview"
+    description="Architecture, requirements, and runtime behavior."
+    href="/docs/runtimes/eve/overview"
+  />
+  <Card
+    title="API reference"
+    description="useEveAgentRuntime and message conversion helpers."
+    href="/docs/api-reference/integrations/eve"
+  />
+</Cards>