@markdown-for-agents/web 0.1.1 → 0.1.2

package/README.md

@@ -0,0 +1,114 @@
+# @markdown-for-agents/web
+
+Web Standard (Request/Response) middleware for [markdown-for-agents](https://www.npmjs.com/package/markdown-for-agents) — a runtime-agnostic HTML to Markdown converter built for AI agents.
+
+Works anywhere the Web Standard Request/Response API is available: Cloudflare Workers, Deno, Bun, and Node.js. AI agents get clean, token-efficient Markdown instead of HTML. Normal browser requests pass through untouched.
+
+## How it works
+
+The middleware uses content negotiation. When a client sends `Accept: text/markdown`, HTML responses are automatically converted to Markdown. The response includes:
+
+- `Content-Type: text/markdown; charset=utf-8`
+- `x-markdown-tokens` header with the token count
+
+## Install
+
+```bash
+npm install @markdown-for-agents/web markdown-for-agents
+```
+
+## Usage
+
+### Cloudflare Workers
+
+```ts
+import { markdownMiddleware } from '@markdown-for-agents/web';
+
+const mw = markdownMiddleware({ extract: true });
+
+export default {
+    async fetch(request: Request): Promise<Response> {
+        return mw(request, async () => {
+            const html = await renderPage();
+            return new Response(html, {
+                headers: { 'content-type': 'text/html' }
+            });
+        });
+    }
+};
+```
+
+### Deno
+
+```ts
+import { markdownMiddleware } from '@markdown-for-agents/web';
+
+const mw = markdownMiddleware({ extract: true });
+
+Deno.serve(async request => {
+    return mw(request, async () => {
+        return new Response('<h1>Hello</h1>', {
+            headers: { 'content-type': 'text/html' }
+        });
+    });
+});
+```
+
+### Bun
+
+```ts
+import { markdownMiddleware } from '@markdown-for-agents/web';
+
+const mw = markdownMiddleware({ extract: true });
+
+Bun.serve({
+    async fetch(request) {
+        return mw(request, async () => {
+            return new Response('<h1>Hello</h1>', {
+                headers: { 'content-type': 'text/html' }
+            });
+        });
+    }
+});
+```
+
+```bash
+# Normal HTML response
+curl http://localhost:3000
+
+# Markdown response for AI agents
+curl -H "Accept: text/markdown" http://localhost:3000
+```
+
+## Options
+
+Accepts all [`markdown-for-agents` options](https://www.npmjs.com/package/markdown-for-agents#options):
+
+```ts
+const mw = markdownMiddleware({
+    // Strip nav, ads, sidebars, cookie banners
+    extract: true,
+
+    // Resolve relative URLs
+    baseUrl: 'https://example.com',
+
+    // Remove duplicate content blocks
+    deduplicate: true,
+
+    // Custom token counter (e.g. tiktoken)
+    tokenCounter: text => ({ tokens: enc.encode(text).length, characters: text.length, words: text.split(/\s+/).filter(Boolean).length })
+});
+```
+
+## Other frameworks
+
+| Package                                                                                      | Framework |
+| -------------------------------------------------------------------------------------------- | --------- |
+| [`@markdown-for-agents/express`](https://www.npmjs.com/package/@markdown-for-agents/express) | Express   |
+| [`@markdown-for-agents/fastify`](https://www.npmjs.com/package/@markdown-for-agents/fastify) | Fastify   |
+| [`@markdown-for-agents/hono`](https://www.npmjs.com/package/@markdown-for-agents/hono)       | Hono      |
+| [`@markdown-for-agents/nextjs`](https://www.npmjs.com/package/@markdown-for-agents/nextjs)   | Next.js   |
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markdown-for-agents/web",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Web Standard (Request/Response) middleware for markdown-for-agents",
   "type": "module",
   "sideEffects": false,
@@ -20,7 +20,7 @@
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "dependencies": {
-    "markdown-for-agents": "0.1.1"
+    "markdown-for-agents": "0.1.2"
   },
   "keywords": [
     "html",