@switchbot/openapi-cli 1.1.0 → 1.2.0

package/dist/commands/plan.js

@@ -0,0 +1,344 @@
+import fs from 'node:fs';
+import { printJson, isJsonMode, handleError } from '../utils/output.js';
+import { executeCommand, isDestructiveCommand } from '../lib/devices.js';
+import { executeScene } from '../lib/scenes.js';
+import { getCachedDevice } from '../devices/cache.js';
+const PLAN_JSON_SCHEMA = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://switchbot.dev/plan-1.0.json',
+    title: 'SwitchBot Plan',
+    description: 'Declarative batch of SwitchBot operations. Agent-authored; CLI validates and executes. No LLM inside the CLI — the schema is the contract.',
+    type: 'object',
+    required: ['version', 'steps'],
+    properties: {
+        version: { const: '1.0' },
+        description: { type: 'string' },
+        steps: {
+            type: 'array',
+            items: {
+                oneOf: [
+                    {
+                        type: 'object',
+                        required: ['type', 'deviceId', 'command'],
+                        properties: {
+                            type: { const: 'command' },
+                            deviceId: { type: 'string', minLength: 1 },
+                            command: { type: 'string', minLength: 1 },
+                            parameter: {},
+                            commandType: { enum: ['command', 'customize'] },
+                            note: { type: 'string' },
+                        },
+                        additionalProperties: false,
+                    },
+                    {
+                        type: 'object',
+                        required: ['type', 'sceneId'],
+                        properties: {
+                            type: { const: 'scene' },
+                            sceneId: { type: 'string', minLength: 1 },
+                            note: { type: 'string' },
+                        },
+                        additionalProperties: false,
+                    },
+                    {
+                        type: 'object',
+                        required: ['type', 'ms'],
+                        properties: {
+                            type: { const: 'wait' },
+                            ms: { type: 'integer', minimum: 0, maximum: 600000 },
+                            note: { type: 'string' },
+                        },
+                        additionalProperties: false,
+                    },
+                ],
+            },
+        },
+    },
+    additionalProperties: false,
+};
+export function validatePlan(raw) {
+    const issues = [];
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return { ok: false, issues: [{ path: '$', message: 'plan must be a JSON object' }] };
+    }
+    const p = raw;
+    if (p.version !== '1.0') {
+        issues.push({ path: 'version', message: 'must equal "1.0"' });
+    }
+    if (!Array.isArray(p.steps)) {
+        issues.push({ path: 'steps', message: 'must be an array' });
+        return { ok: false, issues };
+    }
+    p.steps.forEach((step, i) => {
+        const at = `steps[${i}]`;
+        if (!step || typeof step !== 'object') {
+            issues.push({ path: at, message: 'must be an object' });
+            return;
+        }
+        const s = step;
+        switch (s.type) {
+            case 'command':
+                if (typeof s.deviceId !== 'string' || !s.deviceId) {
+                    issues.push({ path: `${at}.deviceId`, message: 'must be a non-empty string' });
+                }
+                if (typeof s.command !== 'string' || !s.command) {
+                    issues.push({ path: `${at}.command`, message: 'must be a non-empty string' });
+                }
+                if (s.commandType !== undefined &&
+                    s.commandType !== 'command' &&
+                    s.commandType !== 'customize') {
+                    issues.push({
+                        path: `${at}.commandType`,
+                        message: 'must be "command" or "customize"',
+                    });
+                }
+                break;
+            case 'scene':
+                if (typeof s.sceneId !== 'string' || !s.sceneId) {
+                    issues.push({ path: `${at}.sceneId`, message: 'must be a non-empty string' });
+                }
+                break;
+            case 'wait':
+                if (typeof s.ms !== 'number' || !Number.isInteger(s.ms) || s.ms < 0 || s.ms > 600_000) {
+                    issues.push({
+                        path: `${at}.ms`,
+                        message: 'must be an integer in [0, 600000]',
+                    });
+                }
+                break;
+            default:
+                issues.push({
+                    path: `${at}.type`,
+                    message: 'must be one of "command" | "scene" | "wait"',
+                });
+        }
+    });
+    if (issues.length > 0)
+        return { ok: false, issues };
+    return { ok: true, plan: raw };
+}
+async function readPlanSource(file) {
+    const text = file === undefined || file === '-'
+        ? await readStdin()
+        : fs.readFileSync(file, 'utf8');
+    if (!text.trim()) {
+        throw new Error(file === undefined || file === '-'
+            ? 'no plan received on stdin'
+            : `plan file is empty: ${file}`);
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (err) {
+        throw new Error(`plan is not valid JSON: ${err.message}`);
+    }
+}
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        let buf = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => (buf += chunk));
+        process.stdin.on('end', () => resolve(buf));
+        process.stdin.on('error', reject);
+    });
+}
+export function registerPlanCommand(program) {
+    const plan = program
+        .command('plan')
+        .description('Agent-authored batch plans: schema, validate, run')
+        .addHelpText('after', `
+A "plan" is a JSON document describing a sequence of commands/scenes/waits.
+The schema is fixed — agents emit plans, the CLI executes them. No LLM inside.
+
+  { "version": "1.0", "description": "...", "steps": [
+      { "type": "command", "deviceId": "...", "command": "turnOff" },
+      { "type": "wait", "ms": 500 },
+      { "type": "scene",  "sceneId": "..." }
+  ]}
+
+Workflow:
+  $ switchbot plan schema > plan.schema.json     # export the contract
+  $ switchbot plan validate my-plan.json          # check shape without running
+  $ switchbot --dry-run plan run my-plan.json     # preview (mutations skipped)
+  $ switchbot plan run my-plan.json --yes         # execute destructive steps
+  $ cat plan.json | switchbot plan run -          # or stream via stdin
+`);
+    plan
+        .command('schema')
+        .description('Print the JSON Schema for the plan format')
+        .action(() => {
+        printJson(PLAN_JSON_SCHEMA);
+    });
+    plan
+        .command('validate')
+        .description('Validate a plan file (or stdin) against the schema')
+        .argument('[file]', 'Path to plan.json, or "-" / omit to read stdin')
+        .action(async (file) => {
+        let raw;
+        try {
+            raw = await readPlanSource(file);
+        }
+        catch (err) {
+            handleError(err);
+        }
+        const result = validatePlan(raw);
+        if (!result.ok) {
+            if (isJsonMode()) {
+                printJson({ valid: false, issues: result.issues });
+            }
+            else {
+                console.error('✗ plan invalid:');
+                for (const i of result.issues) {
+                    console.error(`  ${i.path}: ${i.message}`);
+                }
+            }
+            process.exit(2);
+        }
+        if (isJsonMode()) {
+            printJson({ valid: true, steps: result.plan.steps.length });
+        }
+        else {
+            console.log(`✓ plan valid (${result.plan.steps.length} step${result.plan.steps.length === 1 ? '' : 's'})`);
+        }
+    });
+    plan
+        .command('run')
+        .description('Validate + execute a plan. Respects --dry-run; destructive steps require --yes')
+        .argument('[file]', 'Path to plan.json, or "-" / omit to read stdin')
+        .option('--yes', 'Authorize destructive commands (e.g. Smart Lock unlock, Garage open)')
+        .option('--continue-on-error', 'Keep running after a failed step (default: stop at first error)')
+        .action(async (file, options) => {
+        let raw;
+        try {
+            raw = await readPlanSource(file);
+        }
+        catch (err) {
+            handleError(err);
+        }
+        const v = validatePlan(raw);
+        if (!v.ok) {
+            if (isJsonMode()) {
+                printJson({ ran: false, issues: v.issues });
+            }
+            else {
+                console.error('✗ plan invalid, refusing to run:');
+                for (const i of v.issues)
+                    console.error(`  ${i.path}: ${i.message}`);
+            }
+            process.exit(2);
+        }
+        const out = {
+            plan: v.plan,
+            results: [],
+            summary: { total: v.plan.steps.length, ok: 0, error: 0, skipped: 0 },
+        };
+        try {
+            for (let i = 0; i < v.plan.steps.length; i++) {
+                const step = v.plan.steps[i];
+                const idx = i + 1;
+                if (step.type === 'wait') {
+                    await new Promise((r) => setTimeout(r, step.ms));
+                    out.results.push({ step: idx, type: 'wait', ms: step.ms, status: 'ok' });
+                    out.summary.ok++;
+                    if (!isJsonMode())
+                        console.log(`  ${idx}. wait ${step.ms}ms`);
+                    continue;
+                }
+                if (step.type === 'scene') {
+                    try {
+                        await executeScene(step.sceneId);
+                        out.results.push({ step: idx, type: 'scene', sceneId: step.sceneId, status: 'ok' });
+                        out.summary.ok++;
+                        if (!isJsonMode())
+                            console.log(`  ${idx}. ✓ scene ${step.sceneId}`);
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        out.results.push({ step: idx, type: 'scene', sceneId: step.sceneId, status: 'error', error: msg });
+                        out.summary.error++;
+                        if (!isJsonMode())
+                            console.log(`  ${idx}. ✗ scene ${step.sceneId}: ${msg}`);
+                        if (!options.continueOnError)
+                            break;
+                    }
+                    continue;
+                }
+                // command
+                const deviceType = getCachedDevice(step.deviceId)?.type;
+                const commandType = step.commandType ?? 'command';
+                const destructive = isDestructiveCommand(deviceType, step.command, commandType);
+                if (destructive && !options.yes) {
+                    out.results.push({
+                        step: idx,
+                        type: 'command',
+                        deviceId: step.deviceId,
+                        command: step.command,
+                        status: 'skipped',
+                        error: 'destructive — rerun with --yes',
+                    });
+                    out.summary.skipped++;
+                    if (!isJsonMode())
+                        console.log(`  ${idx}. ⚠ skipped ${step.command} on ${step.deviceId} (destructive — pass --yes)`);
+                    if (!options.continueOnError)
+                        break;
+                    continue;
+                }
+                try {
+                    await executeCommand(step.deviceId, step.command, step.parameter, commandType);
+                    out.results.push({
+                        step: idx,
+                        type: 'command',
+                        deviceId: step.deviceId,
+                        command: step.command,
+                        status: 'ok',
+                    });
+                    out.summary.ok++;
+                    if (!isJsonMode())
+                        console.log(`  ${idx}. ✓ ${step.command} on ${step.deviceId}`);
+                }
+                catch (err) {
+                    if (err instanceof Error && err.name === 'DryRunSignal') {
+                        out.results.push({
+                            step: idx,
+                            type: 'command',
+                            deviceId: step.deviceId,
+                            command: step.command,
+                            status: 'ok',
+                        });
+                        out.summary.ok++;
+                        if (!isJsonMode())
+                            console.log(`  ${idx}. ◦ dry-run ${step.command} on ${step.deviceId}`);
+                        continue;
+                    }
+                    const msg = err instanceof Error ? err.message : String(err);
+                    out.results.push({
+                        step: idx,
+                        type: 'command',
+                        deviceId: step.deviceId,
+                        command: step.command,
+                        status: 'error',
+                        error: msg,
+                    });
+                    out.summary.error++;
+                    if (!isJsonMode())
+                        console.log(`  ${idx}. ✗ ${step.command} on ${step.deviceId}: ${msg}`);
+                    if (!options.continueOnError)
+                        break;
+                }
+            }
+            if (isJsonMode()) {
+                printJson({ ran: true, ...out });
+            }
+            else {
+                const { ok, error, skipped, total } = out.summary;
+                console.log(`\nsummary: ok=${ok} error=${error} skipped=${skipped} total=${total}`);
+            }
+        }
+        catch (err) {
+            handleError(err);
+        }
+        if (out.summary.error > 0)
+            process.exit(1);
+    });
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

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

package/dist/commands/quota.d.ts

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

package/dist/commands/quota.js

@@ -0,0 +1,77 @@
+import { printJson, isJsonMode } from '../utils/output.js';
+import { DAILY_QUOTA, loadQuota, resetQuota, todayUsage, } from '../utils/quota.js';
+export function registerQuotaCommand(program) {
+    const quota = program
+        .command('quota')
+        .description('Inspect and manage the local SwitchBot API request counter')
+        .addHelpText('after', `
+Every request the CLI makes is counted locally in ~/.switchbot/quota.json.
+Counts are bucketed by local date, one record per endpoint pattern. This
+is a best-effort mirror of the SwitchBot 10,000/day limit — it does not
+include requests made outside this CLI (mobile app, other scripts).
+
+Subcommands:
+  status   Show today's usage and the last 7 days
+  reset    Delete the local counter file
+
+Examples:
+  $ switchbot quota status
+  $ switchbot quota status --json
+  $ switchbot quota reset
+`);
+    quota
+        .command('status')
+        .description("Show today's usage and the last 7 days")
+        .action(() => {
+        const usage = todayUsage();
+        const history = loadQuota();
+        if (isJsonMode()) {
+            printJson({
+                today: {
+                    date: usage.date,
+                    total: usage.total,
+                    remaining: usage.remaining,
+                    dailyLimit: DAILY_QUOTA,
+                    endpoints: usage.endpoints,
+                },
+                history: history.days,
+            });
+            return;
+        }
+        console.log(`Today (${usage.date}):`);
+        console.log(`  Requests used:      ${usage.total} / ${DAILY_QUOTA}`);
+        console.log(`  Remaining budget:   ${usage.remaining}`);
+        if (Object.keys(usage.endpoints).length === 0) {
+            console.log('  (no requests recorded yet)');
+        }
+        else {
+            console.log('  Endpoint breakdown:');
+            const entries = Object.entries(usage.endpoints).sort((a, b) => b[1] - a[1]);
+            for (const [endpoint, count] of entries) {
+                console.log(`    ${endpoint.padEnd(48)} ${count}`);
+            }
+        }
+        const otherDays = Object.entries(history.days)
+            .filter(([d]) => d !== usage.date)
+            .sort((a, b) => b[0].localeCompare(a[0]));
+        if (otherDays.length > 0) {
+            console.log('\nRecent history:');
+            for (const [date, bucket] of otherDays) {
+                console.log(`  ${date}  ${bucket.total}`);
+            }
+        }
+    });
+    quota
+        .command('reset')
+        .description('Delete the local quota counter file')
+        .action(() => {
+        resetQuota();
+        if (isJsonMode()) {
+            printJson({ reset: true });
+        }
+        else {
+            console.log('Quota counter reset.');
+        }
+    });
+}
+//# sourceMappingURL=quota.js.map

package/dist/commands/quota.js.map

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

package/dist/commands/scenes.js

@@ -1,5 +1,6 @@
-import { createClient } from '../api/client.js';
-import { printTable, printJson, isJsonMode, handleError } from '../utils/output.js';
+import { printJson, isJsonMode, handleError } from '../utils/output.js';
+import { resolveFormat, resolveFields, renderRows } from '../utils/format.js';
+import { fetchScenes, executeScene } from '../lib/scenes.js';
 export function registerScenesCommand(program) {
     const scenes = program
         .command('scenes')
@@ -10,25 +11,26 @@ export function registerScenesCommand(program) {
         .description('List all manual scenes (scenes created in the SwitchBot app)')
         .addHelpText('after', `
 Output columns: sceneId, sceneName
+--fields accepts any subset of these names (exit 2 on unknown names).
 
 Examples:
   $ switchbot scenes list
+  $ switchbot scenes list --format tsv --fields sceneId,sceneName
+  $ switchbot scenes list --format id
   $ switchbot scenes list --json
 `)
         .action(async () => {
         try {
-            const client = createClient();
-            const res = await client.get('/v1.1/scenes');
-            if (isJsonMode()) {
-                printJson(res.data.body);
+            const scenes = await fetchScenes();
+            const fmt = resolveFormat();
+            if (fmt === 'json' && process.argv.includes('--json')) {
+                printJson(scenes);
                 return;
             }
-            const scenes = res.data.body;
-            if (scenes.length === 0) {
+            renderRows(['sceneId', 'sceneName'], scenes.map((s) => [s.sceneId, s.sceneName]), fmt, resolveFields());
+            if (fmt === 'table' && scenes.length === 0) {
                 console.log('No scenes found');
-                return;
             }
-            printTable(['sceneId', 'sceneName'], scenes.map((s) => [s.sceneId, s.sceneName]));
         }
         catch (error) {
             handleError(error);
@@ -45,9 +47,13 @@ Example:
 `)
         .action(async (sceneId) => {
         try {
-            const client = createClient();
-            await client.post(`/v1.1/scenes/${sceneId}/execute`);
-            console.log(`✓ Scene executed: ${sceneId}`);
+            await executeScene(sceneId);
+            if (isJsonMode()) {
+                printJson({ ok: true, sceneId });
+            }
+            else {
+                console.log(`✓ Scene executed: ${sceneId}`);
+            }
         }
         catch (error) {
             handleError(error);

package/dist/commands/scenes.js.map

@@ -1 +1 @@
-{"version":3,"file":"scenes.js","sourceRoot":"","sources":["../../src/commands/scenes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOpF,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAEtD,wBAAwB;IACxB,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,8DAA8D,CAAC;SAC3E,WAAW,CAAC,OAAO,EAAE;;;;;;CAMzB,CAAC;SACG,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAoB,cAAc,CAAC,CAAC;YAEhE,IAAI,UAAU,EAAE,EAAE,CAAC;gBACjB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzB,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YAED,UAAU,CACR,CAAC,SAAS,EAAE,WAAW,CAAC,EACxB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAC5C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,qCAAqC;IACrC,MAAM;SACH,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAC;SACpD,WAAW,CAAC,OAAO,EAAE;;;CAGzB,CAAC;SACG,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;YAC9B,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,OAAO,UAAU,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"scenes.js","sourceRoot":"","sources":["../../src/commands/scenes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAEtD,wBAAwB;IACxB,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,8DAA8D,CAAC;SAC3E,WAAW,CAAC,OAAO,EAAE;;;;;;;;;CASzB,CAAC;SACG,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;YAE5B,IAAI,GAAG,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtD,SAAS,CAAC,MAAM,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YAED,UAAU,CACR,CAAC,SAAS,EAAE,WAAW,CAAC,EACxB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAC3C,GAAG,EACH,aAAa,EAAE,CAChB,CAAC;YACF,IAAI,GAAG,KAAK,OAAO,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3C,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,qCAAqC;IACrC,MAAM;SACH,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAC;SACpD,WAAW,CAAC,OAAO,EAAE;;;CAGzB,CAAC;SACG,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,UAAU,EAAE,EAAE,CAAC;gBACjB,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/schema.d.ts

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

package/dist/commands/schema.js

@@ -0,0 +1,77 @@
+import { printJson, isJsonMode } from '../utils/output.js';
+import { getEffectiveCatalog } from '../devices/catalog.js';
+function toSchemaEntry(e) {
+    return {
+        type: e.type,
+        description: e.description ?? '',
+        category: e.category,
+        aliases: e.aliases ?? [],
+        role: e.role ?? null,
+        readOnly: e.readOnly ?? false,
+        commands: e.commands.map(toSchemaCommand),
+        statusFields: e.statusFields ?? [],
+    };
+}
+function toSchemaCommand(c) {
+    return {
+        command: c.command,
+        parameter: c.parameter,
+        description: c.description,
+        commandType: (c.commandType ?? 'command'),
+        idempotent: Boolean(c.idempotent),
+        destructive: Boolean(c.destructive),
+        ...(c.exampleParams ? { exampleParams: c.exampleParams } : {}),
+    };
+}
+export function registerSchemaCommand(program) {
+    const schema = program
+        .command('schema')
+        .description('Export the device catalog as structured JSON (for agent prompts / tooling)');
+    schema
+        .command('export')
+        .description('Print the full catalog as structured JSON (one object per type)')
+        .option('--type <type>', 'Restrict to a single device type (e.g. "Strip Light")')
+        .option('--role <role>', 'Restrict to a functional role: lighting, security, sensor, climate, media, cleaning, curtain, fan, power, hub, other')
+        .option('--category <cat>', 'Restrict to "physical" or "ir"')
+        .addHelpText('after', `
+Output is always JSON (this command ignores --format). The output is a
+catalog export — not a formal JSON Schema standard document — suitable for
+pre-baking LLM prompts or regenerating docs when the catalog changes.
+
+Examples:
+  $ switchbot schema export > catalog.json
+  $ switchbot schema export --type Bot | jq '.types[0].commands'
+  $ switchbot schema export --role lighting | jq '[.types[].type]'
+  $ switchbot schema export --role security --category physical
+`)
+        .action((options) => {
+        const catalog = getEffectiveCatalog();
+        let filtered = catalog;
+        if (options.type) {
+            const q = options.type.toLowerCase();
+            filtered = filtered.filter((e) => e.type.toLowerCase() === q ||
+                (e.aliases ?? []).some((a) => a.toLowerCase() === q));
+        }
+        if (options.role) {
+            const q = options.role.toLowerCase();
+            filtered = filtered.filter((e) => (e.role ?? 'other') === q);
+        }
+        if (options.category) {
+            const q = options.category.toLowerCase();
+            filtered = filtered.filter((e) => e.category === q);
+        }
+        const payload = {
+            version: '1.0',
+            generatedAt: new Date().toISOString(),
+            types: filtered.map(toSchemaEntry),
+        };
+        // Always JSON — schema export without JSON would be a category error.
+        if (isJsonMode()) {
+            printJson(payload);
+        }
+        else {
+            console.log(JSON.stringify(payload, null, 2));
+        }
+    });
+}
+//# sourceMappingURL=schema.js.map

package/dist/commands/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAA6C,MAAM,uBAAuB,CAAC;AAqBvG,SAAS,aAAa,CAAC,CAAqB;IAC1C,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;QAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK;QAC7B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC;QACzC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,EAAE;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,CAAc;IACrC,OAAO;QACL,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,SAAS,CAA4B;QACpE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;QACjC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;QACnC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,4EAA4E,CAAC,CAAC;IAE7F,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,iEAAiE,CAAC;SAC9E,MAAM,CAAC,eAAe,EAAE,uDAAuD,CAAC;SAChF,MAAM,CAAC,eAAe,EAAE,sHAAsH,CAAC;SAC/I,MAAM,CAAC,kBAAkB,EAAE,gCAAgC,CAAC;SAC5D,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;CAUzB,CAAC;SACG,MAAM,CAAC,CAAC,OAA4D,EAAE,EAAE;QACvE,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;QACtC,IAAI,QAAQ,GAAG,OAAO,CAAC;QACvB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC;gBAC1B,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CACrD,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YACzC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC;SACnC,CAAC;QACF,sEAAsE;QACtE,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,SAAS,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/watch.d.ts

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