@formant/formant-cli 0.1.0

package/LICENSE

@@ -0,0 +1,24 @@
+PROPRIETARY LICENSE
+
+Copyright (c) 2024-2026 Formant Inc.
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+to Formant Inc. and are provided solely for use by authorized Formant customers.
+
+The Software may not be:
+- Copied, modified, merged, published, or distributed without express written
+  permission from Formant Inc.
+- Used for any purpose other than in connection with authorized use of Formant
+  services
+- Reverse engineered, decompiled, or disassembled
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+FORMANT INC. BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For licensing inquiries, contact: info@formant.io

package/README.md

@@ -0,0 +1,322 @@
+# Formant CLI (`fcli`)
+
+```
+   ███████╗ ██████╗██╗     ██╗
+   ██╔════╝██╔════╝██║     ██║     🤖 Formant CLI
+   █████╗  ██║     ██║     ██║     ⚡ Manage your robot fleet
+   ██╔══╝  ██║     ██║     ██║     🚀 from the command line
+   ██║     ╚██████╗███████╗██║
+   ╚═╝      ╚═════╝╚══════╝╚═╝
+```
+
+The official command-line interface for [Formant](https://formant.io) — manage your robot fleet, query telemetry, trigger investigations, and more, all from your terminal.
+
+## Features
+
+- 📋 **Device Management** — List, inspect, and configure robots and sensors
+- 📊 **Telemetry Queries** — Retrieve battery, temperature, and sensor data
+- 🔍 **Event Monitoring** — View and filter device events by severity
+- 🤖 **AI Investigations** — Trigger and monitor AI-powered analysis workflows
+- 📡 **Signal Management** — Track and trace investigation signals
+- 💬 **Command Execution** — Send commands to devices
+- 🚨 **Event Triggers** — Configure rules that generate events and signals
+- 👥 **User & Fleet Management** — Manage users, teams, and device groups
+- 📅 **Scheduled Tasks** — Set up recurring jobs and one-time schedules
+- 📈 **Analytics** — Execute SQL queries against analytics data
+- 🗂️ **Key-Value Store** — Manage device metadata
+
+## Installation
+
+### npm
+
+```bash
+npm install -g @formant/formant-cli
+```
+
+### Yarn
+
+```bash
+yarn global add @formant/formant-cli
+```
+
+### pnpm
+
+```bash
+pnpm add -g @formant/formant-cli
+```
+
+## Authentication
+
+Set your Formant credentials as environment variables:
+
+```bash
+export FORMANT_USER="your-service-account@example.com"
+export FORMANT_PASSWORD="your-password"
+```
+
+Or create a `.env` file in your project:
+
+```env
+FORMANT_USER=your-service-account@example.com
+FORMANT_PASSWORD=your-password
+```
+
+## Quick Start
+
+```bash
+# View help
+fcli --help
+
+# List all devices in dev environment
+fcli devices list --dev
+
+# Get device details
+fcli devices get <device-id> --dev
+
+# Query battery telemetry
+fcli query --device <device-id> --stream battery_level --start 2026-01-01 --end 2026-01-02 --dev
+
+# View recent events
+fcli events list --device <device-id> --severity critical --limit 20 --dev
+
+# List investigations
+fcli investigations list --dev
+
+# Send a command to a device
+fcli commands send <device-id> <template-id> --param speed=5 --dev
+```
+
+## Commands
+
+### Devices
+
+Manage robots and sensors in your fleet.
+
+```bash
+fcli devices list [--tag <key>=<value>] [--online] [--dev]
+fcli devices get <device-id> [--dev]
+fcli devices config <device-id> [--dev]
+fcli devices streams <device-id> [--dev]
+fcli devices last-seen <device-id> [--dev]
+```
+
+### Events
+
+View important events emitted by devices.
+
+```bash
+fcli events list [--device <id>] [--severity <level>] [--limit <n>] [--dev]
+fcli events get <event-id> [--dev]
+```
+
+### Query
+
+Retrieve telemetry and sensor data from devices.
+
+```bash
+fcli query --device <id> --stream <name> --start <date> --end <date> [--dev]
+fcli query latest-values --device <id> --stream <name> [--dev]
+```
+
+### Investigations
+
+Run and monitor AI-powered analysis workflows.
+
+```bash
+fcli investigations list [--dev]
+fcli investigations get <investigation-id> [--dev]
+fcli investigations stats [--start <date>] [--end <date>] [--dev]
+fcli investigations runs-list <investigation-id> [--dev]
+fcli investigations run <investigation-id> <run-id> [--trace-signal] [--dev]
+fcli investigations trigger <investigation-id> <device-id> [--dev]
+fcli investigations analytics <investigation-id> [--dev]
+```
+
+### Signals
+
+Manage signals (points of interest that trigger analysis).
+
+```bash
+fcli signals list [--start <date>] [--end <date>] [--dev]
+```
+
+### Commands
+
+Manage command templates and send commands to devices.
+
+```bash
+fcli commands list [--dev]
+fcli commands get <command-id> [--dev]
+fcli commands for-device <device-id> [--dev]
+fcli commands send <device-id> <template-id> [--param <key>=<value>] [--dev]
+fcli commands history <device-id> [--dev]
+```
+
+### Event Triggers
+
+Manage event trigger rules that generate events and signals.
+
+```bash
+fcli event-triggers list [--dev]
+fcli event-triggers get <trigger-id> [--dev]
+```
+
+### Users
+
+Manage users in your organization.
+
+```bash
+fcli users list [--dev]
+fcli users get <user-id> [--dev]
+```
+
+### Fleets
+
+Manage device groups (fleets).
+
+```bash
+fcli fleets list [--dev]
+fcli fleets get <fleet-id> [--dev]
+```
+
+### Schedules
+
+Manage scheduled tasks and recurring jobs.
+
+```bash
+fcli schedules list [--dev]
+fcli schedules get <schedule-id> [--dev]
+```
+
+### Analytics
+
+Execute SQL queries against analytics data.
+
+```bash
+fcli analytics query --sql "<query>" [--dev]
+fcli analytics tables [--dev]
+```
+
+### Key-Value Store
+
+Manage key-value store for device metadata.
+
+```bash
+fcli kv list <device-id> [--dev]
+fcli kv get <device-id> <key> [--dev]
+fcli kv set <device-id> <key> <value> [--dev]
+```
+
+## Global Flags
+
+- `--dev` — Target the dev environment
+- `--stage` — Target the stage environment
+- `--json` — Format output as JSON
+- `-h, --help` — Show help for a command
+
+## Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `FORMANT_USER` | Service account email | Yes |
+| `FORMANT_PASSWORD` | Service account password | Yes |
+
+## Examples
+
+### List online devices with specific tag
+
+```bash
+fcli devices list --tag location=warehouse --online --dev
+```
+
+### Query telemetry data over a time range
+
+```bash
+fcli query --device abc123 --stream battery_level \
+  --start 2026-01-01 --end 2026-01-02 --dev --json
+```
+
+### Trace an investigation back to its signal
+
+```bash
+# Get investigation run
+fcli investigations run <investigation-id> <run-id> --trace-signal --dev
+
+# Get the signal details
+fcli signals get <signal-id> --dev
+```
+
+### Monitor critical events
+
+```bash
+fcli events list --severity critical --limit 50 --dev
+```
+
+### Send a command with parameters
+
+```bash
+fcli commands send device-123 template-456 \
+  --param speed=10 \
+  --param direction=forward \
+  --dev
+```
+
+## Output Formats
+
+### Table (default)
+
+Human-readable tables for terminal viewing:
+
+```bash
+fcli devices list --dev
+```
+
+### JSON
+
+Machine-readable JSON for scripting and automation:
+
+```bash
+fcli devices list --dev --json | jq '.items[] | .name'
+```
+
+## Development
+
+### Build from source
+
+```bash
+git clone https://github.com/FormantIO/formant-cli.git
+cd formant-cli
+npm install
+npm run build
+```
+
+### Run in development mode
+
+```bash
+npm run dev -- devices list --dev
+```
+
+### Build and pack
+
+```bash
+npm run prepack
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- A Formant service account with appropriate permissions
+
+## Support
+
+- Documentation: [https://formant.io/docs](https://formant.io/docs)
+- Support: [support@formant.io](mailto:support@formant.io)
+- Issues: [https://github.com/FormantIO/formant-cli/issues](https://github.com/FormantIO/formant-cli/issues)
+
+## License
+
+UNLICENSED — Proprietary software for Formant customers.
+
+---
+
+Made with ⚡ by [Formant](https://formant.io)

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/dist/base-command.d.ts

@@ -0,0 +1,38 @@
+import { Command, Interfaces } from '@oclif/core';
+import { type ApiTarget } from './lib/api.js';
+import type { Environment } from './lib/config.js';
+export type InferredFlags<T extends typeof Command> = Interfaces.InferredFlags<typeof BaseCommand['baseFlags'] & T['flags']>;
+export type InferredArgs<T extends typeof Command> = Interfaces.InferredArgs<T['args']>;
+/**
+ * Abstract base command for all fcli commands.
+ * Provides global --env flag, --json support, and authenticated API helpers.
+ */
+export declare abstract class BaseCommand<T extends typeof Command> extends Command {
+    static enableJsonFlag: boolean;
+    static baseFlags: {
+        dev: Interfaces.BooleanFlag<boolean>;
+        stage: Interfaces.BooleanFlag<boolean>;
+    };
+    protected flags: InferredFlags<T>;
+    protected args: InferredArgs<T>;
+    /** Resolved environment based on --dev / --stage flags. */
+    protected get env(): Environment;
+    init(): Promise<void>;
+    /**
+     * Make an authenticated GET/POST request to a Formant API.
+     * Automatically uses the correct environment from --dev/--stage flags.
+     */
+    protected api<R = unknown>(target: ApiTarget, path: string, options?: {
+        body?: unknown;
+        method?: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
+        query?: Record<string, string>;
+    }): Promise<R>;
+    protected catch(err: Error & {
+        exitCode?: number;
+    }): Promise<void>;
+    /**
+     * Normalize a date string to ISO 8601 datetime format.
+     * Accepts both simple dates (2026-01-01) and full datetime strings.
+     */
+    protected normalizeDateTime(dateStr: string): string;
+}

package/dist/base-command.js

@@ -0,0 +1,66 @@
+import { Command, Flags } from '@oclif/core';
+import { apiRequest } from './lib/api.js';
+/**
+ * Abstract base command for all fcli commands.
+ * Provides global --env flag, --json support, and authenticated API helpers.
+ */
+export class BaseCommand extends Command {
+    static enableJsonFlag = true;
+    static baseFlags = {
+        dev: Flags.boolean({
+            description: 'Target the dev environment',
+            exclusive: ['stage'],
+            helpGroup: 'GLOBAL',
+        }),
+        stage: Flags.boolean({
+            description: 'Target the stage environment',
+            exclusive: ['dev'],
+            helpGroup: 'GLOBAL',
+        }),
+    };
+    flags;
+    args;
+    /** Resolved environment based on --dev / --stage flags. */
+    get env() {
+        if (this.flags.dev)
+            return 'dev';
+        if (this.flags.stage)
+            return 'stage';
+        return 'prod';
+    }
+    async init() {
+        await super.init();
+        const { args, flags } = await this.parse({
+            args: this.ctor.args,
+            baseFlags: super.ctor.baseFlags,
+            enableJsonFlag: this.ctor.enableJsonFlag,
+            flags: this.ctor.flags,
+            strict: this.ctor.strict,
+        });
+        this.flags = flags;
+        this.args = args;
+    }
+    /**
+     * Make an authenticated GET/POST request to a Formant API.
+     * Automatically uses the correct environment from --dev/--stage flags.
+     */
+    async api(target, path, options) {
+        return apiRequest(this.env, target, path, options);
+    }
+    async catch(err) {
+        throw err;
+    }
+    /**
+     * Normalize a date string to ISO 8601 datetime format.
+     * Accepts both simple dates (2026-01-01) and full datetime strings.
+     */
+    normalizeDateTime(dateStr) {
+        // If it already looks like a full datetime (has 'T' or time), return as-is
+        if (dateStr.includes('T') || dateStr.match(/\d{2}:\d{2}/)) {
+            return dateStr;
+        }
+        // Otherwise, append T00:00:00Z to make it a valid datetime
+        return `${dateStr}T00:00:00Z`;
+    }
+}
+//# sourceMappingURL=base-command.js.map

package/dist/base-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,KAAK,EAAa,MAAM,aAAa,CAAA;AAEtD,OAAO,EAAiB,UAAU,EAAC,MAAM,cAAc,CAAA;AAQvD;;;GAGG;AACH,MAAM,OAAgB,WAAsC,SAAQ,OAAO;IACzE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAA;IAE5B,MAAM,CAAC,SAAS,GAAG;QACjB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,WAAW,EAAE,4BAA4B;YACzC,SAAS,EAAE,CAAC,OAAO,CAAC;YACpB,SAAS,EAAE,QAAQ;SACpB,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,8BAA8B;YAC3C,SAAS,EAAE,CAAC,KAAK,CAAC;YAClB,SAAS,EAAE,QAAQ;SACpB,CAAC;KACH,CAAA;IAES,KAAK,CAAmB;IACxB,IAAI,CAAkB;IAEhC,2DAA2D;IAC3D,IAAc,GAAG;QACf,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG;YAAE,OAAO,KAAK,CAAA;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,OAAO,CAAA;QACpC,OAAO,MAAM,CAAA;IACf,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,MAAM,KAAK,CAAC,IAAI,EAAE,CAAA;QAClB,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;YACrC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,SAAS,EAAG,KAAK,CAAC,IAA2B,CAAC,SAAS;YACvD,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc;YACxC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YACtB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;SACzB,CAAC,CAAA;QAEF,IAAI,CAAC,KAAK,GAAG,KAAyB,CAAA;QACtC,IAAI,CAAC,IAAI,GAAG,IAAuB,CAAA;IACrC,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,GAAG,CACjB,MAAiB,EACjB,IAAY,EACZ,OAAgH;QAEhH,OAAO,UAAU,CAAI,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACvD,CAAC;IAEkB,KAAK,CAAC,KAAK,CAAC,GAAgC;QAC7D,MAAM,GAAG,CAAA;IACX,CAAC;IAED;;;OAGG;IACO,iBAAiB,CAAC,OAAe;QACzC,2EAA2E;QAC3E,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1D,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,2DAA2D;QAC3D,OAAO,GAAG,OAAO,YAAY,CAAA;IAC/B,CAAC"}

package/dist/commands/analytics/query.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command.js';
+export default class AnalyticsQuery extends BaseCommand<typeof AnalyticsQuery> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sql: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static summary: string;
+    run(): Promise<Record<string, unknown>>;
+}

package/dist/commands/analytics/query.js

@@ -0,0 +1,82 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class AnalyticsQuery extends BaseCommand {
+    static description = `Execute a SQL query against analytics data (Snowflake SQL dialect).
+
+Query telemetry data, events, and other analytics tables using Snowflake-compatible SQL.
+Use 'fcli analytics tables' to see available tables and their columns.
+
+Note: The analytics engine uses the Snowflake SQL dialect. String comparisons are
+case-sensitive, use ILIKE for case-insensitive matching, and timestamps should be
+quoted strings (e.g. WHERE time > '2026-01-01'). Large unbounded queries may be
+rejected — always filter by time range for large tables.`;
+    static examples = [
+        '<%= config.bin %> analytics query --sql "SELECT * FROM query_event WHERE time > \'2026-01-01\' LIMIT 10"',
+        '<%= config.bin %> analytics query --sql "SELECT device_id, avg(value) as avg_val FROM query_numeric WHERE time > \'2026-02-01\' GROUP BY device_id LIMIT 10"',
+        '<%= config.bin %> analytics query --sql "SELECT type, count(*) as cnt FROM query_event WHERE time > \'2026-02-01\' GROUP BY type ORDER BY cnt DESC LIMIT 5"',
+        '<%= config.bin %> analytics query --sql "SELECT * FROM query_event LIMIT 10" --json',
+    ];
+    static flags = {
+        limit: Flags.integer({
+            char: 'l',
+            description: 'Maximum number of rows to return',
+        }),
+        sql: Flags.string({
+            char: 's',
+            description: 'SQL query to execute',
+            required: true,
+        }),
+        type: Flags.string({
+            default: 'advanced',
+            description: 'Query type',
+            options: ['stream', 'task', 'advanced'],
+        }),
+    };
+    static summary = 'Execute SQL analytics query';
+    async run() {
+        const body = {
+            sqlQuery: this.flags.sql,
+            type: this.flags.type,
+        };
+        if (this.flags.limit) {
+            body.limit = this.flags.limit;
+        }
+        const result = await this.api('query', 'analytics/rows', { body });
+        if (result.error) {
+            this.error(`Query error: ${result.error}`);
+        }
+        if (!this.jsonEnabled()) {
+            this.log(`\nAnalytics Query Results (${this.env}):\n`);
+            this.log(`  SQL:  ${result.sqlText || this.flags.sql}`);
+            this.log(`  Rows: ${result.rowCount ?? result.rows?.length ?? 0}\n`);
+            const rows = result.rows ?? [];
+            if (rows.length > 0) {
+                // Build columns from the response metadata
+                const columns = (result.columns ?? []).map((col) => ({
+                    key: col.name,
+                    label: col.name.toUpperCase(),
+                    width: Math.max(col.name.length + 2, 20),
+                }));
+                // Fallback: derive from first row if no column metadata
+                if (columns.length === 0) {
+                    const keys = Object.keys(rows[0]);
+                    for (const key of keys) {
+                        columns.push({
+                            key,
+                            label: key.toUpperCase(),
+                            width: Math.max(key.length + 2, 20),
+                        });
+                    }
+                }
+                this.log(formatTable(rows, columns));
+            }
+            else {
+                this.log('  No results.');
+            }
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/analytics/query.js.map

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

package/dist/commands/analytics/tables.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../base-command.js';
+export default class AnalyticsTables extends BaseCommand<typeof AnalyticsTables> {
+    static description: string;
+    static examples: string[];
+    static summary: string;
+    run(): Promise<{
+        items: unknown[];
+    }>;
+}

package/dist/commands/analytics/tables.js

@@ -0,0 +1,34 @@
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class AnalyticsTables extends BaseCommand {
+    static description = `List available SQL tables for analytics queries.
+
+Shows table names, descriptions, and column definitions that can be used
+with 'fcli analytics query'. The analytics engine uses the Snowflake SQL dialect.`;
+    static examples = [
+        '<%= config.bin %> analytics tables',
+        '<%= config.bin %> analytics tables --json',
+    ];
+    static summary = 'List analytics tables';
+    async run() {
+        const result = await this.api('query', 'analytics/tables', { method: 'GET' });
+        const tables = result.items ?? [];
+        if (!this.jsonEnabled()) {
+            this.log(`\nAnalytics Tables (${this.env}):\n`);
+            for (const table of tables) {
+                this.log(`  ${table.name}${table.description ? ` — ${table.description}` : ''}`);
+                if (table.columns && table.columns.length > 0) {
+                    const columns = [
+                        { key: 'name', label: 'COLUMN', width: 30 },
+                        { key: 'dataType', label: 'TYPE', width: 14 },
+                        { key: 'description', label: 'DESCRIPTION', width: 40 },
+                    ];
+                    this.log(formatTable(table.columns, columns));
+                }
+                this.log('');
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=tables.js.map

package/dist/commands/analytics/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../../src/commands/analytics/tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAc,WAAW,EAAC,MAAM,yBAAyB,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,WAAmC;IAC9E,MAAM,CAAU,WAAW,GAAG;;;kFAGkD,CAAA;IAEhF,MAAM,CAAU,QAAQ,GAAG;QACzB,oCAAoC;QACpC,2CAA2C;KAC5C,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,uBAAuB,CAAA;IAE1C,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,OAAO,EACP,kBAAkB,EAClB,EAAC,MAAM,EAAE,KAAK,EAAC,CAChB,CAAA;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAA;QAEjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YAE/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;gBAEhF,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9C,MAAM,OAAO,GAAa;wBACxB,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAC;wBACzC,EAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAC;wBAC3C,EAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAC;qBACtD,CAAA;oBAED,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;gBAC/C,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACd,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}

package/dist/commands/commands/for-device.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command.js';
+export default class CommandsForDevice extends BaseCommand<typeof CommandsForDevice> {
+    static args: {
+        deviceId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static summary: string;
+    run(): Promise<{
+        items: unknown[];
+    }>;
+}

package/dist/commands/commands/for-device.js

@@ -0,0 +1,33 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { formatTable } from '../../lib/formatters.js';
+export default class CommandsForDevice extends BaseCommand {
+    static args = {
+        deviceId: Args.string({ description: 'Device ID (UUID)', required: true }),
+    };
+    static description = `List command templates available for a specific device.
+
+Returns commands that match the device's tags and filters. Only enabled commands
+that apply to this device are shown.`;
+    static examples = [
+        '<%= config.bin %> commands for-device <device-id>',
+        '<%= config.bin %> commands for-device <device-id> --json',
+    ];
+    static summary = 'List commands available for a device';
+    async run() {
+        const result = await this.api('admin', `devices/${this.args.deviceId}/commands`, { method: 'GET' });
+        if (!this.jsonEnabled()) {
+            const columns = [
+                { key: 'name', label: 'NAME', width: 30 },
+                { key: 'command', label: 'COMMAND', width: 30 },
+                { key: 'id', label: 'ID', width: 40 },
+                { key: 'description', label: 'DESCRIPTION', width: 30 },
+            ];
+            this.log(`\nAvailable Commands for Device (${this.env}):\n`);
+            this.log(formatTable(result.items ?? [], columns));
+            this.log('');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=for-device.js.map

package/dist/commands/commands/for-device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"for-device.js","sourceRoot":"","sources":["../../../src/commands/commands/for-device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAA;AACjD,OAAO,EAAc,WAAW,EAAC,MAAM,yBAAyB,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,WAAqC;IAClF,MAAM,CAAU,IAAI,GAAG;QACrB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;KACzE,CAAA;IAED,MAAM,CAAU,WAAW,GAAG;;;qCAGK,CAAA;IAEnC,MAAM,CAAU,QAAQ,GAAG;QACzB,mDAAmD;QACnD,0DAA0D;KAC3D,CAAA;IAED,MAAM,CAAU,OAAO,GAAG,sCAAsC,CAAA;IAEzD,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAC3B,OAAO,EACP,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,WAAW,EACxC,EAAC,MAAM,EAAE,KAAK,EAAC,CAChB,CAAA;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,OAAO,GAAa;gBACxB,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAC;gBACvC,EAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAC;gBAC7C,EAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAC;gBACnC,EAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAC;aACtD,CAAA;YAED,IAAI,CAAC,GAAG,CAAC,oCAAoC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;YAC5D,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;YAClD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACd,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC"}