@switchbot/openapi-cli 3.2.1 → 3.2.2

package/dist/utils/arg-parsers.d.ts

@@ -1,16 +0,0 @@
-/**
- * Commander argParser callbacks that fail fast when a required-value flag
- * swallows the next token (another flag, a subcommand name, etc.) — the
- * default Commander behavior is to take the next argv token verbatim.
- *
- * Use `--flag=<val>` form to pass values that legitimately start with `--`.
- */
-export declare function intArg(flagName: string, opts?: {
-    min?: number;
-    max?: number;
-}): (value: string) => string;
-export declare function durationArg(flagName: string): (value: string) => string;
-export declare function stringArg(flagName: string, opts?: {
-    disallow?: readonly string[];
-}): (value: string) => string;
-export declare function enumArg(flagName: string, allowed: readonly string[]): (value: string) => string;

package/dist/utils/arg-parsers.js

@@ -1,67 +0,0 @@
-import { InvalidArgumentError } from 'commander';
-import { parseDurationToMs } from './flags.js';
-/**
- * Commander argParser callbacks that fail fast when a required-value flag
- * swallows the next token (another flag, a subcommand name, etc.) — the
- * default Commander behavior is to take the next argv token verbatim.
- *
- * Use `--flag=<val>` form to pass values that legitimately start with `--`.
- */
-export function intArg(flagName, opts) {
-    return (value) => {
-        // Flag-like tokens (`--something`, `-x`) are rejected up-front.
-        // Pure negative integers (`-1`, `-42`) fall through to min/max so the
-        // error classifies as a range error rather than "requires a numeric value".
-        if (value.startsWith('-') && !/^-\d+$/.test(value)) {
-            throw new InvalidArgumentError(`${flagName} requires a numeric value, got "${value}". ` +
-                `Did you forget a value? Use ${flagName}=<n> if the value really starts with "-".`);
-        }
-        const n = Number(value);
-        if (!Number.isInteger(n)) {
-            throw new InvalidArgumentError(`${flagName} must be an integer (got "${value}")`);
-        }
-        if (opts?.min !== undefined && n < opts.min) {
-            throw new InvalidArgumentError(`${flagName} must be >= ${opts.min} (got "${value}")`);
-        }
-        if (opts?.max !== undefined && n > opts.max) {
-            throw new InvalidArgumentError(`${flagName} must be <= ${opts.max} (got "${value}")`);
-        }
-        return String(n);
-    };
-}
-export function durationArg(flagName) {
-    return (value) => {
-        if (value.startsWith('-')) {
-            throw new InvalidArgumentError(`${flagName} requires a duration value, got "${value}". ` +
-                `Use ${flagName}=<dur> if the value really starts with "-".`);
-        }
-        const ms = parseDurationToMs(value);
-        if (ms === null) {
-            throw new InvalidArgumentError(`${flagName} must look like "30s", "1m", "500ms", "1h", "7d", "2w" ` +
-                `(supported units: ms, s, m, h, d, w — got "${value}")`);
-        }
-        return value;
-    };
-}
-export function stringArg(flagName, opts) {
-    return (value) => {
-        if (value.startsWith('--')) {
-            throw new InvalidArgumentError(`${flagName} requires a value. "${value}" looks like another option — ` +
-                `did you forget the value? Use ${flagName}=<val> if your value really starts with "--".`);
-        }
-        if (opts?.disallow?.includes(value)) {
-            throw new InvalidArgumentError(`${flagName} requires a value but got "${value}", which is a subcommand name. ` +
-                `Did you forget the value? Use ${flagName}=<val> or put ${flagName} after the subcommand.`);
-        }
-        return value;
-    };
-}
-export function enumArg(flagName, allowed) {
-    return (value) => {
-        if (!allowed.includes(value)) {
-            throw new InvalidArgumentError(`${flagName} must be one of: ${allowed.join(', ')} (got "${value}")`);
-        }
-        return value;
-    };
-}
-//# sourceMappingURL=arg-parsers.js.map

package/dist/utils/arg-parsers.js.map

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

package/dist/utils/audit.d.ts

