@fnndsc/cumin 3.2.4

package/dist/cache/procCache.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @file Process Cache
+ *
+ * Session-scoped cache of ChRIS feed topology. Separates permanent data
+ * (instance DAG structure) from volatile data (status — never stored).
+ *
+ * Design decisions:
+ * - Topology (id, feedID, parentID, pluginName) is permanent once written.
+ * - Status is always fetched live from the API — never stored here.
+ * - Feed job counters (finishedJobs etc.) give aggregate feed status
+ *   without per-instance API calls.
+ * - topologyLoaded distinguishes "loaded but 0 instances" from "not yet loaded".
+ * - loading map prevents duplicate API calls when background loader and
+ *   user navigation race on the same feed.
+ * - warmupComplete enables pure in-memory path for proc find <name>.
+ *
+ * @module
+ */
+/**
+ * Feed-level metadata including job count fields for aggregate status.
+ */
+export interface ProcFeed {
+    id: number;
+    title: string;
+    creationDate: string;
+    finishedJobs: number;
+    erroredJobs: number;
+    startedJobs: number;
+    scheduledJobs: number;
+    cancelledJobs: number;
+    createdJobs: number;
+}
+/**
+ * Topology-only instance entry. Status is never stored — always fetched live.
+ */
+export interface ProcInstance {
+    id: number;
+    feedID: number;
+    /** null for root nodes (direct children of a feed). */
+    parentID: number | null;
+    pluginName: string;
+    /** null until first cat — immutable once populated. */
+    params: Record<string, unknown> | null;
+}
+/**
+ * Warm-up progress counters for the prompt indicator.
+ * total is always 0 during global sweep (unknown upfront).
+ * active transitions false→true when sweep starts, true→false when done.
+ */
+export interface ProcWarmupProgress {
+    loaded: number;
+    total: number;
+    active: boolean;
+}
+/**
+ * Session-scoped cache of feed and instance topology.
+ * Status is never stored — always fetched live from the API.
+ */
+export declare class ProcCache {
+    private static _instance;
+    private feeds;
+    private instances;
+    private feedRoots;
+    private children;
+    /** Feed IDs whose instance topology has been fully fetched. */
+    private topologyLoaded;
+    /** In-flight topology fetch promises — prevents duplicate API calls. */
+    private loading;
+    /** True when background warm-up has finished all feeds. */
+    private _warmupComplete;
+    private _warmupProgress;
+    /** Whether initial feed index has been built. */
+    private _built;
+    private constructor();
+    static instance_get(): ProcCache;
+    get built(): boolean;
+    get warmupComplete(): boolean;
+    /**
+     * Adds or updates a feed entry.
+     */
+    feed_add(feed: ProcFeed): void;
+    feed_get(feedID: number): ProcFeed | undefined;
+    feedIDs_get(): number[];
+    feedRoots_get(feedID: number): number[];
+    /**
+     * Removes a feed and all its instances from the cache.
+     */
+    feed_remove(feedID: number): void;
+    /**
+     * Adds a plugin instance to the topology cache.
+     */
+    instance_add(inst: ProcInstance): void;
+    instance_get(id: number): ProcInstance | undefined;
+    instances_count(): number;
+    instancesForFeed_count(feedID: number): number;
+    children_get(parentID: number): number[];
+    /**
+     * Removes an instance from the topology cache.
+     */
+    instance_remove(id: number): void;
+    /**
+     * Updates cached params for an instance (on first cat).
+     */
+    params_update(id: number, params: Record<string, unknown>): void;
+    topologyLoaded_mark(feedID: number): void;
+    topologyLoaded_has(feedID: number): boolean;
+    loading_set(feedID: number, promise: Promise<void>): void;
+    loading_get(feedID: number): Promise<void> | undefined;
+    loading_clear(feedID: number): void;
+    warmup_complete(): void;
+    warmup_progress(loaded: number, total: number): void;
+    warmupProgress_get(): ProcWarmupProgress;
+    /**
+     * Reconstructs the full /proc/jobs path for a given instance ID.
+     *
+     * @param id - Instance ID.
+     * @returns Full path string, or null if instance not in cache.
+     *
+     * @example
+     * ```typescript
+     * cache.path_build(64306)
+     * // '/proc/jobs/feed_1107/pl-dircopy_64267/.../pl-neurofiles-push_64306'
+     * ```
+     */
+    path_build(id: number): string | null;
+    /**
+     * Searches cached feeds by title substring (case-insensitive).
+     */
+    feeds_find(term: string): ProcFeed[];
+    /**
+     * Searches cached instances by numeric ID or plugin name substring.
+     */
+    instances_find(term: string): ProcInstance[];
+    built_set(): void;
+    /**
+     * Clears all cache data. Called before a full rebuild.
+     */
+    cache_clear(): void;
+}
+/**
+ * Returns the singleton ProcCache instance.
+ *
+ * @example
+ * ```typescript
+ * const cache = procCache_get();
+ * cache.instance_add({ id: 789, feedID: 123, parentID: 456,
+ *                      pluginName: 'pl-fshack', params: null });
+ * ```
+ */
+export declare function procCache_get(): ProcCache;

