@nexface/tools 0.1.13-alpha.1 → 0.1.13-alpha.3

package/dist/browser/actions.js

@@ -70,4 +70,3 @@ export function collectPageActions(actions) {
         add("pageDown", "scrollDown", "scrollBy", [{ y: 560 }]);
     add("wait", "wait", "waitForTimeout", [100]);
 }
-//# sourceMappingURL=actions.js.map

package/dist/browser/controller.js

@@ -841,4 +841,3 @@ export class PageController {
         throw invalidCommand(`Unsupported locator method: ${command.method}`);
     }
 }
-//# sourceMappingURL=controller.js.map

package/dist/browser/diagnostics.js

@@ -17,4 +17,3 @@ export async function measurePagePhase(phase, execute) {
         catch { /* Diagnostics must never interrupt execution. */ }
     }
 }
-//# sourceMappingURL=diagnostics.js.map

package/dist/browser/dom.js

@@ -442,4 +442,3 @@ export function matchesText(value, matcher, exact = false) {
     const expected = normalizeText(matcher);
     return exact ? normalized === expected : normalized.includes(expected);
 }
-//# sourceMappingURL=dom.js.map

package/dist/browser/feedback.js

@@ -11,4 +11,3 @@ export class ActionFeedback {
         });
     }
 }
-//# sourceMappingURL=feedback.js.map

package/dist/browser/focus.js

@@ -26,4 +26,3 @@ export function focusForAgent(element) {
         focusingForAgent = previous;
     }
 }
-//# sourceMappingURL=focus.js.map

package/dist/browser/locator.js

@@ -274,4 +274,3 @@ export function requireValidRef(target) {
     validateIdentity(target);
     return target.element;
 }
-//# sourceMappingURL=locator.js.map

package/dist/browser/prompt.generated.js

@@ -54,4 +54,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

@@ -429,4 +429,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

@@ -449,4 +449,3 @@ export function createBrowserToolset(options = {}) {
         handlers: new Map(toolHandlers.map((tool) => [tool.definition.name, tool])),
     };
 }
-//# sourceMappingURL=toolset.js.map

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.js

@@ -33,4 +33,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

package/dist/internal-react.js

@@ -20,4 +20,3 @@ export function useInternalToolRuntime() {
 export function useOptionalInternalToolRuntime() {
     return useContext(InternalToolRuntimeContext);
 }
-//# sourceMappingURL=internal-react.js.map

package/dist/internal-types.js

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

package/dist/navigation.js

@@ -37,4 +37,3 @@ export function getAgentNavigationEntries(navigation) {
     }
     return entries;
 }
-//# sourceMappingURL=navigation.js.map

package/dist/operation-lock.js

@@ -45,4 +45,3 @@ export function lockOperationSurface(surface, redirectFocus) {
             surface.setAttribute("aria-busy", previousBusy);
     };
 }
-//# sourceMappingURL=operation-lock.js.map

package/dist/operation-runtime.js

@@ -151,4 +151,3 @@ export class OperationTracker {
             listener();
     }
 }
-//# sourceMappingURL=operation-runtime.js.map

package/dist/operation-surface.js

@@ -157,4 +157,3 @@ function OperationSurfaceContent({ toolRuntime, element }) {
     const entries = !cycle || history.scope === cycle.id ? history.entries : [];
     return activated || executing || entries.length ? React.createElement(OperationOverlayView, { key: cycle?.id ?? history.scope, operation: operation, progressHistory: entries, running: running, humanHasControl: waiting, cancelling: stopping, ...(feedback ? { feedback } : {}), ...(cycle?.canCancel ? { onCancel: () => runtime.requestOperationCancel(cycle.id) } : {}), resolveSurface: resolveSurface }) : null;
 }
-//# sourceMappingURL=operation-surface.js.map

package/dist/operation-types.js

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

package/dist/operation-view.js

