@plurnk/plurnk-schemes-http 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PossumTech Laboratories
+
+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

@@ -0,0 +1,39 @@
+# plurnk-schemes-http
+
+`http(s)://` URI scheme handler for the [plurnk](https://github.com/plurnk/plurnk-service) agent runtime. The **first greenfield `@plurnk/plurnk-schemes-*` sibling** — authored entirely against the DB-free capability contract ([`@plurnk/plurnk-schemes`](https://github.com/plurnk/plurnk-schemes) `SchemeCtx`), importing zero plurnk-service internals.
+
+## What it does
+
+Lets the model treat any web URL as an addressable, streamable resource:
+
+| Op | Behavior |
+|---|---|
+| `READ(http(s)://host/path)` | `fetch` the URL; stream the response body into the `body` channel as it arrives. A streaming read — returns `102 Processing`, the subscription accumulates, the model reads the entry on a later turn. |
+| `SEND[200](http(s)://…)` | Request with a body (POST); response streams back the same way. |
+| `SEND[499](http(s)://…)` | Cancel an in-flight request (abort the fetch). |
+| `SEND[410](http(s)://…)` | Delete the cached response entry. |
+
+Response status + headers land in the `header` channel; the body in `body` (the default).
+
+## Channels
+
+- `body` — response payload (default channel).
+- `header` — `HTTP <status> <statusText>` line + response headers.
+
+## Design
+
+- **Streaming via the capability `subscriptions` lifecycle** (`open` → `notifyChunk` → `close`). `open()` returns the run+teardown-composed `AbortSignal`; a `SubscriptionHandle` is registered so the engine routes `SEND[499]` cancellation to the in-flight `fetch`.
+- **No runtime dependencies** — `fetch`, `AbortController`, `TextDecoder`, `ReadableStream` are Node ≥25 built-ins.
+- **DB-free** — reaches the substrate only through `ctx` capabilities (`subscriptions`, `entries`), never a raw DB handle (plurnk-schemes SPEC §5). This is what the keystone capability ctx made possible.
+
+## Install
+
+```
+npm i @plurnk/plurnk-schemes-http && plurnk start
+```
+
+Plugin discovery registers it at boot (`package.json#plurnk.kind === "scheme"`).
+
+## Tests
+
+`test:lint` (tsc) + `test:unit` (conformant `SchemeCtx` stub + mock `fetch`).

package/SPEC.md

@@ -0,0 +1,62 @@
+# plurnk-schemes-http — Specification
+
+`http(s)://` scheme handler. Implements the `@plurnk/plurnk-schemes` author contract (SPEC §2 interface + §3.bis capability ctx). Consumed by plurnk-service via plugin discovery.
+
+## §1 Manifest
+
+```ts
+static manifest: SchemeManifest = {
+    name: "http",
+    channels: { body: "text/markdown", header: "text/markdown" },
+    defaultChannel: "body",
+    category: "data",
+    scope: "session",
+    writableBy: ["model", "client"],
+    volatile: true,        // remote content can change between fetches
+    modelVisible: true,
+    flags: { requiresWeb: true },  // excluded under the loop's noWeb flag
+};
+```
+
+`package.json#plurnk`: `{ "kind": "scheme", "name": "http" }`.
+
+**Open question — dual prefix.** plurnk-service's `SchemeRegistry` keys handlers by a single name (`register("http", …)`); there is no alias mechanism today. This package serves both `http://` and `https://`. How the second prefix registers (registry alias, the handler claiming both, or a convention) is a plurnk-service concern — tracked with the consumer, not resolved here.
+
+## §2 Op surface
+
+Implemented against the DB-free `SchemeCtx` (no `ctx.db`):
+
+- `read(statement, ctx): Promise<PassthroughResult>` — fetch + stream (below).
+- `send(statement, ctx): Promise<PassthroughResult>` — status-as-verb dispatch (200/410/499; else 501).
+
+Results use the `passthrough` family (read-only / network shape) — http entries are coordinate/URL-addressed, not entry-CRUD-backed.
+
+## §3 Streaming lifecycle
+
+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.
+
+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.
+
+## §4 Status mapping
+
+| Outcome | status |
+|---|---|
+| Stream opened (READ / SEND[200] success) | 102 |
+| SEND[410] delete | as `ctx.entries.delete` returns |
+| SEND[499] cancel | 200 (engine already routed teardown to the handle) |
+| Client-cancelled fetch | 499 (`kind: aborted`) |
+| Upstream / network failure | 502 (`kind: fetch_failed`) |
+| Non-url target | 400 (`kind: bad_target`) |
+| Uninterpreted SEND status | 501 (`kind: unsupported_send`) |
+
+Error results carry a `scheme:http` `TelemetryEvent` (via `Results.error`).
+
+## §5 No runtime 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.

package/dist/Http.d.ts

@@ -0,0 +1,9 @@
+import type { SchemeCtx, PassthroughResult, SchemeManifest } from "@plurnk/plurnk-schemes";
+import type { ReadStatement, SendStatement } from "@plurnk/plurnk-grammar";
+export default class Http {
+    #private;
+    static manifest: SchemeManifest;
+    read(statement: ReadStatement, ctx: SchemeCtx): Promise<PassthroughResult>;
+    send(statement: SendStatement, ctx: SchemeCtx): Promise<PassthroughResult>;
+}
+//# sourceMappingURL=Http.d.ts.map

package/dist/Http.d.ts.map

@@ -0,0 +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"}

package/dist/Http.js

@@ -0,0 +1,141 @@
+// http(s):// scheme handler — the first greenfield `@plurnk/plurnk-schemes-*`
+// sibling, authored entirely against the DB-free capability ctx (SchemeCtx).
+// It never imports plurnk-service and never touches a raw DB handle (SPEC §5);
+// the substrate is reached only through intent, via the injected caps.
+//
+// Surface:
+//   READ(http(s)://host/path)   — fetch the URL; stream the response body into
+//                                 the `body` channel as it arrives. A streaming
+//                                 read (SPEC §7.1): returns 102 Processing
+//                                 immediately, the subscription accumulates,
+//                                 the model reads the entry on a later turn.
+//   SEND[200](http(s)://...)    — request with a body (POST by default); the
+//                                 response streams back the same way.
+//   SEND[499](http(s)://...)    — cancel an in-flight request (abort the fetch).
+//   SEND[410](http(s)://...)    — delete the cached response entry.
+//
+// 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.
+import { Results } from "@plurnk/plurnk-schemes";
+// The channel the response body streams into, and the header metadata channel.
+const BODY = "body";
+const HEADER = "header";
+export default 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" },
+        defaultChannel: BODY,
+        category: "data",
+        scope: "session",
+        writableBy: ["model", "client"],
+        volatile: true, // remote content can change between fetches
+        modelVisible: true,
+        flags: {
+            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.
+    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 Http.#fetchStream(statement.target, ctx, undefined);
+    }
+    // SEND dispatch — status-code-as-verb (SPEC §3.5).
+    //   200 → request with body (POST), stream response
+    //   410 → delete the cached entry
+    //   499 → cancel in-flight (handled by the subscription's force-cancel;
+    //         the engine routes 499 to the registered SubscriptionHandle, so a
+    //         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");
+        }
+        const status = statement.signal;
+        if (status === 200) {
+            const body = statement.body?.raw ?? "";
+            return Http.#fetchStream(statement.target, ctx, body);
+        }
+        if (status === 410) {
+            const { status: delStatus } = await ctx.entries.delete(statement.target.pathname);
+            return { shape: "passthrough", status: delStatus };
+        }
+        if (status === 499) {
+            // Cancellation is routed by the engine to the subscription's
+            // SubscriptionHandle.cancel (registered in #fetchStream). Nothing
+            // for the scheme to do at the op level.
+            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`);
+    }
+    // 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);
+        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.
+        const composed = await ctx.subscriptions.open(pathname, handle);
+        const onAbort = () => local.abort();
+        composed.addEventListener("abort", onAbort, { once: true });
+        try {
+            const response = await fetch(url, {
+                method: requestBody === undefined ? "GET" : "POST",
+                body: requestBody,
+                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"));
+            if (response.body === null) {
+                await ctx.subscriptions.close("done", `HTTP ${response.status}; empty body`);
+                return { shape: "passthrough", status: 102 };
+            }
+            let bytes = 0;
+            const decoder = new TextDecoder();
+            for await (const chunk of response.body) {
+                bytes += chunk.length;
+                await ctx.subscriptions.notifyChunk(BODY, decoder.decode(chunk, { stream: true }));
+            }
+            const tail = decoder.decode();
+            if (tail.length > 0)
+                await ctx.subscriptions.notifyChunk(BODY, tail);
+            await ctx.subscriptions.close("done", `HTTP ${response.status}; ${bytes} bytes`);
+            return { shape: "passthrough", status: 102 };
+        }
+        catch (err) {
+            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);
+        }
+        finally {
+            composed.removeEventListener("abort", onAbort);
+        }
+    }
+    // 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.
+    static #urlFrom(target) {
+        return target.raw;
+    }
+    static #bad(status, scheme, kind, message) {
+        return { shape: "passthrough", status, error: Results.error(scheme, kind, message) };
+    }
+}
+//# sourceMappingURL=Http.js.map

package/dist/Http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from "./Http.ts";
+export { default as Http } from "./Http.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// Public API barrel for @plurnk/plurnk-schemes-http.
+// The default export is the scheme class plurnk-service registers at boot
+// (plugin discovery scans node_modules/@plurnk/* for `plurnk.kind === "scheme"`).
+export { default } from "./Http.js";
+export { default as Http } from "./Http.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+    "name": "@plurnk/plurnk-schemes-http",
+    "version": "0.1.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",
+    "bugs": {
+        "url": "https://github.com/plurnk/plurnk-schemes-http/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/plurnk/plurnk-schemes-http.git"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "license": "MIT",
+    "author": "@wikitopian",
+    "type": "module",
+    "publishConfig": {
+        "access": "public"
+    },
+    "plurnk": {
+        "kind": "scheme",
+        "name": "http"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist/**/*",
+        "README.md",
+        "SPEC.md"
+    ],
+    "scripts": {
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --test src/**/*.test.ts",
+        "test": "npm run test:lint && npm run test:unit",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:dist",
+        "prepare": "npm run build"
+    },
+    "peerDependencies": {
+        "@plurnk/plurnk-grammar": "0.21.0",
+        "@plurnk/plurnk-schemes": "0.4.4"
+    },
+    "devDependencies": {
+        "@plurnk/plurnk-grammar": "0.21.0",
+        "@plurnk/plurnk-schemes": "0.4.4",
+        "@types/node": "^25.8.0",
+        "typescript": "^6.0.3"
+    }
+}