@xyteai/cli 0.1.0

package/dist/utils/json-output.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringifyForOutput = stringifyForOutput;
+exports.writeJsonLine = writeJsonLine;
+function safeStringify(value) {
+    const seen = new WeakSet();
+    return JSON.stringify(value, (_key, item) => {
+        if (typeof item === 'bigint') {
+            return item.toString();
+        }
+        if (item && typeof item === 'object') {
+            if (seen.has(item)) {
+                return '[Circular]';
+            }
+            seen.add(item);
+        }
+        return item;
+    }, 2);
+}
+function stringifyForOutput(value, options = {}) {
+    if (options.strictJson) {
+        return JSON.stringify(value, null, 2);
+    }
+    return safeStringify(value);
+}
+function writeJsonLine(stream, value, options = {}) {
+    const text = stringifyForOutput(value, options);
+    stream.write(`${text}\n`);
+}
+//# sourceMappingURL=json-output.js.map

package/dist/utils/json-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-output.js","sourceRoot":"","sources":["../../src/utils/json-output.ts"],"names":[],"mappings":";;AA0BA,gDAKC;AAED,sCAOC;AApCD,SAAS,aAAa,CAAC,KAAc;IACnC,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IACnC,OAAO,IAAI,CAAC,SAAS,CACnB,KAAK,EACL,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC;QAED,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAc,CAAC,EAAE,CAAC;gBAC7B,OAAO,YAAY,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAc,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,EACD,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc,EAAE,UAA4B,EAAE;IAC/E,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAgB,aAAa,CAC3B,MAA4C,EAC5C,KAAc,EACd,UAA4B,EAAE;IAE9B,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/utils/json.d.ts

@@ -0,0 +1,4 @@
+export declare function parseJsonObject(value: string | undefined, fallback?: Record<string, unknown>): Record<string, unknown>;
+export declare function tryParseJson<T = unknown>(value: string): T | undefined;
+export declare function extractFirstJsonObject<T = unknown>(text: string): T | undefined;
+//# sourceMappingURL=json.d.ts.map

package/dist/utils/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW1H;AAED,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAMtE;AAED,wBAAgB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAa/E"}

package/dist/utils/json.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseJsonObject = parseJsonObject;
+exports.tryParseJson = tryParseJson;
+exports.extractFirstJsonObject = extractFirstJsonObject;
+function parseJsonObject(value, fallback = {}) {
+    if (!value) {
+        return fallback;
+    }
+    const parsed = JSON.parse(value);
+    if (!parsed || Array.isArray(parsed) || typeof parsed !== 'object') {
+        throw new Error('Expected a JSON object.');
+    }
+    return parsed;
+}
+function tryParseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractFirstJsonObject(text) {
+    const direct = tryParseJson(text.trim());
+    if (direct !== undefined) {
+        return direct;
+    }
+    const start = text.indexOf('{');
+    const end = text.lastIndexOf('}');
+    if (start === -1 || end === -1 || end <= start) {
+        return undefined;
+    }
+    return tryParseJson(text.slice(start, end + 1));
+}
+//# sourceMappingURL=json.js.map

package/dist/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":";;AAAA,0CAWC;AAED,oCAMC;AAED,wDAaC;AAlCD,SAAgB,eAAe,CAAC,KAAyB,EAAE,WAAoC,EAAE;IAC/F,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;IAC5C,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED,SAAgB,YAAY,CAAc,KAAa;IACrD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,sBAAsB,CAAc,IAAY;IAC9D,MAAM,MAAM,GAAG,YAAY,CAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,YAAY,CAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/utils/version.d.ts

@@ -0,0 +1,2 @@
+export declare function getCliVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/utils/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,IAAI,MAAM,CAkBtC"}

