smithue-cli 0.8.0

package/dist/portfile.js

@@ -0,0 +1,133 @@
+import { readdir, readFile, unlink } from 'fs/promises';
+import { join } from 'path';
+// ---------------------------------------------------------------------------
+// Error class
+// ---------------------------------------------------------------------------
+export class SmithUEError extends Error {
+    exitCode;
+    constructor(message, exitCode) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = 'SmithUEError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+export function getPortfileDir() {
+    const localAppData = process.env['LOCALAPPDATA'];
+    if (!localAppData) {
+        throw new SmithUEError('LOCALAPPDATA environment variable is not set. This command requires Windows.', 2);
+    }
+    return join(localAppData, '.smithue');
+}
+export async function readPortfiles(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    const portfiles = [];
+    for (const entry of entries) {
+        if (!entry.endsWith('.port'))
+            continue;
+        const filePath = join(dir, entry);
+        try {
+            const raw = await readFile(filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            portfiles.push({ file: filePath, data });
+        }
+        catch {
+            // Ignore malformed portfiles
+        }
+    }
+    return portfiles;
+}
+async function checkLiveness(port, filePath) {
+    try {
+        await fetch(`http://127.0.0.1:${port}/ready`, {
+            signal: AbortSignal.timeout(3000),
+        });
+        // any HTTP response = server is alive (including 503 during startup)
+        return;
+    }
+    catch {
+        // network failure = truly stale
+        try {
+            await unlink(filePath);
+        }
+        catch {
+            // best effort
+        }
+        throw new SmithUEError(`SmithUE instance on port ${port} is not responding. Stale portfile removed.`, 2);
+    }
+}
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+export async function discoverPort(opts = {}) {
+    // 1. SMITHUE_PORT env override — skip discovery entirely
+    const envPort = process.env['SMITHUE_PORT'];
+    if (envPort) {
+        const port = parseInt(envPort, 10);
+        if (isNaN(port) || port <= 0) {
+            throw new SmithUEError(`SMITHUE_PORT is not a valid port number: "${envPort}"`, 1);
+        }
+        return { port, pid: 0, project: '', project_name: '' };
+    }
+    // 2. --port flag shortcut (already resolved by caller, treated same as env override)
+    if (opts.port !== undefined) {
+        return { port: opts.port, pid: 0, project: '', project_name: '' };
+    }
+    // 3. Determine effective PID filter (--pid > SMITHUE_PID env)
+    let pidFilter = opts.pid;
+    if (pidFilter === undefined) {
+        const envPid = process.env['SMITHUE_PID'];
+        if (envPid) {
+            const p = parseInt(envPid, 10);
+            if (!isNaN(p) && p > 0) {
+                pidFilter = p;
+            }
+        }
+    }
+    // 4. Read all portfiles
+    const dir = getPortfileDir();
+    const all = await readPortfiles(dir);
+    if (all.length === 0) {
+        throw new SmithUEError('No SmithUE portfiles found. Is the SmithUE plugin running in Unreal Editor?', 2);
+    }
+    // 5. Apply filters
+    let candidates = all;
+    if (pidFilter !== undefined) {
+        candidates = candidates.filter((c) => c.data.pid === pidFilter);
+        if (candidates.length === 0) {
+            throw new SmithUEError(`No SmithUE instance found with PID ${pidFilter}.`, 2);
+        }
+    }
+    else if (opts.project !== undefined) {
+        // Exact absolute path comparison (M7)
+        candidates = candidates.filter((c) => c.data.project === opts.project);
+        if (candidates.length === 0) {
+            throw new SmithUEError(`No SmithUE instance found for project "${opts.project}".`, 2);
+        }
+    }
+    // 6. Multi-instance error (no disambiguation possible)
+    if (candidates.length > 1) {
+        const list = candidates
+            .map((c) => `  PID ${c.data.pid}  ${c.data.project_name}  (port ${c.data.port})`)
+            .join('\n');
+        throw new SmithUEError(`Multiple SmithUE instances are running. Use --pid or --project to select one:\n${list}`, 1);
+    }
+    // 7. Single candidate — liveness check
+    const { file, data } = candidates[0];
+    await checkLiveness(data.port, file);
+    return {
+        port: data.port,
+        pid: data.pid,
+        project: data.project,
+        project_name: data.project_name,
+        plugin_version: data.plugin_version,
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,50 @@
+export interface SmithUEToolParam {
+    name: string;
+    type: string;
+    description: string;
+    required: boolean;
+    default?: string;
+    itemsType?: string;
+    allowedValues?: string[];
+}
+export interface SmithUEToolSchema {
+    name: string;
+    category: string;
+    description: string;
+    params: SmithUEToolParam[];
+}
+export interface SmithUEListToolsResponse {
+    status: 'success' | 'error';
+    data: {
+        protocol_version: string;
+        tools: SmithUEToolSchema[];
+    };
+}
+export interface SmithUEExecuteResponse {
+    status: 'success' | 'error';
+    data?: Record<string, unknown>;
+    error?: string;
+    error_code?: string;
+}
+export interface SmithUEClientConfig {
+    host: string;
+    port: number;
+    timeout: number;
+}
+export interface PurgeOptions {
+    force: boolean;
+    dryRun: boolean;
+    yes: boolean;
+}
+export interface PurgeResult {
+    status: 'purged' | 'nothing_to_purge' | 'partial' | 'cancelled' | 'dry_run';
+    path: string;
+    scanned: number;
+    deleted: number;
+    skipped_live: number;
+    failed: number;
+    directory_removed: boolean;
+    errors: string[];
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,IAAI,EAAE;QACJ,gBAAgB,EAAE,MAAM,CAAC;QACzB,KAAK,EAAE,iBAAiB,EAAE,CAAC;KAC5B,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// SmithUE plugin HTTP API types
+// Mirrors FUEAgentToolParam and FUEAgentToolSchema from plugin C++ code
+export {};

package/dist/version-check.d.ts

@@ -0,0 +1,2 @@
+export declare function checkVersionCompat(cliVersion: string, pluginVersion: string | undefined): void;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../src/version-check.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAW9F"}

package/dist/version-check.js

@@ -0,0 +1,9 @@
+export function checkVersionCompat(cliVersion, pluginVersion) {
+    if (!pluginVersion)
+        return;
+    const [cliMajor, cliMinor] = cliVersion.split('.');
+    const [pluginMajor, pluginMinor] = pluginVersion.split('.');
+    if (cliMajor !== pluginMajor || cliMinor !== pluginMinor) {
+        process.stderr.write(`Warning: smithue-cli version ${cliVersion} does not match plugin version ${pluginVersion}. Run "smithue-cli upgrade" to update.\n`);
+    }
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+    "name":  "smithue-cli",
+    "version":  "0.8.0",
+    "type":  "module",
+    "main":  "dist/cli.js",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsc -p tsconfig.build.json --watch"
+  },
+  "files": [
+    "dist/",
+    "package.json",
+    "README.md"
+  ],
+    "devDependencies":  {
+                            "@types/node":  "^20.0.0",
+                            "typescript":  "^5.3.0",
+                            "vitest":  "^1.0.0"
+                        },
+    "dependencies":  {
+                         "commander":  "^15.0.0"
+                     },
+    "bin":  {
+                "smithue-cli":  "./dist/cli.js"
+            },
+    "engines":  {
+                    "node":  "\u003e=18"
+                },
+    "publishConfig":  {
+                          "access":  "public"
+                      },
+    "license":  "MIT",
+    "description":  "CLI tool for controlling Unreal Engine editor via SmithUE plugin",
+    "repository":  {
+                       "type":  "git",
+                       "url":  "https://github.com/123dx-svg/smithue-cli.git"
+                   }
+}