@maaxyz/maa-node 4.4.0 → 4.5.0-alpha.1

package/dist/context.d.ts

@@ -5,7 +5,7 @@ export declare class Context {
     #private;
     handle: maa.ContextHandle;
     constructor(handle: maa.ContextHandle);
-    run_task(entry: string, pipeline_override?: Record<string, unknown>): Promise<{
+    run_task(entry: string, pipeline_override?: Record<string, unknown> | Record<string, unknown>[]): Promise<{
         entry: string;
         nodes: ({
             name: string;
@@ -22,7 +22,7 @@ export declare class Context {
         } | null)[];
         status: maa.Status;
     } | null>;
-    run_recognition(entry: string, image: ArrayBuffer | Buffer, pipeline_override?: Record<string, unknown>): Promise<{
+    run_recognition(entry: string, image: ArrayBuffer | Buffer, pipeline_override?: Record<string, unknown> | Record<string, unknown>[]): Promise<{
         name: string;
         algorithm: string;
         hit: boolean;
@@ -31,7 +31,7 @@ export declare class Context {
         raw: ArrayBuffer;
         draws: ArrayBuffer[];
     } | null>;
-    run_action(entry: string, box: maa.Rect, reco_detail: string, pipeline_override?: Record<string, unknown>): Promise<{
+    run_action(entry: string, box: maa.Rect, reco_detail: string, pipeline_override?: Record<string, unknown> | Record<string, unknown>[]): Promise<{
         name: string;
         reco: {
             name: string;
@@ -44,7 +44,7 @@ export declare class Context {
         } | null;
         completed: boolean;
     } | null>;
-    override_pipeline(pipeline_override: Record<string, unknown>): void;
+    override_pipeline(pipeline_override: Record<string, unknown> | Record<string, unknown>[]): void;
     override_next(node_name: string, next: string[]): void;
     get_node_data(node_name: string): string | null;
     get_node_data_parsed(node_name: string): DumpTask | null;

package/dist/controller.d.ts

@@ -17,7 +17,7 @@ declare class ImageJob extends Job<maa.CtrlId, JobSource<maa.CtrlId>> {
 }
 export type ControllerNotify = {
     msg: 'Action.Starting' | 'Action.Succeeded' | 'Action.Failed';
-    action: 'connect' | 'click' | 'swipe' | 'touch_down' | 'touch_move' | 'touch_up' | 'press_key' | 'input_text' | 'screencap' | 'start_app' | 'stop_app';
+    action: 'connect' | 'click' | 'swipe' | 'touch_down' | 'touch_move' | 'touch_up' | 'click_key' | 'input_text' | 'screencap' | 'start_app' | 'stop_app' | 'key_down' | 'key_up';
     ctrl_id: maa.CtrlId;
     uuid: string;
 };
@@ -32,11 +32,12 @@ export declare class ControllerBase {
     set screenshot_target_long_side(value: number);
     set screenshot_target_short_side(value: number);
     set screenshot_use_raw_size(value: boolean);
-    set recording(value: boolean);
     post_connection(): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
     post_click(x: number, y: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
     post_swipe(x1: number, y1: number, x2: number, y2: number, duration: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
-    post_press_key(keycode: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
+    post_click_key(keycode: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
+    post_key_down(keycode: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
+    post_key_up(keycode: number): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
     post_input_text(text: string): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
     post_start_app(intent: string): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
     post_stop_app(intent: string): Job<maa.CtrlId, JobSource<maa.CtrlId>>;
@@ -71,8 +72,10 @@ export declare abstract class CustomControllerActor {
     abstract touch_down(contact: number, x: number, y: number, pressure: number): maa.MaybePromise<boolean>;
     abstract touch_move(contact: number, x: number, y: number, pressure: number): maa.MaybePromise<boolean>;
     abstract touch_up(contact: number): maa.MaybePromise<boolean>;
-    abstract press_key(keycode: number): maa.MaybePromise<boolean>;
+    abstract click_key(keycode: number): maa.MaybePromise<boolean>;
     abstract input_text(text: string): maa.MaybePromise<boolean>;
+    abstract key_down(keycode: number): maa.MaybePromise<boolean>;
+    abstract key_up(keycode: number): maa.MaybePromise<boolean>;
 }
 export declare class CustomControllerActorDefaultImpl extends CustomControllerActor {
     connect(): maa.MaybePromise<boolean>;
@@ -85,8 +88,10 @@ export declare class CustomControllerActorDefaultImpl extends CustomControllerAc
     touch_down(contact: number, x: number, y: number, pressure: number): maa.MaybePromise<boolean>;
     touch_move(contact: number, x: number, y: number, pressure: number): maa.MaybePromise<boolean>;
     touch_up(contact: number): maa.MaybePromise<boolean>;
-    press_key(keycode: number): maa.MaybePromise<boolean>;
+    click_key(keycode: number): maa.MaybePromise<boolean>;
     input_text(text: string): maa.MaybePromise<boolean>;
+    key_down(keycode: number): maa.MaybePromise<boolean>;
+    key_up(keycode: number): maa.MaybePromise<boolean>;
 }
 export declare class CustomController extends ControllerBase {
     constructor(actor: CustomControllerActor);

package/dist/global.d.ts

@@ -3,9 +3,7 @@ export declare const Global: {
     readonly version: string;
     log_dir: string;
     save_draw: boolean;
-    recording: boolean;
     stdout_level: keyof typeof maa.LoggingLevel;
-    show_hit_draw: boolean;
     debug_mode: boolean;
     config_init_option(user_path: string, default_json?: string): void;
 };

package/dist/index-client.d.ts

@@ -1,5 +1,6 @@
 import './maa-client.js';
 export * as api from './maa';
+export * from './job';
 export * from './controller';
 export * from './resource';
 export * from './tasker';

package/dist/index-client.js

@@ -83,9 +83,11 @@ __export(index_client_exports, {
   CustomControllerActorDefaultImpl: () => CustomControllerActorDefaultImpl,
   DbgController: () => DbgController,
   Global: () => Global,
+  Job: () => Job,
   Pi: () => Pi,
   Resource: () => Resource,
   ResourceBase: () => ResourceBase,
+  TaskJob: () => TaskJob,
   Tasker: () => Tasker,
   TaskerBase: () => TaskerBase,
   Win32Controller: () => Win32Controller,
@@ -95,9 +97,6 @@ module.exports = __toCommonJS(index_client_exports);
 var import_maa_client = __toESM(require_maa_client());
 var api = __toESM(require_maa());
 
-// src/controller.ts
-var import_path = __toESM(require("path"));
-
 // src/job.ts
 var maa = __toESM(require_maa());
 var Job = class {
@@ -149,6 +148,7 @@ var Job = class {
 };
 
 // src/controller.ts
+var import_path = __toESM(require("path"));
 var import_maa = __toESM(require_maa());
 
 // src/utils.ts
@@ -251,11 +251,6 @@ var ControllerBase = class {
       throw "Controller set screenshot_use_raw_size failed";
     }
   }
-  set recording(value) {
-    if (!import_maa.default.controller_set_option_recording(this.handle, value)) {
-      throw "Controller set recording failed";
-    }
-  }
   post_connection() {
     return new Job(this.#source, import_maa.default.controller_post_connection(this.handle));
   }
@@ -268,8 +263,14 @@ var ControllerBase = class {
       import_maa.default.controller_post_swipe(this.handle, x1, y1, x2, y2, duration)
     );
   }
-  post_press_key(keycode) {
-    return new Job(this.#source, import_maa.default.controller_post_press_key(this.handle, keycode));
+  post_click_key(keycode) {
+    return new Job(this.#source, import_maa.default.controller_post_click_key(this.handle, keycode));
+  }
+  post_key_down(keycode) {
+    return new Job(this.#source, import_maa.default.controller_post_key_down(this.handle, keycode));
+  }
+  post_key_up(keycode) {
+    return new Job(this.#source, import_maa.default.controller_post_key_up(this.handle, keycode));
   }
   post_input_text(text) {
     return new Job(this.#source, import_maa.default.controller_post_input_text(this.handle, text));
@@ -408,12 +409,18 @@ var CustomControllerActorDefaultImpl = class extends CustomControllerActor {
   touch_up(contact) {
     return false;
   }
-  press_key(keycode) {
+  click_key(keycode) {
     return false;
   }
   input_text(text) {
     return false;
   }
+  key_down(keycode) {
+    return false;
+  }
+  key_up(keycode) {
+    return false;
+  }
 };
 var CustomController = class extends ControllerBase {
   constructor(actor) {
@@ -772,8 +779,8 @@ var ResourceBase = class {
   post_bundle(path2) {
     return new Job(this.#source, import_maa3.default.resource_post_bundle(this.handle, path2));
   }
-  override_pipeline(pipeline_override) {
-    if (!import_maa3.default.resource_override_pipeline(this.handle, pipeline_override)) {
+  override_pipeline(pipeline_override = {}) {
+    if (!import_maa3.default.resource_override_pipeline(this.handle, JSON.stringify(pipeline_override))) {
       throw "Resource override_pipeline failed";
     }
   }
@@ -838,21 +845,11 @@ var Global = {
       throw "Global set save_draw failed";
     }
   },
-  set recording(value) {
-    if (!maa6.set_global_option_recording(value)) {
-      throw "Global set recording failed";
-    }
-  },
   set stdout_level(value) {
     if (!maa6.set_global_option_stdout_level(maa6.LoggingLevel[value])) {
       throw "Global set stdout_level failed";
     }
   },
-  set show_hit_draw(value) {
-    if (!maa6.set_global_option_show_hit_draw(value)) {
-      throw "Global set show_hit_draw failed";
-    }
-  },
   set debug_mode(value) {
     if (!maa6.set_global_option_debug_mode(value)) {
       throw "Global set debug_mode failed";
@@ -977,9 +974,11 @@ var AgentClient = class {
   CustomControllerActorDefaultImpl,
   DbgController,
   Global,
+  Job,
   Pi,
   Resource,
   ResourceBase,
+  TaskJob,
   Tasker,
   TaskerBase,
   Win32Controller,

package/dist/index-server.d.ts

@@ -1,5 +1,6 @@
 import './maa-server.js';
 export * as api from './maa';
+export * from './job';
 export * from './controller';
 export * from './resource';
 export * from './tasker';

package/dist/index-server.js

@@ -83,9 +83,11 @@ __export(index_server_exports, {
   CustomControllerActorDefaultImpl: () => CustomControllerActorDefaultImpl,
   DbgController: () => DbgController,
   Global: () => Global,
+  Job: () => Job,
   Pi: () => Pi,
   Resource: () => Resource,
   ResourceBase: () => ResourceBase,
+  TaskJob: () => TaskJob,
   Tasker: () => Tasker,
   TaskerBase: () => TaskerBase,
   Win32Controller: () => Win32Controller,
@@ -95,9 +97,6 @@ module.exports = __toCommonJS(index_server_exports);
 var import_maa_server = __toESM(require_maa_server());
 var api = __toESM(require_maa());
 
-// src/controller.ts
-var import_path = __toESM(require("path"));
-
 // src/job.ts
 var maa = __toESM(require_maa());
 var Job = class {
@@ -149,6 +148,7 @@ var Job = class {
 };
 
 // src/controller.ts
+var import_path = __toESM(require("path"));
 var import_maa = __toESM(require_maa());
 
 // src/utils.ts
@@ -251,11 +251,6 @@ var ControllerBase = class {
       throw "Controller set screenshot_use_raw_size failed";
     }
   }
-  set recording(value) {
-    if (!import_maa.default.controller_set_option_recording(this.handle, value)) {
-      throw "Controller set recording failed";
-    }
-  }
   post_connection() {
     return new Job(this.#source, import_maa.default.controller_post_connection(this.handle));
   }
@@ -268,8 +263,14 @@ var ControllerBase = class {
       import_maa.default.controller_post_swipe(this.handle, x1, y1, x2, y2, duration)
     );
   }
-  post_press_key(keycode) {
-    return new Job(this.#source, import_maa.default.controller_post_press_key(this.handle, keycode));
+  post_click_key(keycode) {
+    return new Job(this.#source, import_maa.default.controller_post_click_key(this.handle, keycode));
+  }
+  post_key_down(keycode) {
+    return new Job(this.#source, import_maa.default.controller_post_key_down(this.handle, keycode));
+  }
+  post_key_up(keycode) {
+    return new Job(this.#source, import_maa.default.controller_post_key_up(this.handle, keycode));
   }
   post_input_text(text) {
     return new Job(this.#source, import_maa.default.controller_post_input_text(this.handle, text));
@@ -408,12 +409,18 @@ var CustomControllerActorDefaultImpl = class extends CustomControllerActor {
   touch_up(contact) {
     return false;
   }
-  press_key(keycode) {
+  click_key(keycode) {
     return false;
   }
   input_text(text) {
     return false;
   }
+  key_down(keycode) {
+    return false;
+  }
+  key_up(keycode) {
+    return false;
+  }
 };
 var CustomController = class extends ControllerBase {
   constructor(actor) {
@@ -772,8 +779,8 @@ var ResourceBase = class {
   post_bundle(path2) {
     return new Job(this.#source, import_maa3.default.resource_post_bundle(this.handle, path2));
   }
-  override_pipeline(pipeline_override) {
-    if (!import_maa3.default.resource_override_pipeline(this.handle, pipeline_override)) {
+  override_pipeline(pipeline_override = {}) {
+    if (!import_maa3.default.resource_override_pipeline(this.handle, JSON.stringify(pipeline_override))) {
       throw "Resource override_pipeline failed";
     }
   }
@@ -838,21 +845,11 @@ var Global = {
       throw "Global set save_draw failed";
     }
   },
-  set recording(value) {
-    if (!maa6.set_global_option_recording(value)) {
-      throw "Global set recording failed";
-    }
-  },
   set stdout_level(value) {
     if (!maa6.set_global_option_stdout_level(maa6.LoggingLevel[value])) {
       throw "Global set stdout_level failed";
     }
   },
-  set show_hit_draw(value) {
-    if (!maa6.set_global_option_show_hit_draw(value)) {
-      throw "Global set show_hit_draw failed";
-    }
-  },
   set debug_mode(value) {
     if (!maa6.set_global_option_debug_mode(value)) {
       throw "Global set debug_mode failed";
@@ -985,9 +982,11 @@ var AgentServer = {
   CustomControllerActorDefaultImpl,
   DbgController,
   Global,
+  Job,
   Pi,
   Resource,
   ResourceBase,
+  TaskJob,
   Tasker,
   TaskerBase,
   Win32Controller,

package/dist/maa.d.ts

@@ -64,8 +64,10 @@ export type CustomControllerParamResultMap = {
     touch_down: [[contact: number, x: number, y: number, pressure: number], boolean]
     touch_move: [[contact: number, x: number, y: number, pressure: number], boolean]
     touch_up: [[contact: number], boolean]
-    press_key: [[keycode: number], boolean]
+    click_key: [[keycode: number], boolean]
     input_text: [[text: string], boolean]
+    key_down: [[keycode: number], boolean]
+    key_up: [[keycode: number], boolean]
 }
 export type CustomControllerCallback = (
     action: keyof CustomControllerParamResultMap,
@@ -150,10 +152,6 @@ export declare function controller_set_option_screenshot_use_raw_size(
     handle: ControllerHandle,
     value: boolean
 ): boolean
-export declare function controller_set_option_recording(
-    handle: ControllerHandle,
-    value: boolean
-): boolean
 export declare function controller_post_connection(handle: ControllerHandle): CtrlId
 export declare function controller_post_click(
     handle: ControllerHandle,
@@ -168,7 +166,9 @@ export declare function controller_post_swipe(
     y2: number,
     duration: number
 ): CtrlId
-export declare function controller_post_press_key(handle: ControllerHandle, keycode: number): CtrlId
+export declare function controller_post_click_key(handle: ControllerHandle, keycode: number): CtrlId
+export declare function controller_post_key_down(handle: ControllerHandle, keycode: number): CtrlId
+export declare function controller_post_key_up(handle: ControllerHandle, keycode: number): CtrlId
 export declare function controller_post_input_text(handle: ControllerHandle, text: string): CtrlId
 export declare function controller_post_start_app(handle: ControllerHandle, intent: string): CtrlId
 export declare function controller_post_stop_app(handle: ControllerHandle, intent: string): CtrlId
@@ -232,12 +232,12 @@ export declare function resource_post_bundle(handle: ResourceHandle, path: strin
 export declare function resource_override_pipeline(
     handle: ResourceHandle,
     pipeline_override: string
-): bool
+): boolean
 export declare function resource_override_next(
     handle: ResourceHandle,
     node_name: string,
     next_list: string[]
-): bool
+): boolean
 export declare function resource_get_node_data(
     handle: ResourceHandle,
     node_name: string
@@ -330,9 +330,7 @@ export declare function find_desktop(): Promise<
 export declare function version(): string
 export declare function set_global_option_log_dir(value: string): boolean
 export declare function set_global_option_save_draw(value: boolean): boolean
-export declare function set_global_option_recording(value: boolean): boolean
 export declare function set_global_option_stdout_level(value: LoggingLevel): boolean
-export declare function set_global_option_show_hit_draw(value: boolean): boolean
 export declare function set_global_option_debug_mode(value: boolean): boolean
 
 // pi.cpp

package/dist/pipeline.d.ts

@@ -136,9 +136,13 @@ export type ActionMultiSwipe<Mode> = RequiredIfStrict<{
         duration?: number;
     }[];
 }, 'swipes', Mode>;
-export type ActionKey<Mode> = RequiredIfStrict<{
+export type ActionClickKey<Mode> = RequiredIfStrict<{
     key?: MaybeArray<number, Mode>;
 }, 'key', Mode>;
+export type ActionLongPressKey<Mode> = RequiredIfStrict<{
+    key?: number;
+    duration?: number;
+}, 'key', Mode>;
 export type ActionInputText<Mode> = RequiredIfStrict<{
     input_text?: string;
 }, 'input_text', Mode>;
@@ -173,7 +177,7 @@ export type Action<Mode> = RemoveIfDump<{
         type?: never;
         param?: never;
     };
-}, Mode> | MixAct<'DoNothing', ActionDoNothing, Mode> | MixAct<'Click', ActionClick, Mode> | MixAct<'LongPress', ActionLongPress, Mode> | MixAct<'Swipe', ActionSwipe, Mode> | MixAct<'MultiSwipe', ActionMultiSwipe<Mode>, Mode> | MixAct<'Key', ActionKey<Mode>, Mode> | MixAct<'InputText', ActionInputText<Mode>, Mode> | MixAct<'StartApp', ActionStartApp<Mode>, Mode> | MixAct<'StopApp', ActionStopApp<Mode>, Mode> | MixAct<'StopTask', ActionStopTask, Mode> | MixAct<'Command', ActionCommand<Mode>, Mode> | MixAct<'Custom', ActionCustom<Mode>, Mode>;
+}, Mode> | MixAct<'DoNothing', ActionDoNothing, Mode> | MixAct<'Click', ActionClick, Mode> | MixAct<'LongPress', ActionLongPress, Mode> | MixAct<'Swipe', ActionSwipe, Mode> | MixAct<'MultiSwipe', ActionMultiSwipe<Mode>, Mode> | MixAct<'Key', ActionClickKey<Mode>, Mode> | MixAct<'ClickKey', ActionClickKey<Mode>, Mode> | MixAct<'LongPressKey', ActionLongPressKey<Mode>, Mode> | MixAct<'InputText', ActionInputText<Mode>, Mode> | MixAct<'StartApp', ActionStartApp<Mode>, Mode> | MixAct<'StopApp', ActionStopApp<Mode>, Mode> | MixAct<'StopTask', ActionStopTask, Mode> | MixAct<'Command', ActionCommand<Mode>, Mode> | MixAct<'Custom', ActionCustom<Mode>, Mode>;
 export type WaitFreeze = {
     time?: number;
     target?: true | NodeName | FlatRect;

package/dist/resource.d.ts

@@ -26,7 +26,7 @@ export declare class ResourceBase {
     unregister_custom_action(name: string): void;
     clear_custom_action(): void;
     post_bundle(path: string): Job<maa.ResId, JobSource<maa.ResId>>;
-    override_pipeline(pipeline_override: string): void;
+    override_pipeline(pipeline_override?: Record<string, unknown> | Record<string, unknown>[]): void;
     override_next(node_name: string, next_list: string[]): void;
     get_node_data(node_name: string): string | null;
     get_node_data_parsed(node_name: string): DumpTask | null;

package/dist/tasker.d.ts

@@ -19,7 +19,7 @@ export type RecoDetail = {
     filtered: RecoDetailEntry[];
     best: RecoDetailEntry | null;
 };
-declare class TaskJob extends Job<maa.TaskId, JobSource<maa.TaskId>> {
+export declare class TaskJob extends Job<maa.TaskId, JobSource<maa.TaskId>> {
     #private;
     constructor(tasker: TaskerBase, source: JobSource<maa.TaskId>, id: maa.TaskId);
     get(): {
@@ -82,7 +82,7 @@ export declare class TaskerBase {
     constructor(handle: maa.TaskerHandle);
     destroy(): void;
     bind(slave: ControllerBase | ResourceBase): void;
-    post_task(entry: string, param?: Record<string, unknown>): TaskJob;
+    post_task(entry: string, param?: Record<string, unknown> | Record<string, unknown>[]): TaskJob;
     get inited(): boolean;
     get running(): boolean;
     post_stop(): TaskJob;

package/package.json

@@ -25,13 +25,13 @@
         "prettier": "^3.5.2",
         "typescript": "^5.8.2"
     },
-    "version": "4.4.0",
+    "version": "4.5.0-alpha.1",
     "optionalDependencies": {
-        "@maaxyz/maa-node-darwin-arm64": "4.4.0",
-        "@maaxyz/maa-node-darwin-x64": "4.4.0",
-        "@maaxyz/maa-node-linux-arm64": "4.4.0",
-        "@maaxyz/maa-node-linux-x64": "4.4.0",
-        "@maaxyz/maa-node-win32-arm64": "4.4.0",
-        "@maaxyz/maa-node-win32-x64": "4.4.0"
+        "@maaxyz/maa-node-darwin-arm64": "4.5.0-alpha.1",
+        "@maaxyz/maa-node-darwin-x64": "4.5.0-alpha.1",
+        "@maaxyz/maa-node-linux-arm64": "4.5.0-alpha.1",
+        "@maaxyz/maa-node-linux-x64": "4.5.0-alpha.1",
+        "@maaxyz/maa-node-win32-arm64": "4.5.0-alpha.1",
+        "@maaxyz/maa-node-win32-x64": "4.5.0-alpha.1"
     }
 }

package/src/context.ts

@@ -11,7 +11,10 @@ export class Context {
         this.#tasker = new TaskerBase(maa.context_get_tasker(this.handle))
     }
 
-    async run_task(entry: string, pipeline_override: Record<string, unknown> = {}) {
+    async run_task(
+        entry: string,
+        pipeline_override: Record<string, unknown> | Record<string, unknown>[] = {}
+    ) {
         const id = await maa.context_run_task(this.handle, entry, JSON.stringify(pipeline_override))
         return this.#tasker.task_detail(id)
     }
@@ -19,7 +22,7 @@ export class Context {
     async run_recognition(
         entry: string,
         image: ArrayBuffer | Buffer,
-        pipeline_override: Record<string, unknown> = {}
+        pipeline_override: Record<string, unknown> | Record<string, unknown>[] = {}
     ) {
         if (image instanceof Buffer) {
             image = image.buffer
@@ -37,7 +40,7 @@ export class Context {
         entry: string,
         box: maa.Rect,
         reco_detail: string,
-        pipeline_override: Record<string, unknown> = {}
+        pipeline_override: Record<string, unknown> | Record<string, unknown>[] = {}
     ) {
         const id = await maa.context_run_action(
             this.handle,
@@ -49,7 +52,7 @@ export class Context {
         return this.#tasker.node_detail(id)
     }
 
-    override_pipeline(pipeline_override: Record<string, unknown>) {
+    override_pipeline(pipeline_override: Record<string, unknown> | Record<string, unknown>[]) {
         if (!maa.context_override_pipeline(this.handle, JSON.stringify(pipeline_override))) {
             throw 'Context override_pipeline failed'
         }

package/src/controller.ts

@@ -47,11 +47,13 @@ export type ControllerNotify = {
         | 'touch_down'
         | 'touch_move'
         | 'touch_up'
-        | 'press_key'
+        | 'click_key'
         | 'input_text'
         | 'screencap'
         | 'start_app'
         | 'stop_app'
+        | 'key_down'
+        | 'key_up'
     ctrl_id: maa.CtrlId
     uuid: string
 }
@@ -106,12 +108,6 @@ export class ControllerBase {
         }
     }
 
-    set recording(value: boolean) {
-        if (!maa.controller_set_option_recording(this.handle, value)) {
-            throw 'Controller set recording failed'
-        }
-    }
-
     post_connection() {
         return new Job(this.#source, maa.controller_post_connection(this.handle))
     }
@@ -127,8 +123,16 @@ export class ControllerBase {
         )
     }
 
-    post_press_key(keycode: number) {
-        return new Job(this.#source, maa.controller_post_press_key(this.handle, keycode))
+    post_click_key(keycode: number) {
+        return new Job(this.#source, maa.controller_post_click_key(this.handle, keycode))
+    }
+
+    post_key_down(keycode: number) {
+        return new Job(this.#source, maa.controller_post_key_down(this.handle, keycode))
+    }
+
+    post_key_up(keycode: number) {
+        return new Job(this.#source, maa.controller_post_key_up(this.handle, keycode))
     }
 
     post_input_text(text: string) {
@@ -289,8 +293,10 @@ export abstract class CustomControllerActor {
         pressure: number
     ): maa.MaybePromise<boolean>
     abstract touch_up(contact: number): maa.MaybePromise<boolean>
-    abstract press_key(keycode: number): maa.MaybePromise<boolean>
+    abstract click_key(keycode: number): maa.MaybePromise<boolean>
     abstract input_text(text: string): maa.MaybePromise<boolean>
+    abstract key_down(keycode: number): maa.MaybePromise<boolean>
+    abstract key_up(keycode: number): maa.MaybePromise<boolean>
 }
 
 export class CustomControllerActorDefaultImpl extends CustomControllerActor {
@@ -330,12 +336,18 @@ export class CustomControllerActorDefaultImpl extends CustomControllerActor {
     touch_up(contact: number): maa.MaybePromise<boolean> {
         return false
     }
-    press_key(keycode: number): maa.MaybePromise<boolean> {
+    click_key(keycode: number): maa.MaybePromise<boolean> {
         return false
     }
     input_text(text: string): maa.MaybePromise<boolean> {
         return false
     }
+    key_down(keycode: number): maa.MaybePromise<boolean> {
+        return false
+    }
+    key_up(keycode: number): maa.MaybePromise<boolean> {
+        return false
+    }
 }
 
 export class CustomController extends ControllerBase {

package/src/global.ts

@@ -17,24 +17,12 @@ export const Global = {
         }
     },
 
-    set recording(value: boolean) {
-        if (!maa.set_global_option_recording(value)) {
-            throw 'Global set recording failed'
-        }
-    },
-
     set stdout_level(value: keyof typeof maa.LoggingLevel) {
         if (!maa.set_global_option_stdout_level(maa.LoggingLevel[value])) {
             throw 'Global set stdout_level failed'
         }
     },
 
-    set show_hit_draw(value: boolean) {
-        if (!maa.set_global_option_show_hit_draw(value)) {
-            throw 'Global set show_hit_draw failed'
-        }
-    },
-
     set debug_mode(value: boolean) {
         if (!maa.set_global_option_debug_mode(value)) {
             throw 'Global set debug_mode failed'

package/src/index-client.ts

@@ -1,6 +1,7 @@
 import './maa-client.js'
 
 export * as api from './maa'
+export * from './job'
 export * from './controller'
 export * from './resource'
 export * from './tasker'

package/src/index-server.ts

@@ -1,6 +1,7 @@
 import './maa-server.js'
 
 export * as api from './maa'
+export * from './job'
 export * from './controller'
 export * from './resource'
 export * from './tasker'

package/src/maa.d.ts

@@ -64,8 +64,10 @@ export type CustomControllerParamResultMap = {
     touch_down: [[contact: number, x: number, y: number, pressure: number], boolean]
     touch_move: [[contact: number, x: number, y: number, pressure: number], boolean]
     touch_up: [[contact: number], boolean]
-    press_key: [[keycode: number], boolean]
+    click_key: [[keycode: number], boolean]
     input_text: [[text: string], boolean]
+    key_down: [[keycode: number], boolean]
+    key_up: [[keycode: number], boolean]
 }
 export type CustomControllerCallback = (
     action: keyof CustomControllerParamResultMap,
@@ -150,10 +152,6 @@ export declare function controller_set_option_screenshot_use_raw_size(
     handle: ControllerHandle,
     value: boolean
 ): boolean
-export declare function controller_set_option_recording(
-    handle: ControllerHandle,
-    value: boolean
-): boolean
 export declare function controller_post_connection(handle: ControllerHandle): CtrlId
 export declare function controller_post_click(
     handle: ControllerHandle,
@@ -168,7 +166,9 @@ export declare function controller_post_swipe(
     y2: number,
     duration: number
 ): CtrlId
-export declare function controller_post_press_key(handle: ControllerHandle, keycode: number): CtrlId
+export declare function controller_post_click_key(handle: ControllerHandle, keycode: number): CtrlId
+export declare function controller_post_key_down(handle: ControllerHandle, keycode: number): CtrlId
+export declare function controller_post_key_up(handle: ControllerHandle, keycode: number): CtrlId
 export declare function controller_post_input_text(handle: ControllerHandle, text: string): CtrlId
 export declare function controller_post_start_app(handle: ControllerHandle, intent: string): CtrlId
 export declare function controller_post_stop_app(handle: ControllerHandle, intent: string): CtrlId
@@ -232,12 +232,12 @@ export declare function resource_post_bundle(handle: ResourceHandle, path: strin
 export declare function resource_override_pipeline(
     handle: ResourceHandle,
     pipeline_override: string
-): bool
+): boolean
 export declare function resource_override_next(
     handle: ResourceHandle,
     node_name: string,
     next_list: string[]
-): bool
+): boolean
 export declare function resource_get_node_data(
     handle: ResourceHandle,
     node_name: string
@@ -330,9 +330,7 @@ export declare function find_desktop(): Promise<
 export declare function version(): string
 export declare function set_global_option_log_dir(value: string): boolean
 export declare function set_global_option_save_draw(value: boolean): boolean
-export declare function set_global_option_recording(value: boolean): boolean
 export declare function set_global_option_stdout_level(value: LoggingLevel): boolean
-export declare function set_global_option_show_hit_draw(value: boolean): boolean
 export declare function set_global_option_debug_mode(value: boolean): boolean
 
 // pi.cpp

package/src/pipeline.ts

@@ -208,7 +208,7 @@ export type ActionMultiSwipe<Mode> = RequiredIfStrict<
     Mode
 >
 
-export type ActionKey<Mode> = RequiredIfStrict<
+export type ActionClickKey<Mode> = RequiredIfStrict<
     {
         key?: MaybeArray<number, Mode>
     },
@@ -216,6 +216,15 @@ export type ActionKey<Mode> = RequiredIfStrict<
     Mode
 >
 
+export type ActionLongPressKey<Mode> = RequiredIfStrict<
+    {
+        key?: number
+        duration?: number
+    },
+    'key',
+    Mode
+>
+
 export type ActionInputText<Mode> = RequiredIfStrict<
     {
         input_text?: string
@@ -292,7 +301,9 @@ export type Action<Mode> =
     | MixAct<'LongPress', ActionLongPress, Mode>
     | MixAct<'Swipe', ActionSwipe, Mode>
     | MixAct<'MultiSwipe', ActionMultiSwipe<Mode>, Mode>
-    | MixAct<'Key', ActionKey<Mode>, Mode>
+    | MixAct<'Key', ActionClickKey<Mode>, Mode>
+    | MixAct<'ClickKey', ActionClickKey<Mode>, Mode>
+    | MixAct<'LongPressKey', ActionLongPressKey<Mode>, Mode>
     | MixAct<'InputText', ActionInputText<Mode>, Mode>
     | MixAct<'StartApp', ActionStartApp<Mode>, Mode>
     | MixAct<'StopApp', ActionStopApp<Mode>, Mode>

package/src/resource.ts

@@ -144,8 +144,8 @@ export class ResourceBase {
         return new Job(this.#source, maa.resource_post_bundle(this.handle, path))
     }
 
-    override_pipeline(pipeline_override: string) {
-        if (!maa.resource_override_pipeline(this.handle, pipeline_override)) {
+    override_pipeline(pipeline_override: Record<string, unknown> | Record<string, unknown>[] = {}) {
+        if (!maa.resource_override_pipeline(this.handle, JSON.stringify(pipeline_override))) {
             throw 'Resource override_pipeline failed'
         }
     }

package/src/tasker.ts

@@ -23,7 +23,7 @@ export type RecoDetail = {
     best: RecoDetailEntry | null
 }
 
-class TaskJob extends Job<maa.TaskId, JobSource<maa.TaskId>> {
+export class TaskJob extends Job<maa.TaskId, JobSource<maa.TaskId>> {
     #tasker: TaskerBase
 
     constructor(tasker: TaskerBase, source: JobSource<maa.TaskId>, id: maa.TaskId) {
@@ -130,7 +130,7 @@ export class TaskerBase {
         }
     }
 
-    post_task(entry: string, param: Record<string, unknown> = {}) {
+    post_task(entry: string, param: Record<string, unknown> | Record<string, unknown>[] = {}) {
         return new TaskJob(
             this,
             this.#source,