@switchbot/openapi-cli 1.1.0 → 1.2.0

package/README.md

@@ -15,6 +15,20 @@ List devices, query live status, send control commands, run scenes, and manage w
 
 ---
 
+## Who is this for?
+
+Three entry points, same binary — pick the one that matches how you use it:
+
+| Audience  | Where to start                                                | What you get                                                                                      |
+|-----------|---------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
+| **Human** | this README ([Quick start](#quick-start))                     | Colored tables, helpful hints on errors, shell completion, `switchbot doctor` self-check.         |
+| **Script**| [Output modes](#output-modes), [Scripting examples](#scripting-examples) | `--json`, `--format=tsv/yaml/id`, `--fields`, stable exit codes, `history replay`, audit log.     |
+| **Agent** | [`docs/agent-guide.md`](./docs/agent-guide.md)                | `switchbot mcp serve` (stdio MCP server), `schema export`, `plan run`, destructive-command guard. |
+
+Under the hood every surface shares the same catalog, cache, and HMAC client — switching between them costs nothing.
+
+---
+
 ## Table of contents
 
 - [Features](#features)
@@ -28,8 +42,13 @@ List devices, query live status, send control commands, run scenes, and manage w
   - [`devices`](#devices--list-status-control)
   - [`scenes`](#scenes--run-manual-scenes)
   - [`webhook`](#webhook--receive-device-events-over-http)
+  - [`batch`](#batch--run-multiple-commands)
+  - [`watch`](#watch--poll-device-status)
+  - [`mcp`](#mcp--model-context-protocol-server)
+  - [`cache`](#cache--inspect-and-clear-local-cache)
   - [`completion`](#completion--shell-tab-completion)
 - [Output modes](#output-modes)
+- [Cache](#cache-1)
 - [Exit codes & error codes](#exit-codes--error-codes)
 - [Environment variables](#environment-variables)
 - [Scripting examples](#scripting-examples)
@@ -47,7 +66,7 @@ List devices, query live status, send control commands, run scenes, and manage w
 - 🎨 **Dual output modes** — colorized tables by default; `--json` passthrough for `jq` and scripting
 - 🔐 **Secure credentials** — HMAC-SHA256 signed requests; config file written with `0600`; env-var override for CI
 - 🔍 **Dry-run mode** — preview every mutating request before it hits the API
-- 🧪 **Fully tested** — 282 Vitest tests, mocked axios, zero network in CI
+- 🧪 **Fully tested** — 592 Vitest tests, mocked axios, zero network in CI
 - ⚡ **Shell completion** — Bash / Zsh / Fish / PowerShell
 
 ## Requirements
@@ -119,15 +138,27 @@ switchbot config show
 
 ## Global options
 
-| Option              | Description                                                              |
-| ------------------- | ------------------------------------------------------------------------ |
-| `--json`            | Print the raw JSON response instead of a formatted table                 |
-| `-v`, `--verbose`   | Log HTTP request/response details to stderr                              |
-| `--dry-run`         | Print mutating requests (POST/PUT/DELETE) without sending them           |
-| `--timeout <ms>`    | HTTP request timeout in milliseconds (default: `30000`)                  |
-| `--config <path>`   | Override credential file location (default: `~/.switchbot/config.json`)  |
-| `-V`, `--version`   | Print the CLI version                                                    |
-| `-h`, `--help`      | Show help for any command or subcommand                                  |
+| Option                      | Description                                                              |
+| --------------------------- | ------------------------------------------------------------------------ |
+| `--json`                    | Print the raw JSON response instead of a formatted table                 |
+| `--format <fmt>`            | Output format: `tsv`, `yaml`, `jsonl`, `json`, `id`                     |
+| `--fields <cols>`           | Comma-separated column names to include (e.g. `deviceId,type`)          |
+| `-v`, `--verbose`           | Log HTTP request/response details to stderr                              |
+| `--dry-run`                 | Print mutating requests (POST/PUT/DELETE) without sending them           |
+| `--timeout <ms>`            | HTTP request timeout in milliseconds (default: `30000`)                  |
+| `--config <path>`           | Override credential file location (default: `~/.switchbot/config.json`) |
+| `--profile <name>`          | Use a named credential profile (`~/.switchbot/profiles/<name>.json`)    |
+| `--cache <dur>`             | Set list and status cache TTL, e.g. `5m`, `1h`, `off`, `auto` (default) |
+| `--cache-list <dur>`        | Set list-cache TTL independently (overrides `--cache`)                   |
+| `--cache-status <dur>`      | Set status-cache TTL independently (default off; overrides `--cache`)   |
+| `--no-cache`                | Disable all cache reads for this invocation                              |
+| `--retry-on-429 <n>`        | Max 429 retry attempts (default: `3`)                                    |
+| `--no-retry`                | Disable automatic 429 retries                                            |
+| `--backoff <strategy>`      | Retry backoff: `exponential` (default) or `linear`                      |
+| `--no-quota`                | Disable local request-quota tracking                                     |
+| `--audit-log [path]`        | Append mutating commands to a JSONL audit log (default path: `~/.switchbot/audit.log`) |
+| `-V`, `--version`           | Print the CLI version                                                    |
+| `-h`, `--help`              | Show help for any command or subcommand                                  |
 
 Every subcommand supports `--help`, and most include a parameter-format reference and examples.
 
@@ -161,10 +192,16 @@ switchbot config show                          # Print current source + masked s
 
 ```bash
 # List all physical devices and IR remote devices
-# Columns: deviceId, deviceName, type, controlType, family, roomID, room, hub, cloud
+# Default columns (4): deviceId, deviceName, type, category
+# Pass --wide for the full 10-column operator view
 switchbot devices list
+switchbot devices list --wide
 switchbot devices list --json | jq '.deviceList[].deviceId'
 
+# IR remotes: type = remoteType (e.g. "TV"), category = "ir"
+# Physical: category = "physical"
+switchbot devices list --format=tsv --fields=deviceId,type,category
+
 # Filter by family / room (family & room info requires the 'src: OpenClaw'
 # header, which this CLI sends on every request)
 switchbot devices list --json | jq '.deviceList[] | select(.familyName == "Home")'
@@ -259,15 +296,115 @@ switchbot completion powershell >> $PROFILE
 
 Supported shells: `bash`, `zsh`, `fish`, `powershell` (`pwsh` is accepted as an alias).
 
-## Output modes
+### `batch` — run multiple commands
+
+```bash
+# Run a sequence of commands from a JSON/YAML file
+switchbot batch run commands.json
+switchbot batch run commands.yaml --dry-run
+
+# Validate a plan file without executing it
+switchbot batch validate commands.json
+```
+
+A batch file is a JSON array of `{ deviceId, command, parameter?, commandType? }` objects.
+
+### `watch` — poll device status
+
+```bash
+# Poll a device's status every 30 s until Ctrl-C
+switchbot watch <deviceId>
+switchbot watch <deviceId> --interval 10s --json
+```
+
+Output is a stream of JSON status objects (with `--json`) or a refreshed table.
+
+### `mcp` — Model Context Protocol server
+
+```bash
+# Start the stdio MCP server (connect via Claude, Cursor, etc.)
+switchbot mcp serve
+```
+
+Exposes 7 MCP tools: `list_devices`, `describe_device`, `get_device_status`, `send_command`, `list_scenes`, `run_scene`, `search_catalog`.
+See [`docs/agent-guide.md`](./docs/agent-guide.md) for the full tool reference and safety rules (destructive-command guard).
+
+### `cache` — inspect and clear local cache
+
+```bash
+# Show cache status (paths, age, entry counts)
+switchbot cache show
+
+# Clear everything
+switchbot cache clear
+
+# Clear only the device-list cache or only the status cache
+switchbot cache clear --key list
+switchbot cache clear --key status
+```
+
+
 
 - **Default** — ANSI-colored tables for `list`/`status`, key-value tables for details.
-- **`--json`** — raw JSON passthrough, ideal for `jq` and scripting.
+- **`--json`** — raw API payload passthrough. Output is the exact JSON the SwitchBot API returned, ideal for `jq` and scripting. Errors are also JSON on stderr: `{ "error": { "code", "kind", "message", "hint?" } }`.
+- **`--format=json`** — projected row view. Same JSON structure but built from the CLI's column model (`--fields` applies). Use this when you only want specific fields.
+- **`--format=tsv|yaml|jsonl|id`** — tabular text formats; `--fields` filters columns.
 
 ```bash
+# Raw API payload (--json)
 switchbot devices list --json | jq '.deviceList[] | {id: .deviceId, name: .deviceName}'
+
+# Projected rows with field filter (--format)
+switchbot devices list --format tsv --fields deviceId,deviceName,type,cloud
+switchbot devices list --format id      # one deviceId per line
+switchbot devices status <id> --format yaml
 ```
 
+## Cache
+
+The CLI maintains two local disk caches under `~/.switchbot/`:
+
+| File | Contents | Default TTL |
+| ---- | -------- | ----------- |
+| `devices.json` | Device metadata (id, name, type, category, hub, room…) | 1 hour |
+| `status.json`  | Per-device status bodies | off (0) |
+
+The device-list cache powers offline validation (command name checks, destructive-command guard) and the MCP server's `send_command` tool. It is refreshed automatically on every `devices list` call.
+
+### Cache control flags
+
+```bash
+# Turn off all cache reads for one invocation
+switchbot devices list --no-cache
+
+# Set both list and status TTL to 5 minutes
+switchbot devices status <id> --cache 5m
+
+# Set TTLs independently
+switchbot devices status <id> --cache-list 2h --cache-status 30s
+
+# Disable only the list cache (keep status cache at its current TTL)
+switchbot devices list --cache-list 0
+```
+
+### Cache management commands
+
+```bash
+# Show paths, age, and entry counts
+switchbot cache show
+
+# Clear all cached data
+switchbot cache clear
+
+# Scope the clear to one store
+switchbot cache clear --key list
+switchbot cache clear --key status
+```
+
+### Status-cache GC
+
+`status.json` entries are automatically evicted after 24 hours (or 10× the configured status TTL, whichever is longer), so the file cannot grow without bound even when the status cache is left enabled long-term.
+
 ## Exit codes & error codes
 
 | Code | Meaning                                                                                                                   |
@@ -318,7 +455,7 @@ npm install
 
 npm run dev -- <args>       # Run from TypeScript sources via tsx
 npm run build               # Compile to dist/
-npm test                    # Run the Vitest suite (282 tests)
+npm test                    # Run the Vitest suite (592 tests)
 npm run test:watch          # Watch mode
 npm run test:coverage       # Coverage report (v8, HTML + text)
 ```
@@ -332,17 +469,36 @@ src/
 ├── config.ts             # Credential load/save; env > file priority; --config override
 ├── api/client.ts         # axios instance + request/response interceptors;
 │                         # --verbose / --dry-run / --timeout wiring
-├── devices/catalog.ts    # Static catalog powering `devices types`/`devices commands`
+├── devices/
+│   ├── catalog.ts        # Static device catalog (commands, params, status fields)
+│   └── cache.ts          # Disk + in-memory cache for device list and status
+├── lib/
+│   └── devices.ts        # Shared logic: listDevices, describeDevice, isDestructiveCommand
 ├── commands/
 │   ├── config.ts
 │   ├── devices.ts
 │   ├── scenes.ts
 │   ├── webhook.ts
+│   ├── batch.ts          # `switchbot batch run/validate`
+│   ├── watch.ts          # `switchbot watch <deviceId>`
+│   ├── mcp.ts            # `switchbot mcp serve` (MCP stdio server)
+│   ├── cache.ts          # `switchbot cache show/clear`
+│   ├── history.ts        # `switchbot history [replay]`
+│   ├── events.ts         # `switchbot events`
+│   ├── quota.ts          # `switchbot quota`
+│   ├── explain.ts        # `switchbot explain <deviceId>`
+│   ├── plan.ts           # `switchbot plan run <file>`
+│   ├── doctor.ts         # `switchbot doctor`
+│   ├── schema.ts         # `switchbot schema export`
+│   ├── catalog.ts        # `switchbot catalog search`
 │   └── completion.ts     # `switchbot completion bash|zsh|fish|powershell`
 └── utils/
-    ├── flags.ts          # Global flag readers (isVerbose / isDryRun / getTimeout / getConfigPath)
-    └── output.ts         # printTable / printKeyValue / printJson / handleError
-tests/                    # Vitest suite (282 tests, mocked axios, no network)
+    ├── flags.ts          # Global flag readers (isVerbose / isDryRun / getCacheMode / …)
+    ├── output.ts         # printTable / printKeyValue / printJson / handleError / buildErrorPayload
+    ├── format.ts         # renderRows / filterFields / output-format dispatch
+    ├── audit.ts          # JSONL audit log writer
+    └── quota.ts          # Local daily-quota counter
+tests/                    # Vitest suite (592 tests, mocked axios, no network)
 ```
 
 ### Release flow

package/dist/api/client.d.ts

@@ -6,7 +6,13 @@ export declare class DryRunSignal extends Error {
     constructor(method: string, url: string);
 }
 export declare function createClient(): AxiosInstance;
+export interface ApiErrorMeta {
+    retryable?: boolean;
+    hint?: string;
+}
 export declare class ApiError extends Error {
     readonly code: number;
-    constructor(message: string, code: number);
+    readonly retryable: boolean;
+    readonly hint?: string;
+    constructor(message: string, code: number, meta?: ApiErrorMeta);
 }

package/dist/api/client.js

@@ -2,7 +2,9 @@ import axios from 'axios';
 import chalk from 'chalk';
 import { buildAuthHeaders } from '../auth.js';
 import { loadConfig } from '../config.js';
-import { isVerbose, isDryRun, getTimeout } from '../utils/flags.js';
+import { isVerbose, isDryRun, getTimeout, getRetryOn429, getBackoffStrategy, isQuotaDisabled, } from '../utils/flags.js';
+import { nextRetryDelayMs, sleep } from '../utils/retry.js';
+import { recordRequest } from '../utils/quota.js';
 const API_ERROR_MESSAGES = {
     151: 'Device type does not support this command',
     152: 'Device ID does not exist',
@@ -26,6 +28,9 @@ export function createClient() {
     const { token, secret } = loadConfig();
     const verbose = isVerbose();
     const dryRun = isDryRun();
+    const maxRetries = getRetryOn429();
+    const backoff = getBackoffStrategy();
+    const quotaEnabled = !isQuotaDisabled();
     const client = axios.create({
         baseURL: 'https://api.switch-bot.com',
         timeout: getTimeout(),
@@ -43,9 +48,9 @@ export function createClient() {
             }
         }
         if (dryRun && method !== 'GET') {
-            console.log(chalk.yellow(`[dry-run] Would ${method} ${url}`));
+            process.stderr.write(chalk.yellow(`[dry-run] Would ${method} ${url}\n`));
             if (config.data !== undefined) {
-                console.log(chalk.yellow(`[dry-run] body: ${JSON.stringify(config.data)}`));
+                process.stderr.write(chalk.yellow(`[dry-run] body: ${JSON.stringify(config.data)}\n`));
             }
             throw new DryRunSignal(method, url);
         }
@@ -56,6 +61,11 @@ export function createClient() {
         if (verbose) {
             process.stderr.write(chalk.grey(`[verbose] ${response.status} ${response.statusText}\n`));
         }
+        if (quotaEnabled && response.config) {
+            const method = (response.config.method ?? 'get').toUpperCase();
+            const url = `${response.config.baseURL ?? ''}${response.config.url ?? ''}`;
+            recordRequest(method, url);
+        }
         const data = response.data;
         if (data.statusCode !== undefined && data.statusCode !== 100) {
             const msg = API_ERROR_MESSAGES[data.statusCode] ??
@@ -69,16 +79,38 @@ export function createClient() {
             throw error;
         if (axios.isAxiosError(error)) {
             if (error.code === 'ECONNABORTED' || error.code === 'ETIMEDOUT') {
-                throw new ApiError(`Request timed out after ${getTimeout()}ms (override with --timeout <ms>)`, 0);
+                throw new ApiError(`Request timed out after ${getTimeout()}ms (override with --timeout <ms>)`, 0, { retryable: false });
             }
             const status = error.response?.status;
+            const config = error.config;
+            // 429 → transparent retry with Retry-After / exponential backoff.
+            // Skipped when: no config (shouldn't happen for real axios errors),
+            // retries disabled, or we've already used our budget.
+            if (status === 429 && config && maxRetries > 0) {
+                const attempt = config.__retryCount ?? 0;
+                if (attempt < maxRetries) {
+                    config.__retryCount = attempt + 1;
+                    const delay = nextRetryDelayMs(attempt, backoff, error.response?.headers?.['retry-after']);
+                    if (verbose) {
+                        process.stderr.write(chalk.grey(`[verbose] 429 received — retry ${attempt + 1}/${maxRetries} in ${delay}ms\n`));
+                    }
+                    return sleep(delay).then(() => client.request(config));
+                }
+            }
+            // Record exhausted/non-retryable HTTP responses too — they count
+            // against the daily quota.
+            if (quotaEnabled && error.response && config) {
+                const method = (config.method ?? 'get').toUpperCase();
+                const url = `${config.baseURL ?? ''}${config.url ?? ''}`;
+                recordRequest(method, url);
+            }
             if (status === 401) {
-                throw new ApiError('Authentication failed: invalid token or daily 10,000-request quota exceeded', 401);
+                throw new ApiError('Authentication failed: invalid token or daily 10,000-request quota exceeded', 401, { retryable: false, hint: 'Run `switchbot config set-token <token> <secret>` to re-enter credentials, or `switchbot quota status` to check today\'s local count.' });
             }
             if (status === 429) {
-                throw new ApiError('Request rate too high: daily 10,000-request quota exceeded', 429);
+                throw new ApiError('Request rate too high: daily 10,000-request quota exceeded (retries exhausted)', 429, { retryable: true, hint: 'Use `switchbot quota status` to see today\'s usage; raise `--retry-on-429 <n>` for more retries.' });
             }
-            throw new ApiError(`HTTP ${status ?? '?'}: ${error.message}`, status ?? 0);
+            throw new ApiError(`HTTP ${status ?? '?'}: ${error.message}`, status ?? 0, { retryable: status !== undefined && status >= 500 });
         }
         throw error;
     });
@@ -86,10 +118,14 @@ export function createClient() {
 }
 export class ApiError extends Error {
     code;
-    constructor(message, code) {
+    retryable;
+    hint;
+    constructor(message, code, meta = {}) {
         super(message);
         this.code = code;
         this.name = 'ApiError';
+        this.retryable = meta.retryable ?? false;
+        this.hint = meta.hint;
     }
 }
 //# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/commands/batch.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerBatchCommand(devices: Command): void;

package/dist/commands/batch.js

@@ -0,0 +1,252 @@
+import { printJson, isJsonMode, handleError } from '../utils/output.js';
+import { fetchDeviceList, executeCommand, isDestructiveCommand, buildHubLocationMap, } from '../lib/devices.js';
+import { parseFilter, applyFilter, FilterSyntaxError } from '../utils/filter.js';
+import { isDryRun } from '../utils/flags.js';
+import { DryRunSignal } from '../api/client.js';
+const DEFAULT_CONCURRENCY = 5;
+/** Run `task(x)` for every element with at most `concurrency` running at once. */
+async function runPool(items, concurrency, task) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const workers = [];
+    const width = Math.max(1, Math.min(concurrency, items.length));
+    for (let w = 0; w < width; w++) {
+        workers.push((async () => {
+            while (cursor < items.length) {
+                const idx = cursor++;
+                results[idx] = await task(items[idx]);
+                // Tiny jitter between starts so we don't hammer the endpoint in a
+                // perfectly aligned burst. Keeps the default concurrency=5 polite.
+                await new Promise((r) => setTimeout(r, 20 + Math.random() * 40));
+            }
+        })());
+    }
+    await Promise.all(workers);
+    return results;
+}
+async function resolveTargetIds(options) {
+    const explicit = [];
+    if (options.ids) {
+        for (const id of options.ids.split(',').map((s) => s.trim()).filter(Boolean)) {
+            explicit.push(id);
+        }
+    }
+    if (options.readStdin) {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        const raw = Buffer.concat(chunks).toString('utf-8');
+        for (const line of raw.split(/\r?\n/)) {
+            const id = line.trim();
+            if (id)
+                explicit.push(id);
+        }
+    }
+    const hasFilter = Boolean(options.filter);
+    if (explicit.length === 0 && !hasFilter) {
+        throw new Error('No target devices supplied — provide --ids, --filter, or pass "-" to read deviceIds from stdin.');
+    }
+    // Always fetch the device list so we can (a) apply --filter when present
+    // and (b) build a deviceId → deviceType map for destructive/validation
+    // checks regardless of how the ids were provided.
+    const body = await fetchDeviceList();
+    const hubLoc = buildHubLocationMap(body.deviceList);
+    const typeMap = new Map();
+    for (const d of body.deviceList)
+        if (d.deviceType)
+            typeMap.set(d.deviceId, d.deviceType);
+    for (const ir of body.infraredRemoteList)
+        typeMap.set(ir.deviceId, ir.remoteType);
+    let ids;
+    if (hasFilter) {
+        const clauses = parseFilter(options.filter);
+        const matched = applyFilter(clauses, body.deviceList, body.infraredRemoteList, hubLoc);
+        const filteredIds = new Set(matched.map((m) => m.deviceId));
+        ids =
+            explicit.length > 0 ? explicit.filter((id) => filteredIds.has(id)) : [...filteredIds];
+    }
+    else {
+        ids = explicit;
+    }
+    return { ids, typeMap };
+}
+export function registerBatchCommand(devices) {
+    devices
+        .command('batch')
+        .description('Send the same command to many devices in one run (filter- or stdin-driven)')
+        .argument('<command>', 'Command name, e.g. turnOn, turnOff, setBrightness')
+        .argument('[parameter]', 'Command parameter (same rules as `devices command`; omit for no-arg)')
+        .option('--filter <expr>', 'Target devices matching a filter, e.g. type=Bot,family=Home')
+        .option('--ids <csv>', 'Explicit comma-separated list of deviceIds')
+        .option('--concurrency <n>', 'Max parallel in-flight requests (default 5)', '5')
+        .option('--yes', 'Allow destructive commands (Smart Lock unlock, garage open, ...)')
+        .option('--type <commandType>', '"command" (default) or "customize" for user-defined IR buttons', 'command')
+        .option('--stdin', 'Read deviceIds from stdin, one per line (same as trailing "-")')
+        .addHelpText('after', `
+Targets are resolved in this priority order:
+  1. --ids when present       (explicit deviceIds)
+  2. stdin when --stdin / "-" (one deviceId per line)
+  3. --filter                 (matches the account's device list)
+  You can combine explicit ids with --filter to intersect them.
+
+Filter grammar:
+  key=value          exact match
+  key~=value         case-insensitive substring match
+  clauses are comma-separated AND
+
+Supported keys:  type, family, room, category  (category: physical | ir)
+
+Output:
+  Human mode:  one status line per device, summary at the end.
+  --json:      {succeeded[], failed[{deviceId,error}], summary:{total,ok,failed,skipped,durationMs}}
+
+Safety:
+  Destructive commands (Smart Lock unlock, Garage Door Opener turnOn/turnOff,
+  Keypad createKey/deleteKey) are blocked by default. Pass --yes to override.
+  --dry-run intercepts every POST and reports the intended calls without
+  hitting the API.
+
+Examples:
+  $ switchbot devices batch turnOff --filter 'type~=Light,family=家里'
+  $ switchbot devices batch turnOn --ids ID1,ID2,ID3
+  $ switchbot devices list --format=id --filter 'type=Bot' | switchbot devices batch toggle -
+  $ switchbot devices batch unlock --filter 'type=Smart Lock' --yes
+`)
+        .action(async (cmd, parameter, options, commandObj) => {
+        // Trailing "-" sentinel selects stdin mode.
+        const extra = commandObj.args ?? [];
+        const readStdin = Boolean(options.stdin) || extra.includes('-');
+        let resolved;
+        try {
+            resolved = await resolveTargetIds({
+                filter: options.filter,
+                ids: options.ids,
+                readStdin,
+            });
+        }
+        catch (error) {
+            if (error instanceof FilterSyntaxError) {
+                if (isJsonMode()) {
+                    console.error(JSON.stringify({ error: { code: 2, kind: 'usage', message: error.message } }));
+                }
+                else {
+                    console.error(`Error: ${error.message}`);
+                }
+                process.exit(2);
+            }
+            if (error instanceof Error && error.message.startsWith('No target devices')) {
+                if (isJsonMode()) {
+                    console.error(JSON.stringify({ error: { code: 2, kind: 'usage', message: error.message } }));
+                }
+                else {
+                    console.error(`Error: ${error.message}`);
+                }
+                process.exit(2);
+            }
+            handleError(error);
+        }
+        if (resolved.ids.length === 0) {
+            const out = {
+                succeeded: [],
+                failed: [],
+                summary: { total: 0, ok: 0, failed: 0, skipped: 0, durationMs: 0 },
+            };
+            if (isJsonMode())
+                printJson(out);
+            else
+                console.log('No devices matched — nothing to do.');
+            return;
+        }
+        const effectiveType = (options.type === 'customize' ? 'customize' : 'command');
+        // Pre-flight: identify destructive targets before spending API calls.
+        const blockedForDestructive = [];
+        for (const id of resolved.ids) {
+            const t = resolved.typeMap.get(id);
+            if (isDestructiveCommand(t, cmd, effectiveType) && !options.yes) {
+                blockedForDestructive.push({
+                    deviceId: id,
+                    reason: `destructive command "${cmd}" on ${t ?? 'unknown'} requires --yes`,
+                });
+            }
+        }
+        if (blockedForDestructive.length > 0 && !options.yes) {
+            if (isJsonMode()) {
+                const deviceIds = blockedForDestructive.map((b) => b.deviceId);
+                console.error(JSON.stringify({
+                    error: {
+                        code: 2,
+                        kind: 'guard',
+                        message: `Destructive command "${cmd}" requires --yes to run on ${blockedForDestructive.length} device(s).`,
+                        hint: 'Re-issue the call with --yes to proceed.',
+                        context: { command: cmd, deviceIds },
+                    },
+                }));
+            }
+            else {
+                console.error(`Refusing to run destructive command "${cmd}" on ${blockedForDestructive.length} device(s) without --yes:`);
+                for (const b of blockedForDestructive)
+                    console.error(`  ${b.deviceId}`);
+            }
+            process.exit(2);
+        }
+        // parameter may be a JSON object string; mirror the single-command action.
+        let parsedParam = parameter ?? 'default';
+        if (parameter) {
+            try {
+                parsedParam = JSON.parse(parameter);
+            }
+            catch {
+                // keep as string
+            }
+        }
+        const concurrency = Math.max(1, Number.parseInt(options.concurrency, 10) || DEFAULT_CONCURRENCY);
+        const dryRun = isDryRun();
+        const startedAt = Date.now();
+        const outcomes = await runPool(resolved.ids, concurrency, async (id) => {
+            try {
+                const result = await executeCommand(id, cmd, parsedParam, effectiveType);
+                if (!isJsonMode()) {
+                    console.log(`✓ ${id}: ${cmd}`);
+                }
+                return { ok: true, deviceId: id, result };
+            }
+            catch (err) {
+                // --dry-run uses DryRunSignal to short-circuit; surface that as a
+                // "skipped" outcome, not a failure.
+                if (err instanceof DryRunSignal) {
+                    return { ok: 'dry-run', deviceId: id };
+                }
+                const message = err instanceof Error ? err.message : String(err);
+                if (!isJsonMode()) {
+                    console.error(`✗ ${id}: ${message}`);
+                }
+                return { ok: false, deviceId: id, error: message };
+            }
+        });
+        const succeeded = outcomes.filter((o) => o.ok === true);
+        const failed = outcomes.filter((o) => o.ok === false);
+        const dryRunned = outcomes.filter((o) => o.ok === 'dry-run');
+        const result = {
+            succeeded: succeeded.map((s) => ({ deviceId: s.deviceId, result: s.result })),
+            failed: failed.map((f) => ({ deviceId: f.deviceId, error: f.error })),
+            summary: {
+                total: resolved.ids.length,
+                ok: succeeded.length,
+                failed: failed.length,
+                skipped: dryRunned.length,
+                durationMs: Date.now() - startedAt,
+                ...(dryRun ? { dryRun: true } : {}),
+            },
+        };
+        if (isJsonMode()) {
+            printJson(result);
+        }
+        else {
+            console.log(`\nSummary: ${result.summary.ok} ok, ${result.summary.failed} failed, ${result.summary.skipped} skipped (${result.summary.durationMs}ms)`);
+        }
+        // Non-zero exit when anything failed so scripts can react.
+        if (failed.length > 0)
+            process.exit(1);
+    });
+}
+//# sourceMappingURL=batch.js.map