@4ort/cli 0.4.0 → 0.5.0

package/dist/web-client.js

@@ -0,0 +1,335 @@
+/**
+ * Public-internet reader for `4ort web get`.
+ *
+ * Tiered, cheapest tier first:
+ *   Tier 0 — if the URL is one of ours (4ort.xyz/entity/<slug>), return our own
+ *            structured entity instead of scraping the HTML.
+ *   Tier 2 — live fetch (undici global fetch, proxy-aware via kg-client's
+ *            EnvHttpProxyAgent) + Mozilla Readability ("Reader Mode") extraction.
+ *   (Tier 1 — full text out of our Common Crawl index via a future server
+ *            /page-text endpoint — TODO once that ships.)
+ *
+ * No JS execution, no cookies, no login. On a JS-wall / 403 / paywall / binary
+ * body / parse failure we return { ok: false, ... } *with the URL* so the calling
+ * agent isn't dead-ended — it can fall back to the link or pick another source.
+ */
+import { Readability } from "@mozilla/readability";
+import { parseHTML } from "linkedom";
+import { loadConfig } from "./config.js";
+import { kgRequest } from "./kg-client.js";
+const UA = "4ort-cli/0.5.0 (+https://4ort.xyz)";
+const FETCH_TIMEOUT_MS = 15_000;
+const MAX_BODY_BYTES = 5 * 1024 * 1024; // 5 MB hard cap on what we'll download
+const DEFAULT_MAX_CHARS = 50_000;
+// ── Tier 0: our own pages ───────────────────────────────────────────────────
+function looksLikeOurEntity(u) {
+    if (!/(^|\.)4ort\.xyz$/i.test(u.hostname))
+        return null;
+    const m = u.pathname.match(/^\/entity\/([^/]+)\/?$/);
+    return m ? decodeURIComponent(m[1]) : null;
+}
+async function readOurEntity(requested, slug) {
+    const kg = loadConfig()?.kg;
+    if (!kg?.apiKey)
+        return null; // no KG key → just scrape the SSR HTML normally
+    try {
+        const data = await kgRequest(kg, `/api/v1/entities/${encodeURIComponent(slug)}`, {
+            query: { detail: "full" },
+        });
+        return {
+            ok: true,
+            url: requested,
+            final_url: requested,
+            source: "4ort.xyz",
+            title: data?.name,
+            entity: data,
+        };
+    }
+    catch {
+        return null; // any failure → fall through to a normal fetch
+    }
+}
+// ── Tier 2: live fetch + Readability ────────────────────────────────────────
+/** Read a Response body into bytes, hard-capped at `cap`. Cancels the stream once full. */
+async function readCapped(res, cap) {
+    if (!res.body) {
+        const ab = await res.arrayBuffer();
+        const u = new Uint8Array(ab);
+        return { bytes: u.length > cap ? u.slice(0, cap) : u, truncatedBody: u.length > cap };
+    }
+    const reader = res.body.getReader();
+    const chunks = [];
+    let total = 0;
+    let truncatedBody = false;
+    while (true) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        if (value && value.length) {
+            chunks.push(value);
+            total += value.length;
+            if (total >= cap) {
+                truncatedBody = true;
+                try {
+                    await reader.cancel();
+                }
+                catch { /* ignore */ }
+                break;
+            }
+        }
+    }
+    const out = new Uint8Array(Math.min(total, cap));
+    let off = 0;
+    for (const c of chunks) {
+        if (off >= cap)
+            break;
+        const take = Math.min(c.length, cap - off);
+        out.set(c.subarray(0, take), off);
+        off += take;
+    }
+    return { bytes: out, truncatedBody };
+}
+/** Crude tag-strip fallback when Readability extracts nothing usable. */
+function crudeStrip(document, rawHtml) {
+    try {
+        for (const sel of ["script", "style", "noscript", "nav", "header", "footer", "aside", "form", "iframe", "svg"]) {
+            for (const el of Array.from(document.querySelectorAll(sel))) {
+                try {
+                    el.remove();
+                }
+                catch { /* ignore */ }
+            }
+        }
+        const body = document.querySelector("body") || document.documentElement;
+        const text = (body?.textContent || "")
+            .replace(/[ \t]+/g, " ")
+            .replace(/\n[ \t]*\n[ \t]*\n+/g, "\n\n")
+            .trim();
+        if (text)
+            return text;
+    }
+    catch { /* fall through */ }
+    return rawHtml
+        .replace(/<script[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[\s\S]*?<\/style>/gi, "")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function wordCount(s) {
+    return s.split(/\s+/).filter(Boolean).length;
+}
+// Anti-bot / JS-challenge interstitials extract as short "content" that isn't.
+// If a page comes back thin AND matches one of these, treat it as blocked so the
+// agent gets an honest signal instead of a "verify you're a robot" page as text.
+const BOT_WALL_RE = /verify (you('| a)re|that you('| a)re) (not )?a (human|robot)|enable javascript|javascript is (disabled|required)|captcha|checking your browser|cf-browser-verification|having trouble accessing|access denied|are you a (human|robot)|please complete the security check|unusual traffic|to continue, (please )?(enable|verify)/i;
+function looksLikeBotWall(text) {
+    return wordCount(text) < 120 && BOT_WALL_RE.test(text);
+}
+async function liveFetch(requested, maxChars) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), FETCH_TIMEOUT_MS);
+    let res;
+    try {
+        res = await fetch(requested, {
+            redirect: "follow",
+            signal: ctrl.signal,
+            headers: {
+                "User-Agent": UA,
+                Accept: "text/html,application/xhtml+xml,text/plain,application/json;q=0.9,*/*;q=0.8",
+                "Accept-Encoding": "gzip, deflate, br",
+            },
+        });
+    }
+    catch (e) {
+        clearTimeout(timer);
+        const detail = e?.cause?.code || e?.cause?.message || e?.message || String(e);
+        const reason = e?.name === "AbortError" ? `timeout after ${FETCH_TIMEOUT_MS}ms` : `fetch failed: ${detail}`;
+        return { ok: false, url: requested, source: "live", reason };
+    }
+    clearTimeout(timer);
+    const finalUrl = res.url || requested;
+    const status = res.status;
+    const ct = (res.headers.get("content-type") || "").toLowerCase();
+    if (!res.ok) {
+        try {
+            await res.arrayBuffer();
+        }
+        catch { /* drain */ }
+        const blocked = status === 401 || status === 403 || status === 429 || status === 451 || status === 503;
+        const reason = blocked
+            ? `HTTP ${status} — blocked; agent should try the URL directly or pick another source`
+            : `HTTP ${status}`;
+        return { ok: false, url: requested, final_url: finalUrl, source: "live", status, content_type: ct || undefined, reason };
+    }
+    const clen = parseInt(res.headers.get("content-length") || "", 10);
+    if (Number.isFinite(clen) && clen > MAX_BODY_BYTES) {
+        try {
+            await res.arrayBuffer();
+        }
+        catch { /* drain */ }
+        return {
+            ok: false, url: requested, final_url: finalUrl, source: "live", status,
+            content_type: ct || undefined, size: clen,
+            reason: `body too large (${clen} bytes) — fetch the URL directly`,
+        };
+    }
+    const { bytes, truncatedBody } = await readCapped(res, MAX_BODY_BYTES);
+    // PDF — out of scope for v1.
+    if (ct.includes("application/pdf") || finalUrl.toLowerCase().split("?")[0].endsWith(".pdf")) {
+        return {
+            ok: false, url: requested, final_url: finalUrl, source: "live", status,
+            content_type: ct || "application/pdf", size: bytes.length,
+            reason: "PDF not supported yet — fetch the URL directly",
+        };
+    }
+    const isHtml = ct.includes("html") || ct.includes("xhtml") || (!ct && /<html[\s>]/i.test(new TextDecoder().decode(bytes.subarray(0, 2048))));
+    const isText = isHtml || ct.includes("text/") || ct.includes("json") || ct.includes("xml") || ct.includes("+xml") || !ct;
+    if (!isText) {
+        return {
+            ok: false, url: requested, final_url: finalUrl, source: "live", status,
+            content_type: ct, size: bytes.length,
+            reason: `binary content (${ct}) — fetch the URL directly`,
+        };
+    }
+    const bodyText = new TextDecoder("utf-8").decode(bytes);
+    // Many JSON APIs serve their payload with a lying Content-Type (text/html,
+    // text/plain). If the body clearly *is* JSON, return it raw — don't run a
+    // DOM parser over it. (VIAF AutoSuggest, some MediaWiki APIs, etc.)
+    const trimmed = bodyText.trimStart();
+    const looksJson = (trimmed.startsWith("{") && bodyText.trimEnd().endsWith("}"))
+        || (trimmed.startsWith("[") && bodyText.trimEnd().endsWith("]"));
+    if (looksJson && !ct.includes("json")) {
+        let text = bodyText.trim();
+        let truncated = truncatedBody;
+        if (text.length > maxChars) {
+            text = text.slice(0, maxChars).trimEnd();
+            truncated = true;
+        }
+        return {
+            ok: true, url: requested, final_url: finalUrl, source: "live", status,
+            content_type: "application/json", word_count: wordCount(text), text, truncated,
+        };
+    }
+    if (isHtml) {
+        try {
+            const { document } = parseHTML(bodyText);
+            let title;
+            let byline = null;
+            let excerpt;
+            let text = "";
+            let note;
+            try {
+                const article = new Readability(document, { charThreshold: 100 }).parse();
+                if (article && article.textContent && article.textContent.trim()) {
+                    title = article.title || undefined;
+                    byline = article.byline ?? null;
+                    excerpt = article.excerpt || undefined;
+                    text = article.textContent.replace(/\n{3,}/g, "\n\n").trim();
+                }
+            }
+            catch { /* fall through to crude strip */ }
+            if (!text) {
+                text = crudeStrip(document, bodyText);
+                title = title || (document.querySelector("title")?.textContent || "").trim() || undefined;
+                note = "readability found no article body — returned crude page text";
+            }
+            let truncated = truncatedBody;
+            if (text.length > maxChars) {
+                text = text.slice(0, maxChars).trimEnd();
+                truncated = true;
+            }
+            if (!text.trim()) {
+                return {
+                    ok: false, url: requested, final_url: finalUrl, source: "live", status,
+                    content_type: ct || "text/html",
+                    reason: "no extractable text (likely a JS-only page) — fetch the URL directly",
+                };
+            }
+            if (looksLikeBotWall(text)) {
+                return {
+                    ok: false, url: requested, final_url: finalUrl, source: "live", status,
+                    content_type: ct || "text/html",
+                    reason: "bot wall / JS challenge — fetch the URL directly or pick another source",
+                };
+            }
+            return {
+                ok: true, url: requested, final_url: finalUrl, source: "live", status,
+                content_type: ct || "text/html",
+                title, byline, excerpt, word_count: wordCount(text), text, truncated,
+                reason: note,
+            };
+        }
+        catch (e) {
+            return {
+                ok: false, url: requested, final_url: finalUrl, source: "live", status,
+                content_type: ct, reason: `HTML parse failed: ${e?.message || e}`,
+            };
+        }
+    }
+    // text/plain, JSON, XML, markdown — return raw, capped.
+    let text = bodyText.replace(/\r\n/g, "\n").trim();
+    let truncated = truncatedBody;
+    if (text.length > maxChars) {
+        text = text.slice(0, maxChars).trimEnd();
+        truncated = true;
+    }
+    return {
+        ok: true, url: requested, final_url: finalUrl, source: "live", status,
+        content_type: ct || "text/plain", word_count: wordCount(text), text, truncated,
+    };
+}
+// ── SSRF guard ──────────────────────────────────────────────────────────────
+// `web_get` is exposed publicly (via `4ort mcp serve`), so refuse to fetch
+// loopback / RFC1918 / link-local / cloud-metadata addresses. v1: literal-host
+// check only — a hardened public deploy should also check the *resolved* IP
+// (DNS-rebinding) and rate-limit. Blocks some legit CLI dev use of localhost —
+// that's the right default for a web-fetcher tool.
+function isInternalHost(hostname) {
+    const h = hostname.replace(/^\[|\]$/g, "").toLowerCase();
+    if (["localhost", "metadata", "metadata.google.internal", "instance-data", "0.0.0.0"].includes(h))
+        return true;
+    if (h === "::1" || h.startsWith("fe80:") || h.startsWith("fc") || h.startsWith("fd"))
+        return true; // IPv6 loopback / link-local / ULA
+    if (/^\d{1,3}(\.\d{1,3}){3}$/.test(h)) {
+        const [a, b] = h.split(".").map(Number);
+        if (a === 127 || a === 10 || a === 0)
+            return true;
+        if (a === 169 && b === 254)
+            return true; // link-local / cloud metadata
+        if (a === 172 && b >= 16 && b <= 31)
+            return true; // RFC1918
+        if (a === 192 && b === 168)
+            return true; // RFC1918
+        if (a === 100 && b >= 64 && b <= 127)
+            return true; // CGNAT
+    }
+    return false;
+}
+// ── Public entry ────────────────────────────────────────────────────────────
+export async function webRead(rawUrl, opts = {}) {
+    let u;
+    try {
+        u = new URL(rawUrl);
+    }
+    catch {
+        return { ok: false, url: rawUrl, source: "live", reason: "invalid URL" };
+    }
+    if (u.protocol !== "http:" && u.protocol !== "https:") {
+        return { ok: false, url: rawUrl, source: "live", reason: `unsupported scheme: ${u.protocol}` };
+    }
+    if (isInternalHost(u.hostname)) {
+        return { ok: false, url: rawUrl, source: "live", reason: "refusing to fetch an internal / loopback / link-local / metadata address" };
+    }
+    const maxChars = opts.maxChars && opts.maxChars > 0 ? opts.maxChars : DEFAULT_MAX_CHARS;
+    // Tier 0 — our own entity pages: serve the structured record, skip scraping.
+    const slug = looksLikeOurEntity(u);
+    if (slug) {
+        const ours = await readOurEntity(rawUrl, slug);
+        if (ours)
+            return ours;
+    }
+    // Tier 2 — live fetch + Readability.
+    return liveFetch(rawUrl, maxChars);
+}
+//# sourceMappingURL=web-client.js.map

