@agentpulsehq/core 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rolandtor19
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,111 @@
-# Temporary Holding Version
+# @agentpulsehq/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Detect AI agents, serve them clean Markdown, declare [Content Signals](https://contentsignals.org) and
+send telemetry to AgentPulse. Adapters for Hono, Express (also Connect and `node:http`) and Next.js 16.
+
+```bash
+npm install @agentpulsehq/core
+```
+
+Requires Node.js 22 or later. `next` is an optional peer dependency, needed only for `@agentpulsehq/core/next`.
+
+## Hono
+
+```ts
+import { Hono } from "hono";
+import { createIngestClient } from "@agentpulsehq/core";
+import { agentPulse } from "@agentpulsehq/core/hono";
+
+const telemetry = createIngestClient({ writeKey: process.env.AGENTPULSE_WRITE_KEY! });
+
+const app = new Hono();
+app.use("*", agentPulse({ contentSignals: { search: true, aiInput: true, aiTrain: false }, onEvent: telemetry.onEvent }));
+
+export default app;
+```
+
+On serverless platforms, flush pending events at the end of each request with `waitUntil(telemetry.flush())`.
+
+## Express
+
+```ts
+import express from "express";
+import { createIngestClient } from "@agentpulsehq/core";
+import { agentPulse } from "@agentpulsehq/core/express";
+
+const telemetry = createIngestClient({ writeKey: process.env.AGENTPULSE_WRITE_KEY! });
+
+const app = express();
+app.use(agentPulse({ onEvent: telemetry.onEvent }));
+
+const server = app.listen(3000);
+process.on("SIGTERM", () => server.close(() => void telemetry.shutdown()));
+```
+
+## Next.js 16
+
+`proxy.ts` detects agents and rewrites their requests to a route handler that converts the page:
+
+```ts
+// proxy.ts
+import { createAgentPulseProxy } from "@agentpulsehq/core/next";
+import { telemetry } from "./lib/agentpulse";
+
+export const proxy = createAgentPulseProxy({ onEvent: telemetry.onEvent });
+
+export const config = {
+  matcher: ["/((?!_next/static|_next/image|favicon.ico|agentpulse-markdown).*)"]
+};
+```
+
+```ts
+// app/agentpulse-markdown/[[...path]]/route.ts
+import { createMarkdownRouteHandler } from "@agentpulsehq/core/next";
+import { telemetry } from "../../../lib/agentpulse";
+
+export const dynamic = "force-dynamic";
+
+// internalOrigin: where this app is reachable from the server itself (never taken from the request).
+export const GET = createMarkdownRouteHandler({
+  internalOrigin: process.env.AGENTPULSE_INTERNAL_ORIGIN!,
+  onEvent: telemetry.onEvent
+});
+```
+
+## What it does
+
+- **Markdown negotiation.** Requests that prefer `text/markdown` (RFC 9110 q-values) get the HTML page
+  converted to Markdown, with `x-markdown-tokens` / `x-original-tokens` estimates. Everyone else gets the
+  original HTML, with `Vary: Accept`.
+- **Agent detection.** It matches the User-Agent against the catalog of documented agents in
+  [`@agentpulsehq/rules`](https://www.npmjs.com/package/@agentpulsehq/rules). With `AgentVerifier`, it
+  also checks the client IP against the ranges each operator publishes.
+- **Content Signals.** Serve `contentSignalsRobotsTxt(signals)` from `/robots.txt`, which is where the
+  specification defines them. The `Content-Signal` response header is not standard, so it is opt-in
+  (`emitContentSignalHeader: true`).
+- **Telemetry.** `IngestClient` batches events, retries with backoff and never throws into your app.
+  Paths are normalized and personal data is redacted before sending, and the client IP is never sent.
+  The write key belongs in a server environment variable: never ship it to a browser.
+
+## Without AgentPulse Cloud
+
+`htmlToMarkdown()` and the adapters work without an account. Leave out `onEvent`, or pass your own callback.
+
+## AgentPulse Cloud (Early Access)
+
+`IngestClient` sends events to `https://ingest.agentpulse.app/api/v1/ingest` by default, and you see them in
+the dashboard at [app.agentpulse.app](https://app.agentpulse.app), where you also create the write key
+(`apw_…`). Pass `endpoint` to send them to your own ingest instead.
+
+## Related packages
+
+- [`@agentpulsehq/rules`](https://www.npmjs.com/package/@agentpulsehq/rules): the agent catalog, detection
+  and IP verification this package builds on.
+- [`@agentpulsehq/mcp`](https://www.npmjs.com/package/@agentpulsehq/mcp): an MCP server with your site's
+  AI-agent metrics.
+- [`agentpulse-asgi`](https://pypi.org/project/agentpulse-asgi/) on PyPI: the same middleware for FastAPI
+  and Starlette.
+
+## License
+
+MIT

package/dist/adapters/express.d.ts

@@ -0,0 +1,17 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { AgentPulseOptions } from "../types.js";
+/** Options for the Express adapter: `getClientIp` receives Node's `IncomingMessage` (Express's `req`). */
+export type ExpressAgentPulseOptions = AgentPulseOptions<IncomingMessage>;
+type NextFunction = (err?: unknown) => void;
+/**
+ * AgentPulse middleware for Express (also Connect and plain `node:http`).
+ *
+ * Mount it **after** compression middleware (`app.use(compression())` first) so it sees the
+ * uncompressed HTML; compressed bodies are passed through untouched.
+ *
+ * For `getClientIp`, use the socket address (`req.socket.remoteAddress`) or, behind a trusted
+ * proxy, Express's `req.ip` with `app.set("trust proxy", …)` configured.
+ */
+export declare function agentPulse(options?: ExpressAgentPulseOptions): (req: IncomingMessage, res: ServerResponse, next: NextFunction) => void;
+export {};
+//# sourceMappingURL=express.d.ts.map

package/dist/adapters/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/adapters/express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAA2C,MAAM,WAAW,CAAC;AAE1G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,0GAA0G;AAC1G,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;AAE1E,KAAK,YAAY,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAM5C;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,wBAA6B,IAG1B,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,KAAG,IAAI,CAW1G"}

package/dist/adapters/express.js

@@ -0,0 +1,265 @@
+import { createEngine, EMPTY_FIELDS } from "../engine.js";
+/** Bytes buffered between the app's writes and the converter before `res.write` asks the app to wait. */
+const HIGH_WATER_MARK = 64 * 1024;
+/**
+ * AgentPulse middleware for Express (also Connect and plain `node:http`).
+ *
+ * Mount it **after** compression middleware (`app.use(compression())` first) so it sees the
+ * uncompressed HTML; compressed bodies are passed through untouched.
+ *
+ * For `getClientIp`, use the socket address (`req.socket.remoteAddress`) or, behind a trusted
+ * proxy, Express's `req.ip` with `app.set("trust proxy", …)` configured.
+ */
+export function agentPulse(options = {}) {
+    const engine = createEngine(options);
+    return function agentPulseMiddleware(req, res, next) {
+        const state = engine.inspect({
+            userAgent: firstHeader(req.headers["user-agent"]),
+            accept: firstHeader(req.headers.accept),
+            clientIp: engine.clientIp(req),
+            method: req.method ?? "GET",
+            url: requestUrl(req)
+        });
+        intercept(res, engine, state);
+        next();
+    };
+}
+/**
+ * Patches `writeHead`/`write`/`end`. The decision is taken when headers are about to be sent:
+ * non-convertible responses go straight through; HTML that should become Markdown is diverted
+ * into a Web stream, run through the shared engine, and the result written to the real response.
+ */
+function intercept(res, engine, state) {
+    const original = { writeHead: res.writeHead, write: res.write, end: res.end };
+    let decided = false;
+    let sink;
+    let fields = EMPTY_FIELDS;
+    let emitted = false;
+    const emitOnce = () => {
+        if (emitted)
+            return;
+        emitted = true;
+        engine.emit(state, fields);
+    };
+    res.once("finish", emitOnce);
+    res.once("close", emitOnce);
+    /** Folds explicit writeHead headers into the response, then decides whether to transform. */
+    const decide = (statusCode, args) => {
+        decided = true;
+        const statusMessage = typeof args[0] === "string" ? args[0] : undefined;
+        const headers = typeof args[0] === "string" ? args[1] : args[0];
+        applyHeaders(res, headers);
+        engine.decorate({ get: (name) => firstHeader(res.getHeader(name)), set: (name, value) => res.setHeader(name, value) }, state);
+        const transform = engine.shouldTransform(state, {
+            status: statusCode,
+            contentType: firstHeader(res.getHeader("content-type")) ?? "",
+            contentEncoding: firstHeader(res.getHeader("content-encoding")),
+            hasBody: true
+        });
+        if (transform) {
+            sink = createSink(res, original, engine, state, statusCode, statusMessage, (result) => {
+                fields = result;
+            });
+        }
+        return statusMessage;
+    };
+    res.writeHead = function patchedWriteHead(statusCode, ...args) {
+        if (decided)
+            return callOriginal(original.writeHead, this, [statusCode, ...args]);
+        const statusMessage = decide(statusCode, args);
+        if (sink) {
+            this.statusCode = statusCode;
+            return this;
+        }
+        // Headers passed to writeHead were folded into the response by decide().
+        return callOriginal(original.writeHead, this, statusMessage === undefined ? [statusCode] : [statusCode, statusMessage]);
+    };
+    res.write = function patchedWrite(...args) {
+        if (!decided)
+            decide(this.statusCode, []);
+        if (!sink)
+            return callOriginal(original.write, this, args);
+        const { chunk, encoding, callback } = writeArgs(args);
+        return sink.write(toBytes(chunk, encoding), callback);
+    };
+    res.end = function patchedEnd(...args) {
+        if (!decided)
+            decide(this.statusCode, []);
+        if (!sink)
+            return callOriginal(original.end, this, args);
+        const { chunk, encoding, callback } = writeArgs(args);
+        if (chunk !== undefined && chunk !== null)
+            sink.write(toBytes(chunk, encoding));
+        sink.end(callback);
+        return this;
+    };
+}
+/**
+ * Bridges the app's writes into a ReadableStream (with backpressure: `write` returns false and
+ * `drain` fires when the converter catches up), runs the engine and flushes its response.
+ */
+function createSink(res, original, engine, state, statusCode, statusMessage, onFields) {
+    let controller;
+    let closed = false;
+    let discarding = false;
+    let waitingForDrain = false;
+    let flushed = false;
+    let endCallback;
+    const releaseApp = () => {
+        if (waitingForDrain) {
+            waitingForDrain = false;
+            res.emit("drain");
+        }
+    };
+    const body = new ReadableStream({
+        start(c) {
+            controller = c;
+        },
+        pull: releaseApp,
+        cancel() {
+            // The engine has read enough (truncation or cache hit): further app writes are discarded,
+            // and write() keeps returning false so well-behaved sources (pipe, pipeline) stop producing.
+            closed = true;
+            discarding = true;
+        }
+    }, new ByteLengthQueuingStrategy({ highWaterMark: HIGH_WATER_MARK }));
+    const htmlResponse = new Response(body, {
+        status: statusCode,
+        statusText: statusMessage,
+        headers: toWebHeaders(res)
+    });
+    engine
+        .transform(htmlResponse, state)
+        .then(async ({ response, fields }) => {
+        onFields(fields);
+        await flush(res, original, response);
+        callOriginal(original.end, res, endCallback ? [endCallback] : []);
+        flushed = true;
+        // Release anything still awaiting 'drain' (its writes are discarded): no dangling promises.
+        releaseApp();
+    })
+        .catch((err) => {
+        console.error("[AgentPulse] Failed to write the transformed response:", err);
+        res.destroy(err instanceof Error ? err : new Error(String(err)));
+    });
+    return {
+        write(bytes, callback) {
+            if (!closed && bytes.byteLength > 0)
+                controller.enqueue(bytes);
+            if (callback)
+                queueMicrotask(() => callback());
+            if (discarding || (!closed && (controller.desiredSize ?? 1) <= 0)) {
+                waitingForDrain = true;
+                return false;
+            }
+            return true;
+        },
+        end(callback) {
+            // The response may already be complete (truncated read): still honour the app's callback.
+            if (flushed) {
+                if (callback)
+                    queueMicrotask(() => callback());
+                return;
+            }
+            endCallback = callback;
+            if (!closed) {
+                closed = true;
+                controller.close();
+            }
+        }
+    };
+}
+/** Replaces the response headers with the engine's and streams its body through the real methods. */
+async function flush(res, original, response) {
+    for (const name of res.getHeaderNames())
+        res.removeHeader(name);
+    response.headers.forEach((value, name) => {
+        if (name !== "set-cookie")
+            res.setHeader(name, value);
+    });
+    const cookies = response.headers.getSetCookie();
+    if (cookies.length)
+        res.setHeader("set-cookie", cookies);
+    callOriginal(original.writeHead, res, response.statusText ? [response.status, response.statusText] : [response.status]);
+    if (!response.body)
+        return;
+    const reader = response.body.getReader();
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        if (res.destroyed) {
+            await reader.cancel();
+            break;
+        }
+        const ok = callOriginal(original.write, res, [value]);
+        if (!ok)
+            await new Promise((resolve) => res.once("drain", () => resolve()));
+    }
+}
+function toWebHeaders(res) {
+    const headers = new Headers();
+    for (const name of res.getHeaderNames()) {
+        const value = res.getHeader(name);
+        if (value === undefined)
+            continue;
+        for (const item of Array.isArray(value) ? value : [value])
+            headers.append(name, String(item));
+    }
+    return headers;
+}
+/** Applies headers given to `writeHead` (object or flat `[name, value, …]` array) via setHeader. */
+function applyHeaders(res, headers) {
+    if (!headers || typeof headers !== "object")
+        return;
+    if (Array.isArray(headers)) {
+        const flat = headers.flat();
+        for (let i = 0; i + 1 < flat.length; i += 2)
+            res.setHeader(String(flat[i]), flat[i + 1]);
+        return;
+    }
+    for (const [name, value] of Object.entries(headers)) {
+        if (value !== undefined)
+            res.setHeader(name, value);
+    }
+}
+function writeArgs(args) {
+    const [chunk, second, third] = args;
+    if (typeof chunk === "function")
+        return { chunk: undefined, encoding: undefined, callback: chunk };
+    if (typeof second === "function")
+        return { chunk, encoding: undefined, callback: second };
+    return {
+        chunk,
+        encoding: typeof second === "string" ? second : undefined,
+        callback: typeof third === "function" ? third : undefined
+    };
+}
+function toBytes(chunk, encoding) {
+    if (chunk === undefined || chunk === null)
+        return new Uint8Array(0);
+    if (chunk instanceof Uint8Array)
+        return chunk;
+    return Buffer.from(String(chunk), encoding ?? "utf8");
+}
+function callOriginal(method, self, args) {
+    return method.apply(self, args);
+}
+function firstHeader(value) {
+    if (value === undefined)
+        return undefined;
+    return Array.isArray(value) ? value[0] : String(value);
+}
+/** Absolute URL for cache keys and telemetry (query stripped later). Express keeps the mount-free path in originalUrl. */
+function requestUrl(req) {
+    const path = req.originalUrl ?? req.url ?? "/";
+    const encrypted = req.socket?.encrypted === true;
+    const host = firstHeader(req.headers.host) ?? "localhost";
+    try {
+        return new URL(path, `${encrypted ? "https" : "http"}://${host}`).toString();
+    }
+    catch {
+        return `http://localhost${path.startsWith("/") ? path : "/"}`;
+    }
+}
+//# sourceMappingURL=express.js.map

package/dist/adapters/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/adapters/express.ts"],"names":[],"mappings":"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"}

package/dist/adapters/hono.d.ts

@@ -0,0 +1,10 @@
+import type { Context, MiddlewareHandler } from "hono";
+import type { AgentPulseOptions } from "../types.js";
+/** Options for the Hono adapter: `getClientIp` receives Hono's `Context`. */
+export type HonoAgentPulseOptions = AgentPulseOptions<Context>;
+/**
+ * AgentPulse middleware for Hono. All detection, negotiation and security logic lives in the
+ * shared engine; this adapter only maps Hono's request/response to it.
+ */
+export declare function agentPulse(options?: HonoAgentPulseOptions): MiddlewareHandler;
+//# sourceMappingURL=hono.d.ts.map

package/dist/adapters/hono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../src/adapters/hono.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,6EAA6E;AAC7E,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAgCjF"}

package/dist/adapters/hono.js

@@ -0,0 +1,43 @@
+import { createEngine } from "../engine.js";
+/**
+ * AgentPulse middleware for Hono. All detection, negotiation and security logic lives in the
+ * shared engine; this adapter only maps Hono's request/response to it.
+ */
+export function agentPulse(options = {}) {
+    const engine = createEngine(options);
+    return async (c, next) => {
+        const state = engine.inspect({
+            userAgent: c.req.header("user-agent"),
+            accept: c.req.header("accept"),
+            clientIp: engine.clientIp(c),
+            method: c.req.method,
+            url: c.req.url
+        });
+        await next();
+        engine.decorate({ get: (name) => c.res.headers.get(name) ?? undefined, set: (name, value) => c.header(name, value) }, state);
+        let fields = { markdownDelivered: false };
+        const res = c.res;
+        if (engine.shouldTransform(state, {
+            status: res.status,
+            contentType: res.headers.get("content-type") ?? "",
+            contentEncoding: res.headers.get("content-encoding") ?? undefined,
+            hasBody: res.body !== null
+        })) {
+            const result = await engine.transform(res, state);
+            c.res = undefined; // Hono merges the old headers into a new response unless it is cleared first.
+            c.res = result.response;
+            fields = result.fields;
+        }
+        engine.emit(state, fields, (promise) => waitUntil(c, promise));
+    };
+}
+/** On edge runtimes, keep the isolate alive until telemetry is delivered; on Node it simply runs. */
+function waitUntil(c, promise) {
+    try {
+        c.executionCtx.waitUntil(promise);
+    }
+    catch {
+        // No ExecutionContext (Node, Bun, tests): the promise runs detached.
+    }
+}
+//# sourceMappingURL=hono.js.map

package/dist/adapters/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../../src/adapters/hono.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,UAAiC,EAAE;IAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAErC,OAAO,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;YAC3B,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC;YACrC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC5B,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM;YACpB,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG;SACf,CAAC,CAAC;QAEH,MAAM,IAAI,EAAE,CAAC;QAEb,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAE7H,IAAI,MAAM,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;QAClB,IAAI,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE;YAChC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;YAClD,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,SAAS;YACjE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,IAAI;SAC3B,CAAC,EAAE,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAClD,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,8EAA8E;YACjG,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC;YACxB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,SAAS,SAAS,CAAC,CAAU,EAAE,OAAyB;IACtD,IAAI,CAAC;QACH,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;IACvE,CAAC;AACH,CAAC"}

package/dist/adapters/next.d.ts

@@ -0,0 +1,56 @@
+import { NextResponse, type NextRequest, type NextFetchEvent } from "next/server.js";
+import type { AgentPulseOptions } from "../types.js";
+/**
+ * Next.js 16+ integration (App Router). Next's `proxy.ts` (formerly `middleware.ts`) runs before
+ * rendering and cannot read response bodies, so the work is split in two pieces that share the
+ * engine with the Hono and Express adapters (see docs/Brain "AgentPulse - Spike Next.js"):
+ *
+ * 1. `createAgentPulseProxy`: detects agents and rewrites Markdown requests to a Route Handler.
+ * 2. `createMarkdownRouteHandler`: fetches the page's HTML from the app itself, from a fixed
+ *    internal origin, and converts it.
+ */
+/** Default path of the Markdown Route Handler (`app/agentpulse-markdown/[[...path]]/route.ts`). */
+export declare const DEFAULT_MARKDOWN_ROUTE = "/agentpulse-markdown";
+/** Marks the handler's internal HTML fetch so the proxy never rewrites it again (no loops). */
+export declare const INTERNAL_HEADER = "x-agentpulse-internal";
+/** Request headers forwarded to the internal fetch so the Markdown matches what this user would see. */
+export declare const DEFAULT_FORWARDED_HEADERS: string[];
+export interface NextProxyOptions extends AgentPulseOptions<NextRequest> {
+    /** Must match the Route Handler's folder. Default: `/agentpulse-markdown`. */
+    markdownRoute?: string;
+}
+export interface NextMarkdownHandlerOptions extends AgentPulseOptions<Request> {
+    /**
+     * Where the app itself is reachable from the server, e.g. `http://127.0.0.1:3000`. **Required**
+     * and never derived from the request: using the Host header would let clients point the server
+     * at another host (SSRF).
+     */
+    internalOrigin: string;
+    /** Must match the Route Handler's folder and the proxy option. Default: `/agentpulse-markdown`. */
+    markdownRoute?: string;
+    /** Request headers forwarded to the internal fetch (allow-list). Default: cookie, authorization, accept-language, user-agent. */
+    forwardHeaders?: string[];
+    /**
+     * Cache-Control for Markdown responses. `"private"` (default) keeps shared caches (CDNs) from
+     * storing them: Next.js drops the proxy's `Vary: Accept` on HTML pages, so a CDN that ignores
+     * Vary could otherwise serve Markdown to browsers. `"inherit"` keeps the page's own header.
+     */
+    markdownCacheControl?: "private" | "inherit";
+    /** fetch implementation for the internal request (tests). Default: global fetch. */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * `proxy.ts` handler. Rewrites requests that prefer Markdown to the Route Handler and adds
+ * `Vary` to the rest. HTML visits are reported to `onEvent` via `event.waitUntil`; Markdown
+ * visits are reported by the Route Handler (one event per request).
+ */
+export declare function createAgentPulseProxy(options?: NextProxyOptions): (request: NextRequest, event?: NextFetchEvent) => NextResponse;
+/**
+ * GET handler for `app/agentpulse-markdown/[[...path]]/route.ts`. Fetches the page's HTML from
+ * `internalOrigin` and returns its Markdown through the shared engine (cache, rate limit, IP
+ * verification, sanitization, telemetry).
+ */
+export declare function createMarkdownRouteHandler(options: NextMarkdownHandlerOptions): (request: Request) => Promise<Response>;
+/** Keeps freshness directives but forbids shared caches: drops public/s-maxage, adds private; no-store wins. */
+export declare function privateCacheControl(value: string | null): string;
+//# sourceMappingURL=next.d.ts.map

package/dist/adapters/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/adapters/next.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;GAQG;AAEH,mGAAmG;AACnG,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,+FAA+F;AAC/F,eAAO,MAAM,eAAe,0BAA0B,CAAC;AAEvD,wGAAwG;AACxG,eAAO,MAAM,yBAAyB,UAA+D,CAAC;AAEtG,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB,CAAC,WAAW,CAAC;IACtE,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA2B,SAAQ,iBAAiB,CAAC,OAAO,CAAC;IAC5E;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,mGAAmG;IACnG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iIAAiI;IACjI,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7C,oFAAoF;IACpF,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,gBAAqB,IAKlC,SAAS,WAAW,EAAE,QAAQ,cAAc,KAAG,YAAY,CAyB5F;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,0BAA0B,IAQlD,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAmE/D;AAED,gHAAgH;AAChH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAWhE"}