@zhihand/mcp 0.26.0 → 0.26.2

package/dist/core/command.d.ts

@@ -18,7 +18,6 @@ export interface ControlParams {
     appPackage?: string;
     bundleId?: string;
     urlScheme?: string;
-    appName?: string;
 }
 export interface QueuedControlCommand {
     type: string;

package/dist/core/command.js

@@ -1,3 +1,4 @@
+import { getStaticContext, isDeviceProfileLoaded } from "./device.js";
 import { dbg } from "../daemon/logger.js";
 let messageCounter = 0;
 function nextMessageId() {
@@ -54,17 +55,34 @@ export function createControlCommand(params) {
             };
         case "open_app": {
             const appPayload = {};
-            if (params.appPackage)
-                appPayload.app_package = params.appPackage;
-            if (params.bundleId)
-                appPayload.bundle_id = params.bundleId;
-            if (params.urlScheme)
-                appPayload.url_scheme = params.urlScheme;
-            if (params.appName)
-                appPayload.app_name = params.appName;
+            const platform = isDeviceProfileLoaded() ? getStaticContext().platform : "unknown";
+            // Only send platform-appropriate fields — Android strict JSON rejects unknown keys
+            if (platform === "android") {
+                // Android: only app_package
+                if (params.appPackage)
+                    appPayload.app_package = params.appPackage;
+            }
+            else if (platform === "ios") {
+                // iOS: bundleId or urlScheme
+                if (params.bundleId)
+                    appPayload.bundle_id = params.bundleId;
+                if (params.urlScheme)
+                    appPayload.url_scheme = params.urlScheme;
+            }
+            else {
+                // Unknown platform: send only what's provided, prefer appPackage
+                if (params.appPackage)
+                    appPayload.app_package = params.appPackage;
+                else if (params.bundleId)
+                    appPayload.bundle_id = params.bundleId;
+                else if (params.urlScheme)
+                    appPayload.url_scheme = params.urlScheme;
+            }
+            // Never send app_name — phone strict JSON parser rejects unknown keys
             if (!appPayload.app_package && !appPayload.bundle_id && !appPayload.url_scheme) {
                 throw new Error("open_app requires at least one of: appPackage, bundleId, urlScheme");
             }
+            dbg(`[cmd] open_app: platform=${platform}, payload=${JSON.stringify(appPayload)}`);
             return { type: "receive_app", payload: appPayload };
         }
         case "screenshot":

package/dist/core/device.d.ts

@@ -40,7 +40,7 @@ export declare function getDynamicContext(): DynamicContext;
 export declare function isDeviceProfileLoaded(): boolean;
 export declare function extractStatic(profile: Record<string, unknown>): StaticContext;
 export declare function extractDynamic(profile: Record<string, unknown>): DynamicContext;
-export declare function updateDeviceProfile(profile: Record<string, unknown>): void;
+export declare function updateDeviceProfile(raw: Record<string, unknown>): void;
 export declare function fetchDeviceProfile(config: ZhiHandConfig): Promise<void>;
 export declare function buildControlToolDescription(): string;
 export declare function buildScreenshotToolDescription(): string;

package/dist/core/device.js

@@ -57,16 +57,37 @@ function bool(v, fallback) {
     return typeof v === "boolean" ? v : fallback;
 }
 export function extractStatic(profile) {
+    // Build OS version string from platform + system_release + api_level
+    const platform = str(profile.platform, DEFAULT_STATIC.platform);
+    const sysRelease = str(profile.system_release, "");
+    const apiLevel = typeof profile.api_level === "number" ? profile.api_level : null;
+    let osVersion;
+    if (platform === "android" && sysRelease && apiLevel) {
+        osVersion = `Android ${sysRelease} (API ${apiLevel})`;
+    }
+    else if (platform === "ios" && sysRelease) {
+        osVersion = `iOS ${sysRelease}`;
+    }
+    else {
+        osVersion = sysRelease || DEFAULT_STATIC.osVersion;
+    }
+    // Screen size: Android uses display_width_px/display_height_px, iOS uses display_width_pixels/display_height_pixels
+    const screenW = num(profile.display_width_px, num(profile.display_width_pixels, DEFAULT_STATIC.screenWidthPx));
+    const screenH = num(profile.display_height_px, num(profile.display_height_pixels, DEFAULT_STATIC.screenHeightPx));
+    // Density: Android uses density, iOS uses display_scale
+    const density = num(profile.density, num(profile.display_scale, DEFAULT_STATIC.density));
+    // Text direction: rtl is boolean
+    const textDirection = profile.rtl === true ? "rtl" : "ltr";
     return {
-        platform: str(profile.platform, DEFAULT_STATIC.platform),
+        platform,
         model: str(profile.model, DEFAULT_STATIC.model),
-        osVersion: str(profile.os_version, DEFAULT_STATIC.osVersion),
-        screenWidthPx: num(profile.screen_width_px, DEFAULT_STATIC.screenWidthPx),
-        screenHeightPx: num(profile.screen_height_px, DEFAULT_STATIC.screenHeightPx),
-        density: num(profile.density, DEFAULT_STATIC.density),
+        osVersion,
+        screenWidthPx: screenW,
+        screenHeightPx: screenH,
+        density,
         formFactor: str(profile.form_factor, DEFAULT_STATIC.formFactor),
         locale: str(profile.locale, DEFAULT_STATIC.locale),
-        textDirection: str(profile.text_direction, DEFAULT_STATIC.textDirection),
+        textDirection,
         timezone: str(profile.timezone, DEFAULT_STATIC.timezone),
         navigationMode: typeof profile.navigation_mode === "string" ? profile.navigation_mode : undefined,
         romFamily: typeof profile.rom_family === "string" ? profile.rom_family : undefined,
@@ -88,7 +109,16 @@ export function extractDynamic(profile) {
     };
 }
 // ── Update from SSE event ─────────────────────────────────
-export function updateDeviceProfile(profile) {
+export function updateDeviceProfile(raw) {
+    // SSE events may also wrap in { platform, attributes: {...} } — flatten if needed
+    let profile;
+    if (typeof raw.attributes === "object" && raw.attributes !== null) {
+        const attrs = raw.attributes;
+        profile = { ...attrs, platform: raw.platform ?? attrs.platform };
+    }
+    else {
+        profile = raw;
+    }
     staticCtx = extractStatic(profile);
     dynamicCtx = extractDynamic(profile);
     loaded = true;
@@ -108,10 +138,16 @@ export async function fetchDeviceProfile(config) {
             return;
         }
         const data = await response.json();
-        // API may wrap in { device_profile: {...} } or return flat
-        const profile = (typeof data.device_profile === "object" && data.device_profile !== null)
-            ? data.device_profile
+        // API returns { profile: { credential_id, platform, attributes: {...} } }
+        const wrapper = (typeof data.profile === "object" && data.profile !== null)
+            ? data.profile
             : data;
+        // Merge top-level fields (platform, edge_id) with attributes for flat extraction
+        const attrs = (typeof wrapper.attributes === "object" && wrapper.attributes !== null)
+            ? wrapper.attributes
+            : {};
+        const profile = { ...attrs, platform: wrapper.platform ?? attrs.platform };
+        dbg(`[device] Raw profile keys: ${Object.keys(profile).join(", ")}`);
         updateDeviceProfile(profile);
     }
     catch (err) {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare const PACKAGE_VERSION = "0.26.0";
+export declare const PACKAGE_VERSION = "0.26.2";
 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.0";
+export const PACKAGE_VERSION = "0.26.2";
 export function createServer(deviceName) {
     const server = new McpServer({
         name: "zhihand",

package/dist/tools/schemas.d.ts

@@ -16,7 +16,6 @@ export declare const controlSchema: {
     appPackage: z.ZodOptional<z.ZodString>;
     bundleId: z.ZodOptional<z.ZodString>;
     urlScheme: z.ZodOptional<z.ZodString>;
-    appName: z.ZodOptional<z.ZodString>;
 };
 export declare const screenshotSchema: {};
 export declare const pairSchema: {

package/dist/tools/schemas.js

@@ -22,7 +22,6 @@ export const controlSchema = {
     appPackage: z.string().optional().describe("Android package name, e.g. 'com.tencent.mm'"),
     bundleId: z.string().optional().describe("iOS bundle ID, e.g. 'com.tencent.xin'"),
     urlScheme: z.string().optional().describe("URL scheme, e.g. 'weixin://'"),
-    appName: z.string().optional().describe("Human-readable app name (for logging)"),
 };
 export const screenshotSchema = {};
 export const pairSchema = {

package/package.json

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