package/dist/web-client.js.map

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

package/package.json

@@ -1,21 +1,37 @@
 {
   "name": "@4ort/cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
+  "description": "Unified CLI for the 4ort ecosystem — 4ort.net hosting, knowledge graph, and more",
   "type": "module",
   "bin": {
     "4ort": "./dist/index.js"
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsc",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@mozilla/readability": "^0.6.0",
     "commander": "^12.0.0",
-    "tar": "^7.0.0"
+    "linkedom": "^0.18.12",
+    "tar": "^7.0.0",
+    "undici": "^6.25.0"
   },
   "devDependencies": {
+    "@types/node": "^25.6.0",
     "tsx": "^4.0.0",
     "typescript": "^5.0.0"
-  }
+  },
+  "license": "UNLICENSED",
+  "private": false
 }

package/src/api-client.ts

@@ -1,51 +0,0 @@
-import { Config } from "./config.js";
-
-export async function apiRequest(
-  config: Config,
-  method: string,
-  path: string,
-  body?: any,
-): Promise<any> {
-  const url = `${config.server}${path}`;
-  const headers: Record<string, string> = {
-    Authorization: `Bearer ${config.apiKey}`,
-  };
-
-  const init: RequestInit = { method, headers };
-
-  if (body instanceof FormData) {
-    init.body = body;
-  } else if (body) {
-    headers["Content-Type"] = "application/json";
-    init.body = JSON.stringify(body);
-  }
-
-  const res = await fetch(url, init);
-  const data = await res.json();
-
-  if (!res.ok) {
-    throw new Error(data.error || `HTTP ${res.status}`);
-  }
-
-  return data;
-}
-
-export async function registerAgent(
-  server: string,
-  name: string,
-  metadata?: Record<string, any>,
-): Promise<any> {
-  const res = await fetch(`${server}/api/register`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ name, metadata }),
-  });
-
-  const data = await res.json();
-
-  if (!res.ok) {
-    throw new Error(data.error || `HTTP ${res.status}`);
-  }
-
-  return data;
-}