package/dist/cache/procCache.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * @file Process Cache
+ *
+ * Session-scoped cache of ChRIS feed topology. Separates permanent data
+ * (instance DAG structure) from volatile data (status — never stored).
+ *
+ * Design decisions:
+ * - Topology (id, feedID, parentID, pluginName) is permanent once written.
+ * - Status is always fetched live from the API — never stored here.
+ * - Feed job counters (finishedJobs etc.) give aggregate feed status
+ *   without per-instance API calls.
+ * - topologyLoaded distinguishes "loaded but 0 instances" from "not yet loaded".
+ * - loading map prevents duplicate API calls when background loader and
+ *   user navigation race on the same feed.
+ * - warmupComplete enables pure in-memory path for proc find <name>.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcCache = void 0;
+exports.procCache_get = procCache_get;
+/**
+ * Session-scoped cache of feed and instance topology.
+ * Status is never stored — always fetched live from the API.
+ */
+class ProcCache {
+    constructor() {
+        this.feeds = new Map();
+        this.instances = new Map();
+        this.feedRoots = new Map();
+        this.children = new Map();
+        /** Feed IDs whose instance topology has been fully fetched. */
+        this.topologyLoaded = new Set();
+        /** In-flight topology fetch promises — prevents duplicate API calls. */
+        this.loading = new Map();
+        /** True when background warm-up has finished all feeds. */
+        this._warmupComplete = false;
+        this._warmupProgress = { loaded: 0, total: 0, active: false };
+        /** Whether initial feed index has been built. */
+        this._built = false;
+    }
+    static instance_get() {
+        if (!ProcCache._instance) {
+            ProcCache._instance = new ProcCache();
+        }
+        return ProcCache._instance;
+    }
+    get built() { return this._built; }
+    get warmupComplete() { return this._warmupComplete; }
+    // ── Feed ──────────────────────────────────────────────────────────────────
+    /**
+     * Adds or updates a feed entry.
+     */
+    feed_add(feed) {
+        this.feeds.set(feed.id, feed);
+        if (!this.feedRoots.has(feed.id)) {
+            this.feedRoots.set(feed.id, []);
+        }
+    }
+    feed_get(feedID) {
+        return this.feeds.get(feedID);
+    }
+    feedIDs_get() {
+        return Array.from(this.feeds.keys());
+    }
+    feedRoots_get(feedID) {
+        return this.feedRoots.get(feedID) ?? [];
+    }
+    /**
+     * Removes a feed and all its instances from the cache.
+     */
+    feed_remove(feedID) {
+        this.feeds.delete(feedID);
+        this.topologyLoaded.delete(feedID);
+        const allInstances = Array.from(this.instances.values())
+            .filter((i) => i.feedID === feedID);
+        for (const inst of allInstances) {
+            this.instance_remove(inst.id);
+        }
+        this.feedRoots.delete(feedID);
+    }
+    // ── Instance ──────────────────────────────────────────────────────────────
+    /**
+     * Adds a plugin instance to the topology cache.
+     */
+    instance_add(inst) {
+        this.instances.set(inst.id, inst);
+        if (inst.parentID === null) {
+            const roots = this.feedRoots.get(inst.feedID) ?? [];
+            if (!roots.includes(inst.id)) {
+                roots.push(inst.id);
+                this.feedRoots.set(inst.feedID, roots);
+            }
+        }
+        else {
+            const kids = this.children.get(inst.parentID) ?? [];
+            if (!kids.includes(inst.id)) {
+                kids.push(inst.id);
+                this.children.set(inst.parentID, kids);
+            }
+        }
+    }
+    instance_get(id) {
+        return this.instances.get(id);
+    }
+    instances_count() {
+        return this.instances.size;
+    }
+    instancesForFeed_count(feedID) {
+        let n = 0;
+        for (const inst of this.instances.values()) {
+            if (inst.feedID === feedID)
+                n++;
+        }
+        return n;
+    }
+    children_get(parentID) {
+        return this.children.get(parentID) ?? [];
+    }
+    /**
+     * Removes an instance from the topology cache.
+     */
+    instance_remove(id) {
+        const inst = this.instances.get(id);
+        if (!inst)
+            return;
+        this.instances.delete(id);
+        if (inst.parentID === null) {
+            const roots = this.feedRoots.get(inst.feedID) ?? [];
+            this.feedRoots.set(inst.feedID, roots.filter((r) => r !== id));
+        }
+        else {
+            const kids = this.children.get(inst.parentID) ?? [];
+            this.children.set(inst.parentID, kids.filter((k) => k !== id));
+        }
+    }
+    /**
+     * Updates cached params for an instance (on first cat).
+     */
+    params_update(id, params) {
+        const inst = this.instances.get(id);
+        if (inst)
+            inst.params = params;
+    }
+    // ── Topology loaded tracking ───────────────────────────────────────────────
+    topologyLoaded_mark(feedID) {
+        this.topologyLoaded.add(feedID);
+    }
+    topologyLoaded_has(feedID) {
+        return this.topologyLoaded.has(feedID);
+    }
+    // ── In-flight map ─────────────────────────────────────────────────────────
+    loading_set(feedID, promise) {
+        this.loading.set(feedID, promise);
+    }
+    loading_get(feedID) {
+        return this.loading.get(feedID);
+    }
+    loading_clear(feedID) {
+        this.loading.delete(feedID);
+    }
+    // ── Warm-up state ─────────────────────────────────────────────────────────
+    warmup_complete() {
+        this._warmupComplete = true;
+        this._warmupProgress = { loaded: this._warmupProgress.loaded, total: 0, active: false };
+    }
+    warmup_progress(loaded, total) {
+        this._warmupProgress = { loaded, total, active: true };
+    }
+    warmupProgress_get() {
+        return { ...this._warmupProgress };
+    }
+    // ── Path reconstruction ───────────────────────────────────────────────────
+    /**
+     * Reconstructs the full /proc/jobs path for a given instance ID.
+     *
+     * @param id - Instance ID.
+     * @returns Full path string, or null if instance not in cache.
+     *
+     * @example
+     * ```typescript
+     * cache.path_build(64306)
+     * // '/proc/jobs/feed_1107/pl-dircopy_64267/.../pl-neurofiles-push_64306'
+     * ```
+     */
+    path_build(id) {
+        const inst = this.instances.get(id);
+        if (!inst)
+            return null;
+        const segments = [];
+        let current = inst;
+        while (current) {
+            segments.unshift(`${current.pluginName}_${current.id}`);
+            if (current.parentID === null)
+                break;
+            current = this.instances.get(current.parentID);
+        }
+        return `/proc/jobs/feed_${inst.feedID}/${segments.join('/')}`;
+    }
+    /**
+     * Searches cached feeds by title substring (case-insensitive).
+     */
+    feeds_find(term) {
+        const lower = term.toLowerCase();
+        return Array.from(this.feeds.values())
+            .filter((f) => f.title.toLowerCase().includes(lower));
+    }
+    /**
+     * Searches cached instances by numeric ID or plugin name substring.
+     */
+    instances_find(term) {
+        const numeric = parseInt(term, 10);
+        const isID = !isNaN(numeric) && String(numeric) === term;
+        if (isID) {
+            const hit = this.instances.get(numeric);
+            return hit ? [hit] : [];
+        }
+        const lower = term.toLowerCase();
+        return Array.from(this.instances.values())
+            .filter((i) => i.pluginName.toLowerCase().includes(lower));
+    }
+    // ── Lifecycle ─────────────────────────────────────────────────────────────
+    built_set() {
+        this._built = true;
+    }
+    /**
+     * Clears all cache data. Called before a full rebuild.
+     */
+    cache_clear() {
+        this.feeds.clear();
+        this.instances.clear();
+        this.feedRoots.clear();
+        this.children.clear();
+        this.topologyLoaded.clear();
+        this.loading.clear();
+        this._warmupComplete = false;
+        this._warmupProgress = { loaded: 0, total: 0, active: false };
+        this._built = false;
+    }
+}
+exports.ProcCache = ProcCache;
+ProcCache._instance = null;
+/**
+ * Returns the singleton ProcCache instance.
+ *
+ * @example
+ * ```typescript
+ * const cache = procCache_get();
+ * cache.instance_add({ id: 789, feedID: 123, parentID: 456,
+ *                      pluginName: 'pl-fshack', params: null });
+ * ```
+ */
+function procCache_get() {
+    return ProcCache.instance_get();
+}
+//# sourceMappingURL=procCache.js.map

