@nexface/tools 0.1.15-alpha.1 → 0.1.15-alpha.10

package/dist/browser/prompt.generated.js

@@ -4,7 +4,10 @@ export const BROWSER_TOOLS_INSTRUCTIONS = `Page automation is a fallback for pag
 Tool selection:
 - Prefer currently registered developer-provided application tools whenever they match the requested capability.
 - The current page is available through nxf_getSnapshot, even when application tools are empty. Read it before asking the user for page information.
-- If the current catalog does not expose the needed capability, use an application navigation or opener tool when available; otherwise page automation may be used as a fallback.
+- When the current page lacks needed information or actions, follow available navigation tools or observed page links and inspect the destination's tools or content. Perform these steps yourself rather than asking the user to open the page.
+- If no application tool covers the remaining work, observe the page with nxf_getSnapshot and continue through page automation. Missing application tools alone are not a blocker.
+- Continue until tool results or page observations confirm completion or reveal a blocker. If blocked, state what is needed to continue.
+- When an application tool reports a permission restriction, required user confirmation, or a blocked write, follow its recovery requirements. Do not bypass the restriction through page automation.
 - Call nxf_getSnapshot only when page information is needed.
 - Call nxf_executeAction only after a current snapshot exists and the page must be operated.
 - When calling a tool, keep assistant content concise. Resolve uncertain page state with a fresh snapshot.
@@ -30,7 +33,7 @@ nxf_executeAction rules:
 - selectOption(value) works on native <select> elements. Pass an option's value string, or an array of value strings for a multiple select; option labels are not accepted as values.
 - press(key) dispatches keydown and keyup events only; it does not perform native text entry or guarantee form submission. Use fill() to enter text and click() on the submit control to submit.
 - On semantic Locators, waitFor({ state?, timeout? }) accepts "visible" (the default), "hidden", or "attached"; timeout is a non-negative number of milliseconds, capped by the per-action limit. On a Snapshot ref, waitFor() only checks that the ref is still valid.
-- text() returns the current value for input, textarea, and select elements; for other elements it returns normalized text content. exists() only checks for a match; it does not establish a unique, enabled, or unobstructed write target.
+- text() requires one unique element and returns its current value for input, textarea, and select elements; for other elements it returns normalized text content. exists() only checks for a match; it does not establish a unique, enabled, or unobstructed write target.
 - Example with a ref from the current Snapshot: await ui.ref("@12").fill("Lin"); const value = await ui.ref("@12").text();
 - Example for a control that appears during execution: await ui.getByRole("dialog", { name: "Edit" }).getByRole("button", { name: "Save" }).waitFor({ state: "visible" });
 
@@ -38,6 +41,7 @@ Targeting policy:
 - For a write target already present in the Snapshot, prefer ui.ref().
 - Runtime Locators are for strict unique semantic lookup, including elements that appear after execution begins.
 - Scope repeated controls through a dialog, form, row, list item, or named region.
+- If a control's input node is covered by its own observed label or trigger, operate that label or trigger and inspect the resulting state. Pointer interception alone is not a permission restriction.
 - Prefer stable business identifiers. Never guess by position or invent a ref.
 - Ambiguous writes are rejected. If the target is ambiguous or unknown, stop and observe again.
 
@@ -54,4 +58,3 @@ Execution policy:
 - Return JSON-serializable data when reading information from the page.
 - A successful Page action receipt proves only that the action ran. Confirm business success through visible feedback, field readback, or an application tool result.
 - nxf_executeAction automatically returns a best-effort viewport snapshot. If refsExpired, postSnapshotTimedOut, or snapshotUnavailable is true, or the expected page state is absent, call nxf_getSnapshot before another write or nxf_finish.`;
-//# sourceMappingURL=prompt.generated.js.map

package/dist/browser/prompt.js

