droidline 0.1.11 → 0.1.12

package/dist/generated.d.ts

@@ -129,6 +129,32 @@ export interface App {
     system?: any;
     [field: string]: any;
 }
+export interface Sms {
+    id?: any;
+    address?: any;
+    text?: any;
+    time?: any;
+    box?: any;
+    read?: any;
+    mms?: any;
+    [field: string]: any;
+}
+export interface Call {
+    id?: any;
+    number?: any;
+    name?: any;
+    type?: any;
+    time?: any;
+    duration?: any;
+    [field: string]: any;
+}
+export interface Contact {
+    id?: any;
+    name?: any;
+    numbers?: any;
+    emails?: any;
+    [field: string]: any;
+}
 /** Error codes the server can answer with, from spec/commands.json. */
 export type ErrorCode = "NOT_FOUND" | "AMBIGUOUS" | "NOT_CLICKABLE" | "TIMEOUT" | "NO_ACCESSIBILITY" | "NO_IME" | "NO_PERMISSION" | "APP_NOT_FOUND" | "ACTIVITY_BLOCKED" | "PROXY_FAILED" | "UNKNOWN_CMD" | "UNSUPPORTED" | "BAD_ARGS" | "DEVICE_NOT_FOUND" | "DEVICE_OFFLINE" | "DEVICE_AMBIGUOUS" | "DEVICE_LEASED" | "LEASE_NOT_FOUND" | "NO_FREE_DEVICE" | "OCR_UNAVAILABLE" | "AGENT_RESTARTED" | "UNAUTHORIZED" | "PAIRING_FAILED" | "INTERNAL";
 /** HTTP status and default retryable flag of each error code. */
@@ -526,6 +552,34 @@ export interface NotifyFilterOptions {
     /** Allowed packages. Omit to read the current list. */
     packages?: ReadonlyArray<string>;
 }
