cbrowser 20.0.1 → 20.0.2

package/dist/help-format.d.ts

@@ -0,0 +1,35 @@
+/**
+ * help-format.ts — turn a help answer into text a terminal can show.
+ *
+ * The help service (help-client.ts) answers in markdown with site-relative
+ * links, because question_answer hands the same answer to MCP clients that
+ * render markdown. `cbrowser ask` printed it verbatim, so a terminal showed
+ * `**bold**`, backticks and paths like /docs/tool-screenshot that nobody can
+ * open from a shell. This strips the markup, keeps the words, and makes every
+ * site path a full https://cbrowser.ai link.
+ *
+ * A path is treated as a site page only when it is a link target, appears in
+ * the answer's own sources, or sits under /docs/ or /blog/. Anything else that
+ * starts with a slash (a file path such as /tmp/shot.png) is left alone.
+ */
+export declare const DOCS_ORIGIN = "https://cbrowser.ai";
+/**
+ * A full link for a site path. Absolute URLs and other schemes pass through.
+ * cbrowser.ai serves its pages with a trailing slash and 301s without one, so
+ * a path whose last segment has no extension gets one.
+ */
+export declare function absoluteSiteUrl(url: string, origin?: string): string;
+/** The page path a source names, or null: "[/docs/x — full]: snippet" gives "/docs/x". */
+export declare function sourcePath(source: string): string | null;
+/** One full link per distinct source page, in order; a source with no page keeps its first line. */
+export declare function sourceLines(sources: readonly string[]): string[];
+/** The full links of the sources that name a page (for --json). */
+export declare function sourceUrls(sources: readonly string[]): string[];
+/**
+ * Markdown to plain terminal text. Headings, bold and code markers go; list
+ * items keep a dash; code blocks are indented; links become "words (url)";
+ * site paths become full links. `knownPaths` are the pages the answer's
+ * sources name, so a bare mention of one of them is linked too.
+ */
+export declare function formatAnswerForTerminal(markdown: string, knownPaths?: readonly string[]): string;
+//# sourceMappingURL=help-format.d.ts.map

package/dist/help-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-format.d.ts","sourceRoot":"","sources":["../src/help-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,WAAW,wBAAwB,CAAC;AAQjD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,MAAM,CAUzE;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKxD;AAED,oGAAoG;AACpG,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAWhE;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAE/D;AAwCD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,CAmBpG"}

package/dist/help-format.js