@@ -1,69 +0,0 @@
-export declare const DEFAULT_AUDIT_PATH: string;
-/**
- * Bump when breaking changes to the audit line shape land.
- *
- * History:
- *   1 — initial command audit (kind: 'command' only).
- *   2 — adds rule-engine kinds ('rule-fire', 'rule-fire-dry',
- *       'rule-throttled', 'rule-webhook-rejected') and a sibling `rule`
- *       block describing which rule fired and why. Reader stays backwards
- *       compatible: v1 lines parse as command entries with `rule`
- *       undefined.
- */
-export declare const AUDIT_VERSION = 2;
-export type AuditEntryKind = 'command' | 'rule-fire' | 'rule-fire-dry' | 'rule-throttled' | 'rule-webhook-rejected';
-export interface AuditRuleContext {
-    /** Rule.name from policy.yaml. */
-    name: string;
-    /** Where the trigger came from. */
-    triggerSource: 'mqtt' | 'cron' | 'webhook';
-    /** Resolved deviceId the rule fired against, if any. */
-    matchedDevice?: string;
-    /** UUID correlating multi-action fires + throttle entries. */
-    fireId: string;
-    /** Optional free-text reason the engine recorded alongside the fire
-     * (e.g. "throttled: 8s since last fire", "destructive command blocked"). */
-    reason?: string;
-}
-export interface AuditEntry {
-    /** Schema version — lets old log lines coexist with new ones after format changes. */
-    auditVersion?: number;
-    t: string;
-    kind: AuditEntryKind;
-    deviceId: string;
-    command: string;
-    parameter: unknown;
-    commandType: 'command' | 'customize';
-    dryRun: boolean;
-    result?: 'ok' | 'error';
-    error?: string;
-    /** When execution is initiated via `plan run`, the stable plan ID for traceability. */
-    planId?: string;
-    /** Present for rule-engine kinds; absent for direct CLI command entries. */
-    rule?: AuditRuleContext;
-}
-export declare function writeAudit(entry: AuditEntry): void;
-export declare function readAudit(file: string): AuditEntry[];
-/**
- * Result of a structural audit log check. See `history verify` for the CLI
- * surface. Malformed lines cause a `problems` entry, missing auditVersion
- * fields cause a `warnings` entry (treated as "pre-v1 record, still parseable").
- */
-export interface VerifyReport {
-    file: string;
-    totalLines: number;
-    parsedLines: number;
-    skippedBlankLines: number;
-    malformedLines: number;
-    unversionedEntries: number;
-    versionCounts: Record<string, number>;
-    problems: Array<{
-        line: number;
-        reason: string;
-        preview?: string;
-    }>;
-    earliest?: string;
-    latest?: string;
-    fileMissing?: boolean;
-}
-export declare function verifyAudit(file: string): VerifyReport;

package/dist/utils/audit.js

