@wa008/ui-audit-mcp 1.0.2

package/dist/tools/get-checklist.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Tool: get_checklist
+ *
+ * Return the evaluation checklist for either single-screen UI quality
+ * or multi-screen style consistency. Creates a new evaluation session.
+ */
+import { z } from "zod";
+import { EvaluationSession } from "../types.js";
+export declare const sessions: Map<string, EvaluationSession>;
+export declare const getChecklistSchema: z.ZodObject<{
+    type: z.ZodEnum<["screen", "style"]>;
+    screenName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "screen" | "style";
+    screenName?: string | undefined;
+}, {
+    type: "screen" | "style";
+    screenName?: string | undefined;
+}>;
+export type GetChecklistInput = z.infer<typeof getChecklistSchema>;
+export declare function getChecklist(input: GetChecklistInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=get-checklist.d.ts.map

package/dist/tools/get-checklist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-checklist.d.ts","sourceRoot":"","sources":["../../src/tools/get-checklist.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,eAAO,MAAM,QAAQ,gCAAuC,CAAC;AAE7D,eAAO,MAAM,kBAAkB;;;;;;;;;EAc7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB;;;;;GA2C1D"}

package/dist/tools/get-checklist.js

@@ -0,0 +1,57 @@
+/**
+ * Tool: get_checklist
+ *
+ * Return the evaluation checklist for either single-screen UI quality
+ * or multi-screen style consistency. Creates a new evaluation session.
+ */
+import { z } from "zod";
+import { v4 as uuidv4 } from "uuid";
+import { SCREEN_CHECKLIST, STYLE_CHECKLIST, DEFAULT_PASSING_SCORE, } from "../evaluation/checklist.js";
+// In-memory session store (keyed by sessionId)
+export const sessions = new Map();
+export const getChecklistSchema = z.object({
+    type: z
+        .enum(["screen", "style"])
+        .describe("'screen' for single-screen UI quality evaluation, " +
+        "'style' for multi-screen style consistency evaluation"),
+    screenName: z
+        .string()
+        .optional()
+        .describe("Name of the screen being evaluated (e.g. 'LoginScreen'). " +
+        "Required for screen evaluation; for style evaluation, use a descriptive name like 'AllScreens'."),
+});
+export async function getChecklist(input) {
+    const sessionId = uuidv4();
+    const screenName = input.screenName ?? "unnamed";
+    const checklist = input.type === "screen" ? SCREEN_CHECKLIST : STYLE_CHECKLIST;
+    const session = {
+        sessionId,
+        type: input.type,
+        screenName,
+        checklist,
+        passingScore: DEFAULT_PASSING_SCORE,
+        createdAt: new Date().toISOString(),
+    };
+    sessions.set(sessionId, session);
+    const instruction = input.type === "screen"
+        ? "Review the screenshot you captured via take_screenshot. Score each checklist item from 1 to 5. " +
+            "For any item scoring below 3, you MUST provide a specific reason and an actionable improvement suggestion."
+        : "Review ALL screenshots you have captured. Score each consistency dimension from 1 to 5. " +
+            "For any item scoring below 3, identify which screens are inconsistent and suggest how to unify them.";
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    sessionId,
+                    type: input.type,
+                    screenName,
+                    checklist,
+                    passingScore: DEFAULT_PASSING_SCORE,
+                    instruction,
+                }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-checklist.js.map

package/dist/tools/get-checklist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-checklist.js","sourceRoot":"","sources":["../../src/tools/get-checklist.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EACH,gBAAgB,EAChB,eAAe,EACf,qBAAqB,GACxB,MAAM,4BAA4B,CAAC;AAGpC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;AAE7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC;SACF,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;SACzB,QAAQ,CACL,oDAAoD;QACpD,uDAAuD,CAC1D;IACL,UAAU,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,2DAA2D;QAC3D,iGAAiG,CACpG;CACR,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACvD,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC;IACjD,MAAM,SAAS,GACX,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC;IAEjE,MAAM,OAAO,GAAsB;QAC/B,SAAS;QACT,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU;QACV,SAAS;QACT,YAAY,EAAE,qBAAqB;QACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;IAEF,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEjC,MAAM,WAAW,GACb,KAAK,CAAC,IAAI,KAAK,QAAQ;QACnB,CAAC,CAAC,iGAAiG;YACnG,4GAA4G;QAC5G,CAAC,CAAC,0FAA0F;YAC5F,sGAAsG,CAAC;IAE/G,OAAO;QACH,OAAO,EAAE;YACL;gBACI,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB;oBACI,SAAS;oBACT,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,UAAU;oBACV,SAAS;oBACT,YAAY,EAAE,qBAAqB;oBACnC,WAAW;iBACd,EACD,IAAI,EACJ,CAAC,CACJ;aACJ;SACJ;KACJ,CAAC;AACN,CAAC"}

package/dist/tools/get-log.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tool: get_evaluation_log
+ *
+ * Query past evaluation results for review and summary.
+ * Useful for tracking improvement across multiple evaluation attempts.
+ */
+import { z } from "zod";
+export declare const getEvaluationLogSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    sessionId?: string | undefined;
+    limit?: number | undefined;
+}, {
+    sessionId?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type GetEvaluationLogInput = z.infer<typeof getEvaluationLogSchema>;
+export declare function getEvaluationLog(input: GetEvaluationLogInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=get-log.d.ts.map

package/dist/tools/get-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-log.d.ts","sourceRoot":"","sources":["../../src/tools/get-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,sBAAsB;;;;;;;;;EAYjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB;;;;;GAWlE"}

package/dist/tools/get-log.js

@@ -0,0 +1,33 @@
+/**
+ * Tool: get_evaluation_log
+ *
+ * Query past evaluation results for review and summary.
+ * Useful for tracking improvement across multiple evaluation attempts.
+ */
+import { z } from "zod";
+import { queryLogs } from "../logger/evaluation-logger.js";
+export const getEvaluationLogSchema = z.object({
+    sessionId: z
+        .string()
+        .optional()
+        .describe("Optional session ID to look up a specific evaluation. If omitted, returns the most recent evaluations."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("Maximum number of log entries to return (default: 10)"),
+});
+export async function getEvaluationLog(input) {
+    const { logs, summary } = queryLogs(input.sessionId, input.limit ?? 10);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ logs, summary }, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-log.js.map

package/dist/tools/get-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-log.js","sourceRoot":"","sources":["../../src/tools/get-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wGAAwG,CAAC;IACvH,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;CACzE,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAA4B;IAC/D,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAExE,OAAO;QACH,OAAO,EAAE;YACL;gBACI,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;aACnD;SACJ;KACJ,CAAC;AACN,CAAC"}

package/dist/tools/launch-app.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tool: launch_app
+ * Launch an iOS app on the simulator by its bundle ID.
+ */
+import { z } from "zod";
+export declare const launchAppSchema: z.ZodObject<{
+    appId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    appId: string;
+}, {
+    appId: string;
+}>;
+export declare function launchApp(input: z.infer<typeof launchAppSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=launch-app.d.ts.map

package/dist/tools/launch-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-app.d.ts","sourceRoot":"","sources":["../../src/tools/launch-app.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe;;;;;;EAE1B,CAAC;AAEH,wBAAsB,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC;;;;;GAarE"}

package/dist/tools/launch-app.js

@@ -0,0 +1,24 @@
+/**
+ * Tool: launch_app
+ * Launch an iOS app on the simulator by its bundle ID.
+ */
+import { z } from "zod";
+import * as device from "../device/adapter.js";
+export const launchAppSchema = z.object({
+    appId: z.string().describe("The bundle ID of the iOS app, e.g. 'com.example.myapp'"),
+});
+export async function launchApp(input) {
+    const result = await device.launchApp(input.appId);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    success: result.success,
+                    ...(result.success
+                        ? { message: `App '${input.appId}' launched.` }
+                        : { error: result.error, hint: "Ensure the app is installed and the simulator is booted." }),
+                }),
+            }],
+    };
+}
+//# sourceMappingURL=launch-app.js.map

