@zhihand/mcp 0.26.2 → 0.26.4

package/bin/zhihand

@@ -291,6 +291,7 @@ switch (command) {
     const { createControlCommand, enqueueCommand } = await import("../dist/core/command.js");
     const { waitForCommandAck } = await import("../dist/core/sse.js");
     const { fetchScreenshotBinary } = await import("../dist/core/screenshot.js");
+    const { fetchDeviceProfile, getStaticContext, isDeviceProfileLoaded, formatDeviceStatus } = await import("../dist/core/device.js");
 
     let testConfig;
     try {
@@ -305,68 +306,152 @@ switch (command) {
     console.log(`   Device: ${testConfig.credentialId}`);
     console.log(`   Endpoint: ${testConfig.controlPlaneEndpoint}\n`);
 
-    const steps = [
-      { label: "1. Screenshot", type: "screenshot" },
-      { label: "2. Click center", type: "hid", params: { action: "click", xRatio: 0.5, yRatio: 0.5 } },
-      { label: "3. Swipe up", type: "hid", params: { action: "swipe", startXRatio: 0.5, startYRatio: 0.7, endXRatio: 0.5, endYRatio: 0.3, durationMs: 300 } },
-      { label: "4. Swipe down", type: "hid", params: { action: "swipe", startXRatio: 0.5, startYRatio: 0.3, endXRatio: 0.5, endYRatio: 0.7, durationMs: 300 } },
-      { label: "5. Press Home", type: "hid", params: { action: "home" } },
-      { label: "6. Open WeChat", type: "hid", params: { action: "open_app", appPackage: "com.tencent.mm" } },
-      { label: "7. Press Back", type: "hid", params: { action: "back" } },
-      { label: "8. Screenshot", type: "screenshot" },
-    ];
-
     let passed = 0;
     let failed = 0;
+    let totalSteps = 0;
 
-    for (const step of steps) {
-      process.stdout.write(`   ${step.label}... `);
+    // ── Helper: run a single HID step ──
+    async function runHidStep(label, params) {
+      totalSteps++;
+      process.stdout.write(`   ${label}... `);
       const t0 = Date.now();
       try {
-        if (step.type === "screenshot") {
-          // Screenshot: send receive_screenshot command, then fetch binary
-          const cmd = createControlCommand({ action: "screenshot" });
-          const queued = await enqueueCommand(testConfig, cmd);
-          const ack = await waitForCommandAck(testConfig, { commandId: queued.id, timeoutMs: 10_000 });
-          if (ack.acked) {
-            const buf = await fetchScreenshotBinary(testConfig);
-            const ms = Date.now() - t0;
-            console.log(`✅ ${(buf.length / 1024).toFixed(0)}KB (${ms}ms)`);
-            passed++;
-          } else {
-            console.log(`⏱️  Timeout (${Date.now() - t0}ms)`);
-            failed++;
-          }
+        const cmd = createControlCommand(params);
+        const queued = await enqueueCommand(testConfig, cmd);
+        const ack = await waitForCommandAck(testConfig, { commandId: queued.id, timeoutMs: 10_000 });
+        const ms = Date.now() - t0;
+        if (ack.acked) {
+          const ackStatus = ack.command?.ack_status ?? "ok";
+          const detail = ackStatus !== "ok" ? ` [${ackStatus}]` : "";
+          const resultInfo = ack.command?.ack_result ? ` ${JSON.stringify(ack.command.ack_result)}` : "";
+          console.log(`✅ (${ms}ms)${detail}${resultInfo}`);
+          passed++;
+          return ack;
         } else {
-          const cmd = createControlCommand(step.params);
-          const queued = await enqueueCommand(testConfig, cmd);
-          const ack = await waitForCommandAck(testConfig, { commandId: queued.id, timeoutMs: 10_000 });
+          console.log(`⏱️  Timeout (${ms}ms)`);
+          failed++;
+          return null;
+        }
+      } catch (err) {
+        console.log(`❌ ${err.message} (${Date.now() - t0}ms)`);
+        failed++;
+        return null;
+      }
+    }
+
+    // ── Helper: run a screenshot step ──
+    async function runScreenshotStep(label) {
+      totalSteps++;
+      process.stdout.write(`   ${label}... `);
+      const t0 = Date.now();
+      try {
+        const cmd = createControlCommand({ action: "screenshot" });
+        const queued = await enqueueCommand(testConfig, cmd);
+        const ack = await waitForCommandAck(testConfig, { commandId: queued.id, timeoutMs: 10_000 });
+        if (ack.acked) {
+          const buf = await fetchScreenshotBinary(testConfig);
           const ms = Date.now() - t0;
-          if (ack.acked) {
-            const ackStatus = ack.command?.ack_status ?? "ok";
-            const detail = ackStatus !== "ok" ? ` [${ackStatus}]` : "";
-            const resultInfo = ack.command?.ack_result ? ` ${JSON.stringify(ack.command.ack_result)}` : "";
-            console.log(`✅ (${ms}ms)${detail}${resultInfo}`);
-            passed++;
-          } else {
-            console.log(`⏱️  Timeout (${ms}ms)`);
-            failed++;
-          }
+          console.log(`✅ ${(buf.length / 1024).toFixed(0)}KB (${ms}ms)`);
+          passed++;
+        } else {
+          console.log(`⏱️  Timeout (${Date.now() - t0}ms)`);
+          failed++;
         }
       } catch (err) {
+        console.log(`❌ ${err.message} (${Date.now() - t0}ms)`);
+        failed++;
+      }
+    }
+
+    const pause = () => new Promise((r) => setTimeout(r, 1500));
+
+    // ── Phase 1: Device Profile ──────────────────────────────
+    console.log("   ── Phase 1: Device Info ──");
+    totalSteps++;
+    process.stdout.write("   1. Fetch device profile... ");
+    {
+      const t0 = Date.now();
+      try {
+        await fetchDeviceProfile(testConfig);
         const ms = Date.now() - t0;
-        console.log(`❌ ${err.message} (${ms}ms)`);
+        if (isDeviceProfileLoaded()) {
+          const s = getStaticContext();
+          console.log(`✅ ${s.platform} ${s.model}, ${s.osVersion}, ${s.screenWidthPx}x${s.screenHeightPx} (${ms}ms)`);
+          passed++;
+        } else {
+          console.log(`⚠️  Loaded but empty (${ms}ms)`);
+          failed++;
+        }
+      } catch (err) {
+        console.log(`❌ ${err.message} (${Date.now() - t0}ms)`);
+        failed++;
+      }
+    }
+
+    totalSteps++;
+    process.stdout.write("   2. Device status fields... ");
+    {
+      try {
+        const status = formatDeviceStatus();
+        const ignoredDefaults = new Set(["unknown", "0x0", "-1% (unknown)", "0"]);
+        const fields = Object.keys(status).filter((k) => {
+          const v = status[k];
+          if (v === null || v === undefined) return false;
+          if (ignoredDefaults.has(String(v))) return false;
+          return true;
+        });
+        console.log(`✅ ${fields.length} fields (${fields.join(", ")})`);
+        passed++;
+      } catch (err) {
+        console.log(`❌ ${err.message}`);
         failed++;
       }
-      // Pause between commands: let phone process + user can observe
-      await new Promise((r) => setTimeout(r, 2000));
     }
 
-    console.log(`\n   Result: ${passed}/${steps.length} passed`);
+    await pause();
+
+    // ── Phase 2: Screenshot + Basic HID ──────────────────────
+    console.log("   ── Phase 2: Screenshot + HID ──");
+    await runScreenshotStep("3. Screenshot");
+    await pause();
+    await runHidStep("4. Click center", { action: "click", xRatio: 0.5, yRatio: 0.5 });
+    await pause();
+    await runHidStep("5. Swipe up", { action: "swipe", startXRatio: 0.5, startYRatio: 0.7, endXRatio: 0.5, endYRatio: 0.3, durationMs: 300 });
+    await pause();
+    await runHidStep("6. Swipe down", { action: "swipe", startXRatio: 0.5, startYRatio: 0.3, endXRatio: 0.5, endYRatio: 0.7, durationMs: 300 });
+    await pause();
+    await runHidStep("7. Scroll down", { action: "scroll", xRatio: 0.5, yRatio: 0.5, direction: "down", amount: 3 });
+    await pause();
+    await runHidStep("8. Scroll up", { action: "scroll", xRatio: 0.5, yRatio: 0.5, direction: "up", amount: 3 });
+    await pause();
+
+    // ── Phase 3: App + Navigation ────────────────────────────
+    console.log("   ── Phase 3: App + Navigation ──");
+    await runHidStep("9. Press Home", { action: "home" });
+    await pause();
+    {
+      const platform = isDeviceProfileLoaded() ? getStaticContext().platform : "android";
+      const openParams = platform === "ios"
+        ? { action: "open_app", bundleId: "com.tencent.xin" }
+        : { action: "open_app", appPackage: "com.tencent.mm" };
+      await runHidStep(`10. Open WeChat (${platform})`, openParams);
+    }
+    await pause();
+    await runHidStep("11. Press Back", { action: "back" });
+    await pause();
+
+    // ── Phase 4: Clipboard Set ─────────────────────────────
+    // Note: App only supports clipboard set, not get
+    console.log("   ── Phase 4: Clipboard ──");
+    const clipboardTestText = `zhihand_test_${Date.now()}`;
+    await runHidStep("12. Clipboard set", { action: "clipboard", text: clipboardTestText });
+
+    // ── Summary ──────────────────────────────────────────────
+    console.log(`\n   Result: ${passed}/${totalSteps} passed`);
     if (failed === 0) {
-      console.log("   ✅ Device is responding to all commands!");
+      console.log("   ✅ All tests passed! Device is fully responsive.");
     } else {
-      console.log("   ⚠️  Some commands failed. Check phone connectivity.");
+      console.log(`   ⚠️  ${failed} test(s) failed. Check phone connectivity.`);
     }
     process.exit(failed > 0 ? 1 : 0);
   }

package/dist/core/command.d.ts

@@ -1,6 +1,5 @@
 import type { ZhiHandConfig } from "./config.ts";
 export type ScrollDirection = "up" | "down" | "left" | "right";
-export type ClipboardAction = "get" | "set";
 export interface ControlParams {
     action: string;
     xRatio?: number;
@@ -9,7 +8,6 @@ export interface ControlParams {
     direction?: ScrollDirection;
     amount?: number;
     keys?: string;
-    clipboardAction?: ClipboardAction;
     durationMs?: number;
     startXRatio?: number;
     startYRatio?: number;

package/dist/core/command.js

@@ -49,9 +49,11 @@ export function createControlCommand(params) {
         case "enter":
             return { type: "receive_enter", payload: {} };
         case "clipboard":
+            // App only supports set — payload: { clipboard: "text" }
+            // No get support on device side; clipboardAction is ignored
             return {
                 type: "receive_clipboard",
-                payload: { action: params.clipboardAction, text: params.text },
+                payload: { clipboard: params.text ?? "" },
             };
         case "open_app": {
             const appPayload = {};

package/dist/daemon/dispatcher.js

@@ -397,7 +397,7 @@ Control the phone. Requires "action" parameter. All coordinates use normalized r
 - home: Press Home button (no params)
 - enter: Press Enter key (no params)
 ${openAppDoc}
-- clipboard: Read/write clipboard. Params: clipboardAction ("get"/"set"), text
+- clipboard: Set clipboard text. Params: text (the content to copy)
 - screenshot: Capture screen via control (same as zhihand_screenshot)
 - wait: Wait before next action. Params: durationMs (default 1000)
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare const PACKAGE_VERSION = "0.26.2";
+export declare const PACKAGE_VERSION = "0.26.4";
 export declare function createServer(deviceName?: string): McpServer;
 export declare function startStdioServer(deviceName?: string): Promise<void>;

package/dist/index.js

@@ -6,7 +6,7 @@ import { executeControl } from "./tools/control.js";
 import { handleScreenshot } from "./tools/screenshot.js";
 import { handlePair } from "./tools/pair.js";
 import { getStaticContext, getDynamicContext, fetchDeviceProfile, buildControlToolDescription, buildScreenshotToolDescription, formatDeviceStatus, } from "./core/device.js";
-export const PACKAGE_VERSION = "0.26.2";
+export const PACKAGE_VERSION = "0.26.4";
 export function createServer(deviceName) {
     const server = new McpServer({
         name: "zhihand",

package/dist/tools/schemas.d.ts

@@ -7,7 +7,6 @@ export declare const controlSchema: {
     direction: z.ZodOptional<z.ZodEnum<["up", "down", "left", "right"]>>;
     amount: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
     keys: z.ZodOptional<z.ZodString>;
-    clipboardAction: z.ZodOptional<z.ZodEnum<["get", "set"]>>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     startXRatio: z.ZodOptional<z.ZodNumber>;
     startYRatio: z.ZodOptional<z.ZodNumber>;

package/dist/tools/schemas.js

@@ -13,7 +13,7 @@ export const controlSchema = {
     direction: z.enum(["up", "down", "left", "right"]).optional().describe("Scroll direction"),
     amount: z.number().int().positive().default(3).optional().describe("Scroll steps (default 3)"),
     keys: z.string().optional().describe("Key combo string, e.g. 'ctrl+c', 'alt+tab'"),
-    clipboardAction: z.enum(["get", "set"]).optional().describe("Clipboard action"),
+    // clipboardAction removed — app only supports set (text via "text" param)
     durationMs: z.number().int().positive().max(10000).optional().describe("Duration in ms: wait (default 1000), longclick (default 800), swipe (default 300). Max 10000"),
     startXRatio: z.number().min(0).max(1).optional().describe("Swipe start X [0,1]"),
     startYRatio: z.number().min(0).max(1).optional().describe("Swipe start Y [0,1]"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhihand/mcp",
-  "version": "0.26.2",
+  "version": "0.26.4",
   "private": false,
   "type": "module",
   "description": "ZhiHand MCP Server — phone control tools for Claude Code, Codex, Gemini CLI, and OpenClaw",