package/dist/utils/version.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCliVersion = getCliVersion;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+let cachedVersion;
+function getCliVersion() {
+    if (cachedVersion) {
+        return cachedVersion;
+    }
+    try {
+        const packageJsonPath = node_path_1.default.resolve(__dirname, '../../package.json');
+        const packageJson = JSON.parse((0, node_fs_1.readFileSync)(packageJsonPath, 'utf8'));
+        if (typeof packageJson.version === 'string' && packageJson.version.trim()) {
+            cachedVersion = packageJson.version;
+            return cachedVersion;
+        }
+    }
+    catch {
+        // Fall through to a safe default version string.
+    }
+    cachedVersion = '0.0.0';
+    return cachedVersion;
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/utils/version.ts"],"names":[],"mappings":";;;;;AAKA,sCAkBC;AAvBD,qCAAuC;AACvC,0DAA6B;AAE7B,IAAI,aAAiC,CAAC;AAEtC,SAAgB,aAAa;IAC3B,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,eAAe,EAAE,MAAM,CAAC,CAA0B,CAAC;QAC/F,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1E,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC;YACpC,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IAED,aAAa,GAAG,OAAO,CAAC;IACxB,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/workflows/fleet-insights.d.ts

@@ -0,0 +1,122 @@
+import type { XyteClient } from '../types/client';
+import { INSPECT_DEEP_DIVE_SCHEMA_VERSION, INSPECT_FLEET_SCHEMA_VERSION, REPORT_SCHEMA_VERSION } from '../contracts/versions';
+interface StatusCounts {
+    [key: string]: number;
+}
+export interface FleetSnapshot {
+    generatedAtUtc: string;
+    tenantId: string;
+    devices: any[];
+    spaces: any[];
+    incidents: any[];
+    tickets: any[];
+}
+export interface FleetInspectResult {
+    schemaVersion: typeof INSPECT_FLEET_SCHEMA_VERSION;
+    generatedAtUtc: string;
+    tenantId: string;
+    totals: {
+        devices: number;
+        spaces: number;
+        incidents: number;
+        tickets: number;
+    };
+    status: {
+        devices: StatusCounts;
+        incidents: StatusCounts;
+        tickets: StatusCounts;
+        spaces: StatusCounts;
+    };
+    highlights: {
+        offlineDevices: number;
+        offlinePct: number;
+        activeIncidents: number;
+        activeIncidentPct: number;
+        openTickets: number;
+    };
+}
+export interface DeepDiveResult {
+    schemaVersion: typeof INSPECT_DEEP_DIVE_SCHEMA_VERSION;
+    generatedAtUtc: string;
+    tenantId: string;
+    windowHours: number;
+    summary: string[];
+    topOfflineSpaces: Array<{
+        space: string;
+        offlineDevices: number;
+        shareOfOfflinePct: number;
+    }>;
+    topIncidentDevices: Array<{
+        device: string;
+        incidentCount: number;
+        activeIncidents: number;
+    }>;
+    activeIncidentAging: Array<{
+        device: string;
+        space: string;
+        ageHours: number;
+        createdAtUtc: string;
+    }>;
+    churn24h: {
+        incidents: number;
+        devices: number;
+        spaces: number;
+        bySpace: Array<{
+            space: string;
+            incidents: number;
+        }>;
+        byDevice: Array<{
+            device: string;
+            incidents: number;
+        }>;
+    };
+    ticketPosture: {
+        openTickets: number;
+        overlappingActiveIncidentDevices: number;
+        oldestOpenTickets: Array<{
+            ticketId: string;
+            title: string;
+            ageHours: number;
+            deviceId: string;
+            createdAtUtc: string;
+        }>;
+    };
+    dataQuality: {
+        statusMismatches: Array<{
+            device: string;
+            status: string;
+            stateStatus: string;
+            lastSeen: string;
+            space: string;
+        }>;
+    };
+}
+export interface FleetReportResult {
+    schemaVersion: typeof REPORT_SCHEMA_VERSION;
+    generatedAtUtc: string;
+    tenantId: string;
+    format: 'markdown' | 'pdf';
+    outputPath: string;
+    includeSensitive: boolean;
+}
+export declare function collectFleetSnapshot(client: XyteClient, tenantId: string): Promise<FleetSnapshot>;
+export declare function buildFleetInspect(snapshot: FleetSnapshot): FleetInspectResult;
+export declare function formatFleetInspectAscii(result: FleetInspectResult): string;
+export declare function buildDeepDive(snapshot: FleetSnapshot, windowHours?: number): DeepDiveResult;
+export declare function formatDeepDiveAscii(result: DeepDiveResult): string;
+export declare function formatDeepDiveMarkdown(result: DeepDiveResult, includeSensitive?: boolean): string;
+interface WindowFocus {
+    label: string;
+    detail: string;
+    accent: string;
+}
+export declare function formatUtcForReport(value: unknown): string;
+export declare function getWindowFocus(windowHours: number): WindowFocus;
+export declare function generateFleetReport(args: {
+    deepDive: DeepDiveResult;
+    format: 'markdown' | 'pdf';
+    outPath: string;
+    includeSensitive: boolean;
+}): Promise<FleetReportResult>;
+export {};
+//# sourceMappingURL=fleet-insights.d.ts.map

package/dist/workflows/fleet-insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-insights.d.ts","sourceRoot":"","sources":["../../src/workflows/fleet-insights.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gCAAgC,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9H,UAAU,YAAY;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,SAAS,EAAE,GAAG,EAAE,CAAC;IACjB,OAAO,EAAE,GAAG,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,4BAA4B,CAAC;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,YAAY,CAAC;QACtB,SAAS,EAAE,YAAY,CAAC;QACxB,OAAO,EAAE,YAAY,CAAC;QACtB,MAAM,EAAE,YAAY,CAAC;KACtB,CAAC;IACF,UAAU,EAAE;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,OAAO,gCAAgC,CAAC;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,kBAAkB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,mBAAmB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtG,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACrD,QAAQ,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACxD,CAAC;IACF,aAAa,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,gCAAgC,EAAE,MAAM,CAAC;QACzC,iBAAiB,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACzH,CAAC;IACF,WAAW,EAAE;QACX,gBAAgB,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnH,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,qBAAqB,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAkLD,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA0BvG;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,kBAAkB,CAkC7E;AASD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAmB1E;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,SAAK,GAAG,cAAc,CAuGvF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAsBlE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,gBAAgB,UAAQ,GAAG,MAAM,CAmE/F;AAyBD,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AA8BD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWzD;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAoB/D;AAkeD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkB7B"}