package/src/commands/delete.ts

@@ -1,15 +0,0 @@
-import { apiRequest } from "../api-client.js";
-import { requireConfig } from "../config.js";
-
-export async function deleteSite(subdomain?: string) {
-  const config = requireConfig();
-  const name = subdomain || config.agentName;
-
-  try {
-    const data = await apiRequest(config, "DELETE", `/api/sites/${name}`);
-    console.log(data.message);
-  } catch (err: any) {
-    console.error(`Delete failed: ${err.message}`);
-    process.exit(1);
-  }
-}

package/src/commands/list.ts

@@ -1,25 +0,0 @@
-import { apiRequest } from "../api-client.js";
-import { requireConfig } from "../config.js";
-
-export async function list() {
-  const config = requireConfig();
-
-  try {
-    const data = await apiRequest(config, "GET", "/api/sites");
-
-    if (data.sites.length === 0) {
-      console.log("No sites yet. Run: 4ort push .");
-      return;
-    }
-
-    console.log("Your sites:\n");
-    for (const site of data.sites) {
-      console.log(`  ${site.subdomain}.4ort.net`);
-      console.log(`    Files: ${site.file_count} | Size: ${(site.size_bytes / 1024).toFixed(1)} KB`);
-      console.log(`    Updated: ${site.updated_at}\n`);
-    }
-  } catch (err: any) {
-    console.error(`Failed: ${err.message}`);
-    process.exit(1);
-  }
-}

