@xiuchang-midscene/shared 2.0.2 → 2.0.3

package/dist/types/mcp/types.d.ts.bak

@@ -1,103 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { z } from 'zod';
-/**
- * Default timeout constants for app loading verification
- */
-export declare const defaultAppLoadingTimeoutMs = 10000;
-export declare const defaultAppLoadingCheckIntervalMs = 2000;
-/**
- * Content item types for tool results (MCP compatible)
- */
-export type ToolResultContent = {
-    type: 'text';
-    text: string;
-} | {
-    type: 'image';
-    data: string;
-    mimeType: string;
-} | {
-    type: 'audio';
-    data: string;
-    mimeType: string;
-} | {
-    type: 'resource';
-    resource: {
-        text: string;
-        uri: string;
-        mimeType?: string;
-    } | {
-        uri: string;
-        blob: string;
-        mimeType?: string;
-    };
-};
-/**
- * Result type for tool execution (MCP compatible)
- */
-export interface ToolResult {
-    [x: string]: unknown;
-    content: ToolResultContent[];
-    isError?: boolean;
-    _meta?: Record<string, unknown>;
-}
-/**
- * Tool handler function type
- * Takes parsed arguments and returns a tool result
- */
-export type ToolHandler<T = Record<string, unknown>> = (args: T) => Promise<ToolResult>;
-/**
- * Tool schema type using Zod
- */
-export type ToolSchema = Record<string, z.ZodTypeAny>;
-/**
- * Tool definition for MCP server
- */
-export interface ToolDefinition<T = Record<string, unknown>> {
-    name: string;
-    description: string;
-    schema: ToolSchema;
-    handler: ToolHandler<T>;
-}
-/**
- * Tool type for mcpKitForAgent return value
- */
-export type Tool = ToolDefinition;
-/**
- * Action space item definition
- * Note: Intentionally no index signature to maintain compatibility with DeviceAction
- */
-export interface ActionSpaceItem {
-    name: string;
-    description?: string;
-    args?: Record<string, unknown>;
-    paramSchema?: z.ZodTypeAny;
-}
-/**
- * Base agent interface
- * Represents a platform-specific agent (Android, iOS, Web)
- * Note: Return types use `unknown` for compatibility with platform-specific implementations
- */
-export interface BaseAgent {
-    getActionSpace(): Promise<ActionSpaceItem[]>;
-    destroy?(): Promise<void>;
-    page?: {
-        screenshotBase64(): Promise<string>;
-    };
-    aiAction?: (description: string, params?: Record<string, unknown>) => Promise<unknown>;
-    aiWaitFor?: (assertion: string, options: Record<string, unknown>) => Promise<unknown>;
-}
-/**
- * Base device interface for temporary device instances
- */
-export interface BaseDevice {
-    actionSpace(): ActionSpaceItem[];
-    destroy?(): Promise<void>;
-}
-/**
- * Interface for platform-specific MCP tools manager
- */
-export interface IMidsceneTools {
-    attachToServer(server: McpServer): void;
-    initTools(): Promise<void>;
-    destroy?(): Promise<void>;
-}

package/dist/types/node/fs.d.ts.bak

@@ -1,15 +0,0 @@
-interface PkgInfo {
-    name: string;
-    version: string;
-    dir: string;
-}
-export declare function getRunningPkgInfo(dir?: string): PkgInfo | null;
-/**
- * Find the nearest package.json file recursively
- * @param {string} dir - Home directory
- * @returns {string|null} - The most recent package.json file path or null
- */
-export declare function findNearestPackageJson(dir: string): string | null;
-export declare function getElementInfosScriptContent(): string;
-export declare function getExtraReturnLogic(tree?: boolean): Promise<string | null>;
-export {};

package/dist/types/node/index.d.ts.bak

@@ -1,2 +0,0 @@
-export * from './fs';
-export * from './port';

package/dist/types/node/port.d.ts.bak

@@ -1,8 +0,0 @@
-/**
- * Check if a port is available
- */
-export declare function isPortAvailable(port: number): Promise<boolean>;
-/**
- * Find an available port starting from the given port
- */
-export declare function findAvailablePort(startPort: number, maxAttempts?: number): Promise<number>;

package/dist/types/oss/demo.d.ts.bak

@@ -1 +0,0 @@
-export {};

package/dist/types/oss/index.d.ts.bak