@@ -1,122 +0,0 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { getAuditLog } from './flags.js';
-export const DEFAULT_AUDIT_PATH = path.join(os.homedir(), '.switchbot', 'audit.log');
-/**
- * Bump when breaking changes to the audit line shape land.
- *
- * History:
- *   1 — initial command audit (kind: 'command' only).
- *   2 — adds rule-engine kinds ('rule-fire', 'rule-fire-dry',
- *       'rule-throttled', 'rule-webhook-rejected') and a sibling `rule`
- *       block describing which rule fired and why. Reader stays backwards
- *       compatible: v1 lines parse as command entries with `rule`
- *       undefined.
- */
-export const AUDIT_VERSION = 2;
-function resolveAuditPath() {
-    const flag = getAuditLog();
-    if (flag === null)
-        return null;
-    return path.resolve(flag);
-}
-export function writeAudit(entry) {
-    let file = resolveAuditPath();
-    if (!file && entry.planId)
-        file = DEFAULT_AUDIT_PATH;
-    if (!file)
-        return;
-    const dir = path.dirname(file);
-    try {
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true });
-        }
-        const stamped = { auditVersion: AUDIT_VERSION, ...entry };
-        fs.appendFileSync(file, JSON.stringify(stamped) + '\n');
-    }
-    catch {
-        // Best-effort — never let audit failures break the actual command.
-    }
-}
-export function readAudit(file) {
-    if (!fs.existsSync(file))
-        return [];
-    const raw = fs.readFileSync(file, 'utf-8');
-    const out = [];
-    for (const line of raw.split(/\r?\n/)) {
-        const trimmed = line.trim();
-        if (!trimmed)
-            continue;
-        try {
-            out.push(JSON.parse(trimmed));
-        }
-        catch {
-            // skip malformed lines
-        }
-    }
-    return out;
-}
-export function verifyAudit(file) {
-    const report = {
-        file,
-        totalLines: 0,
-        parsedLines: 0,
-        skippedBlankLines: 0,
-        malformedLines: 0,
-        unversionedEntries: 0,
-        versionCounts: {},
-        problems: [],
-    };
-    if (!fs.existsSync(file)) {
-        report.fileMissing = true;
-        return report;
-    }
-    const raw = fs.readFileSync(file, 'utf-8');
-    const lines = raw.split(/\r?\n/);
-    let minT;
-    let maxT;
-    for (let i = 0; i < lines.length; i++) {
-        const trimmed = lines[i].trim();
-        if (!trimmed) {
-            report.skippedBlankLines++;
-            continue;
-        }
-        report.totalLines++;
-        let entry = null;
-        try {
-            entry = JSON.parse(trimmed);
-        }
-        catch {
-            report.malformedLines++;
-            report.problems.push({
-                line: i + 1,
-                reason: 'JSON parse failed',
-                preview: trimmed.slice(0, 80),
-            });
-            continue;
-        }
-        report.parsedLines++;
-        const v = entry.auditVersion;
-        if (v === undefined) {
-            report.unversionedEntries++;
-            report.versionCounts['unversioned'] = (report.versionCounts['unversioned'] ?? 0) + 1;
-        }
-        else {
-            const key = String(v);
-            report.versionCounts[key] = (report.versionCounts[key] ?? 0) + 1;
-        }
-        if (entry.t) {
-            if (!minT || entry.t < minT)
-                minT = entry.t;
-            if (!maxT || entry.t > maxT)
-                maxT = entry.t;
-        }
-    }
-    if (minT)
-        report.earliest = minT;
-    if (maxT)
-        report.latest = maxT;
-    return report;
-}
-//# sourceMappingURL=audit.js.map

package/dist/utils/audit.js.map

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

package/dist/utils/filter.d.ts

@@ -1,81 +0,0 @@
-import type { Device, InfraredDevice } from '../lib/devices.js';
-/**
- * A parsed filter clause. Each clause is an (op, key, value) triple that runs
- * against a candidate string. All clauses from a single expression are AND-ed.
- *
- * Four operators (shared across `devices list`, `devices batch`,
- * `events tail` / `mqtt-tail`):
- *   key=value      — case-insensitive substring (exact for `category`)
- *   key!=value     — negated substring (exact-negated for `category`)
- *   key~value      — explicit case-insensitive substring
- *   key=/pattern/  — case-insensitive regex
- */
-export type FilterOp = 'eq' | 'neq' | 'sub' | 'regex';
-export interface FilterClause {
-    key: string;
-    op: FilterOp;
-    raw: string;
-    regex?: RegExp;
-}
-export interface ParseFilterOptions {
-    resolveKey?: (key: string) => string;
-    supportedKeys?: readonly string[];
-}
-export declare class FilterSyntaxError extends Error {
-    constructor(message: string);
-}
-/**
- * Parse a comma-separated filter expression into discrete clauses.
- *
- * Grammar (per clause, recognition order):
- *   1. key=/pattern/   → regex (case-insensitive); invalid regex throws.
- *   2. key!=value      → 'neq' op (negated substring; exact-negated for keys
- *                        listed in matchClause's `exactKeys` option).
- *   3. key~value       → substring (case-insensitive).
- *   4. key=value       → 'eq' op (substring; caller decides whether to treat
- *                        as exact for specific keys via matchClause's
- *                        `exactKeys` option).
- *
- * `allowedKeys` is command-specific: `devices list` uses
- * {type,name,category,room}; `devices batch` uses {type,family,room,category};
- * `events tail` uses {deviceId,type}.
- */
-export declare function parseFilterExpr(expr: string | undefined, allowedKeys: readonly string[], options?: ParseFilterOptions): FilterClause[];
-/**
- * Match a single candidate string against a clause.
- *
- * - `regex` → RegExp.test against the candidate (case-insensitive by construction).
- * - `sub`   → case-insensitive substring.
- * - `eq`    → case-insensitive substring, except for keys listed in
- *             `exactKeys`, which get case-insensitive exact comparison.
- *             Default `exactKeys` is `['category']` to preserve the existing
- *             list/batch behavior for that key.
- * - `neq`   → logical inverse of `eq` (negated substring; exact-negated for
- *             `exactKeys`). `undefined` candidates remain non-matching so a
- *             `neq` clause does NOT accidentally match missing data.
- */
-export declare function matchClause(candidate: string | undefined, clause: FilterClause, options?: {
-    exactKeys?: readonly string[];
-}): boolean;
-/**
- * Back-compat narrow signature: parses with the batch key set. Callers that
- * need a different key set (list, events tail) should call parseFilterExpr
- * directly.
- */
-export declare function parseFilter(expr: string | undefined): FilterClause[];
-interface FilterableDevice {
-    deviceId: string;
-    type: string;
-    family?: string;
-    room?: string;
-    category: 'physical' | 'ir';
-}
-/**
- * Apply the parsed clauses to a mixed list of physical devices + IR remotes.
- * Returns the filterable entries that satisfy every clause.
- */
-export declare function applyFilter(clauses: FilterClause[], deviceList: Device[], infraredRemoteList: InfraredDevice[], hubLocation?: Map<string, {
-    family?: string;
-    room?: string;
-}>): FilterableDevice[];
-export {};