package/dist/tools/launch-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-app.js","sourceRoot":"","sources":["../../src/tools/launch-app.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;CACvF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAsC;IAClE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,OAAO;QACH,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,GAAG,CAAC,MAAM,CAAC,OAAO;wBACd,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,KAAK,CAAC,KAAK,aAAa,EAAE;wBAC/C,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,0DAA0D,EAAE,CAAC;iBACnG,CAAC;aACL,CAAC;KACL,CAAC;AACN,CAAC"}

package/dist/tools/submit-evaluation.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Tool: submit_evaluation
+ *
+ * Accept the agent's scores for each checklist item, determine pass/fail,
+ * persist the result to the evaluation log, and return the outcome.
+ */
+import { z } from "zod";
+export declare const submitEvaluationSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    scores: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        score: z.ZodNumber;
+        reason: z.ZodOptional<z.ZodString>;
+        suggestion: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        score: number;
+        reason?: string | undefined;
+        suggestion?: string | undefined;
+    }, {
+        id: string;
+        score: number;
+        reason?: string | undefined;
+        suggestion?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    scores: {
+        id: string;
+        score: number;
+        reason?: string | undefined;
+        suggestion?: string | undefined;
+    }[];
+}, {
+    sessionId: string;
+    scores: {
+        id: string;
+        score: number;
+        reason?: string | undefined;
+        suggestion?: string | undefined;
+    }[];
+}>;
+export type SubmitEvaluationInput = z.infer<typeof submitEvaluationSchema>;
+export declare function submitEvaluation(input: SubmitEvaluationInput): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=submit-evaluation.d.ts.map