@@ -1,34 +0,0 @@
-export interface OSSUploadConfig {
-    accessKeyId: string;
-    accessKeySecret: string;
-    stsToken: string;
-    region: string;
-    bucket: string;
-    endpoint?: string;
-    prefix?: string;
-    customDomain?: string;
-}
-export interface OSSUploadResult {
-    success: boolean;
-    url?: string;
-    ossPath?: string;
-    error?: string;
-}
-/**
- * 从环境变量获取 OSS 配置并动态获取 STS 凭证
- *
- * 默认启用上传，可通过 MIDSCENE_OSS_ENABLE=false 显式关闭。
- * 返回 null 表示已关闭或凭证获取失败（凭证失败不影响主流程）。
- */
-export declare function getOSSConfigFromEnv(): Promise<OSSUploadConfig | null>;
-/**
- * 上传单个 HTML 报告文件到 OSS
- *
- * 关于 HTML 预览：
- * - 2017-10-01 之后创建的 Bucket，使用 OSS 默认域名访问 .html 文件时，
- *   OSS 会自动添加 x-oss-force-download: true 和 Content-Disposition: attachment，
- *   导致浏览器强制下载而非预览。
- * - 解决方案：使用签名 URL（signatureUrl）并通过 response 参数覆盖响应头，
- *   或配置自定义域名绕过此限制。
- */
-export declare function uploadReportToOSS(localFilePath: string, config: OSSUploadConfig): Promise<OSSUploadResult>;

package/dist/types/polyfills/async-hooks.d.ts.bak

@@ -1,6 +0,0 @@
-/**
- * Browser polyfill for Node.js async_hooks module
- * Provides empty implementation for browser environments where async_hooks is not available
- */
-declare const AsyncLocalStorage: {};
-export { AsyncLocalStorage };

package/dist/types/polyfills/index.d.ts.bak

@@ -1,4 +0,0 @@
-/**
- * Polyfills for Node.js modules in browser environments
- */
-export * from './async-hooks';

package/dist/types/types/index.d.ts.bak

@@ -1,34 +0,0 @@
-import type { NodeType } from '../constants';
-import type { ElementInfo } from '../extractor';
-export interface Point {
-    left: number;
-    top: number;
-}
-export interface Size {
-    width: number;
-    height: number;
-}
-export type Rect = Point & Size;
-export declare abstract class BaseElement {
-    abstract id: string;
-    abstract attributes: {
-        nodeType: NodeType;
-        [key: string]: string;
-    };
-    abstract content: string;
-    abstract rect: Rect;
-    abstract center: [number, number];
-    abstract isVisible: boolean;
-}
-export interface ElementTreeNode<ElementType extends BaseElement = BaseElement> {
-    node: ElementType | null;
-    children: ElementTreeNode<ElementType>[];
-}
-export interface WebElementInfo extends ElementInfo {
-    zoom: number;
-}
-export type LocateResultElement = {
-    description: string;
-    center: [number, number];
-    rect: Rect;
-};

package/dist/types/us-keyboard-layout.d.ts.bak