package/src/commands/mail.ts

@@ -1,79 +0,0 @@
-import { apiRequest } from "../api-client.js";
-import { requireConfig } from "../config.js";
-
-export async function checkMail(options: { unread?: boolean }) {
-  const config = requireConfig();
-
-  try {
-    const query = options.unread ? "?unread=true" : "";
-    const data = await apiRequest(config, "GET", `/api/mail${query}`);
-
-    console.log(`Inbox: ${data.inbox}`);
-    console.log(`Unread: ${data.unread}\n`);
-
-    if (data.messages.length === 0) {
-      console.log("No messages.");
-      return;
-    }
-
-    for (const msg of data.messages) {
-      const marker = msg.read ? " " : "*";
-      console.log(`${marker} [${msg.id}] ${msg.from} — ${msg.subject}`);
-      console.log(`  ${msg.date}`);
-    }
-  } catch (err: any) {
-    console.error(`Failed: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-export async function readMail(id: string) {
-  const config = requireConfig();
-
-  try {
-    const data = await apiRequest(config, "GET", `/api/mail/${id}`);
-
-    console.log(`From: ${data.from}`);
-    console.log(`Subject: ${data.subject}`);
-    console.log(`Date: ${data.date}`);
-    console.log(`---`);
-    console.log(data.body);
-  } catch (err: any) {
-    console.error(`Failed: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-export async function sendMail(to: string, options: { subject?: string; body?: string }) {
-  const config = requireConfig();
-
-  if (!options.body) {
-    console.error("--body is required");
-    process.exit(1);
-  }
-
-  try {
-    const data = await apiRequest(config, "POST", "/api/mail/send", {
-      to,
-      subject: options.subject || "(no subject)",
-      body: options.body,
-    });
-
-    console.log(data.message);
-  } catch (err: any) {
-    console.error(`Failed: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-export async function deleteMail(id: string) {
-  const config = requireConfig();
-
-  try {
-    const data = await apiRequest(config, "DELETE", `/api/mail/${id}`);
-    console.log(data.message);
-  } catch (err: any) {
-    console.error(`Failed: ${err.message}`);
-    process.exit(1);
-  }
-}