package/dist/utils/filter.js

@@ -1,190 +0,0 @@
-export class FilterSyntaxError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'FilterSyntaxError';
-    }
-}
-/**
- * Parse a comma-separated filter expression into discrete clauses.
- *
- * Grammar (per clause, recognition order):
- *   1. key=/pattern/   → regex (case-insensitive); invalid regex throws.
- *   2. key!=value      → 'neq' op (negated substring; exact-negated for keys
- *                        listed in matchClause's `exactKeys` option).
- *   3. key~value       → substring (case-insensitive).
- *   4. key=value       → 'eq' op (substring; caller decides whether to treat
- *                        as exact for specific keys via matchClause's
- *                        `exactKeys` option).
- *
- * `allowedKeys` is command-specific: `devices list` uses
- * {type,name,category,room}; `devices batch` uses {type,family,room,category};
- * `events tail` uses {deviceId,type}.
- */
-export function parseFilterExpr(expr, allowedKeys, options) {
-    if (!expr)
-        return [];
-    const parts = expr.split(',').map((p) => p.trim()).filter((p) => p.length > 0);
-    const clauses = [];
-    for (const part of parts) {
-        const regexMatch = /^([^=~!]+)=\/(.*)\/$/.exec(part);
-        const neqIdx = part.indexOf('!=');
-        const tildeIdx = part.indexOf('~');
-        const eqIdx = part.indexOf('=');
-        let key;
-        let op;
-        let raw;
-        let regex;
-        if (regexMatch) {
-            key = regexMatch[1].trim();
-            op = 'regex';
-            raw = regexMatch[2];
-            try {
-                regex = new RegExp(raw, 'i');
-            }
-            catch (err) {
-                throw new FilterSyntaxError(`Invalid regex in --filter "${part}": ${err.message}`);
-            }
-        }
-        else if (neqIdx !== -1 && (tildeIdx === -1 || neqIdx < tildeIdx)) {
-            key = part.slice(0, neqIdx).trim();
-            op = 'neq';
-            raw = part.slice(neqIdx + 2).trim();
-        }
-        else if (tildeIdx !== -1 && (eqIdx === -1 || tildeIdx < eqIdx)) {
-            key = part.slice(0, tildeIdx).trim();
-            op = 'sub';
-            raw = part.slice(tildeIdx + 1).trim();
-            if (raw.startsWith('=')) {
-                throw new FilterSyntaxError(`Invalid filter clause "${part}" — "~=" is no longer supported. Use "${key}~${raw.slice(1)}" instead.`);
-            }
-        }
-        else if (eqIdx !== -1) {
-            key = part.slice(0, eqIdx).trim();
-            op = 'eq';
-            raw = part.slice(eqIdx + 1).trim();
-        }
-        else {
-            throw new FilterSyntaxError(`Invalid filter clause "${part}" — expected "<key>=<value>", "<key>!=<value>", "<key>~<value>", or "<key>=/<regex>/"`);
-        }
-        if (!key) {
-            throw new FilterSyntaxError(`Empty key in filter clause "${part}"`);
-        }
-        if (!raw) {
-            throw new FilterSyntaxError(`Empty value for filter clause "${part}"`);
-        }
-        let resolvedKey = key;
-        if (options?.resolveKey) {
-            try {
-                resolvedKey = options.resolveKey(key);
-            }
-            catch (err) {
-                if (err instanceof Error) {
-                    throw new FilterSyntaxError(err.message);
-                }
-                throw err;
-            }
-        }
-        if (!allowedKeys.includes(resolvedKey)) {
-            const printableKeys = options?.supportedKeys ?? allowedKeys;
-            throw new FilterSyntaxError(`Unknown filter key "${key}" – supported: ${printableKeys.join(', ')}`);
-        }
-        clauses.push({ key: resolvedKey, op, raw, regex });
-    }
-    return clauses;
-}
-/**
- * Match a single candidate string against a clause.
- *
- * - `regex` → RegExp.test against the candidate (case-insensitive by construction).
- * - `sub`   → case-insensitive substring.
- * - `eq`    → case-insensitive substring, except for keys listed in
- *             `exactKeys`, which get case-insensitive exact comparison.
- *             Default `exactKeys` is `['category']` to preserve the existing
- *             list/batch behavior for that key.
- * - `neq`   → logical inverse of `eq` (negated substring; exact-negated for
- *             `exactKeys`). `undefined` candidates remain non-matching so a
- *             `neq` clause does NOT accidentally match missing data.
- */
-export function matchClause(candidate, clause, options) {
-    if (candidate === undefined) {
-        // Missing field: `neq` treats absence as "definitely not X"; everything
-        // else treats it as "no evidence — don't match".
-        return clause.op === 'neq';
-    }
-    if (clause.op === 'regex') {
-        return clause.regex.test(candidate);
-    }
-    const cLower = candidate.toLowerCase();
-    const vLower = clause.raw.toLowerCase();
-    if (clause.op === 'sub') {
-        return cLower.includes(vLower);
-    }
-    const exactKeys = options?.exactKeys ?? ['category'];
-    const exact = exactKeys.includes(clause.key);
-    if (clause.op === 'neq') {
-        return exact ? cLower !== vLower : !cLower.includes(vLower);
-    }
-    if (exact) {
-        return cLower === vLower;
-    }
-    return cLower.includes(vLower);
-}
-const BATCH_KEYS = ['type', 'family', 'room', 'category'];
-/**
- * Back-compat narrow signature: parses with the batch key set. Callers that
- * need a different key set (list, events tail) should call parseFilterExpr
- * directly.
- */
-export function parseFilter(expr) {
-    return parseFilterExpr(expr, BATCH_KEYS);
-}
-/** Normalize a physical / IR device entry to the shape the filter matcher expects. */
-function toFilterable(d, isPhysical, hubLocation) {
-    if (isPhysical) {
-        const p = d;
-        return {
-            deviceId: p.deviceId,
-            type: p.deviceType ?? '',
-            family: p.familyName ?? undefined,
-            room: p.roomName ?? undefined,
-            category: 'physical',
-        };
-    }
-    const ir = d;
-    const inherited = hubLocation?.get(ir.hubDeviceId);
-    return {
-        deviceId: ir.deviceId,
-        type: ir.remoteType ?? '',
-        family: inherited?.family,
-        room: inherited?.room,
-        category: 'ir',
-    };
-}
-function candidateFor(d, key) {
-    switch (key) {
-        case 'type':
-            return d.type;
-        case 'family':
-            return d.family;
-        case 'room':
-            return d.room;
-        case 'category':
-            return d.category;
-        default:
-            return undefined;
-    }
-}
-/**
- * Apply the parsed clauses to a mixed list of physical devices + IR remotes.
- * Returns the filterable entries that satisfy every clause.
- */
-export function applyFilter(clauses, deviceList, infraredRemoteList, hubLocation) {
-    const candidates = [
-        ...deviceList.map((d) => toFilterable(d, true)),
-        ...infraredRemoteList.map((d) => toFilterable(d, false, hubLocation)),
-    ];
-    if (clauses.length === 0)
-        return candidates;
-    return candidates.filter((c) => clauses.every((clause) => matchClause(candidateFor(c, clause.key), clause)));
-}
-//# sourceMappingURL=filter.js.map

