@wudao-org/browser 0.0.0-stage → 0.4.21

package/dist/snapshot.d.ts

@@ -0,0 +1,58 @@
+import type { SnapshotRefEntry } from "./runtime.js";
+/** Hard output budget for the model-facing snapshot (maxResultSizeChars
+ *  spirit: bounded context, honest truncation note over silent loss). */
+export declare const MAX_SNAPSHOT_CHARS = 12000;
+/** ω99-136 — an element's viewport rect in CSS PIXELS (getBoundingClientRect).
+ *  Screenshot bytes (port.ts) are DEVICE pixels (CSS × devicePixelRatio): this
+ *  arc reports both spaces honestly and does NOT convert — the single
+ *  canonical coordinate layer is the next arc. */
+export interface ElementBbox {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface CollectedElement {
+    readonly ref: string;
+    readonly tag: string;
+    readonly text: string;
+    readonly href?: string;
+    readonly value?: string;
+    readonly placeholder?: string;
+    readonly type?: string;
+    readonly checked?: boolean;
+    readonly disabled?: boolean;
+    /** ω99-136: optional so OLD collected payloads (pre-vision snapshots) stay
+     *  shape-compatible — absence means "geometry not collected", never 0,0. */
+    readonly bbox?: ElementBbox;
+}
+export interface CollectedPage {
+    readonly url: string;
+    readonly title: string;
+    readonly text: string;
+    readonly elements: readonly CollectedElement[];
+}
+/** The snapshot collector — a plain-ES EXPRESSION (an IIFE) the default port
+ *  hands to page.evaluate. Deterministic, no external state: previous refs
+ *  are wiped, visibility is geometry+style, the list caps at 200 elements. */
+export declare const COLLECT_SCRIPT = "(() => {\n  const clean = (s, n) => { const t = String(s == null ? \"\" : s).replace(/\\s+/g, \" \").trim(); return t.length > n ? t.slice(0, n) + \"\u2026\" : t; };\n  document.querySelectorAll(\"[data-wudao-ref]\").forEach((el) => el.removeAttribute(\"data-wudao-ref\"));\n  const visible = (el) => {\n    const r = el.getBoundingClientRect();\n    if (r.width <= 0 || r.height <= 0) return false;\n    const s = getComputedStyle(el);\n    return s.visibility !== \"hidden\" && s.display !== \"none\";\n  };\n  const sel = 'a, button, input, select, textarea, summary, [role=\"button\"], [role=\"link\"], [role=\"tab\"], [role=\"checkbox\"], [onclick]';\n  const els = Array.from(document.querySelectorAll(sel)).filter(visible).slice(0, 200);\n  const elements = els.map((el, i) => {\n    const ref = \"e\" + (i + 1);\n    el.setAttribute(\"data-wudao-ref\", ref);\n    const out = { ref: ref, tag: el.tagName.toLowerCase(), text: clean(el.getAttribute(\"aria-label\") || el.textContent || el.value || \"\", 80) };\n    // \u03C999-136: CSS-pixel viewport rect for the vision lane (see ElementBbox);\n    // raw doubles, no rounding \u2014 coordinate-space decisions belong to the next arc.\n    const r = el.getBoundingClientRect();\n    out.bbox = { x: r.x, y: r.y, width: r.width, height: r.height };\n    const href = el.getAttribute(\"href\");\n    if (el.tagName === \"A\" && href) out.href = clean(href, 100);\n    if (el.tagName === \"INPUT\" || el.tagName === \"TEXTAREA\" || el.tagName === \"SELECT\") {\n      if (el.getAttribute(\"type\")) out.type = el.getAttribute(\"type\");\n      if (el.getAttribute(\"placeholder\")) out.placeholder = clean(el.getAttribute(\"placeholder\"), 60);\n      if (el.value !== undefined && el.value !== \"\") out.value = clean(el.value, 60);\n      if (el.type === \"checkbox\" || el.type === \"radio\") out.checked = !!el.checked;\n    }\n    if (el.disabled) out.disabled = true;\n    return out;\n  });\n  const text = document.body ? document.body.innerText : \"\";\n  return { url: location.href, title: document.title, text: text.slice(0, 20000), elements: elements };\n})()";
+export declare const refSelector: (ref: string) => string;
+/** Tool-input validation: refs are exactly e<positive-digits>. */
+export declare function validRef(ref: string): boolean;
+/** One element line: `- e1 [a] "Guide" → /guide` (+input/value facets).
+ *  ω99-136: a collected bbox appends `@[x,y,w,h]` (CSS px) so the vision lane
+ *  can correlate refs with pixels; the four numbers ride INSIDE the line, so
+ *  their chars are spent from the same 12k budget — over budget shrinks the
+ *  element list (fit check #3), never the discipline. */
+export declare function elementLine(e: CollectedElement): string;
+/** Pure: the model-facing snapshot text + the ref→selector map, under the
+ *  hard budget. Priority when truncating: keep EVERY element line (the refs
+ *  are the actionable surface) and cut the page text first; if the element
+ *  list alone still exceeds the budget, cut lines and say so. The refs map
+ *  only ever contains refs whose line SURVIVED — a ref the model cannot see
+ *  is a stale promise we refuse to hand out. */
+export declare function formatSnapshot(p: CollectedPage): {
+    text: string;
+    refs: Map<string, SnapshotRefEntry>;
+};
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;yEACyE;AACzE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC;;;kDAGkD;AAClD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;gFAC4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAED;;8EAE8E;AAC9E,eAAO,MAAM,cAAc,olEAgCtB,CAAC;AAEN,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,MAAqC,CAAC;AAEhF,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAID;;;;yDAIyD;AACzD,wBAAgB,WAAW,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAYvD;AAED;;;;;gDAKgD;AAChD,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAAE,CAyCtG"}

package/dist/snapshot.js

@@ -0,0 +1,121 @@
+/** Hard output budget for the model-facing snapshot (maxResultSizeChars
+ *  spirit: bounded context, honest truncation note over silent loss). */
+export const MAX_SNAPSHOT_CHARS = 12_000;
+/** The snapshot collector — a plain-ES EXPRESSION (an IIFE) the default port
+ *  hands to page.evaluate. Deterministic, no external state: previous refs
+ *  are wiped, visibility is geometry+style, the list caps at 200 elements. */
+export const COLLECT_SCRIPT = `(() => {
+  const clean = (s, n) => { const t = String(s == null ? "" : s).replace(/\\s+/g, " ").trim(); return t.length > n ? t.slice(0, n) + "…" : t; };
+  document.querySelectorAll("[data-wudao-ref]").forEach((el) => el.removeAttribute("data-wudao-ref"));
+  const visible = (el) => {
+    const r = el.getBoundingClientRect();
+    if (r.width <= 0 || r.height <= 0) return false;
+    const s = getComputedStyle(el);
+    return s.visibility !== "hidden" && s.display !== "none";
+  };
+  const sel = 'a, button, input, select, textarea, summary, [role="button"], [role="link"], [role="tab"], [role="checkbox"], [onclick]';
+  const els = Array.from(document.querySelectorAll(sel)).filter(visible).slice(0, 200);
+  const elements = els.map((el, i) => {
+    const ref = "e" + (i + 1);
+    el.setAttribute("data-wudao-ref", ref);
+    const out = { ref: ref, tag: el.tagName.toLowerCase(), text: clean(el.getAttribute("aria-label") || el.textContent || el.value || "", 80) };
+    // ω99-136: CSS-pixel viewport rect for the vision lane (see ElementBbox);
+    // raw doubles, no rounding — coordinate-space decisions belong to the next arc.
+    const r = el.getBoundingClientRect();
+    out.bbox = { x: r.x, y: r.y, width: r.width, height: r.height };
+    const href = el.getAttribute("href");
+    if (el.tagName === "A" && href) out.href = clean(href, 100);
+    if (el.tagName === "INPUT" || el.tagName === "TEXTAREA" || el.tagName === "SELECT") {
+      if (el.getAttribute("type")) out.type = el.getAttribute("type");
+      if (el.getAttribute("placeholder")) out.placeholder = clean(el.getAttribute("placeholder"), 60);
+      if (el.value !== undefined && el.value !== "") out.value = clean(el.value, 60);
+      if (el.type === "checkbox" || el.type === "radio") out.checked = !!el.checked;
+    }
+    if (el.disabled) out.disabled = true;
+    return out;
+  });
+  const text = document.body ? document.body.innerText : "";
+  return { url: location.href, title: document.title, text: text.slice(0, 20000), elements: elements };
+})()`;
+export const refSelector = (ref) => `[data-wudao-ref="${ref}"]`;
+/** Tool-input validation: refs are exactly e<positive-digits>. */
+export function validRef(ref) {
+    return /^e[1-9][0-9]{0,4}$/.test(ref);
+}
+const TRUNCATION_NOTE = "\n[snapshot truncated at the char budget — run browser_snapshot again after scrolling to see more]";
+/** One element line: `- e1 [a] "Guide" → /guide` (+input/value facets).
+ *  ω99-136: a collected bbox appends `@[x,y,w,h]` (CSS px) so the vision lane
+ *  can correlate refs with pixels; the four numbers ride INSIDE the line, so
+ *  their chars are spent from the same 12k budget — over budget shrinks the
+ *  element list (fit check #3), never the discipline. */
+export function elementLine(e) {
+    const parts = [`- ${e.ref} [${e.tag}`];
+    if (e.type !== undefined)
+        parts.push(`type=${e.type}`);
+    if (e.placeholder !== undefined)
+        parts.push(`placeholder="${e.placeholder}"`);
+    if (e.checked !== undefined)
+        parts.push(e.checked ? "checked" : "unchecked");
+    let line = parts.join(" ") + "]";
+    if (e.text !== "")
+        line += ` "${e.text}"`;
+    if (e.value !== undefined)
+        line += ` (value: ${e.value})`;
+    if (e.href !== undefined)
+        line += ` → ${e.href}`;
+    if (e.bbox !== undefined)
+        line += ` @[${e.bbox.x},${e.bbox.y},${e.bbox.width},${e.bbox.height}]`;
+    if (e.disabled === true)
+        line += " [disabled]";
+    return line;
+}
+/** Pure: the model-facing snapshot text + the ref→selector map, under the
+ *  hard budget. Priority when truncating: keep EVERY element line (the refs
+ *  are the actionable surface) and cut the page text first; if the element
+ *  list alone still exceeds the budget, cut lines and say so. The refs map
+ *  only ever contains refs whose line SURVIVED — a ref the model cannot see
+ *  is a stale promise we refuse to hand out. */
+export function formatSnapshot(p) {
+    const header = `# ${p.title}\n${p.url}\n`;
+    const emptyNote = p.elements.length === 0 ? "no clickable elements on this page\n" : "";
+    const elementLines = p.elements.map(elementLine);
+    const listHead = "\n# Clickable elements (address by ref from browser_snapshot)\n";
+    const refMapFor = (lines, els) => {
+        const shown = new Set(lines.map((l) => /^- (e[1-9][0-9]{0,4}) /.exec(l)?.[1]).filter((x) => x !== undefined));
+        const m = new Map();
+        for (const e of els) {
+            if (shown.has(e.ref)) {
+                // ω99-114: carry the type facet so tools.ts can refuse typing into
+                // password fields (unknown type stays absent — never guessed).
+                // ω99-139: carry the bbox too (browser_click_xy's hit-test source;
+                // absent stays absent — never guessed).
+                m.set(e.ref, { selector: refSelector(e.ref), desc: `${e.tag} "${e.text}"`, ...(e.type !== undefined ? { type: e.type } : {}), ...(e.bbox !== undefined ? { bbox: e.bbox } : {}) });
+            }
+        }
+        return m;
+    };
+    // Fit check #1: everything fits — done.
+    const full = `${header}\n# Page outline\n${p.text}\n${listHead}${elementLines.join("\n")}\n${emptyNote}`.replace(/\n{3,}/g, "\n\n");
+    if (full.length <= MAX_SNAPSHOT_CHARS) {
+        return { text: full, refs: refMapFor(elementLines, p.elements) };
+    }
+    // Fit check #2: keep all element lines, cut the page text.
+    const listBlock = `${listHead}${elementLines.join("\n")}\n`;
+    const textBudget = MAX_SNAPSHOT_CHARS - header.length - listBlock.length - TRUNCATION_NOTE.length - 16;
+    if (textBudget > 200) {
+        const text = `${header}\n# Page outline\n${p.text.slice(0, textBudget)}…\n${listBlock}${TRUNCATION_NOTE}`;
+        return { text, refs: refMapFor(elementLines, p.elements) };
+    }
+    // Fit check #3: the element list alone is over budget — cut lines.
+    const kept = [];
+    let used = header.length + listHead.length + 24 /* outline remnant */;
+    for (const line of elementLines) {
+        if (used + line.length + 1 > MAX_SNAPSHOT_CHARS - TRUNCATION_NOTE.length)
+            break;
+        kept.push(line);
+        used += line.length + 1;
+    }
+    const text = `${header}\n# Page outline\n${p.text.slice(0, Math.max(0, MAX_SNAPSHOT_CHARS - used - listHead.length - TRUNCATION_NOTE.length - 8))}…\n${listHead}${kept.join("\n")}${TRUNCATION_NOTE}`;
+    return { text, refs: refMapFor(kept, p.elements) };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,29 @@
+import type { ImageBlock, Tool } from "@wudao-org/core";
+import type { BrowserRuntime } from "./runtime.js";
+/** What the sink learns about the captured PNG (its IHDR dimensions — the
+ *  CSS-pixel viewport when browser_see captures at scale:"css"). */
+export interface BrowserImageSinkMeta {
+    readonly widthPx: number;
+    readonly heightPx: number;
+}
+/** Receives the PNG bytes, returns the durable ImageBlock they became.
+ *  Returning undefined = honest no-image THIS call (the caller's modality
+ *  pre-check declined — browser_see degrades to its text table); throwing =
+ *  an honest error result (a failed screenshot is never silently empty). */
+export type BrowserImageSink = (png: Uint8Array, meta: BrowserImageSinkMeta) => Promise<ImageBlock | undefined>;
+/** The eleven tools, in their FIXED registration order (the CLI inserts them
+ *  at one fixed position; this order inside the group never changes).
+ *  ω99-138: `imageSink` is optional — absent (or undefined-returning) keeps
+ *  browser_see on its honest text-table degradation; the six 112 tools are
+ *  untouched by it either way.
+ *  ω99-139: browser_click_xy sits right after browser_click (the click pair),
+ *  arming "point at pixels → click" for canvas pages browser_see unveiled.
+ *  ω99-140: browser_type_xy sits right after browser_type (the type pair) —
+ *  the same pairing logic, isomorphic: "point at pixels → type".
+ *  ω99-141: browser_scroll_xy sits right after browser_scroll (the scroll
+ *  pair) — "point at pixels → scroll the container under them".
+ *  ω99-142: browser_downloads sits right after browser_scroll_xy, before
+ *  browser_close — the export flow's last mile (see the file the page
+ *  saved), zero parameters by design. */
+export declare function browserToolsFor(runtime: BrowserRuntime, imageSink?: BrowserImageSink): Tool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAc,MAAM,iBAAiB,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAsC,MAAM,cAAc,CAAC;AAcvF;oEACoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;4EAG4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;AAmIhH;;;;;;;;;;;;;yCAayC;AACzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,EAAE,CAwgB7F"}