@@ -6,4 +6,3 @@ export const BROWSER_TOOLS_SKILL = {
 export function serializeBrowserToolsSkill() {
     return `[NEXFACE_SKILL_V1 name="${BROWSER_TOOLS_SKILL.name}"]\n${BROWSER_TOOLS_SKILL.content}\n[/NEXFACE_SKILL_V1]`;
 }
-//# sourceMappingURL=prompt.js.map

package/dist/browser/snapshot.js

@@ -1,5 +1,5 @@
 import { collectElementActions, collectPageActions } from "./actions.js";
-import { composedChildren, composedParent, computeNameInfo, computeRole, computeState, createIdentity, createScrollableIdentity, findNearestHeadingText, getElementScrollability, isActionableRole, isContextRole, isElementInViewport, isElementRendered, normalizeText, walkComposedElements, } from "./dom.js";
+import { composedChildren, composedParent, computeNameInfo, computeRole, computeState, createIdentity, createScrollableIdentity, findNearestHeadingText, getElementScrollability, isActionableRole, isContextRole, isElementInViewport, isElementRendered, normalizeText, } from "./dom.js";
 const DEFAULT_LIMITS = {
     viewportMaxChars: 18_000,
     viewportMaxVisitedNodes: 12_000,
@@ -27,15 +27,6 @@ const STRUCTURAL_ROLES = new Set([
     "tree",
     "listitem",
 ]);
-const PORTAL_ROLES = new Set([
-    "alert",
-    "listbox",
-    "menu",
-    "progressbar",
-    "status",
-    "tooltip",
-    "tree",
-]);
 const REDUNDANT_WRAPPER_ROLES = new Set(["group", "listitem"]);
 function checkExecution(context) {
     if (!context)
@@ -104,21 +95,19 @@ function isTextInScope(node, context) {
     const style = cachedStyle(parent, context.styles);
     if (!isElementRendered(parent, style))
         return false;
-    if (context.scope === "full")
-        return true;
-    const parentRect = cachedRect(parent, context.rects);
-    if (!isElementInViewport(parent, parentRect))
-        return false;
     const range = document.createRange();
     range.selectNodeContents(node);
     const rect = range.getBoundingClientRect();
     range.detach();
-    return (rect.width > 0 &&
-        rect.height > 0 &&
-        rect.right > 0 &&
-        rect.bottom > 0 &&
-        rect.left < window.innerWidth &&
-        rect.top < window.innerHeight);
+    const inViewport = isElementInViewport(parent, rect);
+    if (context.scope !== "full" && !inViewport)
+        return false;
+    if (!inViewport)
+        return context.scope === "full";
+    // Pointer-transparent text can be visible even when another element receives input.
+    if (style.pointerEvents === "none")
+        return true;
+    return sampleRect(parent, rect, context, false) !== false;
 }
 function isElementInScope(element, context) {
     const style = cachedStyle(element, context.styles);
@@ -130,36 +119,109 @@ function isElementInScope(element, context) {
     }
     return isElementInViewport(element, cachedRect(element, context.rects));
 }
-function isDescendantOrSelf(element, ancestor) {
-    if (element === ancestor)
-        return true;
-    let current = element;
-    while (current) {
-        if (current === ancestor)
-            return true;
-        current = composedParent(current);
+// Only opaque backgrounds provide evidence of visual occlusion. Pointer interception alone does not.
+function hasOpaqueCover(hit, target, context, x, y) {
+    const ancestors = new Set();
+    for (let current = target; current; current = composedParent(current)) {
+        ancestors.add(current);
     }
-    return false;
+    const labels = target instanceof HTMLInputElement ||
+        target instanceof HTMLTextAreaElement ||
+        target instanceof HTMLSelectElement ||
+        target instanceof HTMLButtonElement
+        ? new Set(target.labels ?? [])
+        : undefined;
+    let opaque = false;
+    for (let current = hit; current; current = composedParent(current)) {
+        // A native label still exposes its associated control, even with an opaque background.
+        if (labels?.has(current))
+            return false;
+        if (ancestors.has(current))
+            break;
+        const style = cachedStyle(current, context.styles);
+        if (Number(style.opacity || 1) < 1)
+            return false;
+        const color = style.backgroundColor;
+        if (/^rgb\([^/]+\)$/.test(color) || /^rgba\(.+,\s*1(?:\.0+)?\)$/.test(color)) {
+            const rect = cachedRect(current, context.rects);
+            if (x >= rect.left && x < rect.right && y >= rect.top && y < rect.bottom)
+                opaque = true;
+        }
+    }
+    return opaque;
 }
-function isAllowedByModal(element, context) {
-    if (!context.activeModal)
-        return true;
-    if (isDescendantOrSelf(element, context.activeModal))
-        return true;
-    for (const root of context.allowedPortalRoots) {
-        if (isDescendantOrSelf(element, root))
-            return true;
+// Hit testing is bounded per snapshot and never scans a candidate's descendants.
+function sampleRect(element, rect, context, allowDescendantHit = true) {
+    const left = Math.max(0, rect.left);
+    const top = Math.max(0, rect.top);
+    const right = Math.min(window.innerWidth, rect.right);
+    const bottom = Math.min(window.innerHeight, rect.bottom);
+    if (right <= left || bottom <= top)
+        return undefined;
+    if (typeof document.elementFromPoint !== "function")
+        return undefined;
+    let uncertain = false;
+    for (const [x, y] of [
+        [0.5, 0.5],
+        [0.2, 0.2],
+        [0.8, 0.2],
+        [0.2, 0.8],
+        [0.8, 0.8],
+    ]) {
+        if (context.hitTests >= 4096) {
+            context.truncated = true;
+            return undefined;
+        }
+        context.hitTests += 1;
+        checkExecution(context.execution);
+        let hit = document.elementFromPoint(left + (right - left) * x, top + (bottom - top) * y);
+        while (hit?.shadowRoot) {
+            if (context.hitTests >= 4096) {
+                context.truncated = true;
+                return undefined;
+            }
+            context.hitTests += 1;
+            checkExecution(context.execution);
+            const inner = hit.shadowRoot.elementFromPoint?.(left + (right - left) * x, top + (bottom - top) * y);
+            if (!inner || inner === hit)
+                break;
+            hit = inner;
+        }
+        for (let current = hit; current; current = composedParent(current)) {
+            if (current === element)
+                return true;
+            if (!allowDescendantHit)
+                break;
+        }
+        if (!allowDescendantHit &&
+            !hasOpaqueCover(hit, element, context, left + (right - left) * x, top + (bottom - top) * y))
+            uncertain = true;
     }
-    return false;
+    return uncertain ? undefined : false;
+}
+function elementHit(element, context) {
+    if (context.hits.has(element))
+        return context.hits.get(element);
+    const clientRects = Array.from(element.getClientRects()).filter((rect) => rect.width > 0 && rect.height > 0);
+    const rects = clientRects.length ? clientRects : [cachedRect(element, context.rects)];
+    let result;
+    for (const rect of rects.filter((rect) => isElementInViewport(element, rect)).slice(0, 2)) {
+        const hit = sampleRect(element, rect, context);
+        if (hit === true) {
+            result = true;
+            break;
+        }
+        if (hit === false)
+            result = false;
+    }
+    context.hits.set(element, result);
+    return result;
 }
 function normalizeNodeChildren(node) {
     const merged = [];
     for (const child of node.children) {
         const previous = merged.at(-1);
-        if (child.role === "text" &&
-            previous?.role === "text" &&
-            !child.element &&
-            !previous.element) {
+        if (child.role === "text" && previous?.role === "text" && !child.element && !previous.element) {
             previous.name = normalizeText(`${previous.name} ${child.name}`);
             previous.normalizedName = previous.name;
             continue;
@@ -167,14 +229,12 @@ function normalizeNodeChildren(node) {
         merged.push(child);
     }
     const directText = normalizeText(merged
-        .filter((child) => child.role === "text")
+        .filter((child) => child.role === "text" && !child.element)
         .map((child) => child.name)
         .join(" "));
     node.children =
-        node.normalizedName &&
-            directText &&
-            node.normalizedName === directText
-            ? merged.filter((child) => child.role !== "text")
+        node.normalizedName && directText && node.normalizedName === directText
+            ? merged.filter((child) => child.role !== "text" || child.element)
             : merged;
     const onlyChild = node.children.length === 1 ? node.children[0] : undefined;
     if (REDUNDANT_WRAPPER_ROLES.has(node.role) &&
@@ -199,10 +259,8 @@ function visitNode(node, context) {
     if (node instanceof Text) {
         if (!isTextInScope(node, context))
             return [];
-        const parent = node.parentElement;
-        if (parent && !isAllowedByModal(parent, context))
-            return [];
-        return [{
+        return [
+            {
                 role: "text",
                 name: normalizeText(node.data),
                 normalizedName: normalizeText(node.data),
@@ -210,7 +268,8 @@ function visitNode(node, context) {
                 state: {},
                 actionable: false,
                 children: [],
-            }];
+            },
+        ];
     }
     if (!(node instanceof Element))
         return [];
@@ -223,7 +282,7 @@ function visitNode(node, context) {
         return [];
     const children = composedChildren(node).flatMap((child) => visitNode(child, context));
     const inScope = isElementInScope(node, context);
-    const allowed = isAllowedByModal(node, context);
+    const hit = inScope ? elementHit(node, context) : undefined;
     const role = computeRole(node);
     const state = computeState(node);
     const inferredActionable = isActionableRole(role);
@@ -233,25 +292,39 @@ function visitNode(node, context) {
         node.onclick === null &&
         !node.hasAttribute("onclick") &&
         !node.isContentEditable;
-    const scrollable = inScope && (!inferredActionable || focusOnlyActionable)
+    const scrollable = inScope &&
+        (hit === true || typeof document.elementFromPoint !== "function") &&
+        (!inferredActionable || focusOnlyActionable)
         ? getElementScrollability(node, style)
         : undefined;
-    const actionable = inferredActionable && !scrollable;
+    const actionable = inferredActionable &&
+        !scrollable &&
+        (hit === true || typeof document.elementFromPoint !== "function");
     const hasState = Object.keys(state).length > 0;
-    const keep = allowed &&
-        ((inScope && (actionable || scrollable || STRUCTURAL_ROLES.has(role) || hasState)) ||
-            (children.length > 0 && (isContextRole(role) || role === "table" || role === "list")));
+    // Pointer interception can prevent an action without hiding a control's semantics.
+    const observedControl = inScope &&
+        inferredActionable &&
+        hit === false &&
+        sampleRect(node, cachedRect(node, context.rects), context, false) !== false;
+    const keep = observedControl ||
+        (hit !== false &&
+            ((inScope && (actionable || scrollable || STRUCTURAL_ROLES.has(role) || hasState)) ||
+                (children.length > 0 && (isContextRole(role) || role === "table" || role === "list"))));
     if (!keep)
         return children;
     const computedName = computeNameInfo(node);
+    const visibleName = computedName.source === "content"
+        ? children
+            .map((child) => child.name)
+            .filter(Boolean)
+            .join(" ")
+        : computedName.value;
     const scrollableName = scrollable && computedName.source === "content"
         ? findNearestHeadingText(node)
-        : computedName.value || (scrollable ? findNearestHeadingText(node) : "");
+        : visibleName || (scrollable ? findNearestHeadingText(node) : "");
     const renderNode = {
         element: node,
-        role: scrollable && (!role || role === "actionable")
-            ? "scrollable"
-            : role || "group",
+        role: scrollable && (!role || role === "actionable") ? "scrollable" : role || "text",
         name: scrollableName,
         normalizedName: normalizeText(scrollableName),
         nameSource: computedName.source,
@@ -263,50 +336,6 @@ function visitNode(node, context) {
     normalizeNodeChildren(renderNode);
     return [renderNode];
 }
-function isVisibleModal(element) {
-    const role = computeRole(element);
-    const ariaModal = role === "dialog" && element.getAttribute("aria-modal") === "true";
-    const alertDialog = role === "alertdialog";
-    let nativeModal = false;
-    if (element instanceof HTMLDialogElement && element.open) {
-        try {
-            nativeModal = element.matches(":modal");
-        }
-        catch {
-            nativeModal = element.open;
-        }
-    }
-    return (ariaModal || alertDialog || nativeModal) && isElementInViewport(element);
-}
-function findActiveModal(execution) {
-    let activeModal;
-    let visited = 0;
-    for (const element of walkComposedElements()) {
-        visited += 1;
-        if (visited % 128 === 0)
-            checkExecution(execution);
-        if (isVisibleModal(element))
-            activeModal = element;
-    }
-    return activeModal;
-}
-function findPortalRoots(activeModal, execution) {
-    const roots = new Set();
-    let visited = 0;
-    for (const element of walkComposedElements()) {
-        visited += 1;
-        if (visited % 128 === 0)
-            checkExecution(execution);
-        if (isDescendantOrSelf(element, activeModal))
-            continue;
-        const role = computeRole(element);
-        if ((PORTAL_ROLES.has(role) || element.hasAttribute("aria-live")) &&
-            isElementInViewport(element)) {
-            roots.add(element);
-        }
-    }
-    return roots;
-}
 function serializeState(state) {
     const entries = Object.entries(state);
     if (entries.length === 0)
@@ -340,13 +369,11 @@ function renderTree(nodes, context) {
         const name = node.name ? ` ${JSON.stringify(normalizeText(node.name))}` : "";
         const state = serializeState(node.state);
         const scrollability = serializeScrollability(node.scrollable);
-        const nextRef = node.actionable || node.scrollable
-            ? `@${context.refs.size + 1}`
-            : undefined;
+        const nextRef = node.actionable || node.scrollable ? `@${context.refs.size + 1}` : undefined;
         const refText = nextRef ? ` [ref=${nextRef}]` : "";
         const prefix = node.role === "text" ? `${indent}- text:` : `${indent}- ${node.role}`;
         const line = node.role === "text"
-            ? `${prefix} ${JSON.stringify(normalizeText(node.name))}`
+            ? `${prefix} ${JSON.stringify(normalizeText(node.name))}${state}`
             : `${prefix}${name}${state}${scrollability}${refText}`;
         const added = line.length + (context.lines.length > 0 ? 1 : 0);
         if (context.usedChars + added > context.maxChars) {
@@ -376,13 +403,10 @@ export async function createSnapshot(scope = "viewport", limits = {}, execution,
     await nextAnimationFrame(execution);
     checkExecution(execution);
     const resolvedLimits = { ...DEFAULT_LIMITS, ...limits };
-    const activeModal = findActiveModal(execution);
     const walkContext = {
         scope,
-        ...(activeModal ? { activeModal } : {}),
-        allowedPortalRoots: activeModal
-            ? findPortalRoots(activeModal, execution)
-            : new Set(),
+        hits: new WeakMap(),
+        hitTests: 0,
         styles: new WeakMap(),
         rects: new WeakMap(),
         visitedNodes: 0,
@@ -402,9 +426,7 @@ export async function createSnapshot(scope = "viewport", limits = {}, execution,
     const renderContext = {
         ...(actions ? { actions } : {}),
         refs: registry.refs,
-        maxChars: scope === "viewport"
-            ? resolvedLimits.viewportMaxChars
-            : resolvedLimits.fullMaxChars,
+        maxChars: scope === "viewport" ? resolvedLimits.viewportMaxChars : resolvedLimits.fullMaxChars,
         usedChars: 0,
         lines: [],
         truncated: false,
@@ -429,4 +451,3 @@ export async function createSnapshot(scope = "viewport", limits = {}, execution,
 export async function getSnapshot(scope = "viewport", limits = {}) {
     return (await createSnapshot(scope, limits)).snapshot;
 }
-//# sourceMappingURL=snapshot.js.map

package/dist/browser/toolset.js

@@ -27,11 +27,7 @@ const DEFAULT_SNAPSHOT_LIMITS = {
     fullMaxVisitedNodes: 40_000,
 };
 function isIgnoredMutationNode(node) {
-    const element = node instanceof Element
-        ? node
-        : node instanceof Text
-            ? node.parentElement
-            : null;
+    const element = node instanceof Element ? node : node instanceof Text ? node.parentElement : null;
     return Boolean(element?.closest("[data-nexface-ignore]"));
 }
 function isRelevantMutation(record) {
@@ -40,8 +36,7 @@ function isRelevantMutation(record) {
     if (record.type !== "childList")
         return true;
     const changedNodes = [...record.addedNodes, ...record.removedNodes];
-    return (changedNodes.length === 0
-        || changedNodes.some((node) => !isIgnoredMutationNode(node)));
+    return changedNodes.length === 0 || changedNodes.some((node) => !isIgnoredMutationNode(node));
 }
 let activeHistoryPatch;
 function subscribeHistoryChanges(subscriber) {
@@ -223,12 +218,12 @@ function validateInput(definition, input) {
     }
 }
 export function browserToolsAvailable() {
-    return (typeof window !== "undefined"
-        && typeof document !== "undefined"
-        && typeof Worker !== "undefined"
-        && typeof Blob !== "undefined"
-        && typeof URL?.createObjectURL === "function"
-        && typeof MutationObserver !== "undefined");
+    return (typeof window !== "undefined" &&
+        typeof document !== "undefined" &&
+        typeof Worker !== "undefined" &&
+        typeof Blob !== "undefined" &&
+        typeof URL?.createObjectURL === "function" &&
+        typeof MutationObserver !== "undefined");
 }
 export function createBrowserToolset(options = {}) {
     if (!browserToolsAvailable()) {
@@ -236,19 +231,14 @@ export function createBrowserToolset(options = {}) {
     }
     const limits = {
         ...DEFAULT_EXECUTION_LIMITS,
-        maxDurationMs: options.limits?.maxDurationMs
-            ?? DEFAULT_EXECUTION_LIMITS.maxDurationMs,
-        maxResultChars: options.limits?.maxResultChars
-            ?? DEFAULT_EXECUTION_LIMITS.maxResultChars,
-        singleActionTimeoutMs: options.limits?.singleActionTimeoutMs
-            ?? DEFAULT_EXECUTION_LIMITS.singleActionTimeoutMs,
+        maxDurationMs: options.limits?.maxDurationMs ?? DEFAULT_EXECUTION_LIMITS.maxDurationMs,
+        maxResultChars: options.limits?.maxResultChars ?? DEFAULT_EXECUTION_LIMITS.maxResultChars,
+        singleActionTimeoutMs: options.limits?.singleActionTimeoutMs ?? DEFAULT_EXECUTION_LIMITS.singleActionTimeoutMs,
     };
     const snapshotLimits = {
         ...DEFAULT_SNAPSHOT_LIMITS,
-        viewportMaxChars: options.snapshotLimits?.viewportMaxChars
-            ?? DEFAULT_SNAPSHOT_LIMITS.viewportMaxChars,
-        fullMaxChars: options.snapshotLimits?.fullMaxChars
-            ?? DEFAULT_SNAPSHOT_LIMITS.fullMaxChars,
+        viewportMaxChars: options.snapshotLimits?.viewportMaxChars ?? DEFAULT_SNAPSHOT_LIMITS.viewportMaxChars,
+        fullMaxChars: options.snapshotLimits?.fullMaxChars ?? DEFAULT_SNAPSHOT_LIMITS.fullMaxChars,
     };
     const feedback = new ActionFeedback();
     const controller = new PageController(limits, feedback);
@@ -285,7 +275,8 @@ export function createBrowserToolset(options = {}) {
             const scope = normalizedInput.scope;
             const deadline = performance.now() + limits.maxDurationMs;
             signal.throwIfAborted();
-            return (await observe(scope, { deadline, signal }, pageDecision ? "actions" : "text")).snapshot;
+            return (await observe(scope, { deadline, signal }, pageDecision ? "actions" : "text"))
+                .snapshot;
         },
     };
     const executeObserved = async (signal, execute, cancel, mode = "code", onFeedback, assertActive) => {
@@ -316,7 +307,8 @@ export function createBrowserToolset(options = {}) {
             }
             result = await measurePagePhase("execution", () => execute(activeRegistry, workerBudget));
             signal.throwIfAborted();
-            if (result.error && ["EXECUTION_TIMEOUT", "WORKER_ERROR", "EXECUTION_OUTCOME_UNKNOWN"].includes(result.error.code)) {
+            if (result.error &&
+                ["EXECUTION_TIMEOUT", "WORKER_ERROR", "EXECUTION_OUTCOME_UNKNOWN"].includes(result.error.code)) {
                 result.error.code = "EXECUTION_OUTCOME_UNKNOWN";
             }
             if (!result.ok && result.completedActions.length === 0) {
@@ -325,9 +317,7 @@ export function createBrowserToolset(options = {}) {
             try {
                 const settled = await measurePagePhase("settle", () => tracker.waitForSettle({ deadline, signal }));
                 signal.throwIfAborted();
-                if (settled.timedOut
-                    && settled.urlChanged
-                    && !settled.mutationObservedAfterUrlChange) {
+                if (settled.timedOut && settled.urlChanged && !settled.mutationObservedAfterUrlChange) {
                     result.snapshotUnavailable = true;
                     return expireRefs(result);
                 }
@@ -382,7 +372,9 @@ export function createBrowserToolset(options = {}) {
             if (!bundle || bundle.snapshot.snapshotId !== input.snapshotId)
                 return undefined;
             const selected = bundle.actions?.get(input.actionId);
-            if (!selected || selected.command.method === "scrollBy" || selected.command.method === "waitForTimeout")
+            if (!selected ||
+                selected.command.method === "scrollBy" ||
+                selected.command.method === "waitForTimeout")
                 return undefined;
             const target = selected.command.target;
             const element = target?.type === "ref" ? bundle.registry.refs.get(target.ref)?.element : undefined;
@@ -396,14 +388,21 @@ export function createBrowserToolset(options = {}) {
             const selected = bundle.actions.get(input.actionId);
             if (!selected)
                 throw new AgentToolError("INVALID_INPUT", "Action is not a candidate of this observation.");
-            if (selected.command.method === "fill" ? typeof input.text !== "string" || !input.text.trim() : input.text !== undefined) {
+            if (selected.command.method === "fill"
+                ? typeof input.text !== "string" || !input.text.trim()
+                : input.text !== undefined) {
                 throw new AgentToolError("INVALID_INPUT", "Only fill actions require a non-empty text value.");
             }
             if (selected.command.method === "selectOption") {
                 const target = selected.command.target;
                 const element = target.type === "ref" ? bundle.registry.refs.get(target.ref)?.element : undefined;
-                const options = element instanceof HTMLSelectElement ? [...element.options].filter((option) => option.value === selected.command.args[0]) : [];
-                if (options.length !== 1 || options[0].disabled || options[0].closest("optgroup[disabled]") || options[0].label.slice(0, 500) !== selected.candidate.option) {
+                const options = element instanceof HTMLSelectElement
+                    ? [...element.options].filter((option) => option.value === selected.command.args[0])
+                    : [];
+                if (options.length !== 1 ||
+                    options[0].disabled ||
+                    options[0].closest("optgroup[disabled]") ||
+                    options[0].label.slice(0, 500) !== selected.candidate.option) {
                     throw new AgentToolError("INVALID_INPUT", "The observed option changed or is no longer available. Observe again.");
                 }
             }
@@ -413,7 +412,9 @@ export function createBrowserToolset(options = {}) {
                 let timer;
                 try {
                     const command = {
-                        ...selected.command, executionId, commandSeq: 1,
+                        ...selected.command,
+                        executionId,
+                        commandSeq: 1,
                         args: selected.command.method === "fill" ? [input.text] : selected.command.args,
                     };
                     const response = await Promise.race([
@@ -421,7 +422,8 @@ export function createBrowserToolset(options = {}) {
                             if (selected.optionElement) {
                                 const target = selected.command.target;
                                 const element = target.type === "ref" ? registry.refs.get(target.ref)?.element : undefined;
-                                if (!selected.optionElement.isConnected || selected.optionElement.closest("select") !== element) {
+                                if (!selected.optionElement.isConnected ||
+                                    selected.optionElement.closest("select") !== element) {
                                     throw new AgentToolError("INVALID_INPUT", "The observed option was replaced. Observe again.");
                                 }
                             }
@@ -434,7 +436,12 @@ export function createBrowserToolset(options = {}) {
                         }),
                     ]);
                     const receipt = controller.completeExecution(executionId);
-                    return { executionId, ...receipt, ok: response.ok, ...(response.error ? { error: response.error } : {}) };
+                    return {
+                        executionId,
+                        ...receipt,
+                        ok: response.ok,
+                        ...(response.error ? { error: response.error } : {}),
+                    };
                 }
                 finally {
                     clearTimeout(timer);
@@ -449,4 +456,3 @@ export function createBrowserToolset(options = {}) {
         handlers: new Map(toolHandlers.map((tool) => [tool.definition.name, tool])),
     };
 }
-//# sourceMappingURL=toolset.js.map

package/dist/browser/types.d.ts

@@ -1,6 +1,6 @@
 import type { ObservedAction } from "./actions.js";
 import type { PageSnapshot } from "../shared/page-protocol.js";
-export type { SnapshotScope, SnapshotFormat, SemanticState, PageActionCandidate, PageSnapshot } from "../shared/page-protocol.js";
+export type { SnapshotScope, SnapshotFormat, SemanticState, PageActionCandidate, PageSnapshot, } from "../shared/page-protocol.js";
 export interface RefTarget {
     element: Element;
     identity: string;

package/dist/browser/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/browser/worker-runner.js

@@ -397,4 +397,3 @@ export class WorkerRunner {
         active.cancel();
     }
 }
-//# sourceMappingURL=worker-runner.js.map

package/dist/definition.d.ts

@@ -8,7 +8,5 @@ export declare function isValidAgentContextName(name: string): boolean;
 export declare function defineAgentTool<TResult = unknown>(metadata: AgentToolMetadataInput): AgentToolDefinition<Record<string, never>, TResult>;
 export declare function defineAgentTool<TInput = never, TResult = unknown, const TSchema extends AgentToolInputSchema = AgentToolInputSchema>(metadata: AgentToolMetadataInput & {
     inputSchema: TSchema;
-}): AgentToolDefinition<[
-    TInput
-] extends [never] ? InferJsonSchema<TSchema> : TInput, TResult>;
+}): AgentToolDefinition<[TInput] extends [never] ? InferJsonSchema<TSchema> : TInput, TResult>;
 export {};

package/dist/definition.js

@@ -6,7 +6,8 @@ const emptyInputSchema = Object.freeze({
 });
 const agentNamePattern = /^[A-Za-z0-9_-]{1,64}$/;
 const reservedContextNames = new Set([
-    "nxf_applyAction", "nxf_delegatePageTask",
+    "nxf_applyAction",
+    "nxf_delegatePageTask",
     "nxf_callAppTool",
     "nxf_finish",
     "nxf_getSnapshot",
@@ -33,4 +34,3 @@ export function defineAgentTool(metadata) {
         inputSchema: metadata.inputSchema === undefined ? emptyInputSchema : metadata.inputSchema,
     });
 }
-//# sourceMappingURL=definition.js.map

package/dist/index.browser.js

@@ -1,4 +1,3 @@
 import "./styles.css";
 export * from "./index.js";
 export { registerAgentTool } from "./registration.js";
-//# sourceMappingURL=index.browser.js.map

package/dist/index.js

@@ -4,4 +4,3 @@ export { AgentOperationSurface } from "./operation-surface.js";
 export { createToolRuntime, isToolRuntimeError, } from "./runtime.js";
 export { AgentContext, ToolsProvider, AgentUIAction, useAgentContext, useAgentNavigation, useAgentTool, } from "./react.js";
 export { registerAgentTool } from "./registration.js";
-//# sourceMappingURL=index.js.map