package/dist/utils/filter.js.map

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

package/dist/utils/flags.d.ts

@@ -1,72 +0,0 @@
-/**
- * Read global flags directly from process.argv (same pattern as isJsonMode).
- * Kept simple so subcommand actions don't need to thread program.opts() down.
- */
-export declare function isVerbose(): boolean;
-/**
- * Opt-in: disable header redaction in verbose traces. Adds a big warning on
- * stderr. Use only when actively debugging an auth issue — never in logs or
- * CI output.
- */
-export declare function isTraceUnsafe(): boolean;
-export declare function isDryRun(): boolean;
-/** HTTP request timeout in milliseconds. Default 30s. Minimum 100ms (values below 100ms are ignored). */
-export declare function getTimeout(): number;
-/** Override for the credentials file path. */
-export declare function getConfigPath(): string | undefined;
-/** Named profile → ~/.switchbot/profiles/<name>.json. */
-export declare function getProfile(): string | undefined;
-/**
- * Audit log path. `--audit-log` enables JSONL append on every mutating command.
- * Use `--audit-log-path <path>` to specify a custom file; otherwise defaults to
- * ~/.switchbot/audit.log. Returns null when --audit-log is absent.
- */
-export declare function getAuditLog(): string | null;
-/**
- * Max 429 retries before surfacing the error. Default 3. `--no-retry`
- * disables retries entirely; `--retry-on-429 <n>` overrides the count.
- */
-export declare function getRetryOn429(): number;
-/** Backoff strategy for 429 retries. Default 'exponential'. */
-export declare function getBackoffStrategy(): 'linear' | 'exponential';
-/**
- * Max retries on 5xx / gateway-timeout responses for idempotent (GET) reads.
- * Default 2. `--no-retry` disables retries entirely. POSTs are not retried
- * automatically — use --idempotency-key and let the server dedupe.
- */
-export declare function getRetryOn5xx(): number;
-/**
- * Whether local quota counting is disabled. Quota counting is best-effort
- * (see src/utils/quota.ts) — this lets scripts opt out entirely when even
- * best-effort file I/O is unwelcome.
- */
-export declare function isQuotaDisabled(): boolean;
-/**
- * Cache TTL controls. Values:
- *   - `--no-cache`                 → disable cache for all reads
- *   - `--cache off`                → same as `--no-cache`
- *   - `--cache auto` (default)     → list cache on (1h), status cache off
- *   - `--cache 5m` | `--cache 1h`  → enable both stores with the given TTL
- *   - numeric millisecond values are also accepted
- */
-export interface CacheMode {
-    /** TTL for the device-list cache, in ms. 0/undefined = off. */
-    listTtlMs: number;
-    /** TTL for the device-status cache, in ms. 0/undefined = off. */
-    statusTtlMs: number;
-}
-declare function parseDurationToMs(v: string): number | null;
-export { parseDurationToMs };
-/** The --format flag value, or undefined when absent. */
-export declare function getFormat(): string | undefined;
-/** Comma-separated --fields value, split into an array. */
-export declare function getFields(): string[] | undefined;
-/**
- * Table rendering style. Defaults to `unicode` on a TTY and `ascii` on pipes —
- * agents consuming stdout tend to choke on the Unicode box-drawing chars.
- * Valid values: `unicode` (default on TTY), `ascii`, `simple` (whitespace-only),
- * `markdown` (fenced `| col | col |` table for agent-friendly UI embedding).
- */
-export type TableStyle = 'unicode' | 'ascii' | 'simple' | 'markdown';
-export declare function getTableStyle(): TableStyle;
-export declare function getCacheMode(): CacheMode;