@fnndsc/salsa 3.2.4

package/dist/vfs/providers/native.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @file Native ChRIS VFS Provider.
+ *
+ * Implements filesystem operations mapping directly to CUBE storage.
+ *
+ * @module
+ */
+import { Result } from "@fnndsc/cumin";
+import { VFSProvider, VFSItem, CpOptions } from "../provider.js";
+/**
+ * Native ChRIS filesystem provider operating on absolute CUBE folders.
+ */
+export declare class NativeVfsProvider implements VFSProvider {
+    /** Prefix matches everything. */
+    prefix: string;
+    /**
+     * Lists native ChRIS folder contents (dirs, files, links).
+     *
+     * @param pathStr - Absolute directory path.
+     * @param options - Sorting parameters.
+     */
+    list(pathStr: string, options?: {
+        sort?: "name" | "size" | "date" | "owner";
+        reverse?: boolean;
+    }): Promise<Result<VFSItem[]>>;
+    /**
+     * Copies native files or folders using Salsa's files_copy algorithms.
+     *
+     * @param src - Source absolute path.
+     * @param dest - Destination absolute path.
+     * @param options - Copy options.
+     */
+    cp(src: string, dest: string, options: CpOptions): Promise<boolean>;
+}

package/dist/vfs/providers/native.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * @file Native ChRIS VFS Provider.
+ *
+ * Implements filesystem operations mapping directly to CUBE storage.
+ *
+ * @module
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeVfsProvider = void 0;
+const cumin_1 = require("@fnndsc/cumin");
+const index_js_1 = require("../../files/index.js");
+const path_1 = __importDefault(require("path"));
+/**
+ * Standard sort utility for VFS items.
+ *
+ * @param items - Items list to sort.
+ * @param sortField - Field to sort by.
+ * @param reverse - Whether to reverse sort order.
+ * @returns Sorted array.
+ */
+function vfs_sortItems(items, sortField, reverse) {
+    const field = sortField || "name";
+    const sorted = [...items].sort((a, b) => {
+        const valA = a[field];
+        const valB = b[field];
+        if (typeof valA === "string" && typeof valB === "string") {
+            return valA.localeCompare(valB);
+        }
+        if (typeof valA === "number" && typeof valB === "number") {
+            return valA - valB;
+        }
+        return 0;
+    });
+    if (reverse) {
+        sorted.reverse();
+    }
+    return sorted;
+}
+/**
+ * Native ChRIS filesystem provider operating on absolute CUBE folders.
+ */
+class NativeVfsProvider {
+    /** Prefix matches everything. */
+    prefix = "";
+    /**
+     * Lists native ChRIS folder contents (dirs, files, links).
+     *
+     * @param pathStr - Absolute directory path.
+     * @param options - Sorting parameters.
+     */
+    async list(pathStr, options) {
+        try {
+            const fetchOpts = { limit: 1000, offset: 0 };
+            const resolvedPath = pathStr || "/";
+            // Parallelize files/dirs/links API requests
+            const results = await Promise.allSettled([
+                (0, index_js_1.files_listAll)(fetchOpts, "dirs", resolvedPath),
+                (0, index_js_1.files_listAll)(fetchOpts, "files", resolvedPath),
+                (0, index_js_1.files_listAll)(fetchOpts, "links", resolvedPath),
+            ]);
+            const [dirsResult, filesResult, linksResult] = results;
+            const items = [];
+            const mapToItem = (raw, type) => {
+                let name = raw.fname || raw.path || "";
+                if (name.includes("/")) {
+                    name = name.split("/").pop() || name;
+                }
+                if (type === "link" && name.endsWith(".chrislink")) {
+                    name = name.slice(0, -10);
+                }
+                const targetPath = raw.path
+                    ? raw.path.startsWith("/")
+                        ? raw.path
+                        : "/" + raw.path
+                    : undefined;
+                return {
+                    name,
+                    type,
+                    size: raw.fsize || 0,
+                    owner: raw.owner_username || "unknown",
+                    date: raw.creation_date || "",
+                    target: targetPath,
+                };
+            };
+            if (dirsResult.status === "fulfilled" && dirsResult.value?.tableData) {
+                dirsResult.value.tableData.forEach((d) => items.push(mapToItem(d, "dir")));
+            }
+            if (filesResult.status === "fulfilled" && filesResult.value?.tableData) {
+                filesResult.value.tableData.forEach((f) => items.push(mapToItem(f, "file")));
+            }
+            if (linksResult.status === "fulfilled" && linksResult.value?.tableData) {
+                linksResult.value.tableData.forEach((l) => items.push(mapToItem(l, "link")));
+            }
+            const sorted = vfs_sortItems(items, options?.sort, options?.reverse);
+            return (0, cumin_1.Ok)(sorted);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            cumin_1.errorStack.stack_push("error", `Native VFS list failed: ${msg}`);
+            return (0, cumin_1.Err)();
+        }
+    }
+    /**
+     * Copies native files or folders using Salsa's files_copy algorithms.
+     *
+     * @param src - Source absolute path.
+     * @param dest - Destination absolute path.
+     * @param options - Copy options.
+     */
+    async cp(src, dest, options) {
+        try {
+            const srcIsDir = await path_checkIsDir(src);
+            if (srcIsDir && !options.recursive) {
+                cumin_1.errorStack.stack_push("error", `Source is a directory. Re-run with --recursive to copy: ${src}`);
+                return false;
+            }
+            const destIsDir = await path_checkIsDir(dest);
+            const destLooksDir = dest.endsWith("/");
+            const finalDest = (destIsDir || destLooksDir)
+                ? path_1.default.posix.join(dest, path_1.default.posix.basename(src))
+                : dest;
+            if (options.recursive) {
+                return await (0, index_js_1.files_copyRecursively)(src, finalDest);
+            }
+            else {
+                return await (0, index_js_1.files_copy)(src, finalDest);
+            }
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            cumin_1.errorStack.stack_push("error", `Native VFS copy failed: ${msg}`);
+            return false;
+        }
+    }
+}
+exports.NativeVfsProvider = NativeVfsProvider;
+/**
+ * Determines whether a given ChRIS path refers to a directory.
+ *
+ * @param targetPath - The absolute ChRIS path to check.
+ * @returns Promise<boolean> indicating directory existence.
+ */
+async function path_checkIsDir(targetPath) {
+    const parent = path_1.default.posix.dirname(targetPath);
+    const name = path_1.default.posix.basename(targetPath);
+    try {
+        const results = await (0, index_js_1.files_listAll)({ limit: 1000, offset: 0 }, "dirs", parent);
+        if (!results || !results.tableData) {
+            return false;
+        }
+        return results.tableData.some((entry) => {
+            const candidate = typeof entry.path === "string" && entry.path.length > 0
+                ? entry.path
+                : typeof entry.fname === "string"
+                    ? entry.fname
+                    : "";
+            return candidate === targetPath || path_1.default.posix.basename(candidate) === name;
+        });
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=native.js.map

package/dist/vfs/providers/native.js.map

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

package/dist/vfs/providers/pacs.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @file PACS VFS Provider.
+ *
+ * Implements virtual file browser directories and sequential synthetic PACS retrieves.
+ *
+ * @module
+ */
+import { Result } from "@fnndsc/cumin";
+import { VFSProvider, VFSItem, CpOptions } from "../provider.js";
+type SortOptions = {
+    sort?: "name" | "size" | "date" | "owner";
+    reverse?: boolean;
+};
+/**
+ * Virtual PACS Search results VFS provider.
+ */
+export declare class PacsVfsProvider implements VFSProvider {
+    /** Prefix matches /net/pacs and subdirectories. */
+    prefix: string;
+    /** Cache for decoded PACS query results to avoid redundant API hits. */
+    private _queryCache;
+    /**
+     * Fetches the decoded query result, leveraging a cache to prevent redundant API calls.
+     *
+     * @param queryId - The ID of the PACS query to decode.
+     * @returns Promise resolving to the decoded PACS query result, or null if fetch fails.
+     */
+    private queryResult_fetch;
+    /**
+     * Lazily lists virtual directory contents under `/net/pacs`.
+     */
+    list(pathStr: string, options?: SortOptions): Promise<Result<VFSItem[]>>;
+    /**
+     * Triggers sequential synthetic PACS pulls and link-copies results to feed destination.
+     *
+     * @param src - Source PACS absolute virtual path.
+     * @param dest - Destination native feed folder.
+     * @param options - Copy options like recursive.
+     */
+    cp(src: string, dest: string, _options: CpOptions): Promise<boolean>;
+    /**
+     * Reads virtual file content under '/net/pacs'.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns Promise resolving to a Result containing the file contents as a string.
+     */
+    read(pathStr: string): Promise<Result<string>>;
+    /**
+     * Reads virtual file binary content under '/net/pacs'.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns Promise resolving to a Result containing the file contents as a Buffer.
+     */
+    readBinary(pathStr: string): Promise<Result<Buffer>>;
+}
+export {};

package/dist/vfs/providers/pacs.js

@@ -0,0 +1,413 @@
+"use strict";
+/**
+ * @file PACS VFS Provider.
+ *
+ * Implements virtual file browser directories and sequential synthetic PACS retrieves.
+ *
+ * @module
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PacsVfsProvider = void 0;
+const cumin_1 = require("@fnndsc/cumin");
+const pacsHelpers_js_1 = require("./pacsHelpers.js");
+const index_js_1 = require("../../pacs/index.js");
+const index_js_2 = require("../../files/index.js");
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const pacs_content_js_1 = require("./pacs_content.js");
+/**
+ * Standard sort utility for VFS items.
+ */
+function items_sort(items, sortField, reverse) {
+    const field = sortField || "name";
+    const sorted = [...items].sort((a, b) => {
+        const valA = a[field];
+        const valB = b[field];
+        if (typeof valA === "string" && typeof valB === "string") {
+            return valA.localeCompare(valB);
+        }
+        if (typeof valA === "number" && typeof valB === "number") {
+            return valA - valB;
+        }
+        return 0;
+    });
+    if (reverse) {
+        sorted.reverse();
+    }
+    return sorted;
+}
+/**
+ * Resolves the folder path on ChRIS storage for a retrieved series.
+ *
+ * @param seriesInstanceUID - The Series Instance UID to resolve.
+ * @returns Promise resolving to the folder path string or null on failure.
+ */
+async function series_getFolderPath(seriesInstanceUID) {
+    const client = await cumin_1.chrisConnection.client_get();
+    if (!client) {
+        return null;
+    }
+    const seriesList = await client.getPACSSeriesList({
+        SeriesInstanceUID: seriesInstanceUID,
+        limit: 1,
+    });
+    const seriesItems = seriesList.getItems();
+    if (!seriesItems || seriesItems.length === 0) {
+        return null;
+    }
+    const series = seriesItems[0];
+    return series?.data?.folder_path || null;
+}
+function pacsRoot_list() {
+    return (0, cumin_1.Ok)([{ name: "queries", type: "vfs", size: 0, owner: "root", date: new Date().toISOString() }]);
+}
+async function queries_list(options) {
+    const queriesResult = await (0, index_js_1.pacsQueries_list)({ limit: 100 });
+    if (!queriesResult || !queriesResult.ok || !queriesResult.value)
+        return (0, cumin_1.Ok)([]);
+    const items = queriesResult.value.tableData.map((row) => {
+        const queryId = String(row.id);
+        const title = typeof row.title === "string" ? row.title : "query";
+        const queryStr = typeof row.query === "string" ? row.query : "";
+        let queryObj = {};
+        try {
+            if (queryStr)
+                queryObj = JSON.parse(queryStr);
+        }
+        catch { /* ignore */ }
+        const queryParts = [];
+        for (const [k, v] of Object.entries(queryObj)) {
+            if (v !== undefined && v !== null && String(v).trim().length > 0)
+                queryParts.push(`${k}:${v}`);
+        }
+        let queryDesc = queryParts.join("_");
+        if (!queryDesc)
+            queryDesc = title.replace(/^pacs_query_\d+_\d+$/, "query").replace(/^pacs_query_/, "");
+        const hasResult = typeof row.result === "string" && row.result.trim().length > 0;
+        const noHitsSuffix = hasResult ? "" : "_no-hits";
+        const ownerUsername = typeof row.owner_username === "string" ? row.owner_username : "";
+        const userSuffix = ownerUsername ? `_${ownerUsername}` : "";
+        const creationDate = typeof row.creation_date === "string" ? row.creation_date : new Date().toISOString();
+        return {
+            name: `${queryDesc}_qid:${queryId}${userSuffix}${noHitsSuffix}`,
+            type: "dir",
+            size: 0,
+            owner: ownerUsername || "system",
+            date: creationDate,
+        };
+    });
+    return (0, cumin_1.Ok)(items_sort(items, options?.sort, options?.reverse));
+}
+function studies_list(studies, options) {
+    const items = studies.map((studyObj, idx) => {
+        const rawUID = studyObj.StudyInstanceUID || studyObj.uid;
+        const studyUID = (0, pacsHelpers_js_1.tag_extractValue)(rawUID || `study_${idx}`);
+        const studyDesc = (0, pacsHelpers_js_1.tag_extractValue)(studyObj.StudyDescription || "NoDescription");
+        return {
+            name: `Study_${studyUID}_${studyDesc.replace(/[\s/]/g, "_")}`,
+            type: "dir",
+            size: 0,
+            owner: "system",
+            date: "",
+        };
+    });
+    return (0, cumin_1.Ok)(items_sort(items, options?.sort, options?.reverse));
+}
+function series_list(seriesArr, options) {
+    const items = seriesArr.map((seriesObj, idx) => {
+        const rawUID = seriesObj.SeriesInstanceUID || seriesObj.uid;
+        const seriesUID = (0, pacsHelpers_js_1.tag_extractValue)(rawUID || `series_${idx}`);
+        const seriesDesc = (0, pacsHelpers_js_1.tag_extractValue)(seriesObj.SeriesDescription || "NoDescription");
+        return {
+            name: `Series_${seriesUID}_${seriesDesc.replace(/[\s/]/g, "_")}`,
+            type: "dir",
+            size: 0,
+            owner: "system",
+            date: "",
+        };
+    });
+    return (0, cumin_1.Ok)(items_sort(items, options?.sort, options?.reverse));
+}
+function seriesFiles_list(seriesObj) {
+    return (0, cumin_1.Ok)([
+        { name: "metadata.json", type: "file", size: JSON.stringify(seriesObj).length, owner: "system", date: "" },
+        { name: "image_slices.dcm", type: "file", size: 0, owner: "system", date: "" },
+    ]);
+}
+function seriesToRetrieve_build(decoded, studyUID, seriesUID, src) {
+    const studies = (0, pacsHelpers_js_1.studies_extractFromDecoded)(decoded.json);
+    const studyObj = (0, pacsHelpers_js_1.study_findByUID)(studies, studyUID);
+    if (!studyObj) {
+        cumin_1.errorStack.stack_push("error", `cp: Study with UID ${studyUID} not found in query results.`);
+        return (0, cumin_1.Err)();
+    }
+    const seriesArray = (0, pacsHelpers_js_1.series_extractFromStudy)(studyObj);
+    const seriesToRetrieve = [];
+    if (seriesUID) {
+        const seriesObj = (0, pacsHelpers_js_1.series_findByUID)(seriesArray, seriesUID);
+        const desc = seriesObj ? (0, pacsHelpers_js_1.tag_extractValue)(seriesObj.SeriesDescription || "Series") : "Series";
+        seriesToRetrieve.push({ uid: seriesUID, description: desc });
+    }
+    else {
+        for (const s of seriesArray) {
+            const sUID = (0, pacsHelpers_js_1.tag_extractValue)(s.SeriesInstanceUID || s.uid);
+            if (sUID) {
+                seriesToRetrieve.push({ uid: sUID, description: (0, pacsHelpers_js_1.tag_extractValue)(s.SeriesDescription || "Series") });
+            }
+        }
+    }
+    if (seriesToRetrieve.length === 0) {
+        cumin_1.errorStack.stack_push("error", `cp: No series found to retrieve from '${src}'`);
+        return (0, cumin_1.Err)();
+    }
+    return (0, cumin_1.Ok)(seriesToRetrieve);
+}
+async function pacsServer_resolve() {
+    const fromContext = await cumin_1.chrisContext.current_get(cumin_1.Context.PACSserver);
+    if (fromContext)
+        return (0, cumin_1.Ok)(fromContext);
+    const serversResult = await (0, index_js_1.pacsServers_list)();
+    if (serversResult.ok && serversResult.value.length > 0) {
+        return (0, cumin_1.Ok)(String(serversResult.value[0].id));
+    }
+    cumin_1.errorStack.stack_push("error", "cp: No PACS server available or configured in context.");
+    return (0, cumin_1.Err)();
+}
+async function retrieve_pollUntilComplete(syntheticQueryId, seriesUID, maxAttempts) {
+    let attempts = 0;
+    while (attempts < maxAttempts) {
+        attempts++;
+        await new Promise((resolve) => setTimeout(resolve, 5000));
+        const statusResult = await (0, index_js_1.pacsRetrieve_statusForQuery)(syntheticQueryId);
+        if (!statusResult.ok || !statusResult.value) {
+            console.log(chalk_1.default.yellow(`     [Attempt ${attempts}/${maxAttempts}] Failed to fetch status report, retrying...`));
+            continue;
+        }
+        const statusReport = statusResult.value;
+        let totalExpected = 0;
+        let totalActual = 0;
+        let anyPulling = false;
+        let allPulled = true;
+        let anyError = false;
+        if (statusReport.studies) {
+            for (const s of statusReport.studies) {
+                if (s.series) {
+                    for (const ser of s.series) {
+                        if (String(ser.seriesInstanceUID) === String(seriesUID)) {
+                            totalExpected = Number(ser.expectedFiles) || 0;
+                            totalActual = Number(ser.actualFiles) || 0;
+                            if (ser.status === "pulling")
+                                anyPulling = true;
+                            if (ser.status !== "pulled")
+                                allPulled = false;
+                            if (ser.status === "error")
+                                anyError = true;
+                        }
+                    }
+                }
+            }
+        }
+        const overallStatus = statusReport.retrieveStatus || "pending";
+        console.log(chalk_1.default.gray(`     [Attempt ${attempts}/${maxAttempts}] CUBE Status: ${overallStatus} | Files: ${totalActual}/${totalExpected}`));
+        if (allPulled && totalExpected > 0 && totalActual === totalExpected) {
+            console.log(chalk_1.default.green(`  ✓ Pull complete: ${totalActual}/${totalExpected} files retrieved.`));
+            return true;
+        }
+        if (overallStatus === "succeeded" || overallStatus === "completed") {
+            console.log(chalk_1.default.green(`  ✓ Pull complete (Status: ${overallStatus}).`));
+            return true;
+        }
+        if (anyError || overallStatus === "error" || overallStatus === "failed") {
+            console.error(chalk_1.default.red("  ✗ PACS retrieve reported error status."));
+            return false;
+        }
+    }
+    console.error(chalk_1.default.red("  ✗ PACS retrieve timed out."));
+    return false;
+}
+async function series_retrieveAndCopy(seriesItem, studyUID, pacsserver, dest, idx, total) {
+    console.log(chalk_1.default.cyan(`\n[PACS Retrieve ${idx + 1}/${total}] Processing series: ${seriesItem.description} (${seriesItem.uid})...`));
+    const queryPayload = {
+        title: `Synthetic cp Query ${seriesItem.uid}`,
+        query: JSON.stringify({ SeriesInstanceUID: seriesItem.uid, StudyInstanceUID: studyUID }),
+        execute: false,
+    };
+    console.log(chalk_1.default.gray("  -> Registering synthetic query on CUBE..."));
+    const queryResult = await (0, index_js_1.pacsQueries_create)(pacsserver, queryPayload);
+    if (!queryResult.ok) {
+        console.error(chalk_1.default.red(`  ✗ Failed to create synthetic query for series ${seriesItem.uid}`));
+        return false;
+    }
+    const syntheticQueryId = queryResult.value.id;
+    console.log(chalk_1.default.gray(`  -> Triggering PACS retrieve (Query ID: ${syntheticQueryId})...`));
+    const retrieveResult = await (0, index_js_1.pacsRetrieve_create)(syntheticQueryId);
+    if (!retrieveResult.ok) {
+        console.error(chalk_1.default.red(`  ✗ Failed to create PACS retrieve for query ${syntheticQueryId}`));
+        return false;
+    }
+    console.log(chalk_1.default.gray("  -> Pulling series data sequentially, polling progress..."));
+    const finished = await retrieve_pollUntilComplete(syntheticQueryId, seriesItem.uid, 60);
+    if (!finished)
+        return false;
+    console.log(chalk_1.default.gray("  -> Finding folder path on ChRIS storage..."));
+    const folderPath = await series_getFolderPath(seriesItem.uid);
+    if (!folderPath) {
+        console.error(chalk_1.default.red(`  ✗ No registered folder path found for series UID ${seriesItem.uid}`));
+        return false;
+    }
+    const absoluteFolderPath = folderPath.startsWith("/") ? folderPath : "/" + folderPath;
+    const cleanDesc = seriesItem.description.replace(/[\s/]/g, "_");
+    const targetSeriesFolder = path_1.default.posix.join(dest, `Series_${seriesItem.uid}_${cleanDesc}`);
+    console.log(chalk_1.default.gray(`  -> Copying series files to '${targetSeriesFolder}'...`));
+    const copySuccess = await (0, index_js_2.files_copyRecursively)(absoluteFolderPath, targetSeriesFolder);
+    if (!copySuccess) {
+        console.error(chalk_1.default.red(`  ✗ Recursive copy failed from '${absoluteFolderPath}' to '${targetSeriesFolder}'`));
+        return false;
+    }
+    console.log(chalk_1.default.green(`  ✓ Series '${seriesItem.description}' copied successfully.`));
+    return true;
+}
+/**
+ * Virtual PACS Search results VFS provider.
+ */
+class PacsVfsProvider {
+    /** Prefix matches /net/pacs and subdirectories. */
+    prefix = "/net/pacs";
+    /** Cache for decoded PACS query results to avoid redundant API hits. */
+    _queryCache = new Map();
+    /**
+     * Fetches the decoded query result, leveraging a cache to prevent redundant API calls.
+     *
+     * @param queryId - The ID of the PACS query to decode.
+     * @returns Promise resolving to the decoded PACS query result, or null if fetch fails.
+     */
+    async queryResult_fetch(queryId) {
+        const cached = this._queryCache.get(queryId);
+        if (cached) {
+            return cached;
+        }
+        const decodedResult = await (0, index_js_1.pacsQuery_resultDecode)(queryId);
+        if (!decodedResult.ok || !decodedResult.value) {
+            return null;
+        }
+        this._queryCache.set(queryId, decodedResult.value);
+        return decodedResult.value;
+    }
+    /**
+     * Lazily lists virtual directory contents under `/net/pacs`.
+     */
+    async list(pathStr, options) {
+        try {
+            const effectivePath = (0, pacsHelpers_js_1.path_normalize)(pathStr);
+            if (effectivePath === "/net/pacs")
+                return pacsRoot_list();
+            if (effectivePath === "/net/pacs/queries")
+                return queries_list(options);
+            const parts = effectivePath.split("/").filter(Boolean);
+            if (parts.length >= 3 && parts[2] !== "queries") {
+                cumin_1.errorStack.stack_push("error", `'${effectivePath}': No such virtual directory. Valid paths under /net/pacs: /net/pacs/queries`);
+                return (0, cumin_1.Err)();
+            }
+            const queryFolder = parts[3];
+            if (!queryFolder)
+                return (0, cumin_1.Ok)([]);
+            const queryId = (0, pacsHelpers_js_1.queryId_extractFromFolder)(queryFolder);
+            if (Number.isNaN(queryId)) {
+                cumin_1.errorStack.stack_push("error", `'${effectivePath}': No such virtual directory. Use 'ls /net/pacs/queries' to see available queries.`);
+                return (0, cumin_1.Err)();
+            }
+            const decoded = await this.queryResult_fetch(queryId);
+            if (!decoded?.json) {
+                cumin_1.errorStack.stack_push("error", `PACS query ${queryId} has no structured study/series result payload.`);
+                return (0, cumin_1.Err)();
+            }
+            const studies = (0, pacsHelpers_js_1.studies_extractFromDecoded)(decoded.json);
+            if (parts.length === 4)
+                return studies_list(studies, options);
+            const studyUID = parts[4].replace(/^Study_/, "").split("_")[0];
+            const studyObj = (0, pacsHelpers_js_1.study_findByUID)(studies, studyUID);
+            if (!studyObj)
+                return (0, cumin_1.Ok)([]);
+            const seriesArr = (0, pacsHelpers_js_1.series_extractFromStudy)(studyObj);
+            if (parts.length === 5)
+                return series_list(seriesArr, options);
+            if (parts.length === 6) {
+                const seriesUID = parts[5].replace(/^Series_/, "").split("_")[0];
+                const seriesObj = (0, pacsHelpers_js_1.series_findByUID)(seriesArr, seriesUID);
+                if (!seriesObj)
+                    return (0, cumin_1.Ok)([]);
+                return seriesFiles_list(seriesObj);
+            }
+            return (0, cumin_1.Ok)([]);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            cumin_1.errorStack.stack_push("error", `PACS VFS list failed: ${msg}`);
+            return (0, cumin_1.Err)();
+        }
+    }
+    /**
+     * Triggers sequential synthetic PACS pulls and link-copies results to feed destination.
+     *
+     * @param src - Source PACS absolute virtual path.
+     * @param dest - Destination native feed folder.
+     * @param options - Copy options like recursive.
+     */
+    async cp(src, dest, _options) {
+        try {
+            const parsedResult = (0, pacsHelpers_js_1.cpSrc_parse)(src);
+            if (!parsedResult.ok)
+                return false;
+            const { studyUID, seriesUID, queryId } = parsedResult.value;
+            const decoded = await this.queryResult_fetch(queryId);
+            if (!decoded?.json) {
+                cumin_1.errorStack.stack_push("error", `cp: Failed to decode query results for query ID ${queryId}`);
+                return false;
+            }
+            const seriesResult = seriesToRetrieve_build(decoded, studyUID, seriesUID, src);
+            if (!seriesResult.ok)
+                return false;
+            const seriesToRetrieve = seriesResult.value;
+            const serverResult = await pacsServer_resolve();
+            if (!serverResult.ok)
+                return false;
+            const pacsserver = serverResult.value;
+            console.log(chalk_1.default.cyan(`[PACS Retrieve] Initiating sequential gather of ${seriesToRetrieve.length} series...`));
+            let overallSuccess = true;
+            for (let i = 0; i < seriesToRetrieve.length; i++) {
+                const ok = await series_retrieveAndCopy(seriesToRetrieve[i], studyUID, pacsserver, dest, i, seriesToRetrieve.length);
+                if (!ok)
+                    overallSuccess = false;
+            }
+            return overallSuccess;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            cumin_1.errorStack.stack_push("error", `PACS cp failed: ${msg}`);
+            return false;
+        }
+    }
+    /**
+     * Reads virtual file content under '/net/pacs'.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns Promise resolving to a Result containing the file contents as a string.
+     */
+    async read(pathStr) {
+        return (0, pacs_content_js_1.pacsVfs_read)(pathStr, (queryId) => this.queryResult_fetch(queryId));
+    }
+    /**
+     * Reads virtual file binary content under '/net/pacs'.
+     *
+     * @param pathStr - The absolute virtual path of the file to read.
+     * @returns Promise resolving to a Result containing the file contents as a Buffer.
+     */
+    async readBinary(pathStr) {
+        return (0, pacs_content_js_1.pacsVfs_readBinary)(pathStr, (queryId) => this.queryResult_fetch(queryId));
+    }
+}
+exports.PacsVfsProvider = PacsVfsProvider;
+//# sourceMappingURL=pacs.js.map