@opentiny/next-sdk 0.4.0 → 0.4.2

package/dist/page-tools/page-agent-tool.d.ts

@@ -1,9 +1,4 @@
-declare global {
-    interface Window {
-        __webmcpcli_interactiveWhitelist?: Element[];
-        __webmcpcli_interactiveBlacklist?: Element[];
-        __webmcpcli_beforeGetBrowserState?: (() => void) | null;
-    }
-}
+import { PageAgentToolOptions } from './constants';
+
 /** 在浏览器页面中注册 page-agent-tool, 用于页面的内容获取和操作，页面的动效 */
-export declare function registerPageAgentTool(): void;
+export declare function registerPageAgentTool(options?: PageAgentToolOptions): void;

package/dist/page-tools/schema.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+
+export declare const inputSchema: z.ZodObject<{
+    action: z.ZodEnum<["browserState", "click", "fill", "select", "scroll", "executeJavascript", "searchTree"]>;
+    index: z.ZodOptional<z.ZodNumber>;
+    text: z.ZodOptional<z.ZodString>;
+    down: z.ZodOptional<z.ZodBoolean>;
+    right: z.ZodOptional<z.ZodBoolean>;
+    numPages: z.ZodOptional<z.ZodNumber>;
+    pixels: z.ZodOptional<z.ZodNumber>;
+    script: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    contextLines: z.ZodDefault<z.ZodNumber>;
+    maxMatches: z.ZodDefault<z.ZodNumber>;
+    responseMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["full", "diff", "both"]>>>;
+}, "strip", z.ZodTypeAny, {
+    action: "fill" | "click" | "select" | "scroll" | "browserState" | "executeJavascript" | "searchTree";
+    contextLines: number;
+    maxMatches: number;
+    responseMode: "full" | "diff" | "both";
+    text?: string | undefined;
+    right?: boolean | undefined;
+    script?: string | undefined;
+    index?: number | undefined;
+    down?: boolean | undefined;
+    numPages?: number | undefined;
+    pixels?: number | undefined;
+    query?: string | undefined;
+}, {
+    action: "fill" | "click" | "select" | "scroll" | "browserState" | "executeJavascript" | "searchTree";
+    text?: string | undefined;
+    right?: boolean | undefined;
+    script?: string | undefined;
+    contextLines?: number | undefined;
+    maxMatches?: number | undefined;
+    index?: number | undefined;
+    down?: boolean | undefined;
+    numPages?: number | undefined;
+    pixels?: number | undefined;
+    query?: string | undefined;
+    responseMode?: "full" | "diff" | "both" | undefined;
+}>;
+export type PageAgentToolInput = z.infer<typeof inputSchema>;
+export type PageAgentToolRawInput = z.input<typeof inputSchema>;

package/dist/page-tools/tool-config.d.ts

