@syengup/friday-channel-next 0.1.26 → 0.1.28

package/dist/index.js

@@ -8,6 +8,7 @@ import { getFridayNextRuntime } from "./src/runtime.js";
 import { sseEmitter } from "./src/sse/emitter.js";
 import { forwardAgentEventRaw, getLastRegisteredFridayDeviceId, resolveFridayDeviceIdForSessionKey, } from "./src/friday-session.js";
 import { setFridayAgentForwardRuntime } from "./src/agent-forward-runtime.js";
+import { setUpgradeRuntime } from "./src/upgrade-runtime.js";
 import { getOpenClawAgentRunContext } from "./src/agent-run-context-bridge.js";
 import { accumulateRunUsage } from "./src/agent/run-usage-accumulator.js";
 import { createFridayNextLogger } from "./src/logging.js";
@@ -78,6 +79,7 @@ export default defineChannelPluginEntry({
     setRuntime: setFridayNextRuntime,
     registerFull: (api) => {
         setFridayAgentForwardRuntime(api);
+        setUpgradeRuntime(api);
         const sameApi = lastApiRoutesRegistered?.deref() === api;
         if (!sameApi) {
             lastApiRoutesRegistered = new WeakRef(api);

package/dist/src/http/handlers/files.js

@@ -294,6 +294,7 @@ export function guessMimeType(filename) {
         ".jpeg": "image/jpeg",
         ".gif": "image/gif",
         ".webp": "image/webp",
+        ".ico": "image/x-icon",
         ".heic": "image/heic",
         ".pdf": "application/pdf",
         ".mp4": "video/mp4",

package/dist/src/http/handlers/health.d.ts

@@ -15,6 +15,7 @@ export interface HealthCheckResult {
     timestamp: number;
     deviceId: string;
     nodeDeviceId: string;
+    pluginVersion: string;
     nodePairing?: HealthComponentStatus;
     repairActions?: RepairAction[];
 }

package/dist/src/http/handlers/health.js

@@ -1,6 +1,7 @@
 import { extractBearerToken } from "../middleware/auth.js";
 import { loadNodePairingModule } from "../../agent/node-pairing-bridge.js";
 import { createFridayNextLogger } from "../../logging.js";
+import { PLUGIN_VERSION } from "../../version.js";
 const REQUIRED_NODE_CAPS = ["location", "canvas"];
 const REQUIRED_NODE_COMMANDS = [
     "location.get",
@@ -36,6 +37,7 @@ export async function handleHealth(req, res) {
         timestamp: Date.now(),
         deviceId,
         nodeDeviceId,
+        pluginVersion: PLUGIN_VERSION,
     };
     const log = createFridayNextLogger("health");
     if (nodeDeviceId) {

package/dist/src/http/handlers/link-preview.d.ts

@@ -0,0 +1,9 @@
+/**
+ * GET /friday-next/link-preview?url=<percent-encoded http(s) URL>
+ *
+ * Returns Open Graph metadata for a page link so the app can render a preview card without
+ * ever contacting the third-party site itself. Cover images are re-hosted under
+ * /friday-next/files/ by the preview service.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+export declare function handleLinkPreview(req: IncomingMessage, res: ServerResponse): Promise<boolean>;

package/dist/src/http/handlers/link-preview.js

@@ -0,0 +1,41 @@
+/**
+ * GET /friday-next/link-preview?url=<percent-encoded http(s) URL>
+ *
+ * Returns Open Graph metadata for a page link so the app can render a preview card without
+ * ever contacting the third-party site itself. Cover images are re-hosted under
+ * /friday-next/files/ by the preview service.
+ */
+import { getLinkPreview } from "../../link-preview/preview-service.js";
+import { extractBearerToken } from "../middleware/auth.js";
+const ERROR_STATUS = {
+    invalid_url: 400,
+    blocked_url: 403,
+    no_metadata: 422,
+    fetch_failed: 502,
+};
+export async function handleLinkPreview(req, res) {
+    if (req.method !== "GET") {
+        res.statusCode = 405;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({ error: "Method Not Allowed" }));
+        return true;
+    }
+    if (!extractBearerToken(req)) {
+        res.statusCode = 401;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({ ok: false, error: "unauthorized" }));
+        return true;
+    }
+    const url = new URL(req.url ?? "/", "http://localhost").searchParams.get("url")?.trim();
+    if (!url) {
+        res.statusCode = 400;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({ ok: false, error: "invalid_url" }));
+        return true;
+    }
+    const result = await getLinkPreview(url);
+    res.statusCode = result.ok ? 200 : ERROR_STATUS[result.error];
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(result));
+    return true;
+}

package/dist/src/http/handlers/messages.d.ts

@@ -47,4 +47,9 @@ export interface FridayMessagePayload {
     reasoningLevel?: string;
     thinkingLevel?: string;
 }
+/**
+ * 把可选文本与媒体引用拼成给 agent 的最终 body。纯附件（文本为空）场景下
+ * 不能带前导空行，否则 agent 收到的是 `\n\n[media…]`——故拆成可测纯函数。
+ */
+export declare function composeBodyWithMediaRefs(text: string, mediaRefs: string[]): string;
 export declare function handleMessages(req: IncomingMessage, res: ServerResponse): Promise<boolean>;

package/dist/src/http/handlers/messages.js

@@ -262,6 +262,16 @@ async function resolveRunMetadataFromRuntimeSession(runtime, sessionKey) {
     }
     return null;
 }
+/**
+ * 把可选文本与媒体引用拼成给 agent 的最终 body。纯附件（文本为空）场景下
+ * 不能带前导空行，否则 agent 收到的是 `\n\n[media…]`——故拆成可测纯函数。
+ */
+export function composeBodyWithMediaRefs(text, mediaRefs) {
+    const trimmed = text.trim();
+    if (mediaRefs.length === 0)
+        return trimmed;
+    return trimmed ? `${trimmed}\n\n${mediaRefs.join("\n")}` : mediaRefs.join("\n");
+}
 async function buildBodyForAgentWithAttachments(text, attachmentIds) {
     if (attachmentIds.length === 0)
         return text.trim();
@@ -275,9 +285,7 @@ async function buildBodyForAgentWithAttachments(text, attachmentIds) {
             mediaRefs.push(`[media attached: file://${saved.path}]`);
         }
     }
-    if (mediaRefs.length === 0)
-        return text.trim();
-    return `${text.trim()}\n\n${mediaRefs.join("\n")}`;
+    return composeBodyWithMediaRefs(text, mediaRefs);
 }
 export async function handleMessages(req, res) {
     if (req.method !== "POST") {
@@ -320,14 +328,17 @@ export async function handleMessages(req, res) {
         res.end(JSON.stringify({ error: "Missing required field: deviceId" }));
         return true;
     }
-    if (!text || !text.trim()) {
-        log("BAD_REQUEST", normalizedDeviceId, undefined, "missing text", "warn");
+    // 允许"只发附件、不发文本"：text 与 attachments 不能同时为空，但任一非空即放行。
+    const hasText = Boolean(text && text.trim());
+    const hasAttachments = Array.isArray(attachments) && attachments.length > 0;
+    if (!hasText && !hasAttachments) {
+        log("BAD_REQUEST", normalizedDeviceId, undefined, "missing text and attachments", "warn");
         res.statusCode = 400;
         res.setHeader("Content-Type", "application/json");
-        res.end(JSON.stringify({ error: "Missing required field: text" }));
+        res.end(JSON.stringify({ error: "Missing required field: text or attachments" }));
         return true;
     }
-    const trimmedText = text.trim();
+    const trimmedText = (text ?? "").trim();
     touchFridayInbound();
     const isSlashCommand = trimmedText.startsWith("/");
     const runId = crypto.randomUUID();
@@ -363,7 +374,7 @@ export async function handleMessages(req, res) {
     registerFridaySessionDeviceMapping(appSessionKey, normalizedDeviceId);
     sseEmitter.trackDeviceForRun(normalizedDeviceId, runId);
     registerRunRoute({ runId, deviceId: normalizedDeviceId, sessionKey: baseSessionKey });
-    const bodyForAgent = await buildBodyForAgentWithAttachments(text, attachments);
+    const bodyForAgent = await buildBodyForAgentWithAttachments(trimmedText, attachments);
     const msgContext = {
         Body: trimmedText,
         BodyForAgent: bodyForAgent,

package/dist/src/http/handlers/plugin-info.d.ts

@@ -0,0 +1,11 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+export interface PluginInfoResult {
+    currentVersion: string;
+    latestVersion: string | null;
+    installSource: string;
+    /** True when the install is npm-managed (the only auto-upgradable source). */
+    canAutoUpgrade: boolean;
+    /** True when a newer version is published AND the install can be auto-upgraded. */
+    upgradable: boolean;
+}
+export declare function handlePluginInfo(req: IncomingMessage, res: ServerResponse): Promise<boolean>;

package/dist/src/http/handlers/plugin-info.js

@@ -0,0 +1,32 @@
+import { extractBearerToken } from "../middleware/auth.js";
+import { PLUGIN_VERSION } from "../../version.js";
+import { fetchLatestVersion, getInstallSource, semverGreater, } from "../../plugin-install-info.js";
+export async function handlePluginInfo(req, res) {
+    if (req.method !== "GET") {
+        res.statusCode = 405;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({ error: "Method Not Allowed" }));
+        return true;
+    }
+    if (!extractBearerToken(req)) {
+        res.statusCode = 401;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({ error: "Unauthorized: bearer token mismatch" }));
+        return true;
+    }
+    const installSource = getInstallSource();
+    const canAutoUpgrade = installSource === "npm";
+    const latestVersion = await fetchLatestVersion(Date.now());
+    const upgradable = canAutoUpgrade && semverGreater(latestVersion, PLUGIN_VERSION);
+    const result = {
+        currentVersion: PLUGIN_VERSION,
+        latestVersion,
+        installSource,
+        canAutoUpgrade,
+        upgradable,
+    };
+    res.statusCode = 200;
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(result));
+    return true;
+}

package/dist/src/http/handlers/plugin-upgrade.d.ts

@@ -0,0 +1,11 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+/**
+ * POST /friday-next/plugin/upgrade
+ *
+ * Runs `openclaw plugins install @syengup/friday-channel-next@latest --force`
+ * (registry-aware, updates the install record), responds 202, then triggers a
+ * safe gateway restart so the new version loads. Only npm-installed plugins are
+ * eligible — dev (load.paths / source==="path") installs return 409 to protect
+ * the dev environment from duplicate npm installs.
+ */
+export declare function handlePluginUpgrade(req: IncomingMessage, res: ServerResponse): Promise<boolean>;

package/dist/src/http/handlers/plugin-upgrade.js

@@ -0,0 +1,94 @@
+import { extractBearerToken } from "../middleware/auth.js";
+import { createFridayNextLogger } from "../../logging.js";
+import { PLUGIN_PACKAGE_NAME, PLUGIN_VERSION } from "../../version.js";
+import { getInstallSource } from "../../plugin-install-info.js";
+import { getUpgradeRuntime } from "../../upgrade-runtime.js";
+const UPGRADE_TIMEOUT_MS = 120_000;
+/** Give the 202 response time to flush before the restart kills the process. */
+const RESTART_DELAY_MS = 500;
+/**
+ * POST /friday-next/plugin/upgrade
+ *
+ * Runs `openclaw plugins install @syengup/friday-channel-next@latest --force`
+ * (registry-aware, updates the install record), responds 202, then triggers a
+ * safe gateway restart so the new version loads. Only npm-installed plugins are
+ * eligible — dev (load.paths / source==="path") installs return 409 to protect
+ * the dev environment from duplicate npm installs.
+ */
+export async function handlePluginUpgrade(req, res) {
+    if (req.method !== "POST") {
+        res.statusCode = 405;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({ error: "Method Not Allowed" }));
+        return true;
+    }
+    if (!extractBearerToken(req)) {
+        res.statusCode = 401;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({ error: "Unauthorized: bearer token mismatch" }));
+        return true;
+    }
+    const log = createFridayNextLogger("upgrade");
+    const installSource = getInstallSource();
+    if (installSource !== "npm") {
+        res.statusCode = 409;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({
+            error: "auto-upgrade not available",
+            detail: `install source is "${installSource}"; only npm installs can be auto-upgraded`,
+            installSource,
+        }));
+        return true;
+    }
+    const rt = getUpgradeRuntime();
+    if (!rt) {
+        res.statusCode = 500;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({ error: "upgrade runtime unavailable" }));
+        return true;
+    }
+    const spec = `${PLUGIN_PACKAGE_NAME}@latest`;
+    log.info(`Starting plugin upgrade: ${spec} (from ${PLUGIN_VERSION})`);
+    let result;
+    try {
+        result = await rt.runCommandWithTimeout(["openclaw", "plugins", "install", spec, "--force"], UPGRADE_TIMEOUT_MS);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.error(`plugin upgrade command failed to spawn: ${msg}`);
+        res.statusCode = 500;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({ error: "upgrade command failed", detail: msg }));
+        return true;
+    }
+    if (result.code !== 0) {
+        const stderrTail = (result.stderr ?? "").slice(-2000);
+        log.error(`plugin upgrade exited code=${result.code}: ${stderrTail}`);
+        res.statusCode = 500;
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify({
+            error: "upgrade command exited non-zero",
+            code: result.code,
+            detail: stderrTail,
+        }));
+        return true;
+    }
+    log.info("Plugin upgrade install succeeded; scheduling gateway restart");
+    // Respond first so the app receives confirmation before the restart drops the
+    // connection, then trigger the safe restart after a short flush delay.
+    res.statusCode = 202;
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify({ status: "upgrading", from: PLUGIN_VERSION }));
+    setTimeout(() => {
+        void rt
+            .mutateConfigFile({
+            afterWrite: { mode: "restart", reason: "friday-next 插件自动升级后重启" },
+            mutate: () => { },
+        })
+            .catch((err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            log.error(`gateway restart trigger failed: ${msg}`);
+        });
+    }, RESTART_DELAY_MS).unref?.();
+    return true;
+}