@@ -1,32 +0,0 @@
-/**
- * @license
- * Copyright 2017 Google Inc.
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * @internal
- */
-export interface KeyDefinition {
-    keyCode?: number;
-    shiftKeyCode?: number;
-    key?: string;
-    shiftKey?: string;
-    code?: string;
-    text?: string;
-    shiftText?: string;
-    location?: number;
-}
-/**
- * All the valid keys that can be passed to functions that take user input, such
- * as {@link Keyboard.press | keyboard.press }
- *
- * @public
- */
-export type KeyInput = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | 'Power' | 'Eject' | 'Abort' | 'Help' | 'Backspace' | 'Tab' | 'Numpad5' | 'NumpadEnter' | 'Enter' | '\r' | '\n' | 'ShiftLeft' | 'ShiftRight' | 'ControlLeft' | 'ControlRight' | 'AltLeft' | 'AltRight' | 'Pause' | 'CapsLock' | 'Escape' | 'Convert' | 'NonConvert' | 'Space' | 'Numpad9' | 'PageUp' | 'Numpad3' | 'PageDown' | 'End' | 'Numpad1' | 'Home' | 'Numpad7' | 'ArrowLeft' | 'Numpad4' | 'Numpad8' | 'ArrowUp' | 'ArrowRight' | 'Numpad6' | 'Numpad2' | 'ArrowDown' | 'Select' | 'Open' | 'PrintScreen' | 'Insert' | 'Numpad0' | 'Delete' | 'NumpadDecimal' | 'Digit0' | 'Digit1' | 'Digit2' | 'Digit3' | 'Digit4' | 'Digit5' | 'Digit6' | 'Digit7' | 'Digit8' | 'Digit9' | 'KeyA' | 'KeyB' | 'KeyC' | 'KeyD' | 'KeyE' | 'KeyF' | 'KeyG' | 'KeyH' | 'KeyI' | 'KeyJ' | 'KeyK' | 'KeyL' | 'KeyM' | 'KeyN' | 'KeyO' | 'KeyP' | 'KeyQ' | 'KeyR' | 'KeyS' | 'KeyT' | 'KeyU' | 'KeyV' | 'KeyW' | 'KeyX' | 'KeyY' | 'KeyZ' | 'MetaLeft' | 'MetaRight' | 'ContextMenu' | 'NumpadMultiply' | 'NumpadAdd' | 'NumpadSubtract' | 'NumpadDivide' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'F13' | 'F14' | 'F15' | 'F16' | 'F17' | 'F18' | 'F19' | 'F20' | 'F21' | 'F22' | 'F23' | 'F24' | 'NumLock' | 'ScrollLock' | 'AudioVolumeMute' | 'AudioVolumeDown' | 'AudioVolumeUp' | 'MediaTrackNext' | 'MediaTrackPrevious' | 'MediaStop' | 'MediaPlayPause' | 'Semicolon' | 'Equal' | 'NumpadEqual' | 'Comma' | 'Minus' | 'Period' | 'Slash' | 'Backquote' | 'BracketLeft' | 'Backslash' | 'BracketRight' | 'Quote' | 'AltGraph' | 'Props' | 'Cancel' | 'Clear' | 'Shift' | 'Control' | 'Alt' | 'Accept' | 'ModeChange' | ' ' | 'Print' | 'Execute' | '\u0000' | 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z' | 'Meta' | '*' | '+' | '-' | '/' | ';' | '=' | ',' | '.' | '`' | '[' | '\\' | ']' | "'" | 'Attn' | 'CrSel' | 'ExSel' | 'EraseEof' | 'Play' | 'ZoomOut' | ')' | '!' | '@' | '#' | '$' | '%' | '^' | '&' | '(' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z' | ':' | '<' | '_' | '>' | '?' | '~' | '{' | '|' | '}' | '"' | 'SoftLeft' | 'SoftRight' | 'Camera' | 'Call' | 'EndCall' | 'VolumeDown' | 'VolumeUp';
-/**
- * @internal
- */
-export declare const _keyDefinitions: Readonly<Record<KeyInput, KeyDefinition>>;
-export declare const getKeyDefinition: (key: string) => KeyInput;
-export declare const isMac: boolean;
-export declare function transformHotkeyInput(keyInput: string): string[];

package/dist/types/utils.d.ts.bak

@@ -1,34 +0,0 @@
-export declare const ifInBrowser: boolean;
-export declare const ifInWorker: boolean;
-export declare const ifInNode: string | false;
-export declare function uuid(): string;
-export declare function generateHashId(rect: any, content?: string): string;
-/**
- * A utility function that asserts a condition and throws an error with a message if the condition is false.
- *
- * @param condition - The condition to assert
- * @param message - The error message to throw if the condition is false
- * @throws Error with the provided message if the condition is false
- */
-export declare function assert(condition: any, message?: string): asserts condition;
-export declare function setIsMcp(value: boolean): void;
-export declare function logMsg(...message: Parameters<typeof console.log>): void;
-export declare function repeat(times: number, fn: (index: number) => Promise<void>): Promise<void>;
-export declare const escapeScriptTag: (html: string) => string;
-export declare const antiEscapeScriptTag: (html: string) => string;
-export declare function replaceIllegalPathCharsAndSpace(str: string): string;
-/**
- * Check if a value is a plain object (not null, not array, not other types)
- */
-export declare function isPlainObject(value: unknown): value is Record<string, any>;
-/**
- * Normalize string for comparison: lowercase and remove spaces, dashes, and underscores.
- * Useful for flexible app name matching.
- */
-export declare function normalizeForComparison(str: string): string;
-/**
- * Merge and normalize app name mappings.
- * Keys are normalized (lowercase, no spaces/dashes/underscores) for flexible matching.
- * User-provided mapping takes precedence over default mapping.
- */
-export declare function mergeAndNormalizeAppNameMapping(defaultMapping: Record<string, string>, userMapping?: Record<string, string>): Record<string, string>;

package/dist/types/zod-schema-utils.d.ts.bak

@@ -1,23 +0,0 @@
-import type { z } from 'zod';
-/**
- * Recursively unwrap optional, nullable, default, and effects wrapper types
- * to get the actual inner Zod type
- */
-export declare function unwrapZodField(field: unknown): unknown;
-/**
- * Check if a field is a Midscene locator field
- * Checks for either:
- * 1. midscene_location_field_flag in shape (result schema)
- * 2. prompt field in shape (input schema)
- */
-export declare function isMidsceneLocatorField(field: unknown): boolean;
-/**
- * Get type name string from a Zod schema field
- * @param field - Zod schema field
- * @param locatorTypeDescription - Optional description for MidsceneLocation fields (used by core)
- */
-export declare function getZodTypeName(field: unknown, locatorTypeDescription?: string): string;
-/**
- * Get description from a Zod schema field
- */
-export declare function getZodDescription(field: z.ZodTypeAny): string | null;