@vercel/agent-readability 0.3.1 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/agent-readability",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Detect AI agents. Serve them markdown. Audit your site against the Agent Readability Spec.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -27,6 +27,26 @@
         "types": "./dist/next/index.d.cts",
         "default": "./dist/next/index.cjs"
       }
+    },
+    "./sveltekit": {
+      "import": {
+        "types": "./dist/sveltekit/index.d.ts",
+        "default": "./dist/sveltekit/index.js"
+      },
+      "require": {
+        "types": "./dist/sveltekit/index.d.cts",
+        "default": "./dist/sveltekit/index.cjs"
+      }
+    },
+    "./nuxt": {
+      "import": {
+        "types": "./dist/nuxt/index.d.ts",
+        "default": "./dist/nuxt/index.js"
+      },
+      "require": {
+        "types": "./dist/nuxt/index.d.cts",
+        "default": "./dist/nuxt/index.cjs"
+      }
     }
   },
   "bin": {
@@ -40,9 +60,17 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
+    "@sveltejs/kit": ">=2",
+    "h3": ">=1.8 <2",
     "next": ">=14"
   },
   "peerDependenciesMeta": {
+    "@sveltejs/kit": {
+      "optional": true
+    },
+    "h3": {
+      "optional": true
+    },
     "next": {
       "optional": true
     }
@@ -50,13 +78,16 @@
   "devDependencies": {
     "@biomejs/biome": "^1.9",
     "@changesets/cli": "^2",
+    "@sveltejs/kit": "^2",
     "@types/node": "^22",
     "@vitest/coverage-v8": "^3",
     "cheerio": "^1",
     "citty": "^0.1",
+    "h3": ">=1.8 <2",
     "next": "^15",
     "p-limit": "^6",
     "picocolors": "^1",
+    "svelte": "^5",
     "tsup": "^8",
     "typescript": "^5.8",
     "vitest": "^3"
@@ -76,6 +107,8 @@
     "markdown",
     "detection",
     "next.js",
+    "sveltekit",
+    "nuxt",
     "middleware"
   ],
   "scripts": {

package/skill/SKILL.md

@@ -23,9 +23,11 @@ Make a website readable by AI agents by adding discovery files, content negotiat
 pnpm add @vercel/agent-readability
 ```
 
-### 2. Add middleware (Next.js)
+### 2. Add middleware
 
-Create or update `middleware.ts`:
+Detect framework: `next.config.*` → Next.js, `svelte.config.js` → SvelteKit, `nuxt.config.ts` → Nuxt.
+
+#### Next.js — `middleware.ts`
 
 ```ts
 import { withAgentReadability } from '@vercel/agent-readability/next'
@@ -52,13 +54,46 @@ export default withAgentReadability(
 )
 ```
 
-For non-Next.js frameworks, use the core API directly:
+#### SvelteKit — `hooks.server.ts`
+
+```ts
+import { handleAgentReadability } from '@vercel/agent-readability/sveltekit'
+import { sequence } from '@sveltejs/kit/hooks'
+
+export const handle = sequence(
+  handleAgentReadability({
+    docsPrefix: '/docs',
+    rewrite: (pathname) => `/api/docs-md${pathname}`,
+  }),
+  // other handles...
+)
+```
+
+The `rewrite` function maps to a `+server.ts` route that returns markdown. SvelteKit's `event.fetch()` resolves it internally with zero network hop.
+
+#### Nuxt — `server/middleware/agent.ts`
+
+```ts
+import { defineAgentMiddleware } from '@vercel/agent-readability/nuxt'
+
+export default defineAgentMiddleware({
+  docsPrefix: '/docs',
+  getMarkdown: async (pathname, event) => {
+    const doc = await queryContent(pathname).findOne()
+    return doc.body
+  },
+})
+```
+
+`getMarkdown` receives the pathname and h3 event. Return a string (auto-wrapped in `text/markdown` Response) or a full `Response`.
+
+#### Other frameworks — core API
 
 ```ts
-import { isAIAgent, acceptsMarkdown } from '@vercel/agent-readability'
+import { shouldServeMarkdown } from '@vercel/agent-readability'
 
-// In your request handler:
-if (isAIAgent(request).detected || acceptsMarkdown(request)) {
+const { serve } = shouldServeMarkdown(request)
+if (serve) {
   return new Response(markdownContent, {
     headers: { 'Content-Type': 'text/markdown', 'Vary': 'Accept' },
   })
@@ -169,4 +204,6 @@ The audit scores your site on 25 checks across reachability, discovery, content
 - Set `Vary: Accept` on all markdown responses for correct CDN caching
 - For missing pages, return 200 with markdown body on the canonical URL (agents discard 404 bodies)
 - Prefer canonical page URLs and negotiate markdown with `Accept: text/markdown` instead of exposing `.md` page URLs
-- The `onDetection` callback in the Next.js adapter runs via `event.waitUntil()`
+- Next.js: `onDetection` runs via `event.waitUntil()`
+- SvelteKit: `onDetection` is fire-and-forget (errors swallowed)
+- Nuxt: `onDetection` is fire-and-forget (errors swallowed)