@usenaive-sdk/cli 0.12.2 → 0.13.0

package/dist/commands/mobile.js

@@ -0,0 +1,382 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError, handlePendingApproval } from "../client.js";
+import { agentError, agentOutput } from "../output.js";
+export function mobileHealthIssue(data) {
+    const result = data;
+    const health = result.provider ?? result;
+    if (health.configured === false) {
+        return {
+            code: "feature_not_configured",
+            message: "MobileRun is not configured on this deployment.",
+            operator_action: "Set a valid MOBILERUN_API_KEY on the API deployment, redeploy, then retry.",
+        };
+    }
+    if (health.reachable === false) {
+        return {
+            code: "provider_unavailable",
+            message: "MobileRun is configured but the provider health check failed.",
+            provider: "mobilerun",
+            provider_error: health.error,
+            operator_action: "Validate or rotate MOBILERUN_API_KEY on the API deployment, redeploy, then retry.",
+            ...(result.devices ? { cached_devices: result.devices } : {}),
+        };
+    }
+    return undefined;
+}
+function requireMobileHealth(action, data) {
+    const issue = mobileHealthIssue(data);
+    if (issue) {
+        agentError({
+            action,
+            error: issue,
+            recovery_steps: [
+                {
+                    command: "naive mobile status",
+                    description: issue.code === "feature_not_configured"
+                        ? "Re-check after the deployment operator configures MobileRun"
+                        : "Re-check provider health",
+                },
+            ],
+        });
+    }
+}
+export const mobileCmd = new Command("mobile")
+    .description("Mobile — provision, control & display cloud mobile emulators/devices via Mobilerun")
+    .addHelpText("after", `
+Phones are billed PER MINUTE from your credits: the phone provisions
+immediately and the meter runs until you terminate it (there is NO upstream
+auto-stop — running out of credits auto-terminates the phone).
+
+Subcommands:
+  naive mobile status                         Integration status + your phone count
+  naive mobile devices                        List your phones (alias: phones)
+  naive mobile provision                      Create a phone (alias: create-phone)
+  naive mobile device <id>                    Show a device's live details
+  naive mobile stream <id>                    Get the live stream URL/token (to display)
+  naive mobile reboot <id>                    Reboot a device
+  naive mobile reset <id>                     Reset a device to a fresh state
+  naive mobile terminate <id>                 Release a device (stops the per-minute meter)
+  naive mobile wait <id> [--timeout <secs>]   Block until a device is ready
+  naive mobile proxy <id>                     Show the device's proxy attachment
+  naive mobile proxy-set <id> --host ...      Attach a SOCKS5 proxy (residential IP)
+  naive mobile proxy-remove <id>              Detach the proxy (back to datacenter IP)
+  naive mobile run "<task>" [--device <id>]   Run an agent task on a device
+  naive mobile tasks                          List agent tasks
+  naive mobile task <id>                      Show a task's status/result
+  naive mobile stop <id>                      Cancel a running task
+  naive mobile screenshots <id>               List a task's screenshots
+  naive mobile trajectory <id>                Show a task's trajectory
+  naive mobile apps                           List apps in the Mobilerun library
+  naive mobile upload-app <name>              Create a signed upload URL for an app
+  naive mobile search "<query>"               Search the Mobilerun API catalog (wildcard)
+  naive mobile call <operationId> ...         Call ANY Mobilerun operation (wildcard)
+
+Governance:
+  Provisioning, reboot/reset/terminate, proxy changes, running/stopping tasks,
+  uploading apps, and mutating wildcard calls are SENSITIVE and may require
+  human approval depending on the Account Kit (status "pending_approval").
+
+Examples:
+  $ naive mobile provision --country US
+  $ naive mobile run "Open Settings and enable dark mode" --device <id> --vision
+  $ naive mobile stream <id>
+  $ naive mobile terminate <id>
+  $ naive mobile call take-screenshot --path deviceId=<id>
+`);
+mobileCmd
+    .command("status", { isDefault: true })
+    .description("Show mobile integration status + your device count")
+    .action(async () => {
+    const resp = await apiRequest("GET", "/v1/mobile/status");
+    handleApiError("mobile.status", resp);
+    requireMobileHealth("mobile.status", resp.data);
+    agentOutput({ action: "mobile.status", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("devices")
+    .alias("phones")
+    .description("List your phones (cloud mobile devices) with status")
+    .option("--state <state>", "Filter by state, e.g. ready")
+    .option("--type <type>", "Filter by device type")
+    .option("--country <country>", "Filter by country")
+    .action(async (opts) => {
+    const params = new URLSearchParams();
+    if (opts.state)
+        params.set("state", opts.state);
+    if (opts.type)
+        params.set("type", opts.type);
+    if (opts.country)
+        params.set("country", opts.country);
+    const qs = params.toString();
+    const resp = await apiRequest("GET", `/v1/mobile/devices${qs ? `?${qs}` : ""}`);
+    handleApiError("mobile.devices", resp);
+    requireMobileHealth("mobile.devices", resp.data);
+    agentOutput({ action: "mobile.devices", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("provision")
+    .alias("create-phone")
+    .description("Create a phone — provisions immediately, billed per minute from your credits")
+    .option("--type <type>", "Device type (default: dedicated_premium_device — the minute-billed cloud phone)")
+    .option("--country <country>", "Country code")
+    .option("--profile <id>", "Device profile id")
+    .option("--name <name>", "Phone name")
+    .action(async (opts) => {
+    const body = {
+        type: opts.type,
+        country: opts.country,
+        profile_id: opts.profile,
+        name: opts.name,
+    };
+    const resp = await apiRequest("POST", "/v1/mobile/devices", body);
+    if (handlePendingApproval("mobile.provision", resp))
+        return;
+    handleApiError("mobile.provision", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "mobile.provision",
+        result: resp.data,
+        next_steps: data.phone?.device_id
+            ? [
+                { command: `naive mobile wait ${data.phone.device_id}`, description: "Block until the device is ready" },
+                { command: `naive mobile terminate ${data.phone.device_id}`, description: "Terminate when done (stops the per-minute meter)" },
+            ]
+            : [],
+        hints: [
+            `Billed ${data.credits_per_minute ?? "a few"} credits/min from your balance until terminated — running out of credits auto-terminates the phone.`,
+        ],
+    });
+});
+mobileCmd
+    .command("device <id>")
+    .description("Show a device's live details")
+    .action(async (id) => {
+    const resp = await apiRequest("GET", `/v1/mobile/devices/${id}`);
+    handleApiError("mobile.device", resp);
+    agentOutput({ action: "mobile.device", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("stream <id>")
+    .description("Get the live stream URL + token (to display the device screen)")
+    .action(async (id) => {
+    const resp = await apiRequest("GET", `/v1/mobile/devices/${id}/stream`);
+    handleApiError("mobile.stream", resp);
+    agentOutput({ action: "mobile.stream", result: resp.data, next_steps: [] });
+});
+for (const verb of ["reboot", "reset"]) {
+    mobileCmd
+        .command(`${verb} <id>`)
+        .description(verb === "reboot" ? "Reboot a device" : "Reset a device to a fresh state")
+        .action(async (id) => {
+        const resp = await apiRequest("POST", `/v1/mobile/devices/${id}/${verb}`);
+        if (handlePendingApproval(`mobile.${verb}`, resp))
+            return;
+        handleApiError(`mobile.${verb}`, resp);
+        agentOutput({ action: `mobile.${verb}`, result: resp.data, next_steps: [] });
+    });
+}
+mobileCmd
+    .command("terminate <id>")
+    .description("Terminate (release) a device")
+    .action(async (id) => {
+    const resp = await apiRequest("DELETE", `/v1/mobile/devices/${id}`);
+    if (handlePendingApproval("mobile.terminate", resp))
+        return;
+    handleApiError("mobile.terminate", resp);
+    agentOutput({ action: "mobile.terminate", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("wait <id>")
+    .description("Block until a device is ready")
+    .option("--timeout <secs>", "Timeout in seconds")
+    .action(async (id, opts) => {
+    const body = opts.timeout ? { timeout_seconds: Number(opts.timeout) } : {};
+    const resp = await apiRequest("POST", `/v1/mobile/devices/${id}/wait`, body);
+    handleApiError("mobile.wait", resp);
+    agentOutput({ action: "mobile.wait", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("proxy <id>")
+    .description("Show a device's proxy attachment (devices default to a datacenter IP)")
+    .action(async (id) => {
+    const resp = await apiRequest("GET", `/v1/mobile/devices/${id}/proxy`);
+    handleApiError("mobile.proxy", resp);
+    agentOutput({ action: "mobile.proxy", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("proxy-set <id>")
+    .description("Attach a SOCKS5 proxy to a device (residential / country-specific IP)")
+    .requiredOption("--host <host>", "Proxy host")
+    .requiredOption("--port <port>", "Proxy port")
+    .option("--user <user>", "Proxy username")
+    .option("--password <password>", "Proxy password")
+    .option("--no-smart-ip", "Disable smart IP rotation handling")
+    .action(async (id, opts) => {
+    const resp = await apiRequest("POST", `/v1/mobile/devices/${id}/proxy`, {
+        host: opts.host,
+        port: Number(opts.port),
+        user: opts.user,
+        password: opts.password,
+        smart_ip: opts.smartIp,
+    });
+    if (handlePendingApproval("mobile.set_proxy", resp))
+        return;
+    handleApiError("mobile.set_proxy", resp);
+    agentOutput({ action: "mobile.set_proxy", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("proxy-remove <id>")
+    .description("Detach the proxy from a device (back to the datacenter IP)")
+    .action(async (id) => {
+    const resp = await apiRequest("DELETE", `/v1/mobile/devices/${id}/proxy`);
+    if (handlePendingApproval("mobile.remove_proxy", resp))
+        return;
+    handleApiError("mobile.remove_proxy", resp);
+    agentOutput({ action: "mobile.remove_proxy", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("run <task>")
+    .description("Run an agent task on one of your phones with a natural-language instruction")
+    .requiredOption("--device <id>", "Target phone (device) id — required")
+    .option("--model <model>", "LLM model id")
+    .option("--vision", "Enable vision (screenshots)")
+    .option("--reasoning", "Enable multi-step planning")
+    .option("--steps <n>", "Max execution steps")
+    .action(async (task, opts) => {
+    const body = {
+        task,
+        device_id: opts.device,
+        model: opts.model,
+        vision: opts.vision || undefined,
+        reasoning: opts.reasoning || undefined,
+        steps: opts.steps ? Number(opts.steps) : undefined,
+    };
+    const resp = await apiRequest("POST", "/v1/mobile/tasks", body);
+    if (handlePendingApproval("mobile.run", resp))
+        return;
+    handleApiError("mobile.run", resp);
+    agentOutput({ action: "mobile.run", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("tasks")
+    .description("List agent tasks")
+    .option("--device <id>", "Filter by device id")
+    .option("--status <status>", "Filter by status")
+    .action(async (opts) => {
+    const params = new URLSearchParams();
+    if (opts.device)
+        params.set("device_id", opts.device);
+    if (opts.status)
+        params.set("status", opts.status);
+    const qs = params.toString();
+    const resp = await apiRequest("GET", `/v1/mobile/tasks${qs ? `?${qs}` : ""}`);
+    handleApiError("mobile.tasks", resp);
+    agentOutput({ action: "mobile.tasks", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("task <id>")
+    .description("Show a task's status/result")
+    .action(async (id) => {
+    const resp = await apiRequest("GET", `/v1/mobile/tasks/${id}`);
+    handleApiError("mobile.task", resp);
+    agentOutput({ action: "mobile.task", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("stop <id>")
+    .description("Cancel a running task")
+    .action(async (id) => {
+    const resp = await apiRequest("POST", `/v1/mobile/tasks/${id}/stop`);
+    if (handlePendingApproval("mobile.stop", resp))
+        return;
+    handleApiError("mobile.stop", resp);
+    agentOutput({ action: "mobile.stop", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("screenshots <id>")
+    .description("List a task's screenshot URLs")
+    .action(async (id) => {
+    const resp = await apiRequest("GET", `/v1/mobile/tasks/${id}/screenshots`);
+    handleApiError("mobile.screenshots", resp);
+    agentOutput({ action: "mobile.screenshots", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("trajectory <id>")
+    .description("Show a task's step-by-step trajectory")
+    .action(async (id) => {
+    const resp = await apiRequest("GET", `/v1/mobile/tasks/${id}/trajectory`);
+    handleApiError("mobile.trajectory", resp);
+    agentOutput({ action: "mobile.trajectory", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("apps")
+    .description("List apps in the Mobilerun library")
+    .action(async () => {
+    const resp = await apiRequest("GET", "/v1/mobile/apps");
+    handleApiError("mobile.apps", resp);
+    agentOutput({ action: "mobile.apps", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("upload-app <name>")
+    .description("Create a signed upload URL to add an app (APK) to the library")
+    .option("--file <name>", "File name of the APK")
+    .action(async (name, opts) => {
+    const resp = await apiRequest("POST", "/v1/mobile/apps", { name, file_name: opts.file });
+    if (handlePendingApproval("mobile.upload_app", resp))
+        return;
+    handleApiError("mobile.upload_app", resp);
+    agentOutput({ action: "mobile.upload_app", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("search [query]")
+    .description("Search the Mobilerun API catalog (wildcard discovery)")
+    .option("--tag <tag>", "Filter by API group, e.g. Devices, Tasks, Tools")
+    .action(async (query, opts) => {
+    const params = new URLSearchParams();
+    if (query)
+        params.set("q", query);
+    if (opts.tag)
+        params.set("tag", opts.tag);
+    const qs = params.toString();
+    const resp = await apiRequest("GET", `/v1/mobile/methods${qs ? `?${qs}` : ""}`);
+    handleApiError("mobile.search", resp);
+    agentOutput({ action: "mobile.search", result: resp.data, next_steps: [] });
+});
+mobileCmd
+    .command("call <operationId>")
+    .description("Call ANY Mobilerun operation by operationId (wildcard)")
+    .option("--path <kv...>", "Path params KEY=VALUE (repeatable), e.g. deviceId=<id>")
+    .option("--query <kv...>", "Query params KEY=VALUE (repeatable)")
+    .option("--body <json>", "JSON request body")
+    .action(async (operationId, opts) => {
+    const parseKv = (entries) => {
+        const out = {};
+        for (const kv of entries ?? []) {
+            const i = String(kv).indexOf("=");
+            if (i > 0)
+                out[String(kv).slice(0, i)] = String(kv).slice(i + 1);
+        }
+        return out;
+    };
+    let body;
+    if (opts.body) {
+        try {
+            body = JSON.parse(opts.body);
+        }
+        catch {
+            handleApiError("mobile.call", { status: 400, data: { error: { code: "invalid_input", message: "--body must be valid JSON" } } });
+            return;
+        }
+    }
+    const reqBody = {
+        operation_id: operationId,
+        path: parseKv(opts.path),
+        query: parseKv(opts.query),
+        ...(body !== undefined ? { body } : {}),
+    };
+    const resp = await apiRequest("POST", "/v1/mobile/call", reqBody);
+    if (handlePendingApproval("mobile.call", resp))
+        return;
+    handleApiError("mobile.call", resp);
+    agentOutput({ action: "mobile.call", result: resp.data, next_steps: [] });
+});
+//# sourceMappingURL=mobile.js.map

package/dist/commands/mobile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile.js","sourceRoot":"","sources":["../../src/commands/mobile.ts"],"names":[],"mappings":"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"}

package/dist/commands/payments.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const paymentsCmd: Command;

package/dist/commands/payments.js

@@ -0,0 +1,131 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { agentOutput } from "../output.js";
+export const paymentsCmd = new Command("payments")
+    .description("Payments — pay for x402 resources with the agent's crypto wallet")
+    .addHelpText("after", `
+Subcommands:
+  naive payments quote      Probe an x402 URL for its price — no side effects
+  naive payments pay        Pay for and fetch an x402 resource
+  naive payments receipts   List payment receipts
+
+How it works:
+  x402 is the HTTP 402 payment protocol. A paywalled resource answers with
+  402 Payment Required and a 'payment-required' header describing what it
+  accepts. 'quote' reads that without paying. 'pay' signs a USDC payment from
+  the agent's wallet, retries the request with the payment attached, and returns
+  the resource body plus a receipt.
+
+  'quote' first, then 'pay' — quote has ZERO side effects (no wallet is even
+  loaded), so it is the safe way to learn a price.
+
+Spend control:
+  'pay' is SENSITIVE — it spends real USDC. There is deliberately NO approval
+  queue: the cap is enforced inside the custody plane at signing time, which
+  survives a compromised runtime in a way an approval prompt would not. What
+  bounds a payment:
+    1. The wallet balance (an agent cannot spend what isn't there).
+    2. perTxMax — enforced at runtime AND as a static custody-plane policy.
+    3. dailyBudget (optional) — a rolling runtime counter.
+    4. --max-amount — a per-call ceiling you set on this one payment.
+  Set the policy with 'naive wallet policy'.
+
+Examples:
+  $ naive use alice
+  $ naive payments quote --url https://api.example.com/report
+  $ naive payments pay --url https://api.example.com/report --max-amount 0.50
+  $ naive payments receipts --direction buy --limit 10
+  $ naive payments receipts --since 2026-07-01T00:00:00Z
+`);
+paymentsCmd
+    .command("quote")
+    .description("Probe an x402 URL for its price — zero side effects, no payment")
+    .requiredOption("--url <url>", "The x402 resource URL")
+    .option("--method <method>", "HTTP method to probe with (default: GET)")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/payments/quote", {
+        url: opts.url,
+        ...(opts.method && { init: { method: opts.method } }),
+    });
+    handleApiError("payments.quote", resp);
+    const data = resp.data;
+    const first = data.accepts?.[0];
+    const atomic = first?.amount ?? first?.maxAmountRequired;
+    agentOutput({
+        action: "payments.quote",
+        result: resp.data,
+        next_steps: [{ command: `naive payments pay --url ${opts.url}`, description: "Pay for and fetch the resource" }],
+        hints: [
+            data.free
+                ? `This resource is not paywalled (HTTP ${data.status}) — fetch it normally, no payment needed.`
+                : first
+                    ? `Priced at ${atomic ?? "?"} atomic units of ${first.asset ?? "?"} on ${first.network ?? "?"}, payable to ${first.payTo ?? "?"}. USDC has 6 decimals, so 500000 = 0.50 USDC.`
+                    : "The resource returned 402 but advertised no acceptable payment method.",
+            "Quote does not touch the wallet — nothing was spent.",
+            "--max-amount on 'pay' is a DECIMAL amount (e.g. 0.50), not atomic units.",
+        ],
+        related_commands: ["naive payments pay", "naive wallet balance"],
+    });
+});
+paymentsCmd
+    .command("pay")
+    .description("Pay for and fetch an x402 resource — SENSITIVE, spends real USDC")
+    .requiredOption("--url <url>", "The x402 resource URL")
+    .option("--max-amount <amount>", "Refuse to pay more than this (decimal USDC) — a per-call ceiling")
+    .option("--method <method>", "HTTP method (default: GET)")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/payments/pay", {
+        url: opts.url,
+        ...(opts.maxAmount && { max_amount: opts.maxAmount }),
+        ...(opts.method && { init: { method: opts.method } }),
+    });
+    handleApiError("payments.pay", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "payments.pay",
+        result: resp.data,
+        next_steps: [{ command: "naive payments receipts --direction buy", description: "See the receipt" }],
+        hints: [
+            data.paid
+                ? `Paid ${data.receipt?.amount ?? "?"} USDC. Settlement tx: ${data.receipt?.txHash ?? "?"}.`
+                : `No payment was made — the resource returned HTTP ${data.status ?? "?"} (it may be free, or the request failed).`,
+            ...(opts.maxAmount ? [] : ["Tip: pass --max-amount to cap this specific payment on top of the wallet's perTxMax."]),
+        ],
+        related_commands: ["naive payments receipts", "naive wallet balance"],
+    });
+});
+paymentsCmd
+    .command("receipts")
+    .description("List x402 payment receipts")
+    .option("--direction <direction>", "buy (paid out) | sell (received)")
+    .option("--origin <origin>", "Filter to one resource origin")
+    .option("--since <iso>", "Only receipts at/after an ISO-8601 timestamp")
+    .option("--limit <n>", "Max receipts to return")
+    .action(async (opts) => {
+    const params = new URLSearchParams();
+    if (opts.direction)
+        params.set("direction", opts.direction);
+    if (opts.origin)
+        params.set("origin", opts.origin);
+    if (opts.since)
+        params.set("since", opts.since);
+    if (opts.limit)
+        params.set("limit", String(opts.limit));
+    const qs = params.toString();
+    const resp = await apiRequest("GET", `/v1/payments/receipts${qs ? `?${qs}` : ""}`);
+    handleApiError("payments.receipts", resp);
+    // payReceipts returns a bare row array (not { receipts: [...] }).
+    const receipts = Array.isArray(resp.data) ? resp.data : [];
+    agentOutput({
+        action: "payments.receipts",
+        result: resp.data,
+        next_steps: [{ command: "naive wallet balance", description: "Read the remaining balance" }],
+        hints: [
+            receipts.length === 0
+                ? "No receipts match. This agent has not paid for anything yet."
+                : `${receipts.length} receipt(s). Every settled x402 payment is recorded here.`,
+        ],
+        related_commands: ["naive payments pay", "naive wallet balance"],
+    });
+});
+//# sourceMappingURL=payments.js.map

package/dist/commands/payments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.js","sourceRoot":"","sources":["../../src/commands/payments.ts"],"names":[],"mappings":"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"}

package/dist/commands/people.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const peopleCmd: Command;