@@ -0,0 +1,140 @@
+/**
+ * help-format.ts — turn a help answer into text a terminal can show.
+ *
+ * The help service (help-client.ts) answers in markdown with site-relative
+ * links, because question_answer hands the same answer to MCP clients that
+ * render markdown. `cbrowser ask` printed it verbatim, so a terminal showed
+ * `**bold**`, backticks and paths like /docs/tool-screenshot that nobody can
+ * open from a shell. This strips the markup, keeps the words, and makes every
+ * site path a full https://cbrowser.ai link.
+ *
+ * A path is treated as a site page only when it is a link target, appears in
+ * the answer's own sources, or sits under /docs/ or /blog/. Anything else that
+ * starts with a slash (a file path such as /tmp/shot.png) is left alone.
+ */
+export const DOCS_ORIGIN = "https://cbrowser.ai";
+/** Site sections a bare path may name without appearing in the sources. */
+const SITE_SECTIONS = /^\/(docs|blog)(\/|$)/;
+/** A token that looks like a site path: letters, digits, dashes, slashes, an anchor. */
+const PATH_TOKEN = /^\/[A-Za-z0-9][\w\-/]*(#[\w-]*)?$/;
+/**
+ * A full link for a site path. Absolute URLs and other schemes pass through.
+ * cbrowser.ai serves its pages with a trailing slash and 301s without one, so
+ * a path whose last segment has no extension gets one.
+ */
+export function absoluteSiteUrl(url, origin = DOCS_ORIGIN) {
+    if (/^[a-z][a-z0-9+.-]*:/i.test(url))
+        return url;
+    if (url.startsWith("//"))
+        return `https:${url}`;
+    if (!url.startsWith("/"))
+        return url;
+    const m = /^([^?#]*)([?#].*)?$/.exec(url);
+    let path = m?.[1] ?? url;
+    const rest = m?.[2] ?? "";
+    const last = path.split("/").pop() ?? "";
+    if (path !== "/" && !path.endsWith("/") && !/\.[A-Za-z0-9]+$/.test(last))
+        path += "/";
+    return origin + path + rest;
+}
+/** The page path a source names, or null: "[/docs/x — full]: snippet" gives "/docs/x". */
+export function sourcePath(source) {
+    const labelled = /^\[\s*(\S+)\s+[—-][^\]]*\]/.exec(source.trim());
+    const first = labelled?.[1] ?? source.trim().split(/\s/)[0] ?? "";
+    if (/^https?:\/\//i.test(first))
+        return first;
+    return PATH_TOKEN.test(first) ? first : null;
+}
+/** One full link per distinct source page, in order; a source with no page keeps its first line. */
+export function sourceLines(sources) {
+    const seen = new Set();
+    const out = [];
+    for (const s of sources) {
+        const p = sourcePath(s);
+        const line = p ? absoluteSiteUrl(p) : s.split("\n")[0].slice(0, 120);
+        if (!line || seen.has(line))
+            continue;
+        seen.add(line);
+        out.push(line);
+    }
+    return out;
+}
+/** The full links of the sources that name a page (for --json). */
+export function sourceUrls(sources) {
+    return [...new Set(sources.map(sourcePath).filter((p) => p !== null).map((p) => absoluteSiteUrl(p)))];
+}
+function isSitePath(token, known) {
+    if (!PATH_TOKEN.test(token))
+        return false;
+    const bare = token.replace(/#.*$/, "").replace(/\/$/, "");
+    return SITE_SECTIONS.test(token) || known.has(bare);
+}
+/** Inline markup: code spans, links, emphasis, bare site paths. */
+function inline(text, known) {
+    // Code spans first, so nothing inside them is read as emphasis or a link.
+    // They wait behind private-use placeholders (U+E000), which no answer contains.
+    const codes = [];
+    let s = text.replace(/`([^`\n]+)`/g, (_, code) => {
+        codes.push(code);
+        return `\uE000${codes.length - 1}\uE000`;
+    });
+    // [text](url) and ![alt](url): the words, then the full link.
+    s = s.replace(/!?\[([^\]\n]*)\]\(\s*<?([^)\s>]+)>?(?:\s+"[^"]*")?\s*\)/g, (_, label, url) => {
+        const full = absoluteSiteUrl(url);
+        const words = label.trim();
+        return !words || words === url || absoluteSiteUrl(words) === full ? full : `${words} (${full})`;
+    });
+    s = s.replace(/<(https?:\/\/[^>\s]+)>/g, "$1");
+    // Emphasis. Underscores are only stripped in pairs of two, so an identifier
+    // such as _browserToken keeps its leading underscore.
+    s = s.replace(/\*\*(\S(?:.*?\S)?)\*\*/g, "$1").replace(/__(\S(?:.*?\S)?)__/g, "$1");
+    s = s.replace(/(^|[^\w*])\*(\S(?:[^*\n]*?\S)?)\*(?![\w*])/g, "$1$2");
+    s = s.replace(/~~(\S(?:.*?\S)?)~~/g, "$1");
+    // Bare site paths, where a word starts (never inside a URL).
+    s = s.replace(/(^|[\s(["'])(\/[A-Za-z0-9][\w\-/]*(?:#[\w-]*)?)/g, (m, before, path) => isSitePath(path, known) ? before + absoluteSiteUrl(path) : m);
+    s = s.replace(/\\([\\`*_{}[\]()#+\-.!>|~])/g, "$1");
+    return s.replace(/\uE000(\d+)\uE000/g, (_, i) => {
+        const code = codes[Number(i)];
+        return isSitePath(code, known) ? absoluteSiteUrl(code) : code;
+    });
+}
+/**
+ * Markdown to plain terminal text. Headings, bold and code markers go; list
+ * items keep a dash; code blocks are indented; links become "words (url)";
+ * site paths become full links. `knownPaths` are the pages the answer's
+ * sources name, so a bare mention of one of them is linked too.
+ */
+export function formatAnswerForTerminal(markdown, knownPaths = []) {
+    const known = new Set(knownPaths.map((p) => p.replace(/#.*$/, "").replace(/\/$/, "")));
+    const out = [];
+    let inFence = false;
+    for (const raw of markdown.replace(/\r\n?/g, "\n").split("\n")) {
+        if (/^\s*(```|~~~)/.test(raw)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence) {
+            out.push(`    ${raw}`);
+            continue;
+        }
+        if (/^\s*([-*_])(\s*\1){2,}\s*$/.test(raw)) {
+            out.push("");
+            continue;
+        }
+        if (/^\s*\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)*\|?\s*$/.test(raw))
+            continue;
+        const heading = /^\s{0,3}#{1,6}\s+(.*?)\s*#*\s*$/.exec(raw);
+        if (heading) {
+            out.push(inline(heading[1], known));
+            continue;
+        }
+        const line = raw
+            .replace(/^(\s*)>\s?/, "$1  ")
+            .replace(/^(\s*)[-*+]\s+/, "$1  - ")
+            .replace(/^(\s*)(\d+)[.)]\s+/, "$1  $2. ");
+        out.push(inline(line, known));
+    }
+    // Blank lines go from the ends; a first line's indent (a list item) stays.
+    return out.join("\n").replace(/\n{3,}/g, "\n\n").replace(/^(?:[ \t]*\n)+/, "").replace(/\s+$/, "");
+}
+//# sourceMappingURL=help-format.js.map

package/dist/help-format.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cbrowser",
-  "version": "20.0.1",
+  "version": "20.0.2",
   "type": "module",
   "description": "Cognitive browser automation that thinks like your users—and helps AI agents navigate too. Simulate real user cognition with abandonment detection, constitutional safety, chaos engineering, and UX friction discovery. Sites that pass CBrowser's cognitive tests are easier for both humans and AI agents to navigate.",
   "main": "dist/index.js",