replicant-mcp 1.6.2 → 1.6.4

package/dist/tools/ui-capture.d.ts

@@ -7,38 +7,19 @@ export declare const uiCaptureInputSchema: z.ZodObject<{
         "visual-snapshot": "visual-snapshot";
     }>;
     localPath: z.ZodOptional<z.ZodString>;
-    inline: z.ZodOptional<z.ZodBoolean>;
-    maxDimension: z.ZodOptional<z.ZodNumber>;
-    raw: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
+    inline: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodBoolean>>;
+    maxDimension: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | number, unknown>, z.ZodCoercedNumber<unknown>>>;
+    raw: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodBoolean>>;
+}, z.core.$strict>;
 export type UiCaptureInput = z.infer<typeof uiCaptureInputSchema>;
 export declare function handleUiCaptureTool(input: UiCaptureInput, context: ServerContext, uiConfig?: UiConfig): Promise<Record<string, unknown>>;
 export declare const uiCaptureToolDefinition: {
     name: string;
     description: string;
     inputSchema: {
-        type: string;
-        properties: {
-            operation: {
-                type: string;
-                enum: string[];
-            };
-            localPath: {
-                type: string;
-            };
-            inline: {
-                type: string;
-            };
-            maxDimension: {
-                type: string;
-                description: string;
-            };
-            raw: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
+        type: "object";
+        properties?: Record<string, unknown>;
+        required?: string[];
     };
     annotations: {
         readOnlyHint: boolean;

package/dist/tools/ui-capture.js

@@ -1,12 +1,16 @@
 import { z } from "zod";
 import { ReplicantError, ErrorCode } from "../types/index.js";
 import { DEFAULT_CONFIG } from "../types/config.js";
-export const uiCaptureInputSchema = z.object({
+import { booleanInput, numberInput, toolSchema } from "../schemas/inputs.js";
+import { toMcpJsonSchema } from "../schemas/derive.js";
+export const uiCaptureInputSchema = toolSchema({
     operation: z.enum(["screenshot", "visual-snapshot"]),
     localPath: z.string().optional(),
-    inline: z.boolean().optional(),
-    maxDimension: z.number().optional(),
-    raw: z.boolean().optional(),
+    inline: booleanInput().optional(),
+    maxDimension: numberInput()
+        .optional()
+        .describe(`Max image dimension in pixels (default: ${DEFAULT_CONFIG.ui.maxImageDimension}). Higher = better quality, more tokens.`),
+    raw: booleanInput().optional().describe("Skip scaling, full device resolution."),
 });
 const operations = {
     screenshot: handleScreenshot,
@@ -39,23 +43,7 @@ async function handleVisualSnapshot(input, context, config, deviceId) {
 export const uiCaptureToolDefinition = {
     name: "ui-capture",
     description: "Capture screenshots or visual snapshots.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            operation: {
-                type: "string",
-                enum: ["screenshot", "visual-snapshot"],
-            },
-            localPath: { type: "string" },
-            inline: { type: "boolean" },
-            maxDimension: {
-                type: "number",
-                description: `Max image dimension in pixels (default: ${DEFAULT_CONFIG.ui.maxImageDimension}). Higher = better quality, more tokens.`,
-            },
-            raw: { type: "boolean", description: "Skip scaling, full device resolution." },
-        },
-        required: ["operation"],
-    },
+    inputSchema: toMcpJsonSchema(uiCaptureInputSchema),
     annotations: {
         readOnlyHint: false,
         destructiveHint: false,

package/dist/tools/ui-query.d.ts

@@ -7,89 +7,30 @@ export declare const uiQueryInputSchema: z.ZodObject<{
         dump: "dump";
         "accessibility-check": "accessibility-check";
     }>;
-    selector: z.ZodOptional<z.ZodObject<{
+    selector: z.ZodOptional<z.ZodPipe<z.ZodTransform<any, unknown>, z.ZodObject<{
         resourceId: z.ZodOptional<z.ZodString>;
         text: z.ZodOptional<z.ZodString>;
         textContains: z.ZodOptional<z.ZodString>;
         className: z.ZodOptional<z.ZodString>;
         nearestTo: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    debug: z.ZodOptional<z.ZodBoolean>;
-    maxTier: z.ZodOptional<z.ZodNumber>;
-    gridCell: z.ZodOptional<z.ZodNumber>;
-    gridPosition: z.ZodOptional<z.ZodNumber>;
-    compact: z.ZodOptional<z.ZodBoolean>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    offset: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
+    }, z.core.$strict>>>;
+    debug: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodBoolean>>;
+    maxTier: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | number, unknown>, z.ZodCoercedNumber<unknown>>>;
+    gridCell: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | number, unknown>, z.ZodCoercedNumber<unknown>>>;
+    gridPosition: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | number, unknown>, z.ZodCoercedNumber<unknown>>>;
+    compact: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodBoolean>>;
+    limit: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | number, unknown>, z.ZodCoercedNumber<unknown>>>;
+    offset: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | number, unknown>, z.ZodCoercedNumber<unknown>>>;
+}, z.core.$strict>;
 export type UiQueryInput = z.infer<typeof uiQueryInputSchema>;
 export declare function handleUiQueryTool(input: UiQueryInput, context: ServerContext, uiConfig?: UiConfig): Promise<Record<string, unknown>>;
 export declare const uiQueryToolDefinition: {
     name: string;
     description: string;
     inputSchema: {
-        type: string;
-        properties: {
-            operation: {
-                type: string;
-                enum: string[];
-            };
-            selector: {
-                type: string;
-                properties: {
-                    resourceId: {
-                        type: string;
-                    };
-                    text: {
-                        type: string;
-                    };
-                    textContains: {
-                        type: string;
-                    };
-                    className: {
-                        type: string;
-                    };
-                    nearestTo: {
-                        type: string;
-                        description: string;
-                    };
-                };
-            };
-            debug: {
-                type: string;
-            };
-            maxTier: {
-                type: string;
-                minimum: number;
-                maximum: number;
-                description: string;
-            };
-            gridCell: {
-                type: string;
-                minimum: number;
-                maximum: number;
-            };
-            gridPosition: {
-                type: string;
-                minimum: number;
-                maximum: number;
-            };
-            compact: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                minimum: number;
-                maximum: number;
-                description: string;
-            };
-            offset: {
-                type: string;
-                minimum: number;
-            };
-        };
-        required: string[];
+        type: "object";
+        properties?: Record<string, unknown>;
+        required?: string[];
     };
     annotations: {
         readOnlyHint: boolean;

package/dist/tools/ui-query.js

@@ -3,22 +3,31 @@ import { CACHE_TTLS, ReplicantError, ErrorCode } from "../types/index.js";
 import { flattenTree } from "../parsers/ui-dump.js";
 import { DEFAULT_CONFIG } from "../types/config.js";
 import { handleFind } from "./ui-find.js";
-export const uiQueryInputSchema = z.object({
+import { booleanInput, jsonObjectInput, numberInput, toolSchema, } from "../schemas/inputs.js";
+import { toMcpJsonSchema } from "../schemas/derive.js";
+export const uiQueryInputSchema = toolSchema({
     operation: z.enum(["dump", "find", "accessibility-check"]),
-    selector: z.object({
+    selector: jsonObjectInput({
         resourceId: z.string().optional(),
         text: z.string().optional(),
         textContains: z.string().optional(),
         className: z.string().optional(),
-        nearestTo: z.string().optional(),
+        nearestTo: z
+            .string()
+            .optional()
+            .describe("Find elements nearest to this text (spatial proximity)"),
     }).optional(),
-    debug: z.boolean().optional(),
-    maxTier: z.number().min(1).max(5).optional(),
-    gridCell: z.number().min(1).max(24).optional(),
-    gridPosition: z.number().min(1).max(5).optional(),
-    compact: z.boolean().optional(),
-    limit: z.number().min(1).max(100).optional(),
-    offset: z.number().min(0).optional(),
+    debug: booleanInput().optional(),
+    maxTier: numberInput({ min: 1, max: 5 })
+        .optional()
+        .describe("Max fallback tier (1-5). Use 3 to stop before visual/grid payloads."),
+    gridCell: numberInput({ min: 1, max: 24 }).optional(),
+    gridPosition: numberInput({ min: 1, max: 5 }).optional(),
+    compact: booleanInput()
+        .optional()
+        .describe("Paginated flat list (default: true). false for full tree."),
+    limit: numberInput({ min: 1, max: 100 }).optional().describe("Default: 20"),
+    offset: numberInput({ min: 0 }).optional(),
 });
 const operations = {
     dump: handleDump,
@@ -34,6 +43,18 @@ export async function handleUiQueryTool(input, context, uiConfig) {
     }
     return handler(input, context, config, device.id);
 }
+function buildCoordinateMeta(context) {
+    const scalingState = context.ui.getScalingState();
+    if (!scalingState) {
+        return { coordinateSpace: "device", scaleFactor: 1.0 };
+    }
+    return {
+        coordinateSpace: "device",
+        scaleFactor: scalingState.scaleFactor,
+        deviceDimensions: { width: scalingState.deviceWidth, height: scalingState.deviceHeight },
+        imageDimensions: { width: scalingState.imageWidth, height: scalingState.imageHeight },
+    };
+}
 async function handleDump(input, context, _config, deviceId) {
     const tree = await context.ui.dump(deviceId);
     const dumpId = context.cache.generateId("ui-dump");
@@ -41,12 +62,13 @@ async function handleDump(input, context, _config, deviceId) {
     const emptyWarning = tree.length === 0
         ? "No accessibility nodes found. Possible causes: (1) UI still loading - wait and retry, (2) App uses custom rendering (Flutter, games, video players) - use screenshot instead, (3) App blocks accessibility services."
         : undefined;
+    const coordMeta = buildCoordinateMeta(context);
     if (input.compact !== false) {
-        return handleCompactDump(tree, input, dumpId, deviceId, emptyWarning);
+        return handleCompactDump(tree, input, dumpId, deviceId, emptyWarning, coordMeta);
     }
-    return handleFullDump(tree, dumpId, deviceId, emptyWarning);
+    return handleFullDump(tree, dumpId, deviceId, emptyWarning, coordMeta);
 }
-function handleCompactDump(tree, input, dumpId, deviceId, emptyWarning) {
+function handleCompactDump(tree, input, dumpId, deviceId, emptyWarning, coordMeta) {
     const flat = flattenTree(tree);
     const interactive = flat.filter((n) => n.clickable || n.focusable);
     const limit = input.limit ?? 20;
@@ -76,11 +98,12 @@ function handleCompactDump(tree, input, dumpId, deviceId, emptyWarning) {
         offset,
         limit,
         deviceId,
+        ...coordMeta,
         hint,
         warning: emptyWarning || noInteractiveWarning,
     };
 }
-function handleFullDump(tree, dumpId, deviceId, emptyWarning) {
+function handleFullDump(tree, dumpId, deviceId, emptyWarning, coordMeta) {
     const simplifyNode = (node) => ({
         className: node.className.split(".").pop(),
         text: node.text || undefined,
@@ -93,6 +116,7 @@ function handleFullDump(tree, dumpId, deviceId, emptyWarning) {
         dumpId,
         tree: tree.map((n) => simplifyNode(n)),
         deviceId,
+        ...coordMeta,
         warning: emptyWarning,
     };
 }
@@ -103,38 +127,7 @@ async function handleAccessibilityCheck(_input, context, _config, deviceId) {
 export const uiQueryToolDefinition = {
     name: "ui-query",
     description: "Query app UI. Accessibility-first.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            operation: {
-                type: "string",
-                enum: ["dump", "find", "accessibility-check"],
-            },
-            selector: {
-                type: "object",
-                properties: {
-                    resourceId: { type: "string" },
-                    text: { type: "string" },
-                    textContains: { type: "string" },
-                    className: { type: "string" },
-                    nearestTo: { type: "string", description: "Find elements nearest to this text (spatial proximity)" },
-                },
-            },
-            debug: { type: "boolean" },
-            maxTier: {
-                type: "number",
-                minimum: 1,
-                maximum: 5,
-                description: "Max fallback tier (1-5). Use 3 to stop before visual/grid payloads.",
-            },
-            gridCell: { type: "number", minimum: 1, maximum: 24 },
-            gridPosition: { type: "number", minimum: 1, maximum: 5 },
-            compact: { type: "boolean", description: "Paginated flat list (default: true). false for full tree." },
-            limit: { type: "number", minimum: 1, maximum: 100, description: "Default: 20" },
-            offset: { type: "number", minimum: 0 },
-        },
-        required: ["operation"],
-    },
+    inputSchema: toMcpJsonSchema(uiQueryInputSchema),
     annotations: {
         readOnlyHint: true,
         destructiveHint: false,

package/dist/types/errors.d.ts

@@ -15,6 +15,7 @@ export declare const ErrorCode: {
     readonly INPUT_VALIDATION_FAILED: "INPUT_VALIDATION_FAILED";
     readonly INVALID_OPERATION: "INVALID_OPERATION";
     readonly ELEMENT_NOT_FOUND: "ELEMENT_NOT_FOUND";
+    readonly AMBIGUOUS_MATCH: "AMBIGUOUS_MATCH";
     readonly COMMAND_BLOCKED: "COMMAND_BLOCKED";
     readonly TIMEOUT: "TIMEOUT";
     readonly CACHE_MISS: "CACHE_MISS";

package/dist/types/errors.js

@@ -20,6 +20,7 @@ export const ErrorCode = {
     INPUT_VALIDATION_FAILED: "INPUT_VALIDATION_FAILED",
     INVALID_OPERATION: "INVALID_OPERATION",
     ELEMENT_NOT_FOUND: "ELEMENT_NOT_FOUND",
+    AMBIGUOUS_MATCH: "AMBIGUOUS_MATCH",
     // Safety errors
     COMMAND_BLOCKED: "COMMAND_BLOCKED",
     TIMEOUT: "TIMEOUT",

package/dist/types/schemas/ui-output.d.ts

@@ -3,6 +3,17 @@ import { z } from "zod";
  * Output for ui dump operation (full mode)
  */
 export declare const UiDumpFullOutput: z.ZodObject<{
+    warning: z.ZodOptional<z.ZodString>;
+    coordinateSpace: z.ZodLiteral<"device">;
+    scaleFactor: z.ZodNumber;
+    deviceDimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    imageDimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
     dumpId: z.ZodString;
     tree: z.ZodArray<z.ZodType<{
         className?: string;
@@ -20,12 +31,23 @@ export declare const UiDumpFullOutput: z.ZodObject<{
         children?: unknown[];
     }, unknown>>>;
     deviceId: z.ZodString;
-    warning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * Output for ui dump operation (compact mode)
  */
 export declare const UiDumpCompactOutput: z.ZodObject<{
+    hint: z.ZodOptional<z.ZodString>;
+    warning: z.ZodOptional<z.ZodString>;
+    coordinateSpace: z.ZodLiteral<"device">;
+    scaleFactor: z.ZodNumber;
+    deviceDimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    imageDimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
     dumpId: z.ZodString;
     elements: z.ZodArray<z.ZodObject<{
         text: z.ZodOptional<z.ZodString>;
@@ -40,8 +62,6 @@ export declare const UiDumpCompactOutput: z.ZodObject<{
     offset: z.ZodNumber;
     limit: z.ZodNumber;
     deviceId: z.ZodString;
-    hint: z.ZodOptional<z.ZodString>;
-    warning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * Output for ui find operation
@@ -136,6 +156,13 @@ export declare const UiTapOutput: z.ZodObject<{
         deviceSpace: z.ZodBoolean;
     }, z.core.$strip>;
     deviceId: z.ZodString;
+    matchedSelector: z.ZodOptional<z.ZodObject<{
+        resourceId: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        textContains: z.ZodOptional<z.ZodString>;
+        className: z.ZodOptional<z.ZodString>;
+        nearestTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * Output for ui input operation
@@ -143,6 +170,13 @@ export declare const UiTapOutput: z.ZodObject<{
 export declare const UiInputOutput: z.ZodObject<{
     input: z.ZodString;
     deviceId: z.ZodString;
+    matchedSelector: z.ZodOptional<z.ZodObject<{
+        resourceId: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        textContains: z.ZodOptional<z.ZodString>;
+        className: z.ZodOptional<z.ZodString>;
+        nearestTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * Output for ui scroll operation
@@ -156,8 +190,17 @@ export declare const UiScrollOutput: z.ZodObject<{
             right: "right";
         }>;
         amount: z.ZodNumber;
+        container: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     deviceId: z.ZodString;
+    matchedSelector: z.ZodOptional<z.ZodObject<{
+        resourceId: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        textContains: z.ZodOptional<z.ZodString>;
+        className: z.ZodOptional<z.ZodString>;
+        nearestTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    warning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * Output for ui screenshot operation (passthrough from adapter)
@@ -196,6 +239,17 @@ export declare const UiVisualSnapshotOutput: z.ZodObject<{
  * Union of all ui tool outputs
  */
 export declare const UiOutput: z.ZodUnion<readonly [z.ZodObject<{
+    warning: z.ZodOptional<z.ZodString>;
+    coordinateSpace: z.ZodLiteral<"device">;
+    scaleFactor: z.ZodNumber;
+    deviceDimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    imageDimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
     dumpId: z.ZodString;
     tree: z.ZodArray<z.ZodType<{
         className?: string;
@@ -213,8 +267,19 @@ export declare const UiOutput: z.ZodUnion<readonly [z.ZodObject<{
         children?: unknown[];
     }, unknown>>>;
     deviceId: z.ZodString;
-    warning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
+    hint: z.ZodOptional<z.ZodString>;
+    warning: z.ZodOptional<z.ZodString>;
+    coordinateSpace: z.ZodLiteral<"device">;
+    scaleFactor: z.ZodNumber;
+    deviceDimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    imageDimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
     dumpId: z.ZodString;
     elements: z.ZodArray<z.ZodObject<{
         text: z.ZodOptional<z.ZodString>;
@@ -229,8 +294,6 @@ export declare const UiOutput: z.ZodUnion<readonly [z.ZodObject<{
     offset: z.ZodNumber;
     limit: z.ZodNumber;
     deviceId: z.ZodString;
-    hint: z.ZodOptional<z.ZodString>;
-    warning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     elements: z.ZodArray<z.ZodObject<{
         index: z.ZodNumber;
@@ -317,9 +380,23 @@ export declare const UiOutput: z.ZodUnion<readonly [z.ZodObject<{
         deviceSpace: z.ZodBoolean;
     }, z.core.$strip>;
     deviceId: z.ZodString;
+    matchedSelector: z.ZodOptional<z.ZodObject<{
+        resourceId: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        textContains: z.ZodOptional<z.ZodString>;
+        className: z.ZodOptional<z.ZodString>;
+        nearestTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     input: z.ZodString;
     deviceId: z.ZodString;
+    matchedSelector: z.ZodOptional<z.ZodObject<{
+        resourceId: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        textContains: z.ZodOptional<z.ZodString>;
+        className: z.ZodOptional<z.ZodString>;
+        nearestTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     scrolled: z.ZodObject<{
         direction: z.ZodEnum<{
@@ -329,8 +406,17 @@ export declare const UiOutput: z.ZodUnion<readonly [z.ZodObject<{
             right: "right";
         }>;
         amount: z.ZodNumber;
+        container: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     deviceId: z.ZodString;
+    matchedSelector: z.ZodOptional<z.ZodObject<{
+        resourceId: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        textContains: z.ZodOptional<z.ZodString>;
+        className: z.ZodOptional<z.ZodString>;
+        nearestTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    warning: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     screenshotPath: z.ZodOptional<z.ZodString>;
     base64: z.ZodOptional<z.ZodString>;

package/dist/types/schemas/ui-output.js

@@ -16,6 +16,12 @@ const SimplifiedNodeSchema = z.lazy(() => z.object({
     clickable: z.boolean().optional(),
     children: z.array(SimplifiedNodeSchema).optional(),
 }));
+const DumpCoordMetaShape = {
+    coordinateSpace: z.literal("device"),
+    scaleFactor: z.number(),
+    deviceDimensions: z.object({ width: z.number(), height: z.number() }).optional(),
+    imageDimensions: z.object({ width: z.number(), height: z.number() }).optional(),
+};
 /**
  * Output for ui dump operation (full mode)
  */
@@ -23,6 +29,7 @@ export const UiDumpFullOutput = z.object({
     dumpId: z.string(),
     tree: z.array(SimplifiedNodeSchema),
     deviceId: z.string(),
+    ...DumpCoordMetaShape,
     warning: z.string().optional(),
 });
 /**
@@ -47,6 +54,7 @@ export const UiDumpCompactOutput = z.object({
     offset: z.number(),
     limit: z.number(),
     deviceId: z.string(),
+    ...DumpCoordMetaShape,
     hint: z.string().optional(),
     warning: z.string().optional(),
 });
@@ -111,6 +119,13 @@ export const UiFindOutput = z.object({
         hint: z.string().optional(),
     }).optional(),
 });
+const SelectorEcho = z.object({
+    resourceId: z.string().optional(),
+    text: z.string().optional(),
+    textContains: z.string().optional(),
+    className: z.string().optional(),
+    nearestTo: z.string().optional(),
+});
 /**
  * Output for ui tap operation
  */
@@ -121,6 +136,7 @@ export const UiTapOutput = z.object({
         deviceSpace: z.boolean(),
     }),
     deviceId: z.string(),
+    matchedSelector: SelectorEcho.optional(),
 });
 /**
  * Output for ui input operation
@@ -128,6 +144,7 @@ export const UiTapOutput = z.object({
 export const UiInputOutput = z.object({
     input: z.string(),
     deviceId: z.string(),
+    matchedSelector: SelectorEcho.optional(),
 });
 /**
  * Output for ui scroll operation
@@ -136,8 +153,11 @@ export const UiScrollOutput = z.object({
     scrolled: z.object({
         direction: z.enum(["up", "down", "left", "right"]),
         amount: z.number(),
+        container: z.string().optional(),
     }),
     deviceId: z.string(),
+    matchedSelector: SelectorEcho.optional(),
+    warning: z.string().optional(),
 });
 /**
  * Output for ui screenshot operation (passthrough from adapter)