package/dist/cache/procCache.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @file Command-line entry point for the cumin utility library.
+ *
+ * @module
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * @file Command-line entry point for the cumin utility library.
+ *
+ * @module
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const figlet_1 = __importDefault(require("figlet"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const chrisConnection_1 = require("./connect/chrisConnection");
+const config_1 = require("./config/config");
+const node_io_js_1 = require("./io/node_io.js");
+// Read package.json
+const packageJson = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, "..", "package.json"), "utf-8"));
+const version = packageJson.version;
+/**
+ * Main entry point for the cumin CLI.
+ * Initializes the connection and prints version/config info.
+ */
+async function main() {
+    const nodeStorageProvider = new node_io_js_1.NodeStorageProvider();
+    await (0, chrisConnection_1.chrisConnection_init)(nodeStorageProvider);
+    console.log(figlet_1.default.textSync("cumin"));
+    console.log(" -- CUbe Management INterface --");
+    console.log("      == version ", version, "==");
+    console.log("\n");
+    console.log("Welcome to cumin! Also known as the basis for any good chili.\n\n");
+    console.log("Note that cumin isn't really intended to be used as standalone program;");
+    console.log("rather, it is a support interface providing useful services especially");
+    console.log("the ChILI project.");
+    console.log("\n");
+    console.log("For this set of configuration values read during initialization,");
+    console.log("the authorization token is: ", await chrisConnection_1.chrisConnection.authToken_get());
+    console.log("the chris URL is ", await chrisConnection_1.chrisConnection.chrisURL_get());
+    console.log(config_1.connectionConfig);
+}
+main().catch(console.error);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AACA;;;;GAIG;;;;;AAEH,oDAA4B;AAE5B,2BAAkC;AAClC,+BAA4B;AAG5B,+DAAkF;AAClF,4CAAmD;AACnD,gDAAsD;AAOtD,oBAAoB;AACpB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAC7D,CAAC;AACF,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;AAEpC;;;GAGG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,mBAAmB,GAAwB,IAAI,gCAAmB,EAAE,CAAC;IAC3E,MAAM,IAAA,sCAAoB,EAAC,mBAAmB,CAAC,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,gBAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,OAAO,CAAC,GAAG,CACT,mEAAmE,CACpE,CAAC;IACF,OAAO,CAAC,GAAG,CACT,yEAAyE,CAC1E,CAAC;IACF,OAAO,CAAC,GAAG,CACT,wEAAwE,CACzE,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,OAAO,CAAC,GAAG,CACT,kEAAkE,CACnE,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,MAAM,iCAAe,CAAC,aAAa,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,MAAM,iCAAe,CAAC,YAAY,EAAE,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,yBAAgB,CAAC,CAAC;AAChC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/compute/computeResources.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file Compute Resource Validation and Management
+ *
+ * This module provides functions for validating and managing compute resources
+ * in ChRIS CUBE. Used by plugin registration to ensure compute resources exist
+ * before attempting to assign plugins to them.
+ *
+ * @module
+ */
+import { ChRISResourceGroup } from '../resources/chrisResourceGroup.js';
+import { Result } from '../utils/result.js';
+/**
+ * Group handler for ChRIS compute resources.
+ */
+export declare class ChRISComputeResourceGroup extends ChRISResourceGroup {
+    constructor();
+}
+/**
+ * Interface representing a compute resource.
+ */
+export interface ComputeResource {
+    id: number;
+    name: string;
+    compute_url: string;
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * Validates that specified compute resources exist in ChRIS CUBE.
+ *
+ * @param resourceNames - Array of compute resource names to validate.
+ * @returns A Result containing valid resource names, or Err with available resources in errorStack.
+ *
+ * @example
+ * ```
+ * const result = await computeResources_validate(['host', 'gpu']);
+ * if (!result.ok) {
+ *   // Check errorStack for available resources
+ *   const errors = errorStack.allOfType_get('error');
+ *   console.error(errors);
+ *   return;
+ * }
+ * // Proceed with valid resources
+ * ```
+ */
+export declare function computeResources_validate(resourceNames: string[]): Promise<Result<string[]>>;
+/**
+ * Fetches all available compute resources from ChRIS CUBE.
+ *
+ * @returns A Result containing array of compute resources, or Err on failure.
+ */
+export declare function computeResources_getAll(): Promise<Result<ComputeResource[]>>;
+/**
+ * Gets compute resource names from a comma-separated string or array.
+ *
+ * @param computeInput - Comma-separated string or array of compute resource names.
+ * @returns Array of trimmed compute resource names.
+ *
+ * @example
+ * ```
+ * computeResourceNames_parse('host, gpu, remote') // ['host', 'gpu', 'remote']
+ * computeResourceNames_parse(['host', 'gpu'])     // ['host', 'gpu']
+ * ```
+ */
+export declare function computeResourceNames_parse(computeInput: string | string[]): string[];

package/dist/compute/computeResources.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * @file Compute Resource Validation and Management
+ *
+ * This module provides functions for validating and managing compute resources
+ * in ChRIS CUBE. Used by plugin registration to ensure compute resources exist
+ * before attempting to assign plugins to them.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChRISComputeResourceGroup = void 0;
+exports.computeResources_validate = computeResources_validate;
+exports.computeResources_getAll = computeResources_getAll;
+exports.computeResourceNames_parse = computeResourceNames_parse;
+const chrisConnection_js_1 = require("../connect/chrisConnection.js");
+const chrisResourceGroup_js_1 = require("../resources/chrisResourceGroup.js");
+const errorStack_js_1 = require("../error/errorStack.js");
+const result_js_1 = require("../utils/result.js");
+/**
+ * Group handler for ChRIS compute resources.
+ */
+class ChRISComputeResourceGroup extends chrisResourceGroup_js_1.ChRISResourceGroup {
+    constructor() {
+        super('ComputeResources', 'getComputeResources');
+    }
+}
+exports.ChRISComputeResourceGroup = ChRISComputeResourceGroup;
+/**
+ * Validates that specified compute resources exist in ChRIS CUBE.
+ *
+ * @param resourceNames - Array of compute resource names to validate.
+ * @returns A Result containing valid resource names, or Err with available resources in errorStack.
+ *
+ * @example
+ * ```
+ * const result = await computeResources_validate(['host', 'gpu']);
+ * if (!result.ok) {
+ *   // Check errorStack for available resources
+ *   const errors = errorStack.allOfType_get('error');
+ *   console.error(errors);
+ *   return;
+ * }
+ * // Proceed with valid resources
+ * ```
+ */
+async function computeResources_validate(resourceNames) {
+    try {
+        const client = await chrisConnection_js_1.chrisConnection.client_get();
+        if (!client) {
+            errorStack_js_1.errorStack.stack_push('error', 'Not connected to ChRIS. Please log in.');
+            return (0, result_js_1.Err)();
+        }
+        const computeResourceList = await client.getComputeResources();
+        const resources = computeResourceList.data || [];
+        const availableNames = new Set(resources.map((r) => r.name));
+        // Validate requested resources
+        const invalidResources = resourceNames.filter((name) => !availableNames.has(name));
+        if (invalidResources.length > 0) {
+            const availableList = Array.from(availableNames).join(', ');
+            errorStack_js_1.errorStack.stack_push('error', `Invalid compute resource(s): ${invalidResources.join(', ')}`);
+            errorStack_js_1.errorStack.stack_push('error', `Available compute resources: ${availableList}`);
+            return (0, result_js_1.Err)();
+        }
+        return (0, result_js_1.Ok)(resourceNames);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        errorStack_js_1.errorStack.stack_push('error', `Failed to validate compute resources: ${errorMessage}`);
+        return (0, result_js_1.Err)();
+    }
+}
+/**
+ * Fetches all available compute resources from ChRIS CUBE.
+ *
+ * @returns A Result containing array of compute resources, or Err on failure.
+ */
+async function computeResources_getAll() {
+    try {
+        const client = await chrisConnection_js_1.chrisConnection.client_get();
+        if (!client) {
+            errorStack_js_1.errorStack.stack_push('error', 'Not connected to ChRIS. Please log in.');
+            return (0, result_js_1.Err)();
+        }
+        const computeResourceList = await client.getComputeResources();
+        const resources = computeResourceList.data || [];
+        return (0, result_js_1.Ok)(resources);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        errorStack_js_1.errorStack.stack_push('error', `Failed to fetch compute resources: ${errorMessage}`);
+        return (0, result_js_1.Err)();
+    }
+}
+/**
+ * Gets compute resource names from a comma-separated string or array.
+ *
+ * @param computeInput - Comma-separated string or array of compute resource names.
+ * @returns Array of trimmed compute resource names.
+ *
+ * @example
+ * ```
+ * computeResourceNames_parse('host, gpu, remote') // ['host', 'gpu', 'remote']
+ * computeResourceNames_parse(['host', 'gpu'])     // ['host', 'gpu']
+ * ```
+ */
+function computeResourceNames_parse(computeInput) {
+    if (Array.isArray(computeInput)) {
+        return computeInput.map((name) => name.trim());
+    }
+    return computeInput.split(',').map((name) => name.trim());
+}
+//# sourceMappingURL=computeResources.js.map

package/dist/compute/computeResources.js.map

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