package/dist/tools/submit-evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-evaluation.d.ts","sourceRoot":"","sources":["../../src/tools/submit-evaluation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB;;;;;;;;;;;;GAsFlE"}

package/dist/tools/submit-evaluation.js

@@ -0,0 +1,107 @@
+/**
+ * Tool: submit_evaluation
+ *
+ * Accept the agent's scores for each checklist item, determine pass/fail,
+ * persist the result to the evaluation log, and return the outcome.
+ */
+import { z } from "zod";
+import { sessions } from "./get-checklist.js";
+import { evaluateScores } from "../evaluation/scorer.js";
+import { saveLog, countScreenAttempts } from "../logger/evaluation-logger.js";
+const scoreEntrySchema = z.object({
+    id: z.string().describe("Checklist item ID (e.g. 'overlap', 'layout')"),
+    score: z
+        .number()
+        .int()
+        .min(1)
+        .max(5)
+        .describe("Score from 1 (worst) to 5 (best)"),
+    reason: z
+        .string()
+        .optional()
+        .describe("Why this score was given. Required if score < passing threshold."),
+    suggestion: z
+        .string()
+        .optional()
+        .describe("Actionable improvement suggestion. Required if score < passing threshold."),
+});
+export const submitEvaluationSchema = z.object({
+    sessionId: z
+        .string()
+        .describe("The session ID returned by get_checklist"),
+    scores: z
+        .array(scoreEntrySchema)
+        .describe("Array of score entries, one per checklist item"),
+});
+export async function submitEvaluation(input) {
+    const session = sessions.get(input.sessionId);
+    if (!session) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: `Session '${input.sessionId}' not found. Call get_checklist first to create a session.`,
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Validate that all checklist items have scores
+    const missingIds = session.checklist
+        .filter((item) => !input.scores.find((s) => s.id === item.id))
+        .map((item) => item.id);
+    if (missingIds.length > 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: `Missing scores for checklist items: ${missingIds.join(", ")}`,
+                        expectedIds: session.checklist.map((c) => c.id),
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Determine attempt number for this screen
+    const attemptNumber = countScreenAttempts(session.screenName) + 1;
+    // Evaluate
+    const scores = input.scores;
+    const outcome = evaluateScores(session.sessionId, session.type, session.screenName, session.checklist, scores, session.passingScore, attemptNumber);
+    // Persist to log
+    const logPath = saveLog(outcome, session.checklist, scores);
+    // Clean up session
+    sessions.delete(input.sessionId);
+    // Build response
+    const response = {
+        sessionId: outcome.sessionId,
+        screenName: outcome.screenName,
+        overallPassed: outcome.overallPassed,
+        averageScore: outcome.averageScore,
+        attemptNumber: outcome.attemptNumber,
+        results: outcome.results,
+        logPath,
+    };
+    if (!outcome.overallPassed) {
+        response.failedItems = outcome.failedItems;
+        response.nextSteps =
+            "The evaluation did NOT pass. Review the failed items above — each includes a reason and suggestion. " +
+                "Please fix the identified issues in the code, rebuild, and re-evaluate the screen.";
+    }
+    else {
+        response.nextSteps =
+            "All checklist items passed! You may proceed to evaluate the next screen or run style consistency checks.";
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=submit-evaluation.js.map

package/dist/tools/submit-evaluation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-evaluation.js","sourceRoot":"","sources":["../../src/tools/submit-evaluation.ts"],"names":[],"mappings":"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"}

package/dist/tools/swipe.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tool: swipe
+ * Swipe from one point to another using ratio coordinates (0-1).
+ */
+import { z } from "zod";
+export declare const swipeSchema: z.ZodObject<{
+    startX: z.ZodNumber;
+    startY: z.ZodNumber;
+    endX: z.ZodNumber;
+    endY: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    startX: number;
+    startY: number;
+    endX: number;
+    endY: number;
+}, {
+    startX: number;
+    startY: number;
+    endX: number;
+    endY: number;
+}>;
+export declare function swipe(input: z.infer<typeof swipeSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=swipe.d.ts.map

package/dist/tools/swipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swipe.d.ts","sourceRoot":"","sources":["../../src/tools/swipe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAKtB,CAAC;AAEH,wBAAsB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;GAY7D"}

package/dist/tools/swipe.js

@@ -0,0 +1,26 @@
+/**
+ * Tool: swipe
+ * Swipe from one point to another using ratio coordinates (0-1).
+ */
+import { z } from "zod";
+import * as device from "../device/adapter.js";
+export const swipeSchema = z.object({
+    startX: z.number().min(0).max(1).describe("Start horizontal ratio (0-1)"),
+    startY: z.number().min(0).max(1).describe("Start vertical ratio (0-1)"),
+    endX: z.number().min(0).max(1).describe("End horizontal ratio (0-1)"),
+    endY: z.number().min(0).max(1).describe("End vertical ratio (0-1)"),
+});
+export async function swipe(input) {
+    const result = await device.swipe(input.startX, input.startY, input.endX, input.endY);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    success: result.success,
+                    swipe: { from: { x: input.startX, y: input.startY }, to: { x: input.endX, y: input.endY } },
+                    ...(result.error ? { error: result.error } : {}),
+                }),
+            }],
+    };
+}
+//# sourceMappingURL=swipe.js.map