+export interface SmsOptions {
+    /** Received, sent, or both. @default "inbox" */
+    box?: "inbox" | "sent" | "all";
+    /** Only messages whose number or sender contains this. Spaces and dashes are ignored. */
+    address?: string;
+    /** Only messages whose text contains this, ignoring case. */
+    contains?: string;
+    /** Only messages from the last this many seconds. 0 means any time. @default 0 */
+    within?: number;
+    /** Most messages to return, up to 500. @default 20 */
+    max?: number;
+}
+export interface CallsOptions {
+    /** Which calls. @default "all" */
+    type?: "all" | "incoming" | "outgoing" | "missed" | "rejected" | "blocked";
+    /** Only calls whose number or saved name contains this. Spaces and dashes are ignored. */
+    number?: string;
+    /** Only calls from the last this many seconds. 0 means any time. @default 0 */
+    within?: number;
+    /** Most calls to return, up to 500. @default 20 */
+    max?: number;
+}
+export interface ContactsOptions {
+    /** Only contacts whose name, number or email contains this, ignoring case. Spaces and dashes in numbers are ignored. */
+    query?: string;
+    /** Most contacts to return, up to 500. @default 50 */
+    max?: number;
+}
 export interface ChromeGoOptions {
     /** Open in a new tab. @default false */
     new_tab?: boolean;
@@ -4183,6 +4237,188 @@ export declare abstract class DeviceCommands {
      * @alias notify_filter
      */
     notifyFilter(packages?: ReadonlyArray<string>, opts?: NotifyFilterOptions): Promise<Array<string>>;
+    /**
+     * Text messages stored on the phone, newest first.
+     *
+     * Optional. Allow SMS on the app's Setup tab first; until then the answer is NO_PERMISSION. Covers SMS and the text of MMS. Chat messages (RCS) are kept by the messaging app itself and are not included. The MCP server lists this tool only when --tools names it.
+     *
+     * @param box Received, sent, or both. Default: "inbox".
+     * @param address Only messages whose number or sender contains this. Spaces and dashes are ignored.
+     * @param contains Only messages whose text contains this, ignoring case.
+     * @param within Only messages from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most messages to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see SmsOptions.
+     * @example await d.sms({ contains: "인증번호", within: 300, max: 1 })
+     */
+    sms(opts?: SmsOptions): Promise<Array<Sms>>;
+    /**
+     * Text messages stored on the phone, newest first.
+     *
+     * Optional. Allow SMS on the app's Setup tab first; until then the answer is NO_PERMISSION. Covers SMS and the text of MMS. Chat messages (RCS) are kept by the messaging app itself and are not included. The MCP server lists this tool only when --tools names it.
+     *
+     * @param box Received, sent, or both. Default: "inbox".
+     * @param address Only messages whose number or sender contains this. Spaces and dashes are ignored.
+     * @param contains Only messages whose text contains this, ignoring case.
+     * @param within Only messages from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most messages to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see SmsOptions.
+     * @example await d.sms({ contains: "인증번호", within: 300, max: 1 })
+     */
+    sms(box?: "inbox" | "sent" | "all", opts?: SmsOptions): Promise<Array<Sms>>;
+    /**
+     * Text messages stored on the phone, newest first.
+     *
+     * Optional. Allow SMS on the app's Setup tab first; until then the answer is NO_PERMISSION. Covers SMS and the text of MMS. Chat messages (RCS) are kept by the messaging app itself and are not included. The MCP server lists this tool only when --tools names it.
+     *
+     * @param box Received, sent, or both. Default: "inbox".
+     * @param address Only messages whose number or sender contains this. Spaces and dashes are ignored.
+     * @param contains Only messages whose text contains this, ignoring case.
+     * @param within Only messages from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most messages to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see SmsOptions.
+     * @example await d.sms({ contains: "인증번호", within: 300, max: 1 })
+     */
+    sms(box?: "inbox" | "sent" | "all", address?: string, opts?: SmsOptions): Promise<Array<Sms>>;
+    /**
+     * Text messages stored on the phone, newest first.
+     *
+     * Optional. Allow SMS on the app's Setup tab first; until then the answer is NO_PERMISSION. Covers SMS and the text of MMS. Chat messages (RCS) are kept by the messaging app itself and are not included. The MCP server lists this tool only when --tools names it.
+     *
+     * @param box Received, sent, or both. Default: "inbox".
+     * @param address Only messages whose number or sender contains this. Spaces and dashes are ignored.
+     * @param contains Only messages whose text contains this, ignoring case.
+     * @param within Only messages from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most messages to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see SmsOptions.
+     * @example await d.sms({ contains: "인증번호", within: 300, max: 1 })
+     */
+    sms(box?: "inbox" | "sent" | "all", address?: string, contains?: string, opts?: SmsOptions): Promise<Array<Sms>>;
+    /**
+     * Text messages stored on the phone, newest first.
+     *
+     * Optional. Allow SMS on the app's Setup tab first; until then the answer is NO_PERMISSION. Covers SMS and the text of MMS. Chat messages (RCS) are kept by the messaging app itself and are not included. The MCP server lists this tool only when --tools names it.
+     *
+     * @param box Received, sent, or both. Default: "inbox".
+     * @param address Only messages whose number or sender contains this. Spaces and dashes are ignored.
+     * @param contains Only messages whose text contains this, ignoring case.
+     * @param within Only messages from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most messages to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see SmsOptions.
+     * @example await d.sms({ contains: "인증번호", within: 300, max: 1 })
+     */
+    sms(box?: "inbox" | "sent" | "all", address?: string, contains?: string, within?: number, opts?: SmsOptions): Promise<Array<Sms>>;
+    /**
+     * Text messages stored on the phone, newest first.
+     *
+     * Optional. Allow SMS on the app's Setup tab first; until then the answer is NO_PERMISSION. Covers SMS and the text of MMS. Chat messages (RCS) are kept by the messaging app itself and are not included. The MCP server lists this tool only when --tools names it.
+     *
+     * @param box Received, sent, or both. Default: "inbox".
+     * @param address Only messages whose number or sender contains this. Spaces and dashes are ignored.
+     * @param contains Only messages whose text contains this, ignoring case.
+     * @param within Only messages from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most messages to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see SmsOptions.
+     * @example await d.sms({ contains: "인증번호", within: 300, max: 1 })
+     */
+    sms(box?: "inbox" | "sent" | "all", address?: string, contains?: string, within?: number, max?: number, opts?: SmsOptions): Promise<Array<Sms>>;
+    /**
+     * Call history, newest first.
+     *
+     * Optional. Allow call history on the app's Setup tab first; until then the answer is NO_PERMISSION. Only calls made through the phone app are listed; calls inside apps such as messengers usually are not. The MCP server lists this tool only when --tools names it.
+     *
+     * @param type Which calls. Default: "all".
+     * @param number Only calls whose number or saved name contains this. Spaces and dashes are ignored.
+     * @param within Only calls from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most calls to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see CallsOptions.
+     * @example await d.calls({ type: "missed", within: 3600 })
+     */
+    calls(opts?: CallsOptions): Promise<Array<Call>>;
+    /**
+     * Call history, newest first.
+     *
+     * Optional. Allow call history on the app's Setup tab first; until then the answer is NO_PERMISSION. Only calls made through the phone app are listed; calls inside apps such as messengers usually are not. The MCP server lists this tool only when --tools names it.
+     *
+     * @param type Which calls. Default: "all".
+     * @param number Only calls whose number or saved name contains this. Spaces and dashes are ignored.
+     * @param within Only calls from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most calls to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see CallsOptions.
+     * @example await d.calls({ type: "missed", within: 3600 })
+     */
+    calls(type?: "all" | "incoming" | "outgoing" | "missed" | "rejected" | "blocked", opts?: CallsOptions): Promise<Array<Call>>;
+    /**
+     * Call history, newest first.
+     *
+     * Optional. Allow call history on the app's Setup tab first; until then the answer is NO_PERMISSION. Only calls made through the phone app are listed; calls inside apps such as messengers usually are not. The MCP server lists this tool only when --tools names it.
+     *
+     * @param type Which calls. Default: "all".
+     * @param number Only calls whose number or saved name contains this. Spaces and dashes are ignored.
+     * @param within Only calls from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most calls to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see CallsOptions.
+     * @example await d.calls({ type: "missed", within: 3600 })
+     */
+    calls(type?: "all" | "incoming" | "outgoing" | "missed" | "rejected" | "blocked", number?: string, opts?: CallsOptions): Promise<Array<Call>>;
+    /**
+     * Call history, newest first.
+     *
+     * Optional. Allow call history on the app's Setup tab first; until then the answer is NO_PERMISSION. Only calls made through the phone app are listed; calls inside apps such as messengers usually are not. The MCP server lists this tool only when --tools names it.
+     *
+     * @param type Which calls. Default: "all".
+     * @param number Only calls whose number or saved name contains this. Spaces and dashes are ignored.
+     * @param within Only calls from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most calls to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see CallsOptions.
+     * @example await d.calls({ type: "missed", within: 3600 })
+     */
+    calls(type?: "all" | "incoming" | "outgoing" | "missed" | "rejected" | "blocked", number?: string, within?: number, opts?: CallsOptions): Promise<Array<Call>>;
+    /**
+     * Call history, newest first.
+     *
+     * Optional. Allow call history on the app's Setup tab first; until then the answer is NO_PERMISSION. Only calls made through the phone app are listed; calls inside apps such as messengers usually are not. The MCP server lists this tool only when --tools names it.
+     *
+     * @param type Which calls. Default: "all".
+     * @param number Only calls whose number or saved name contains this. Spaces and dashes are ignored.
+     * @param within Only calls from the last this many seconds. 0 means any time. Default: 0.
+     * @param max Most calls to return, up to 500. Default: 20.
+     * @param opts Optional parameters by name, see CallsOptions.
+     * @example await d.calls({ type: "missed", within: 3600 })
+     */
+    calls(type?: "all" | "incoming" | "outgoing" | "missed" | "rejected" | "blocked", number?: string, within?: number, max?: number, opts?: CallsOptions): Promise<Array<Call>>;
+    /**
+     * Contacts saved on the phone, by name.
+     *
+     * Optional. Allow contacts on the app's Setup tab first; until then the answer is NO_PERMISSION. The MCP server lists this tool only when --tools names it.
+     *
+     * @param query Only contacts whose name, number or email contains this, ignoring case. Spaces and dashes in numbers are ignored.
+     * @param max Most contacts to return, up to 500. Default: 50.
+     * @param opts Optional parameters by name, see ContactsOptions.
+     * @example await d.contacts("Kim")
+     */
+    contacts(opts?: ContactsOptions): Promise<Array<Contact>>;
+    /**
+     * Contacts saved on the phone, by name.
+     *
+     * Optional. Allow contacts on the app's Setup tab first; until then the answer is NO_PERMISSION. The MCP server lists this tool only when --tools names it.
+     *
+     * @param query Only contacts whose name, number or email contains this, ignoring case. Spaces and dashes in numbers are ignored.
+     * @param max Most contacts to return, up to 500. Default: 50.
+     * @param opts Optional parameters by name, see ContactsOptions.
+     * @example await d.contacts("Kim")
+     */
+    contacts(query?: string, opts?: ContactsOptions): Promise<Array<Contact>>;
+    /**
+     * Contacts saved on the phone, by name.
+     *
+     * Optional. Allow contacts on the app's Setup tab first; until then the answer is NO_PERMISSION. The MCP server lists this tool only when --tools names it.
+     *
+     * @param query Only contacts whose name, number or email contains this, ignoring case. Spaces and dashes in numbers are ignored.
+     * @param max Most contacts to return, up to 500. Default: 50.
+     * @param opts Optional parameters by name, see ContactsOptions.
+     * @example await d.contacts("Kim")
+     */
+    contacts(query?: string, max?: number, opts?: ContactsOptions): Promise<Array<Contact>>;
 }
 /** Commands the PC server answers itself. Droidline extends this and implements _run. */
 export declare abstract class ClientCommands extends EventEmitter {

package/dist/generated.js

@@ -385,6 +385,15 @@ export class DeviceCommands {
     async notifyFilter(...args) {
         return this._run("notify_filter", "value", collect("notify_filter", args, [], ["packages"]));
     }
+    async sms(...args) {
+        return this._run("sms", "value", collect("sms", args, [], ["box", "address", "contains", "within", "max"]));
+    }
+    async calls(...args) {
+        return this._run("calls", "value", collect("calls", args, [], ["type", "number", "within", "max"]));
+    }
+    async contacts(...args) {
+        return this._run("contacts", "value", collect("contacts", args, [], ["query", "max"]));
+    }
 }
 /** Commands the PC server answers itself. Droidline extends this and implements _run. */
 export class ClientCommands extends EventEmitter {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "droidline",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Android automation from Node.js: test your apps on real phones, script the tasks you repeat and run many phones at once. No ADB, no USB cable, no root.",
   "license": "MIT",
   "type": "module",