@@ -0,0 +1,50 @@
+import { A11yConfig, ResolvedA11yConfig } from './a11y/config';
+
+export interface PageAgentToolConfig {
+    /** 是否启用元素高亮 */
+    enableHighlight: boolean;
+    /** 是否在工具调用后移除遮罩， 默认值为 true 移除 */
+    removeMaskAfterToolCall?: boolean;
+    /**
+     * 统一无障碍配置：按角色（roles）、状态（states：selected/disabled/error/warning 等）自定义规则，
+     * 以及白名单/黑名单/自定义暴露属性/弹窗选择器。已与默认配置合并（数组类字段是拼接结果）。
+     */
+    a11yConfig: ResolvedA11yConfig;
+}
+/**
+ * 用于初始化（registerPageAgentTool 的入参）或运行期 setPageAgentToolConfig 的补丁对象：
+ * enableHighlight 为覆盖式更新；a11yConfig 为拼接式合并（数组类字段追加，不丢已有规则，语义见 a11y/config.ts）。
+ */
+export interface PageAgentToolConfigPatch {
+    /** 是否启用元素高亮 */
+    enableHighlight?: boolean;
+    /** 是否在工具调用后移除遮罩， 默认值为 true 移除 */
+    removeMaskAfterToolCall?: boolean;
+    /** 是否在工具调用后移除遮罩 */
+    /** 统一无障碍配置，会与当前生效的 a11yConfig 按数组拼接合并 */
+    a11yConfig?: A11yConfig;
+}
+/** registerPageAgentTool(options) 的入参类型，与运行期补丁 {@link PageAgentToolConfigPatch} 完全一致 */
+export type PageAgentToolOptions = PageAgentToolConfigPatch;
+/** 默认生效的完整工具配置 */
+export declare const DEFAULT_PAGE_AGENT_TOOL_CONFIG: PageAgentToolConfig;
+declare global {
+    interface Window {
+        /** 运行期唯一生效的 page-agent-tool 完整配置（已与默认值合并），可通过 getPageAgentToolConfig/setPageAgentToolConfig 读写 */
+        __webmcpcli_toolConfig?: PageAgentToolConfig;
+    }
+}
+/** 读取当前生效的完整工具配置（已与默认值合并）。未初始化时返回默认配置 */
+export declare function getPageAgentToolConfig(): PageAgentToolConfig;
+/**
+ * 更新当前生效配置。
+ * - patch 为对象时：enableHighlight 覆盖式更新；a11yConfig 与当前配置按数组拼接合并（不丢已有规则）
+ * - patch 为函数时：入参为当前生效配置，返回值直接与默认配置合并（而不是再与 current 相加）。
+ *   这样函数体内可以对 current.a11yConfig 做任意过滤/裁剪（如按条件"移除"某条旧规则），
+ *   返回值即为最终生效的配置，不会因为再与 current 相加而让被过滤掉的旧规则"复活"
+ * - options.mode = 'replace' 时（仅影响对象类型的 patch）：不与"当前生效配置"合并，而是与默认配置重新合并
+ * 返回合并后的最新完整配置，并写回运行期存储供 buildBrowserStateResponse/buildA11yTree 等读取。
+ */
+export declare function setPageAgentToolConfig(patch: PageAgentToolConfigPatch | ((current: PageAgentToolConfig) => PageAgentToolConfigPatch), options?: {
+    mode?: 'merge' | 'replace';
+}): PageAgentToolConfig;

package/dist/page-tools/utils/dom.d.ts

@@ -0,0 +1,6 @@
+export declare function isInShadowDom(el: Element): boolean;
+export declare function dispatchComposedEvents(el: Element, ...types: string[]): void;
+export declare function deepQuerySelectorAll(selector: string, root?: Document | Element | ShadowRoot): Element[];
+export declare function waitForDomSettled(timeout?: number, settleTime?: number): Promise<void>;
+export declare function detectPageDialog(): string;
+export declare function detectValidationErrors(): string;

package/dist/page-tools/utils/scroll.d.ts

@@ -0,0 +1,15 @@
+export declare function getScrollInfo(target?: Window | Element): {
+    scrollY: number;
+    scrollX: number;
+    pixelsAbove: number;
+    pixelsBelow: number;
+    pixelsLeft: number;
+    pixelsRight: number;
+    pagesAbove: number;
+    pagesBelow: number;
+    atTop: boolean;
+    atBottom: boolean;
+    atLeft: boolean;
+    atRight: boolean;
+};
+export declare function waitForScrollEnd(target: Window | Element, timeout?: number): Promise<void>;

package/dist/runtime.d.ts

@@ -0,0 +1,7 @@
+import { initializeBuiltinWebMCP } from './page-tools/initialize-builtin-WebMCP';
+import { registerPageAgentTool } from './page-tools/page-agent-tool';
+import { getPageAgentToolConfig, setPageAgentToolConfig } from './page-tools/tool-config';
+import { defineA11yConfig } from './page-tools/a11y/config';
+import { consoleCloudPageAgentToolOptions, isConsoleCloudHost } from './page-tools/configs/console-cloud';
+
+export { initializeBuiltinWebMCP, registerPageAgentTool, getPageAgentToolConfig, setPageAgentToolConfig, defineA11yConfig, consoleCloudPageAgentToolOptions, isConsoleCloudHost, };