package/dist/tools/swipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swipe.js","sourceRoot":"","sources":["../../src/tools/swipe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAC;AAE/C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACzE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACvE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,KAAkC;IAC1D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACtF,OAAO;QACH,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE;oBAC3F,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACnD,CAAC;aACL,CAAC;KACL,CAAC;AACN,CAAC"}

package/dist/tools/take-screenshot.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tool: take_screenshot
+ * Capture the current simulator screen and return it as a base64 PNG image.
+ */
+import { z } from "zod";
+export declare const takeScreenshotSchema: z.ZodObject<{
+    screenName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    screenName?: string | undefined;
+}, {
+    screenName?: string | undefined;
+}>;
+export declare function takeScreenshot(input: z.infer<typeof takeScreenshotSchema>): Promise<{
+    content: ({
+        type: "image";
+        data: string;
+        mimeType: "image/png";
+        text?: undefined;
+    } | {
+        type: "text";
+        text: string;
+        data?: undefined;
+        mimeType?: undefined;
+    })[];
+}>;
+//# sourceMappingURL=take-screenshot.d.ts.map

package/dist/tools/take-screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"take-screenshot.d.ts","sourceRoot":"","sources":["../../src/tools/take-screenshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC;;;;;;;;;;;;GAqB/E"}

package/dist/tools/take-screenshot.js

