@kln-mcp/ctrl-mobile-cn 0.0.6

package/wrapper/index.d.ts

@@ -0,0 +1,107 @@
+import type { JsAgentMessage } from '../core';
+
+export interface KlnWrapperOptions {
+  ticket?: string;
+  apiKey?: string;
+  api_key?: string;
+  apiUrl?: string;
+  api_url?: string;
+  deviceId?: string;
+  device_id?: string;
+  deviceCachePath?: string;
+  device_cache_path?: string;
+  reconnectWindowMs?: number;
+  reconnect_window_ms?: number;
+  relayUrls?: string[];
+  relay_urls?: string[];
+  alpn?: string;
+  timeoutMs?: number;
+  timeout_ms?: number;
+  trace_id?: string;
+  outputDir?: string;
+  output_dir?: string;
+  taskMemoryPath?: string;
+  task_memory_path?: string;
+  host?: string;
+  port?: number;
+  env?: string;
+}
+
+export interface NormalizedAgentMessage extends JsAgentMessage {
+  ok?: boolean;
+  text?: string;
+  media?: unknown;
+}
+
+export interface ToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: Record<string, unknown>;
+}
+
+export declare const TOOL_DEFINITIONS: ToolDefinition[];
+
+export declare class KlnMobileController {
+  constructor(options?: KlnWrapperOptions);
+  connect(options?: KlnWrapperOptions): Promise<unknown>;
+  setApiKey(apiKey: string, options?: KlnWrapperOptions & { validate?: boolean }): Promise<unknown>;
+  listServerDevices(options?: KlnWrapperOptions): Promise<KlnServerDevice[]>;
+  selectDevice(deviceId: string, options?: KlnWrapperOptions): Promise<unknown>;
+  sendCommand(name: string, text?: string | null, options?: KlnWrapperOptions): Promise<NormalizedAgentMessage>;
+  sendText(text: string, options?: KlnWrapperOptions): Promise<NormalizedAgentMessage>;
+  sendOnlyCommand(name: string, text?: string | null, options?: KlnWrapperOptions): Promise<string>;
+  sendJsonRpc(method: string, params?: Record<string, unknown>, options?: KlnWrapperOptions): Promise<unknown>;
+  getDeviceContext(options?: KlnWrapperOptions): Promise<unknown>;
+  inputTap(x: number, y: number, options?: KlnWrapperOptions & { profile?: string }): Promise<unknown>;
+  inputSwipe(args: KlnWrapperOptions & { startX: number; startY: number; endX: number; endY: number; durationMs?: number; profile?: string }): Promise<unknown>;
+  inputText(text: string, options?: KlnWrapperOptions & { replace?: boolean }): Promise<unknown>;
+  inputClear(options?: KlnWrapperOptions): Promise<unknown>;
+  inputKey(key: string, options?: KlnWrapperOptions): Promise<unknown>;
+  globalAction(action: string, options?: KlnWrapperOptions): Promise<unknown>;
+  appStart(packageName: string, options?: KlnWrapperOptions & { activity?: string }): Promise<unknown>;
+  appStop(packageName: string, options?: KlnWrapperOptions): Promise<unknown>;
+  listLaunchableApps(options?: KlnWrapperOptions & { includeSystem?: boolean }): Promise<NormalizedAgentMessage>;
+  taskMemory(args?: KlnTaskMemoryArgs): KlnTaskMemoryResult;
+  startScreenStream(text?: string | null, options?: KlnWrapperOptions): Promise<string>;
+  startLiveView(text?: string | null, options?: KlnWrapperOptions): Promise<H264LiveViewServer>;
+  callTool(name: string, args?: Record<string, unknown>): Promise<unknown>;
+  close(): Promise<void>;
+}
+
+export interface KlnServerDevice {
+  deviceId: string;
+  deviceInfo: unknown;
+  deviceRemark: unknown;
+  ticket: string;
+  lastHeartbeatAt: number;
+  status: unknown;
+}
+
+export declare class H264LiveViewServer {
+  readonly url: string;
+  start(): Promise<void>;
+  close(): Promise<void>;
+  wait(): Promise<void>;
+}
+
+export declare class KlnMcpServer {
+  constructor(options?: KlnWrapperOptions & { controller?: KlnMobileController; name?: string; version?: string });
+  handleRequest(request: Record<string, unknown>): Promise<Record<string, unknown> | null>;
+  listenStdio(input?: NodeJS.ReadableStream, output?: NodeJS.WritableStream): Promise<void>;
+}
+
+export declare function createController(options?: KlnWrapperOptions): KlnMobileController;
+export declare function createMcpServer(options?: KlnWrapperOptions): KlnMcpServer;
+export declare function normalizeMessage(message: JsAgentMessage): NormalizedAgentMessage;
+export declare function taskMemoryOperation(args?: KlnTaskMemoryArgs & { path?: string }): KlnTaskMemoryResult;
+export declare function checkTaskMemoryFile(memoryPath?: string): { ok: boolean; path: string; readable: boolean; writable: boolean };
+
+export interface KlnTaskMemoryArgs {
+  op?: 'list' | 'get' | 'put' | 'delete' | string;
+  key?: string;
+  value?: string;
+  summary?: string;
+  progress?: string;
+}
+
+export type KlnTaskMemoryResult = Record<string, unknown>;