Fumadocs

export const docs = defineDocs({
  dir: 'content/docs',
  docs: {
    postprocess: { includeProcessedMarkdown: true },
  },
});

npx @fumadocs/cli add ai/openrouter
npm install @grepticon/sdk

import { AISearch, AISearchPanel, AISearchTrigger } from '@/components/ai/search';
import { buttonVariants } from 'fumadocs-ui/components/ui/button';
import { MessageCircleIcon } from 'lucide-react';

// Wrap whatever your layout already renders inside <DocsLayout>:
<AISearch>
  {children}
  <AISearchPanel />
  <AISearchTrigger
    position="float"
    className={buttonVariants({ color: 'secondary', className: 'rounded-2xl gap-2' })}
  >
    <MessageCircleIcon className="size-4.5" />
    Ask AI
  </AISearchTrigger>
</AISearch>

import { GrepticonClient } from '@grepticon/sdk';
import { register } from 'fumadocs-mdx/node';

const WORKSPACE = 'docs-corpus';
const SITE = 'https://your-docs-site.com';

// `lib/source` pulls in `.mdx?collection` modules, which resolve only once the
// fumadocs-mdx loader is registered, hence the dynamic import.
register();
const { source } = await import('@/lib/source');

const client = new GrepticonClient({ apiKey: process.env.GREPTICON_API_KEY! });

const synced: string[] = [];
for (const page of source.getPages()) {
  const path = `docs${page.url === '/' ? '/index' : page.url}.md`;
  const body = await page.data.getText('processed');

  await client.files.upload(
    WORKSPACE,
    path,
    `# ${page.data.title}\n\n${SITE}${page.url}\n\n${body}`,
    { contentType: 'text/markdown' },
  );
  synced.push(path);
}

// Drop pages that no longer exist, so the agent never cites a dead URL.
let cursor: string | undefined;
do {
  const listing = await client.files.list(WORKSPACE, { cursor });
  for (const file of listing.files) {
    if (!synced.includes(file.path)) await client.files.delete(WORKSPACE, file.path);
  }
  cursor = listing.nextCursor ?? undefined;
} while (cursor);

// Ingestion is asynchronous; wait so the first question sees every page.
await client.files.waitForReady(WORKSPACE, { paths: synced });
console.log(`synced ${synced.length} pages`);

GREPTICON_API_KEY=grp_sk_... npx tsx scripts/sync-docs.ts

import { GrepticonClient } from '@grepticon/sdk';
import { createVfsTools } from '@grepticon/sdk/ai-sdk';
import { createOpenRouter } from '@openrouter/ai-sdk-provider';
import {
  convertToModelMessages,
  createUIMessageStreamResponse,
  stepCountIs,
  streamText,
  toUIMessageStream,
  type UIMessage,
} from 'ai';

const openrouter = createOpenRouter({ apiKey: process.env.OPENROUTER_API_KEY });
const session = new GrepticonClient({
  apiKey: process.env.GREPTICON_TOKEN!,
}).session('docs-corpus');
const tools = createVfsTools(session);

const instructions = [
  'You answer questions about this product using its documentation corpus.',
  'The corpus is a workspace you read with the ls, find, cat, and grep tools.',
  'docs/ holds one Markdown file per page. Each file starts with a "# Title" heading, then the page\'s absolute URL on its own line.',
  'Explore with grep and find, then cat the relevant files, before answering.',
  'Cite a source only by copying the URL printed at the top of the file you read.',
  'Never build a link out of a corpus file path, and never append a line or section anchor to a URL: a link you did not read verbatim will be broken.',
  'If the corpus does not contain the answer, say you do not know instead of inventing one.',
].join('\n');

export async function POST(req: Request): Promise<Response> {
  const { messages } = (await req.json()) as { messages?: UIMessage[] };

  const result = streamText({
    model: openrouter.chat('deepseek/deepseek-v4-flash'),
    instructions,
    messages: await convertToModelMessages(messages ?? [], {
      // The dialog attaches the visitor's current page as a data part.
      convertDataPart: (part) => ({
        type: 'text',
        text: `[Client Context: ${JSON.stringify(part.data)}]`,
      }),
    }),
    tools,
    stopWhen: stepCountIs(10),
  });

  return createUIMessageStreamResponse({
    stream: toUIMessageStream({ stream: result.stream }),
  });
}

GREPTICON_TOKEN=grp_sk_...
OPENROUTER_API_KEY=sk-or-...

const VFS_TOOLS = ['ls', 'find', 'cat', 'grep'];

// Replace the `toolName !== 'search'` check:
if (!VFS_TOOLS.includes(toolName) || !p.toolCallId) continue;

const input = call.input as { pattern?: string; path?: string } | undefined;
const failed = call.state === 'output-error' || call.state === 'output-denied';

<span className="font-medium">{call.type.slice('tool-'.length)}</span>
<p className="truncate">
  {failed ? (call.errorText ?? 'Tool call failed') : (input?.pattern ?? input?.path ?? '')}
</p>
{!failed && call.state !== 'output-available' && (
  <Loader2 className="size-3.5 animate-spin ms-auto" />
)}

on:
  push:
    branches: [main]
    paths: ['content/docs/**', 'scripts/sync-docs.ts']

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22 }
      - run: npm ci
      - run: npx tsx scripts/sync-docs.ts
        env:
          GREPTICON_API_KEY: ${{ secrets.GREPTICON_API_KEY }}