package/dist/src/http/handlers/sse.js

@@ -3,6 +3,7 @@ import { getHostOpenClawConfigSnapshot } from "../../host-config.js";
 import { getFridayNextRuntime } from "../../runtime.js";
 import { sseEmitter } from "../../sse/emitter.js";
 import { extractBearerToken } from "../middleware/auth.js";
+import { PLUGIN_VERSION } from "../../version.js";
 function parseLastEventId(req, url) {
     const query = Number.parseInt(url.searchParams.get("lastEventId") ?? "", 10);
     if (Number.isFinite(query))
@@ -48,6 +49,7 @@ export async function handleSseStream(req, res) {
             deviceId: normalized,
             serverTime: Date.now(),
             lastSeq,
+            pluginVersion: PLUGIN_VERSION,
         },
     }, deviceId, true);
     const lastEventId = parseLastEventId(req, url);

package/dist/src/http/handlers/status.js

@@ -1,6 +1,7 @@
 import { getActiveRunIds } from "../../agent/active-runs.js";
 import { sseEmitter } from "../../sse/emitter.js";
 import { extractBearerToken } from "../middleware/auth.js";
+import { PLUGIN_VERSION } from "../../version.js";
 export async function handleStatus(req, res) {
     if (req.method !== "GET") {
         res.statusCode = 405;
@@ -21,6 +22,7 @@ export async function handleStatus(req, res) {
         ok: true,
         channel: "friday-next",
         version: "v2",
+        pluginVersion: PLUGIN_VERSION,
         connections: sseEmitter.getConnectionCount(),
         activeRuns,
         activeRunCount: activeRuns.length,

package/dist/src/http/server.js

@@ -18,7 +18,10 @@ import { handleHistorySessions } from "./handlers/history-sessions.js";
 import { handleHistoryMessages } from "./handlers/history-messages.js";
 import { handleHistorySetTitle } from "./handlers/history-set-title.js";
 import { handleStatus } from "./handlers/status.js";
+import { handleLinkPreview } from "./handlers/link-preview.js";
 import { handleHealth } from "./handlers/health.js";
+import { handlePluginInfo } from "./handlers/plugin-info.js";
+import { handlePluginUpgrade } from "./handlers/plugin-upgrade.js";
 import { applyCorsHeaders } from "./middleware/cors.js";
 import { resolveFridayNextConfig } from "../config.js";
 import { getHostOpenClawConfigSnapshot } from "../host-config.js";
@@ -83,10 +86,22 @@ async function handleFridayNextRoute(req, res) {
     if ((req.method === "PUT" || req.method === "POST") && pathname === "/friday-next/sessions/title") {
         return await handleHistorySetTitle(req, res);
     }
+    // Route: GET /friday-next/link-preview?url=... (Open Graph metadata for preview cards)
+    if (req.method === "GET" && pathname === "/friday-next/link-preview") {
+        return await handleLinkPreview(req, res);
+    }
     // Route: GET /friday-next/health?deviceId=...&nodeDeviceId=...&selfHeal=true
     if (req.method === "GET" && pathname === "/friday-next/health") {
         return await handleHealth(req, res);
     }
+    // Route: GET /friday-next/plugin/info (current/latest version + upgradability)
+    if (req.method === "GET" && pathname === "/friday-next/plugin/info") {
+        return await handlePluginInfo(req, res);
+    }
+    // Route: POST /friday-next/plugin/upgrade (npm install @latest + safe gateway restart)
+    if (req.method === "POST" && pathname === "/friday-next/plugin/upgrade") {
+        return await handlePluginUpgrade(req, res);
+    }
     // Not found
     return false;
 }

package/dist/src/link-preview/og-parse.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Open Graph metadata extraction via regex — no HTML parser dependency.
+ *
+ * Good enough for the link-preview card use case: og:* meta tags are flat, attribute-ordered
+ * variants are handled generically, and pages where this fails simply degrade to "no card".
+ */
+export interface OpenGraphResult {
+    title: string | null;
+    description: string | null;
+    imageUrl: string | null;
+    siteName: string | null;
+    /** Favicon URL parsed from `<link rel="...icon...">`, resolved absolute. */
+    iconUrl: string | null;
+}
+export declare function decodeHtmlEntities(s: string): string;
+export declare function parseOpenGraph(html: string, baseUrl: string): OpenGraphResult;
+/**
+ * Pick the best `<link rel="...icon...">` href. Prefers a high-res `apple-touch-icon`, then a
+ * regular `icon` / `shortcut icon`. Skips `mask-icon` (monochrome SVG). Returns absolute http(s).
+ */
+export declare function parseFaviconUrl(html: string, baseUrl: string): string | null;

package/dist/src/link-preview/og-parse.js

@@ -0,0 +1,232 @@
+/**
+ * Open Graph metadata extraction via regex — no HTML parser dependency.
+ *
+ * Good enough for the link-preview card use case: og:* meta tags are flat, attribute-ordered
+ * variants are handled generically, and pages where this fails simply degrade to "no card".
+ */
+const MAX_PARSE_BYTES = 512 * 1024;
+const META_TAG_RE = /<meta\b[^>]*>/gi;
+const TITLE_TAG_RE = /<title[^>]*>([\s\S]*?)<\/title>/i;
+const LINK_TAG_RE = /<link\b[^>]*>/gi;
+/** Extract one attribute value from a tag, tolerating single/double/no quotes and any order. */
+function attributeValue(tag, name) {
+    const re = new RegExp(`\\b${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s"'>]+))`, "i");
+    const m = tag.match(re);
+    if (!m)
+        return null;
+    return m[1] ?? m[2] ?? m[3] ?? "";
+}
+const NAMED_ENTITIES = {
+    amp: "&",
+    lt: "<",
+    gt: ">",
+    quot: '"',
+    apos: "'",
+    nbsp: " ",
+    ndash: "–",
+    mdash: "—",
+    hellip: "…",
+    middot: "·",
+    copy: "©",
+    reg: "®",
+    trade: "™",
+    lsquo: "‘",
+    rsquo: "’",
+    ldquo: "“",
+    rdquo: "”",
+    laquo: "«",
+    raquo: "»",
+};
+export function decodeHtmlEntities(s) {
+    return s.replace(/&(#x?[0-9a-f]+|[a-z]+);/gi, (whole, body) => {
+        if (body.startsWith("#x") || body.startsWith("#X")) {
+            const code = Number.parseInt(body.slice(2), 16);
+            return Number.isFinite(code) ? String.fromCodePoint(code) : whole;
+        }
+        if (body.startsWith("#")) {
+            const code = Number.parseInt(body.slice(1), 10);
+            return Number.isFinite(code) ? String.fromCodePoint(code) : whole;
+        }
+        return NAMED_ENTITIES[body.toLowerCase()] ?? whole;
+    });
+}
+function cleanText(raw) {
+    if (raw == null)
+        return null;
+    const text = decodeHtmlEntities(raw).replace(/\s+/g, " ").trim();
+    return text || null;
+}
+/** Resolve og:image (possibly relative) against the final page URL; only http(s) survives. */
+function resolveImageUrl(raw, baseUrl) {
+    if (!raw)
+        return null;
+    try {
+        const url = new URL(raw.trim(), baseUrl);
+        if (url.protocol !== "http:" && url.protocol !== "https:")
+            return null;
+        return url.toString();
+    }
+    catch {
+        return null;
+    }
+}
+export function parseOpenGraph(html, baseUrl) {
+    const slice = html.length > MAX_PARSE_BYTES ? html.slice(0, MAX_PARSE_BYTES) : html;
+    // First occurrence wins per key (matches browser/crawler behavior).
+    const og = {};
+    const tw = {};
+    let metaDescription = null;
+    for (const match of slice.matchAll(META_TAG_RE)) {
+        const tag = match[0];
+        const key = (attributeValue(tag, "property") ?? attributeValue(tag, "name"))?.trim().toLowerCase();
+        if (!key)
+            continue;
+        const content = attributeValue(tag, "content");
+        if (content == null || !content.trim())
+            continue;
+        if (key.startsWith("og:")) {
+            const ogKey = key.slice(3);
+            if (!(ogKey in og))
+                og[ogKey] = content;
+        }
+        else if (key.startsWith("twitter:")) {
+            const twKey = key.slice(8);
+            if (!(twKey in tw))
+                tw[twKey] = content;
+        }
+        else if (key === "description" && metaDescription == null) {
+            metaDescription = content;
+        }
+    }
+    const ld = parseJsonLd(slice);
+    const pageTitle = slice.match(TITLE_TAG_RE)?.[1] ?? null;
+    // Title chain: standard tags first, then server-rendered body title (h1 / article-title class)
+    // BEFORE the generic <title> — many SPA/news shells put a useless <title> ("搜索资讯页") in the
+    // head while the real headline lives in the body.
+    const title = cleanText(og["title"]) ??
+        cleanText(tw["title"]) ??
+        cleanText(ld.title) ??
+        cleanText(parseBodyTitle(slice)) ??
+        cleanText(pageTitle);
+    const description = cleanText(og["description"]) ??
+        cleanText(tw["description"]) ??
+        cleanText(ld.description) ??
+        cleanText(metaDescription);
+    const imageUrl = resolveImageUrl(og["image"] ?? null, baseUrl) ??
+        resolveImageUrl(tw["image"] ?? null, baseUrl) ??
+        resolveImageUrl(ld.image, baseUrl) ??
+        resolveImageUrl(parseBodyCoverImage(slice), baseUrl);
+    return {
+        title,
+        description,
+        imageUrl,
+        siteName: cleanText(og["site_name"] ?? tw["site"] ?? null),
+        iconUrl: parseFaviconUrl(slice, baseUrl),
+    };
+}
+const JSON_LD_RE = /<script[^>]*type\s*=\s*["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi;
+/** Extract title/description/image from JSON-LD blocks (schema.org Article/NewsArticle/etc.). */
+function parseJsonLd(html) {
+    for (const match of html.matchAll(JSON_LD_RE)) {
+        let data;
+        try {
+            data = JSON.parse(match[1].trim());
+        }
+        catch {
+            continue;
+        }
+        // JSON-LD may be a single object, an array, or a @graph container.
+        const nodes = Array.isArray(data)
+            ? data
+            : isRecord(data) && Array.isArray(data["@graph"])
+                ? data["@graph"]
+                : [data];
+        for (const node of nodes) {
+            if (!isRecord(node))
+                continue;
+            const title = asString(node.headline) ?? asString(node.name);
+            const description = asString(node.description);
+            const image = firstImage(node.image) ?? asString(node.thumbnailUrl);
+            if (title || description || image) {
+                return { title: title ?? null, description: description ?? null, image: image ?? null };
+            }
+        }
+    }
+    return { title: null, description: null, image: null };
+}
+function isRecord(v) {
+    return typeof v === "object" && v !== null;
+}
+function asString(v) {
+    return typeof v === "string" && v.trim() ? v : null;
+}
+/** JSON-LD `image` is a string, an array, or an ImageObject `{ url }`. */
+function firstImage(v) {
+    if (typeof v === "string")
+        return v;
+    if (Array.isArray(v)) {
+        for (const item of v) {
+            const found = firstImage(item);
+            if (found)
+                return found;
+        }
+        return null;
+    }
+    if (isRecord(v))
+        return asString(v.url);
+    return null;
+}
+// Common server-rendered article-title class names (whitelist keeps false positives down vs. any
+// class containing "title", e.g. a sidebar "related-titles" block).
+const BODY_TITLE_CLASS_RE = /class\s*=\s*["'][^"']*\b(?:article-title|post-title|entry-title|news-title|content-title|headline|title-text)\b[^"']*["'][^>]*>\s*([^<]{4,200}?)\s*</i;
+const H1_RE = /<h1\b[^>]*>\s*([\s\S]{4,200}?)\s*<\/h1>/i;
+/** Server-rendered headline fallback: first <h1>, else an element with a known article-title class. */
+function parseBodyTitle(html) {
+    const h1 = html.match(H1_RE)?.[1];
+    if (h1) {
+        const text = stripTags(h1).trim();
+        if (text.length >= 4)
+            return text;
+    }
+    return html.match(BODY_TITLE_CLASS_RE)?.[1] ?? null;
+}
+// Cover image embedded in inline JSON (e.g. QQ's `"imgUrl":"http:\/\/...cover..."`). The URL may be
+// extensionless; the re-host step's magic-byte sniff is the safety net against non-image matches.
+const JSON_COVER_RE = /"(?:imgUrl|imageUrl|coverUrl|coverImage|cover|ogImage|thumbnail|picUrl)"\s*:\s*"(https?:(?:\\?\/){2}[^"]+?)"/i;
+/** Cover image from inline JSON when no og/twitter/json-ld image is present. */
+function parseBodyCoverImage(html) {
+    const raw = html.match(JSON_COVER_RE)?.[1];
+    if (!raw)
+        return null;
+    return raw.replace(/\\\//g, "/"); // unescape JSON `\/`
+}
+function stripTags(s) {
+    return s.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ");
+}
+/**
+ * Pick the best `<link rel="...icon...">` href. Prefers a high-res `apple-touch-icon`, then a
+ * regular `icon` / `shortcut icon`. Skips `mask-icon` (monochrome SVG). Returns absolute http(s).
+ */
+export function parseFaviconUrl(html, baseUrl) {
+    let appleTouch = null;
+    let regular = null;
+    for (const match of html.matchAll(LINK_TAG_RE)) {
+        const tag = match[0];
+        const rel = attributeValue(tag, "rel")?.trim().toLowerCase();
+        if (!rel || !rel.includes("icon") || rel.includes("mask-icon"))
+            continue;
+        const href = attributeValue(tag, "href");
+        if (!href)
+            continue;
+        const resolved = resolveImageUrl(href, baseUrl);
+        if (!resolved)
+            continue;
+        if (rel.includes("apple-touch-icon")) {
+            appleTouch ??= resolved;
+        }
+        else {
+            regular ??= resolved;
+        }
+    }
+    return appleTouch ?? regular;
+}