@@ -0,0 +1,32 @@
+/**
+ * Tool: take_screenshot
+ * Capture the current simulator screen and return it as a base64 PNG image.
+ */
+import { z } from "zod";
+import * as device from "../device/adapter.js";
+export const takeScreenshotSchema = z.object({
+    screenName: z.string().optional().describe("Label for this screen (e.g. 'LoginScreen'). Used for logging."),
+});
+export async function takeScreenshot(input) {
+    const screenshot = await device.takeScreenshot();
+    return {
+        content: [
+            {
+                type: "image",
+                data: screenshot.imageBase64,
+                mimeType: "image/png",
+            },
+            {
+                type: "text",
+                text: JSON.stringify({
+                    screenName: input.screenName ?? "unnamed",
+                    screenWidth: screenshot.width,
+                    screenHeight: screenshot.height,
+                    timestamp: new Date().toISOString(),
+                    hint: "Use ratio coordinates (0-1) when calling tap or swipe.",
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=take-screenshot.js.map

package/dist/tools/take-screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"take-screenshot.js","sourceRoot":"","sources":["../../src/tools/take-screenshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAC;AAE/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CAC9G,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAA2C;IAC5E,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;IACjD,OAAO;QACH,OAAO,EAAE;YACL;gBACI,IAAI,EAAE,OAAgB;gBACtB,IAAI,EAAE,UAAU,CAAC,WAAW;gBAC5B,QAAQ,EAAE,WAAoB;aACjC;YACD;gBACI,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACjB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,SAAS;oBACzC,WAAW,EAAE,UAAU,CAAC,KAAK;oBAC7B,YAAY,EAAE,UAAU,CAAC,MAAM;oBAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,IAAI,EAAE,wDAAwD;iBACjE,CAAC;aACL;SACJ;KACJ,CAAC;AACN,CAAC"}

package/dist/tools/tap.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tool: tap
+ * Tap at a position on the simulator screen using ratio coordinates (0-1).
+ */
+import { z } from "zod";
+export declare const tapSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
+}, {
+    x: number;
+    y: number;
+}>;
+export declare function tap(input: z.infer<typeof tapSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=tap.d.ts.map

package/dist/tools/tap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap.d.ts","sourceRoot":"","sources":["../../src/tools/tap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,SAAS;;;;;;;;;EAGpB,CAAC;AAEH,wBAAsB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC;;;;;GAYzD"}

package/dist/tools/tap.js

@@ -0,0 +1,24 @@
+/**
+ * Tool: tap
+ * Tap at a position on the simulator screen using ratio coordinates (0-1).
+ */
+import { z } from "zod";
+import * as device from "../device/adapter.js";
+export const tapSchema = z.object({
+    x: z.number().min(0).max(1).describe("Horizontal position ratio (0 = left, 1 = right)"),
+    y: z.number().min(0).max(1).describe("Vertical position ratio (0 = top, 1 = bottom)"),
+});
+export async function tap(input) {
+    const result = await device.tap(input.x, input.y);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    success: result.success,
+                    tappedAt: { ratioX: input.x, ratioY: input.y, pointX: result.pointX, pointY: result.pointY },
+                    ...(result.error ? { error: result.error } : {}),
+                }),
+            }],
+    };
+}
+//# sourceMappingURL=tap.js.map

package/dist/tools/tap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap.js","sourceRoot":"","sources":["../../src/tools/tap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAC;AAE/C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACvF,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CACxF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,KAAgC;IACtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO;QACH,OAAO,EAAE,CAAC;gBACN,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;oBAC5F,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACnD,CAAC;aACL,CAAC;KACL,CAAC;AACN,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Core type definitions for ui-critic-mcp
+ */
+export interface ChecklistItem {
+    id: string;
+    name: string;
+    description: string;
+    scoringGuide: string;
+}
+export type EvaluationType = "screen" | "style";
+export interface EvaluationSession {
+    sessionId: string;
+    type: EvaluationType;
+    screenName: string;
+    checklist: ChecklistItem[];
+    passingScore: number;
+    createdAt: string;
+}
+export interface ScoreEntry {
+    id: string;
+    score: number;
+    reason?: string;
+    suggestion?: string;
+}
+export interface EvaluationResult {
+    id: string;
+    score: number;
+    passed: boolean;
+    reason?: string;
+    suggestion?: string;
+}
+export interface EvaluationOutcome {
+    sessionId: string;
+    type: EvaluationType;
+    screenName: string;
+    overallPassed: boolean;
+    averageScore: number;
+    results: EvaluationResult[];
+    failedItems: string[];
+    timestamp: string;
+    attemptNumber: number;
+}
+export interface LogEntry extends EvaluationOutcome {
+    checklist: ChecklistItem[];
+    scores: ScoreEntry[];
+}
+export interface LogSummary {
+    totalEvaluations: number;
+    passedCount: number;
+    failedCount: number;
+    screens: Record<string, {
+        attempts: number;
+        finalPassed: boolean;
+        finalScore: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAIhD,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,QAAS,SAAQ,iBAAiB;IAC/C,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,MAAM,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CACX,MAAM,EACN;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CACjE,CAAC;CACL"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core type definitions for ui-critic-mcp
+ */
+export {};
+//# sourceMappingURL=types.js.map