@@ -209,4 +209,3 @@ export function OperationOverlayView({ operation, feedback, progressHistory = []
             (running || humanHasControl) && operation.status !== "cancelled" ? React.createElement("span", { className: "agent-operation__compact-status", title: compactStatusLabel }, compactStatusLabel) : null,
             cancel && (running || humanHasControl) && operation.status !== "cancelled" ? React.createElement("button", { ref: cancelButtonRef, className: "agent-operation__stop", type: "button", disabled: cancelling, onClick: cancel }, cancelling ? "正在终止" : "终止任务") : null) : null), document.body);
 }
-//# sourceMappingURL=operation-view.js.map

package/dist/react.js

@@ -365,4 +365,3 @@ export function AgentUIAction({ name, description, event = "click", children, })
         ref: mergedRef,
     });
 }
-//# sourceMappingURL=react.js.map

package/dist/registration.js

@@ -9,4 +9,3 @@ export function registerAgentTool(definition, options) {
     assertAgentToolInputSchema(definition.inputSchema, `Tool "${definition.name}".inputSchema`);
     return Object.freeze({ definition, execute: options.execute });
 }
-//# sourceMappingURL=registration.js.map

package/dist/runtime.d.ts

@@ -7,10 +7,11 @@ import type { AgentContextEntry, AgentContextInput, AgentContextRegistration, Ag
 import type { AgentToolExecutionEvent } from "./internal-types.js";
 export interface ToolRuntimeOptions {
     readonly pageAutomation?: boolean;
+    readonly routeSearch?: boolean;
 }
 export interface ToolRuntimeToolChangeEvent {
     readonly toolName: string;
-    readonly change: "registered" | "unregistered";
+    readonly change: "registered" | "unregistered" | "visibility";
 }
 declare const CONTEXT_ERROR_CODES: readonly ["CONTEXT_DISPOSED", "CONTEXT_NAME_MISMATCH", "DUPLICATE_CONTEXT", "INVALID_CONTEXT"];
 type AgentContextErrorCode = typeof CONTEXT_ERROR_CODES[number];
@@ -170,6 +171,7 @@ export declare class ToolRuntimeImplementation extends EventTarget implements To
     getContexts(options?: {
         signal?: AbortSignal;
     }): Promise<readonly AgentContextEntry[]>;
+    getRegisteredTools(): readonly RuntimeAgentTool[];
     getWebMcpTools(): readonly RuntimeAgentTool[];
     isRegistered(name: string): boolean;
     getTools(): readonly RuntimeAgentTool[];

package/dist/runtime.js

@@ -1,3 +1,4 @@
+import { searchNavigationTools, searchToolDefinition } from "./tool-search.js";
 import { pageDecisionSymbol } from "./shared/runtime-execution.js";
 import { PageCommandError } from "./browser/locator.js";
 import { measurePagePhase } from "./browser/diagnostics.js";
@@ -123,6 +124,8 @@ export function getInternalToolRuntime(runtime) {
 export class ToolRuntimeImplementation extends EventTarget {
     [toolRuntimeBrand] = true;
     #bindings = new Map();
+    #routeSearch;
+    #visibleNavigation = new Set();
     #contexts = new Map();
     #contextRevision = 0;
     #browserToolset;
@@ -157,6 +160,33 @@ export class ToolRuntimeImplementation extends EventTarget {
             typeof options.pageAutomation !== "boolean") {
             throw new AgentToolError("INVALID_INPUT", "pageAutomation must be a boolean.");
         }
+        if (options.routeSearch !== undefined && typeof options.routeSearch !== "boolean") {
+            throw new AgentToolError("INVALID_INPUT", "routeSearch must be a boolean.");
+        }
+        this.#routeSearch = options.routeSearch ?? false;
+        if (this.#routeSearch)
+            this.register(searchToolDefinition, ({ query, queries }) => {
+                if (query !== undefined && queries !== undefined)
+                    throw new AgentToolError("INVALID_INPUT", "Use either query or queries, not both.");
+                const searchQueries = queries === undefined ? (query === undefined ? undefined : [query]) : [...queries];
+                if (searchQueries?.some((phrase) => typeof phrase !== "string" || !phrase.trim()))
+                    throw new AgentToolError("INVALID_INPUT", "Search queries must contain nonblank strings.");
+                const navigation = this.getRegisteredTools().filter(({ definition }) => definition.effect === "navigate");
+                const candidates = searchQueries === undefined ? navigation : searchNavigationTools(navigation, searchQueries.map((phrase) => phrase.trim()));
+                if (searchQueries !== undefined) {
+                    const previous = this.#visibleNavigation;
+                    this.#visibleNavigation = new Set(candidates);
+                    for (const tool of new Set([...previous, ...candidates])) {
+                        if (previous.has(tool) === this.#visibleNavigation.has(tool))
+                            continue;
+                        this.dispatchEvent(new DetailEvent("toolchange", Object.freeze({
+                            toolName: tool.definition.name,
+                            change: "visibility",
+                        })));
+                    }
+                }
+                return { tools: candidates.map(({ definition: { name, description } }) => ({ name, description })) };
+            });
         this.#browserToolset = options.pageAutomation ? createBrowserToolset() : undefined;
         runtimeInternals.set(this, this);
         const controller = Object.freeze({
@@ -165,6 +195,7 @@ export class ToolRuntimeImplementation extends EventTarget {
             setTaskProgress: this.setTaskProgress,
             getOperationSnapshot: () => this.getActivitySnapshot().operation,
             subscribeOperation: this.subscribeActivity,
+            getRegisteredTools: () => this.getRegisteredTools(),
         });
         Object.defineProperty(this, runtimeControllerSymbol, { value: controller });
     }
@@ -224,6 +255,7 @@ export class ToolRuntimeImplementation extends EventTarget {
             disposed = true;
             options.signal?.removeEventListener("abort", dispose);
             this.#bindings.delete(definition.name);
+            this.#visibleNavigation.delete(runtimeTool);
             lifecycleController.abort();
             this.dispatchEvent(new DetailEvent("toolchange", Object.freeze({
                 toolName: definition.name,
@@ -337,17 +369,23 @@ export class ToolRuntimeImplementation extends EventTarget {
             revision: this.#contextRevision,
         }));
     }
+    getRegisteredTools() {
+        return [...this.#bindings.values()]
+            .map(({ runtimeTool }) => runtimeTool)
+            .filter(({ definition }) => !this.#routeSearch || definition !== searchToolDefinition)
+            .sort((left, right) => compareStrings(left.definition.name, right.definition.name));
+    }
     getWebMcpTools() {
         return [...this.#bindings.values()]
             .map(({ runtimeTool }) => runtimeTool)
+            .filter((tool) => !this.#routeSearch || tool.definition.effect !== "navigate" || this.#visibleNavigation.has(tool))
             .sort((left, right) => compareStrings(left.definition.name, right.definition.name));
     }
     isRegistered(name) {
         return this.#bindings.has(name);
     }
     getTools() {
-        const applicationTools = [...this.#bindings.values()]
-            .map(({ runtimeTool }) => runtimeTool);
+        const applicationTools = this.getWebMcpTools();
         const browserTools = (this.#browserToolset?.definitions ?? [])
             .map((definition) => this.#getBrowserRuntimeTool(definition));
         return [...applicationTools, ...browserTools]
@@ -599,4 +637,3 @@ export class ToolRuntimeImplementation extends EventTarget {
         return runtimeTool;
     }
 }
-//# sourceMappingURL=runtime.js.map

package/dist/shared/definition.js

@@ -30,4 +30,3 @@ function cloneAndFreeze(value) {
     }
     return value;
 }
-//# sourceMappingURL=definition.js.map

package/dist/shared/errors.js

@@ -33,4 +33,3 @@ export class AgentToolError extends Error {
         this.name = "ToolRuntimeError";
     }
 }
-//# sourceMappingURL=errors.js.map

package/dist/shared/page-protocol.js

@@ -1,3 +1,2 @@
 // Generated from shared/page-protocol.ts. Do not edit manually.
 export {};
-//# sourceMappingURL=page-protocol.js.map

package/dist/shared/page-tools.js

@@ -40,4 +40,3 @@ export const applyActionTool = createAgentToolDefinition({
         additionalProperties: false,
     },
 });
-//# sourceMappingURL=page-tools.js.map

package/dist/shared/runtime-controller.d.ts

@@ -12,6 +12,7 @@ interface OperationSnapshot {
     readonly taskProgress?: TaskProgress;
 }
 export interface RuntimeController {
+    getRegisteredTools(): ReturnType<ToolRuntime["getTools"]>;
     beginInternalOperation(options?: {
         signal?: AbortSignal;
         onCancel?: () => void;

package/dist/shared/runtime-controller.js

@@ -8,4 +8,3 @@ export function getRuntimeController(runtime) {
     }
     return controller;
 }
-//# sourceMappingURL=runtime-controller.js.map

package/dist/shared/runtime-execution.js

@@ -1,3 +1,2 @@
 // Generated from shared/runtime-execution.ts. Do not edit manually.
 export const pageDecisionSymbol = Symbol.for("@nexface/tools/page-decision");
-//# sourceMappingURL=runtime-execution.js.map

package/dist/shared/schema.js

@@ -197,4 +197,3 @@ export function validateAgentToolInput(schema, value, path = "input") {
     }
     return errors;
 }
-//# sourceMappingURL=schema.js.map

package/dist/tool-search.d.ts

@@ -0,0 +1,11 @@
+import type { RuntimeAgentTool } from "./runtime.js";
+export declare const searchToolDefinition: import("./types.js").AgentToolDefinition<{
+    query?: string;
+    queries?: string[];
+}, {
+    tools: Array<{
+        name: string;
+        description: string;
+    }>;
+}>;
+export declare function searchNavigationTools(tools: readonly RuntimeAgentTool[], query: string | readonly string[]): RuntimeAgentTool[];

package/dist/tool-search.js

@@ -0,0 +1,91 @@
+import { createAgentToolDefinition } from "./shared/definition.js";
+export const searchToolDefinition = createAgentToolDefinition({
+    name: "nxf_searchTool",
+    description: "Search registered navigation tools when opening a page with no suitable callable navigation tool. Use query for one phrase or queries for alternative phrasings of the same task. Results replace visible candidates (max 5). Call a match from the refreshed catalog, then use the page's tools. If none fits, call {} for the directory, then query an exact name.",
+    effect: "read",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Page name, purpose, or exact navigation tool name." },
+            queries: { type: "array", description: "Alternative search phrases for the same navigation task. Use instead of query.", minItems: 1, maxItems: 3, items: { type: "string", minLength: 1 } },
+        },
+        additionalProperties: false,
+    },
+});
+function tokenize(text, segmenter) {
+    const normalized = text.normalize("NFKC").replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ").toLowerCase();
+    if (segmenter) {
+        return [...segmenter.segment(normalized)].filter((part) => part.isWordLike).map((part) => part.segment);
+    }
+    return (normalized.match(/\p{Script=Han}+|[\p{L}\p{N}]+/gu) ?? []).flatMap((word) => {
+        if (!/^\p{Script=Han}+$/u.test(word))
+            return [word];
+        const characters = [...word];
+        return characters.length < 2 ? characters : characters.slice(1).map((character, index) => characters[index] + character);
+    });
+}
+function schemaText(value) {
+    if (!value || typeof value !== "object")
+        return [];
+    if (Array.isArray(value))
+        return value.flatMap(schemaText);
+    const schema = value;
+    return Object.entries(schema).flatMap(([key, child]) => {
+        if (key === "description" && typeof child === "string")
+            return [child];
+        if (key === "properties" && child && typeof child === "object") {
+            return Object.entries(child).flatMap(([name, property]) => [name, ...schemaText(property)]);
+        }
+        return child && typeof child === "object" ? schemaText(child) : [];
+    });
+}
+export function searchNavigationTools(tools, query) {
+    if (typeof query !== "string") {
+        const queries = [...new Set(query)];
+        if (queries.length === 1)
+            return searchNavigationTools(tools, queries[0]);
+        // Fuse ranks rather than comparing BM25 scores across different queries.
+        const scores = new Map();
+        for (const phrase of queries) {
+            searchNavigationTools(tools, phrase).forEach((tool, index) => {
+                scores.set(tool, (scores.get(tool) ?? 0) + 1 / (60 + index + 1));
+            });
+        }
+        return [...scores].sort(([left, a], [right, b]) => {
+            const x = left.definition.name;
+            const y = right.definition.name;
+            return b - a || (x < y ? -1 : x > y ? 1 : 0);
+        }).slice(0, 5).map(([tool]) => tool);
+    }
+    const exact = tools.find((tool) => tool.definition.name === query);
+    if (exact)
+        return [exact];
+    const segmenter = typeof Intl.Segmenter === "function" ? new Intl.Segmenter("zh", { granularity: "word" }) : undefined;
+    const terms = [...new Set(tokenize(query, segmenter))];
+    if (!terms.length || !tools.length)
+        return [];
+    const documents = tools.map((tool) => {
+        const { name, description, inputSchema } = tool.definition;
+        const tokens = tokenize([name, description, ...schemaText(inputSchema)].join(" "), segmenter);
+        const frequencies = new Map();
+        for (const token of tokens)
+            frequencies.set(token, (frequencies.get(token) ?? 0) + 1);
+        return { tool, length: tokens.length, frequencies };
+    });
+    const averageLength = documents.reduce((sum, document) => sum + document.length, 0) / documents.length || 1;
+    const idf = new Map(terms.map((term) => {
+        const count = documents.filter((document) => document.frequencies.has(term)).length;
+        return [term, Math.log(1 + (documents.length - count + 0.5) / (count + 0.5))];
+    }));
+    return documents.map((document) => {
+        const score = terms.reduce((sum, term) => {
+            const frequency = document.frequencies.get(term) ?? 0;
+            return sum + idf.get(term) * frequency * 2.2 / (frequency + 1.2 * (0.25 + 0.75 * document.length / averageLength));
+        }, 0);
+        return { tool: document.tool, score };
+    }).filter(({ score }) => score > 0).sort((left, right) => {
+        const a = left.tool.definition.name;
+        const b = right.tool.definition.name;
+        return right.score - left.score || (a < b ? -1 : a > b ? 1 : 0);
+    }).slice(0, 5).map(({ tool }) => tool);
+}

package/dist/types.js

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

package/dist/webmcp.js

@@ -225,4 +225,3 @@ function createConnection(runtime, modelContext) {
         registrations.clear();
     };
 }
-//# sourceMappingURL=webmcp.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexface/tools",
-  "version": "0.1.13-alpha.1",
+  "version": "0.1.13-alpha.3",
   "type": "module",
   "exports": {
     ".": {
@@ -27,5 +27,9 @@
   },
   "files": [
     "dist"
-  ]
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fishear/nexface.git"
+  }
 }

package/dist/browser/actions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/browser/actions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PageActionCandidate, PageCommand, SemanticState } from \"./types.js\";\nimport { computeName } from \"./dom.js\";\n\nexport interface ObservedAction {\n  candidate: PageActionCandidate;\n  command: Pick<PageCommand, \"target\" | \"method\" | \"args\">;\n  optionElement?: HTMLOptionElement;\n}\n\nexport function collectElementActions(\n  actions: Map<string, ObservedAction>,\n  ref: string,\n  element: Element,\n  role: string,\n  label: string,\n  state: SemanticState,\n  scrollable: boolean,\n): void {\n  const target = { type: \"ref\", ref } as const;\n  const add = (operation: PageActionCandidate[\"operation\"], method: PageCommand[\"method\"], args: unknown[], option?: string, optionElement?: HTMLOptionElement): void => {\n    if (actions.size >= 240) return;\n    const id = `a${actions.size + 1}`;\n    actions.set(id, {\n      candidate: { id, operation, ref, role, label: (optionElement ? `${label} / ${option}` : label).slice(0, 500), state, ...(option === undefined ? {} : { option: option.slice(0, 500) }) },\n      command: { target, method, args },\n      ...(optionElement ? { optionElement } : {}),\n    });\n  };\n  if (state.disabled || element.closest('[inert],[aria-disabled=\"true\"]') || element.matches(\":disabled\")) return;\n  if (scrollable) {\n    if (element.scrollTop > 0) add(\"scrollUp\", \"scrollBy\", [{ y: -560 }]);\n    if (element.scrollTop + element.clientHeight < element.scrollHeight - 1) add(\"scrollDown\", \"scrollBy\", [{ y: 560 }]);\n    return;\n  }\n  if (element instanceof HTMLInputElement && [\"password\", \"file\", \"hidden\"].includes(element.type)) return;\n  if (element instanceof HTMLOptionElement) return;\n  if (element instanceof HTMLSelectElement) {\n    const counts = new Map<string, number>();\n    for (const option of element.options) counts.set(option.value, (counts.get(option.value) ?? 0) + 1);\n    for (const option of element.options) {\n      if (element.multiple) {\n        if (counts.get(option.value) === 1 && !option.disabled && !option.closest(\"optgroup[disabled]\")) {\n          add(option.selected ? \"uncheck\" : \"check\", \"setOptionSelected\", [option.value, !option.selected, option.label], option.label, option);\n        }\n        continue;\n      }\n      if (counts.get(option.value) === 1 && !(element.required && option.value === \"\") && !option.disabled && !option.selected && !option.closest(\"optgroup[disabled]\")) add(\"select\", \"selectOption\", [option.value], option.label);\n    }\n    return;\n  }\n  if (role === \"option\" && element.closest('[role=\"listbox\"]')?.getAttribute(\"aria-multiselectable\") === \"true\"\n    && [\"true\", \"false\"].includes(element.getAttribute(\"aria-selected\") ?? \"\")) {\n    const field = computeName(element.closest('[role=\"listbox\"]')!);\n    label = field ? `${field} / ${label}` : label;\n    add(state.selected ? \"uncheck\" : \"check\", state.selected ? \"uncheck\" : \"check\", []);\n    return;\n  }\n  if (role === \"checkbox\" || role === \"switch\" || role === \"radio\") {\n    if (state.checked !== true) add(\"check\", \"check\", []);\n    else if (role !== \"radio\") add(\"uncheck\", \"uncheck\", []);\n    return;\n  }\n  const editable = element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || (element instanceof HTMLElement && element.isContentEditable);\n  if (editable && !(\"readOnly\" in element && element.readOnly) && element.getAttribute(\"aria-readonly\") !== \"true\" && [\"textbox\", \"searchbox\", \"combobox\", \"spinbutton\"].includes(role)) {\n    add(\"fill\", \"fill\", []);\n  }\n  add(\"click\", \"click\", []);\n}\n\nexport function collectPageActions(actions: Map<string, ObservedAction>): void {\n  const add = (id: string, operation: PageActionCandidate[\"operation\"], method: PageCommand[\"method\"], args: unknown[]): void => {\n    actions.set(id, { candidate: { id, operation, label: operation, role: \"page\", state: {} }, command: { target: { type: \"page\" }, method, args } });\n  };\n  if (window.scrollY > 0) add(\"pageUp\", \"scrollUp\", \"scrollBy\", [{ y: -560 }]);\n  if (window.scrollY + window.innerHeight < document.documentElement.scrollHeight - 1) add(\"pageDown\", \"scrollDown\", \"scrollBy\", [{ y: 560 }]);\n  add(\"wait\", \"wait\", \"waitForTimeout\", [100]);\n}\n"]}