@plurnk/plurnk-schemes-http 0.1.0 → 0.2.0

package/SPEC.md

@@ -7,7 +7,10 @@
 ```ts
 static manifest: SchemeManifest = {
     name: "http",
-    channels: { body: "text/markdown", header: "text/markdown" },
+    // Seed defaults (pre-fetch placeholders). `body` is retyped per-call via
+    // notifyChunk's mimetype arg — to the response Content-Type, or text/html
+    // for a rendered page. `header` is always text/plain.
+    channels: { body: "application/octet-stream", header: "text/plain" },
     defaultChannel: "body",
     category: "data",
     scope: "session",
@@ -35,13 +38,14 @@ Results use the `passthrough` family (read-only / network shape) — http entrie
 
 READ and SEND[200] share one core:
 
-1. `ctx.subscriptions.open(pathname, handle)` — registers the subscription for cancel routing; returns the run+teardown-composed `AbortSignal`. The handle's `cancel()` aborts a local `AbortController` wired to the `fetch`.
-2. `fetch(url, { signal })` — GET (READ) or POST (SEND[200], body from `SendBody.raw`).
-3. Response status + headers → `ctx.subscriptions.notifyChunk("header", …)`.
-4. Body chunks → `ctx.subscriptions.notifyChunk("body", chunk)` as they arrive (fused append + stream/event).
-5. `ctx.subscriptions.close("done", "HTTP <status>; <n> bytes")` on clean end; `close("error", reason)` on failure.
+1. `ctx.subscriptions.open(pathname, handle)` — registers the subscription for cancel routing; returns the run+teardown-composed `AbortSignal`. The handle's `cancel()` aborts a local `AbortController` wired to the `fetch`/render.
+2. `fetch(url, { signal })` — GET (READ) or POST (SEND[200], body from `SendBody.raw`); read the response `Content-Type`.
+3. **Render gate (§6):** a GET whose response is HTML routes to the render path; everything else (POST responses, non-HTML bodies) streams raw.
+4. Response status + headers → `notifyChunk("header", …, "text/plain")`.
+5. Body → `notifyChunk("body", chunk, mimetype)` — labelled with its real type (the response Content-Type, or `text/html` rendered). Byte path streams chunks as they arrive; render path writes the serialized DOM in one chunk.
+6. `close("done", …)` on clean end; `close("error", reason)` on failure.
 
-Returns `102 Processing` on success (the subscription drives the channel content). The composed signal aborting (loop.cancel) and the local handle (SEND[499]) both tear the fetch down.
+Returns `102 Processing` on success (the subscription drives the channel content). The composed signal aborting (loop.cancel) and the local handle (SEND[499]) both tear the fetch/render down.
 
 ## §4 Status mapping
 
@@ -57,6 +61,18 @@ Returns `102 Processing` on success (the subscription drives the channel content
 
 Error results carry a `scheme:http` `TelemetryEvent` (via `Results.error`).
 
-## §5 No runtime dependencies
+## §5 Dependencies
 
-`fetch` / `AbortController` / `TextDecoder` / `ReadableStream` are Node ≥25 built-ins. The package declares only peer deps (`@plurnk/plurnk-schemes`, `@plurnk/plurnk-grammar`) — never pulls a transport library.
+The **byte path** is dependency-free: `fetch` / `AbortController` / `TextDecoder` / `ReadableStream` are Node ≥25 built-ins.
+
+The **render path** takes one runtime dependency, `playwright`, **lazy-imported** (`Browser.ts`) so only an actual render pays for it — a byte fetch never loads it. The chromium binary is optional: set `PLURNK_HTTP_PLAYWRIGHT_WS` to drive a remote CDP endpoint (shared chromium / Lightpanda / browserless) instead of launching locally. This is the conscious, scoped inversion of the original "no runtime deps" stance — rendering is acquisition, and acquisition is this scheme's job.
+
+## §6 Render lifecycle
+
+`Browser` (`export default class`, barrel-exported as a standalone foundation) is the headless-Chromium render engine — ported from rummy.web's WebFetcher, render-only.
+
+- **Gate:** a GET whose response `Content-Type` is `text/html` / `application/xhtml+xml` renders; the probe-fetch body is discarded and the browser does its own navigation. POST never renders.
+- **Render:** warm chromium (one per `Browser`), per-run `BrowserContext` keyed on `ctx.runId`, navigate with `waitUntil: "networkidle"` + a salvage path (timed-out-but-rendered pages with substantive body text), serialize the final DOM via `page.content()`.
+- **Body:** the serialized DOM is delivered as one `body` chunk labelled `text/html`; the mimetype layer projects everything (`content`/`symbols`/`deepXml`/embedding) off it. http never cleans or extracts — the body is the faithful, final page (schemes-http#1).
+- **Config:** `PLURNK_HTTP_FETCH_TIMEOUT`, `PLURNK_HTTP_NO_SANDBOX`, `PLURNK_HTTP_CHROMIUM_HEAP_MB`, `PLURNK_HTTP_PLAYWRIGHT_WS`. Idle teardown after 15 min.
+- **Cancel:** the composed `AbortSignal` / SEND[499] handle aborts the render by closing the page (in-flight `goto` rejects promptly).

package/dist/Browser.d.ts

@@ -0,0 +1,50 @@
+interface PwResponse {
+    status(): number;
+    statusText(): string;
+    headers(): Record<string, string>;
+}
+interface PwPage {
+    goto(url: string, opts: {
+        waitUntil: "networkidle";
+        timeout: number;
+    }): Promise<PwResponse | null>;
+    content(): Promise<string>;
+    evaluate<T>(fn: () => T): Promise<T>;
+    close(): Promise<void>;
+}
+interface PwContext {
+    newPage(): Promise<PwPage>;
+    close(): Promise<void>;
+}
+interface PwBrowser {
+    newContext(): Promise<PwContext>;
+    on(event: "disconnected", cb: () => void): void;
+    close(): Promise<void>;
+}
+export interface ChromiumEngine {
+    launch(opts: {
+        headless: boolean;
+        args: ReadonlyArray<string>;
+    }): Promise<PwBrowser>;
+    connect(wsEndpoint: string): Promise<PwBrowser>;
+}
+export type ChromiumFactory = () => Promise<ChromiumEngine>;
+export interface RenderResult {
+    readonly status: number;
+    readonly statusText: string;
+    readonly headers: ReadonlyArray<readonly [string, string]>;
+    readonly html: string;
+}
+export default class Browser {
+    #private;
+    constructor(factory?: ChromiumFactory);
+    render(url: string, { runId, signal, timeout }: {
+        runId: number;
+        signal?: AbortSignal;
+        timeout?: number;
+    }): Promise<RenderResult>;
+    closeContext(runId: number): void;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=Browser.d.ts.map

package/dist/Browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Browser.d.ts","sourceRoot":"","sources":["../src/Browser.ts"],"names":[],"mappings":"AAmBA,UAAU,UAAU;IAChB,MAAM,IAAI,MAAM,CAAC;IACjB,UAAU,IAAI,MAAM,CAAC;IACrB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AACD,UAAU,MAAM;IACZ,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACnG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AACD,UAAU,SAAS;IACf,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AACD,UAAU,SAAS;IACf,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IACjC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAChD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AACD,MAAM,WAAW,cAAc;IAC3B,MAAM,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACrF,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACnD;AACD,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;AAO5D,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAwBD,MAAM,CAAC,OAAO,OAAO,OAAO;;gBAWZ,OAAO,GAAE,eAAgC;IAO/C,MAAM,CACR,GAAG,EAAE,MAAM,EACX,EAAE,KAAK,EAAE,MAAM,EAAE,OAAiE,EAAE,EAChF;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9D,OAAO,CAAC,YAAY,CAAC;IAwFxB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAe3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B"}

package/dist/Browser.js

@@ -0,0 +1,176 @@
+// Browser — the headless-Chromium render foundation, ported from
+// rummy.web's WebFetcher (@possumtech/rummy.web, MIT, same author). A
+// STANDALONE foundation, not Http-private: the render scheme drives it now,
+// and a future plurnk browser-troubleshooting MCP sits on the same warm pool.
+//
+// Scope here is render-ONLY: navigate, let JS run + hydration settle, serialize
+// the final DOM. It returns the true rendered page; it never cleans, strips,
+// or extracts — projection (markdown/symbols/deepXml) is the mimetype layer's
+// job, off the faithful body we hand over.
+//
+// Driver is Playwright, lazy-imported so only the render path pays for it (the
+// raw-byte fetch path stays Node-builtin-only). The engine is reached through
+// a minimal structural seam (`ChromiumEngine`) so it can be injected — fakes
+// in unit tests, and a remote CDP endpoint (Lightpanda/browserless/shared
+// chromium) swapped in via env with zero code change.
+// Salvage threshold: a navigation that times out on networkidle but whose DOM
+// already holds this much body text is the chatty-page case (long-poll, ad
+// refresh, a server that never closes the stream) — the page rendered, the
+// network just never settled. Below it we discard: too little to be sure the
+// DOM ever rendered the article rather than a skeleton.
+const SALVAGE_MIN_BODY_CHARS = 200;
+const IDLE_TIMEOUT_MS = 15 * 60 * 1000;
+const DEFAULT_TIMEOUT_MS = 30_000;
+const numEnv = (key, fallback) => {
+    const raw = process.env[key];
+    if (raw === undefined)
+        return fallback;
+    const n = Number(raw);
+    if (Number.isNaN(n))
+        throw new Error(`Browser: ${key}=${raw} is not a number`);
+    return n;
+};
+// Default factory: lazy-import the real chromium. The cast bridges Playwright's
+// full type to our structural view at the single trusted library boundary.
+const defaultFactory = async () => (await import("playwright")).chromium;
+export default class Browser {
+    #factory;
+    #browser = null;
+    #launching = null;
+    // One BrowserContext per run — cookies / cache / storage scoped to the run
+    // that opened it, no cross-run bleed. Closed by closeContext() on run end
+    // or abort. The browser process stays warm across all of them.
+    #contexts = new Map();
+    #idleTimer = null;
+    // Inject a factory in tests; production lazy-imports playwright.
+    constructor(factory = defaultFactory) {
+        this.#factory = factory;
+    }
+    // Render a URL to its final serialized DOM. Opens a page in the run's
+    // context, navigates with the settle+salvage strategy, serializes, closes
+    // the page. Throws on navigation failure (the caller maps it to a status).
+    async render(url, { runId, signal, timeout = numEnv("PLURNK_HTTP_FETCH_TIMEOUT", DEFAULT_TIMEOUT_MS) }) {
+        const context = await this.#getContext(runId);
+        const page = await context.newPage();
+        // Abort cascades by closing the page — an in-flight goto rejects with
+        // "Target closed", surfacing promptly instead of blocking on timeout.
+        const onAbort = () => { page.close().catch(() => { }); };
+        signal?.addEventListener("abort", onAbort, { once: true });
+        // Already aborted before the page opened: the listener won't fire
+        // retroactively, so close now — the navigation must not proceed.
+        if (signal?.aborted)
+            onAbort();
+        try {
+            const response = await this.#safeGoto(page, url, timeout);
+            const html = await page.content();
+            return {
+                status: response?.status() ?? 200,
+                statusText: response?.statusText() ?? "",
+                headers: response ? Object.entries(response.headers()) : [],
+                html,
+            };
+        }
+        finally {
+            signal?.removeEventListener("abort", onAbort);
+            await page.close().catch(() => { });
+        }
+    }
+    // page.goto with the salvage path. networkidle timing out while the DOM has
+    // already rendered substantive body text is the chatty-page case: the
+    // content is there even though the network never settled. readyState is
+    // unreliable (a never-ending stream stays `loading` forever); the load-
+    // bearing signal is the body's innerText length. Returns the Response on
+    // normal completion, null on salvage, and re-throws every other error.
+    async #safeGoto(page, url, timeout) {
+        try {
+            return await page.goto(url, { waitUntil: "networkidle", timeout });
+        }
+        catch (err) {
+            if (!(err instanceof Error) || err.name !== "TimeoutError")
+                throw err;
+            const bodyLen = await page
+                .evaluate(() => document?.body?.innerText?.length ?? 0)
+                .catch(() => 0);
+            if (bodyLen < SALVAGE_MIN_BODY_CHARS)
+                throw err;
+            return null;
+        }
+    }
+    // Get-or-launch the warm chromium. Connects to a remote CDP endpoint via
+    // PLURNK_HTTP_PLAYWRIGHT_WS if set (shared / Lightpanda / browserless),
+    // else launches locally. Single browser across all runs; per-run isolation
+    // is at the context layer. Relaunches if chromium dies (OOM/segfault/WS
+    // teardown) leaves the handle stale.
+    async #getBrowser() {
+        this.#touchIdle();
+        if (this.#browser)
+            return this.#browser;
+        this.#launching ??= (async () => {
+            const chromium = await this.#factory();
+            const ws = process.env.PLURNK_HTTP_PLAYWRIGHT_WS;
+            if (ws)
+                return chromium.connect(ws);
+            const args = [];
+            if (process.env.PLURNK_HTTP_NO_SANDBOX === "1")
+                args.push("--no-sandbox");
+            const heapMb = process.env.PLURNK_HTTP_CHROMIUM_HEAP_MB;
+            if (heapMb)
+                args.push(`--js-flags=--max-old-space-size=${heapMb}`);
+            return chromium.launch({ headless: true, args });
+        })();
+        const browser = await this.#launching;
+        this.#launching = null;
+        browser.on("disconnected", () => {
+            if (this.#browser === browser) {
+                this.#browser = null;
+                this.#contexts.clear();
+            }
+        });
+        this.#browser = browser;
+        return browser;
+    }
+    // Get-or-create the run's BrowserContext. Desktop default (no device
+    // emulation) — we render the true page, not a mobile-extraction view.
+    async #getContext(runId) {
+        this.#touchIdle();
+        const existing = this.#contexts.get(runId);
+        if (existing)
+            return existing;
+        const browser = await this.#getBrowser();
+        const context = await browser.newContext();
+        this.#contexts.set(runId, context);
+        return context;
+    }
+    // Drop the run's context (run end or abort). Closing it cascades to any
+    // in-flight page in that context. Fire-and-forget.
+    closeContext(runId) {
+        const context = this.#contexts.get(runId);
+        if (!context)
+            return;
+        this.#contexts.delete(runId);
+        context.close().catch(() => { });
+    }
+    #touchIdle() {
+        if (this.#idleTimer)
+            clearTimeout(this.#idleTimer);
+        this.#idleTimer = setTimeout(() => { this.close().catch(() => { }); }, IDLE_TIMEOUT_MS);
+        this.#idleTimer.unref?.();
+    }
+    // Tear everything down: per-run contexts then the browser. In CDP mode
+    // close() disconnects the local handle without shutting the remote down.
+    async close() {
+        if (this.#idleTimer) {
+            clearTimeout(this.#idleTimer);
+            this.#idleTimer = null;
+        }
+        const contexts = [...this.#contexts.values()];
+        this.#contexts.clear();
+        await Promise.allSettled(contexts.map((c) => c.close()));
+        if (this.#browser) {
+            await this.#browser.close().catch(() => { });
+            this.#browser = null;
+        }
+        this.#launching = null;
+    }
+}
+//# sourceMappingURL=Browser.js.map

package/dist/Browser.js.map

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

package/dist/Http.d.ts

@@ -1,9 +1,18 @@
 import type { SchemeCtx, PassthroughResult, SchemeManifest } from "@plurnk/plurnk-schemes";
 import type { ReadStatement, SendStatement } from "@plurnk/plurnk-grammar";
+import { type RenderResult } from "./Browser.ts";
+interface Renderer {
+    render(url: string, opts: {
+        runId: number;
+        signal?: AbortSignal;
+    }): Promise<RenderResult>;
+}
 export default class Http {
     #private;
     static manifest: SchemeManifest;
+    constructor(browser?: Renderer);
     read(statement: ReadStatement, ctx: SchemeCtx): Promise<PassthroughResult>;
     send(statement: SendStatement, ctx: SchemeCtx): Promise<PassthroughResult>;
 }
+export {};
 //# sourceMappingURL=Http.d.ts.map

package/dist/Http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Http.d.ts","sourceRoot":"","sources":["../src/Http.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACR,SAAS,EAET,iBAAiB,EACjB,cAAc,EACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAW,MAAM,wBAAwB,CAAC;AAMpF,MAAM,CAAC,OAAO,OAAO,IAAI;;IACrB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAe7B;IAII,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAa1E,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA2FnF"}
+{"version":3,"file":"Http.d.ts","sourceRoot":"","sources":["../src/Http.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACR,SAAS,EAET,iBAAiB,EACjB,cAAc,EACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAW,MAAM,wBAAwB,CAAC;AACpF,OAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAO1D,UAAU,QAAQ;IACd,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC7F;AAED,MAAM,CAAC,OAAO,OAAO,IAAI;;IACrB,MAAM,CAAC,QAAQ,EAAE,cAAc,CAiB7B;gBAKU,OAAO,GAAE,QAAwB;IAOvC,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAa1E,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAiHnF"}

package/dist/Http.js

@@ -17,17 +17,21 @@
 // Network exception: SPEC §5 forbids opening connections "unless specifically
 // a network scheme." This IS that scheme — `fetch` is the whole point. No
 // runtime deps: `fetch` and `AbortController` are Node built-ins.
+var _a;
 import { Results } from "@plurnk/plurnk-schemes";
+import Browser from "./Browser.js";
 // The channel the response body streams into, and the header metadata channel.
 const BODY = "body";
 const HEADER = "header";
-export default class Http {
+class Http {
     static manifest = {
         name: "http",
-        // body: the response payload (mimetype is per-call — set from the
-        // response Content-Type — so channels declares the names, the write
-        // carries the actual mimetype). header: the response status line + headers.
-        channels: { [BODY]: "text/markdown", [HEADER]: "text/markdown" },
+        // Channel mimetypes here are SEED DEFAULTS (pre-fetch placeholders).
+        // body is retyped per-call via notifyChunk's mimetype arg — to the real
+        // response Content-Type, or text/html for a rendered page; octet-stream
+        // is the honest "unknown until fetched". header is always the status
+        // line + headers (text/plain).
+        channels: { [BODY]: "application/octet-stream", [HEADER]: "text/plain" },
         defaultChannel: BODY,
         category: "data",
         scope: "session",
@@ -38,13 +42,20 @@ export default class Http {
             requiresWeb: true, // excluded under the loop's noWeb flag
         },
     };
-    // READ → fetch + stream the response body. Returns 102 Processing; the
-    // subscription drives the channel content the model sees next turn.
+    // The render foundation (lazy chromium). Injectable for tests; one warm
+    // pool per Http instance, shared across this scheme's fetches.
+    #browser;
+    constructor(browser = new Browser()) {
+        this.#browser = browser;
+    }
+    // READ → fetch; an HTML page is rendered, everything else streams raw.
+    // Returns 102 Processing; the subscription drives the channel content the
+    // model sees next turn.
     async read(statement, ctx) {
         if (statement.target === null || statement.target.kind !== "url") {
-            return Http.#bad(400, "http", "bad_target", "READ requires an http(s):// URL target");
+            return _a.#bad(400, "http", "bad_target", "READ requires an http(s):// URL target");
         }
-        return Http.#fetchStream(statement.target, ctx, undefined);
+        return this.#fetchStream(statement.target, ctx, undefined);
     }
     // SEND dispatch — status-code-as-verb (SPEC §3.5).
     //   200 → request with body (POST), stream response
@@ -54,12 +65,12 @@ export default class Http {
     //         scheme-level no-op here is correct — teardown already happened)
     async send(statement, ctx) {
         if (statement.target === null || statement.target.kind !== "url") {
-            return Http.#bad(400, "http", "bad_target", "SEND requires an http(s):// URL target");
+            return _a.#bad(400, "http", "bad_target", "SEND requires an http(s):// URL target");
         }
         const status = statement.signal;
         if (status === 200) {
             const body = statement.body?.raw ?? "";
-            return Http.#fetchStream(statement.target, ctx, body);
+            return this.#fetchStream(statement.target, ctx, body);
         }
         if (status === 410) {
             const { status: delStatus } = await ctx.entries.delete(statement.target.pathname);
@@ -72,20 +83,22 @@ export default class Http {
             return { shape: "passthrough", status: 200 };
         }
         // Entry-bearing schemes return 501 for status codes they don't interpret.
-        return Http.#bad(501, "http", "unsupported_send", `SEND[${status}] not supported by http`);
+        return _a.#bad(501, "http", "unsupported_send", `SEND[${status}] not supported by http`);
     }
     // The streaming core, shared by READ and SEND[200]. Opens the subscription
-    // (registering the abort handle for SEND[499] routing), fetches, and pumps
-    // the response body into the BODY channel chunk-by-chunk via the fused
-    // notifyChunk. Settles via close().
-    static async #fetchStream(target, ctx, requestBody) {
-        const url = Http.#urlFrom(target);
+    // (registering the abort handle for SEND[499] routing), fetches headers,
+    // then EITHER renders (always-render: a GET of an HTML page is re-acquired
+    // through the browser and its final DOM becomes the body) OR streams the
+    // raw bytes (POST responses and every non-HTML body). Each chunk is labelled
+    // with its real mimetype via notifyChunk. Settles via close().
+    async #fetchStream(target, ctx, requestBody) {
+        const url = _a.#urlFrom(target);
         const pathname = target.pathname;
         // Local AbortController for force-cancel from outside (SEND[499]).
         const local = new AbortController();
         const handle = { cancel: () => local.abort() };
         // open() returns the run+teardown-composed signal — fires on loop.cancel
-        // OR our local teardown. Wire it to the fetch so either path aborts it.
+        // OR our local teardown. Wire it so either path aborts the fetch/render.
         const composed = await ctx.subscriptions.open(pathname, handle);
         const onAbort = () => local.abort();
         composed.addEventListener("abort", onAbort, { once: true });
@@ -96,11 +109,24 @@ export default class Http {
                 signal: local.signal,
                 redirect: "follow",
             });
-            // Record the response status + headers in the HEADER channel.
-            const headerLines = [`HTTP ${response.status} ${response.statusText}`];
-            for (const [k, v] of response.headers)
-                headerLines.push(`${k}: ${v}`);
-            await ctx.subscriptions.notifyChunk(HEADER, headerLines.join("\n"));
+            const contentType = response.headers.get("content-type") ?? "";
+            // Always-render: a GET of an HTML page is re-acquired through the
+            // browser so the body is the final rendered DOM. The probe-fetch
+            // body is discarded — the browser does its own navigation. A POST
+            // never renders (it can't be replayed as a browser navigation).
+            const isHtml = requestBody === undefined
+                && /^(?:text\/html|application\/xhtml\+xml)\b/i.test(contentType);
+            if (isHtml) {
+                await response.body?.cancel();
+                const result = await this.#browser.render(url, { runId: ctx.runId, signal: local.signal });
+                await _a.#writeHeader(ctx, result.status, result.statusText, result.headers);
+                await ctx.subscriptions.notifyChunk(BODY, result.html, "text/html");
+                await ctx.subscriptions.close("done", `rendered HTTP ${result.status}; ${result.html.length} chars`);
+                return { shape: "passthrough", status: 102 };
+            }
+            // Byte path: stream the body labelled with its real content type.
+            await _a.#writeHeader(ctx, response.status, response.statusText, [...response.headers]);
+            const bodyMime = contentType.split(";")[0].trim() || "application/octet-stream";
             if (response.body === null) {
                 await ctx.subscriptions.close("done", `HTTP ${response.status}; empty body`);
                 return { shape: "passthrough", status: 102 };
@@ -109,11 +135,11 @@ export default class Http {
             const decoder = new TextDecoder();
             for await (const chunk of response.body) {
                 bytes += chunk.length;
-                await ctx.subscriptions.notifyChunk(BODY, decoder.decode(chunk, { stream: true }));
+                await ctx.subscriptions.notifyChunk(BODY, decoder.decode(chunk, { stream: true }), bodyMime);
             }
             const tail = decoder.decode();
             if (tail.length > 0)
-                await ctx.subscriptions.notifyChunk(BODY, tail);
+                await ctx.subscriptions.notifyChunk(BODY, tail, bodyMime);
             await ctx.subscriptions.close("done", `HTTP ${response.status}; ${bytes} bytes`);
             return { shape: "passthrough", status: 102 };
         }
@@ -121,13 +147,20 @@ export default class Http {
             const aborted = local.signal.aborted;
             const reason = aborted ? "aborted" : err instanceof Error ? err.message : String(err);
             await ctx.subscriptions.close("error", reason);
-            // 499 for client-cancelled, 502 for upstream/network failure.
-            return Http.#bad(aborted ? 499 : 502, "http", aborted ? "aborted" : "fetch_failed", reason);
+            // 499 for client-cancelled, 502 for upstream/network/render failure.
+            return _a.#bad(aborted ? 499 : 502, "http", aborted ? "aborted" : "fetch_failed", reason);
         }
         finally {
             composed.removeEventListener("abort", onAbort);
         }
     }
+    // Record the response status line + headers into the HEADER channel (text/plain).
+    static async #writeHeader(ctx, status, statusText, headers) {
+        const lines = [`HTTP ${status} ${statusText}`];
+        for (const [k, v] of headers)
+            lines.push(`${k}: ${v}`);
+        await ctx.subscriptions.notifyChunk(HEADER, lines.join("\n"), "text/plain");
+    }
     // Reconstruct the absolute URL from the parsed UrlPath. `raw` is the
     // grammar's verbatim URL — authoritative; the decomposed fields are a
     // convenience. Use raw so query strings / auth / port survive exactly.
@@ -138,4 +171,6 @@ export default class Http {
         return { shape: "passthrough", status, error: Results.error(scheme, kind, message) };
     }
 }
+_a = Http;
+export default Http;
 //# sourceMappingURL=Http.js.map

package/dist/Http.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { default } from "./Http.ts";
 export { default as Http } from "./Http.ts";
+export { default as Browser } from "./Browser.ts";
+export type { ChromiumEngine, ChromiumFactory, RenderResult } from "./Browser.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAI5C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -3,4 +3,7 @@
 // (plugin discovery scans node_modules/@plurnk/* for `plurnk.kind === "scheme"`).
 export { default } from "./Http.js";
 export { default as Http } from "./Http.js";
+// Standalone render foundation — exported so a future plurnk browser-
+// troubleshooting MCP package can sit on the same warm-Chromium pool.
+export { default as Browser } from "./Browser.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,0EAA0E;AAC1E,kFAAkF;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,0EAA0E;AAC1E,kFAAkF;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5C,sEAAsE;AACtE,sEAAsE;AACtE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plurnk/plurnk-schemes-http",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "description": "http(s):// URI scheme handler for the plurnk agent runtime — fetch + streaming response body.",
     "keywords": ["plurnk", "scheme", "uri", "http", "https"],
     "homepage": "https://github.com/plurnk/plurnk-schemes-http#readme",
@@ -44,13 +44,16 @@
         "build": "npm run build:dist",
         "prepare": "npm run build"
     },
+    "dependencies": {
+        "playwright": "^1.58.2"
+    },
     "peerDependencies": {
         "@plurnk/plurnk-grammar": "0.21.0",
-        "@plurnk/plurnk-schemes": "0.4.4"
+        "@plurnk/plurnk-schemes": "0.7.0"
     },
     "devDependencies": {
         "@plurnk/plurnk-grammar": "0.21.0",
-        "@plurnk/plurnk-schemes": "0.4.4",
+        "@plurnk/plurnk-schemes": "0.7.0",
         "@types/node": "^25.8.0",
         "typescript": "^6.0.3"
     }