@fnndsc/brasa 0.1.0

package/dist/builtins/net/pacsUtils.js

@@ -0,0 +1,184 @@
+/**
+ * @file Shared PACS utilities for VFS path traversal and CUBE FS resolution.
+ *
+ * Used by `pull` and `cubepath` builtins.
+ *
+ * @module
+ */
+import { errorStack, pacsQuery_resultDecode, pacsServers_list, chrisContext, Context } from '@fnndsc/cumin';
+/**
+ * Safely unwraps a DICOM tag value (may be `{value: ...}` wrapper or plain string/number).
+ */
+export function pacs_tagValueExtract(val) {
+    if (val && typeof val === 'object') {
+        const r = val;
+        if ('value' in r)
+            return String(r.value ?? '');
+        if ('Value' in r && Array.isArray(r.Value) && r.Value.length > 0)
+            return String(r.Value[0] ?? '');
+    }
+    return String(val ?? '');
+}
+/**
+ * Extracts the UID portion of a VFS folder name (`<prefix>_<uid>_<label>`).
+ */
+export function folderUID_get(folder, prefix) {
+    const withoutPrefix = folder.replace(new RegExp(`^${prefix}_`), '');
+    return withoutPrefix.split('_')[0];
+}
+/**
+ * Resolves a PACS server identifier string from a numeric ID or context.
+ *
+ * @param override - Optional numeric-string PACS server ID from flags.
+ * @returns Resolved identifier string, or null if unavailable.
+ */
+export async function pacsServer_resolve(override) {
+    const raw = override ?? await chrisContext.current_get(Context.PACSserver);
+    if (!raw) {
+        const serversResult = await pacsServers_list();
+        if (serversResult.ok && serversResult.value.length > 0) {
+            return String(serversResult.value[0].id);
+        }
+        return null;
+    }
+    if (/^\d+$/.test(raw)) {
+        const allServers = await pacsServers_list();
+        if (allServers.ok) {
+            const srv = allServers.value.find(s => s.id === Number(raw));
+            if (srv?.identifier)
+                return srv.identifier;
+        }
+    }
+    return raw;
+}
+/**
+ * Walks a `/net/pacs/queries/...` VFS path and collects series info.
+ *
+ * Supports query-level, study-level, and series-level paths.
+ *
+ * @param pathStr - Absolute VFS path to a query, study, or series directory.
+ * @param fallbackPacsName - PACS identifier used when RetrieveAETitle is absent.
+ * @param callerTag - Command name for error messages (e.g. 'pull', 'cubepath').
+ * @returns Array of PACSSeriesInfo for all matched series.
+ */
+export async function pacs_seriesCollect(pathStr, fallbackPacsName, callerTag = 'pacs') {
+    const effective = pathStr.startsWith('/') ? pathStr : '/' + pathStr;
+    const parts = effective.split('/').filter(Boolean);
+    if (parts.length < 4 ||
+        parts[0] !== 'net' ||
+        parts[1] !== 'pacs' ||
+        parts[2] !== 'queries') {
+        errorStack.stack_push('error', `${callerTag}: Not a PACS query path: ${pathStr}`);
+        return [];
+    }
+    const queryFolder = parts[3];
+    const qidMatch = /_qid:(\d+)/.exec(queryFolder);
+    const queryId = qidMatch ? Number(qidMatch[1]) : NaN;
+    if (Number.isNaN(queryId)) {
+        errorStack.stack_push('error', `${callerTag}: Cannot parse query ID from: ${queryFolder}`);
+        return [];
+    }
+    const queryLabel = queryFolder.replace(/_qid:\d+.*$/, '');
+    const decodedResult = await pacsQuery_resultDecode(queryId);
+    if (!decodedResult.ok || !decodedResult.value.json) {
+        errorStack.stack_push('error', `${callerTag}: Failed to decode results for query ${queryId}`);
+        return [];
+    }
+    const raw = decodedResult.value.json;
+    let studiesSource;
+    if (raw && typeof raw === 'object') {
+        const r = raw;
+        studiesSource =
+            'studies' in r ? r.studies :
+                'Studies' in r ? r.Studies :
+                    'results' in r ? r.results :
+                        raw;
+    }
+    else {
+        studiesSource = raw;
+    }
+    const studies = (Array.isArray(studiesSource) ? studiesSource : [studiesSource]);
+    const targetStudyUID = parts.length >= 5
+        ? folderUID_get(parts[4], 'Study')
+        : null;
+    const targetSeriesUID = parts.length >= 6
+        ? folderUID_get(parts[5], 'Series')
+        : null;
+    const infos = [];
+    for (const studyObj of studies) {
+        if (!studyObj || typeof studyObj !== 'object')
+            continue;
+        const studyUID = pacs_tagValueExtract(studyObj.StudyInstanceUID ?? studyObj.uid);
+        if (targetStudyUID && studyUID !== targetStudyUID)
+            continue;
+        const studyLabel = pacs_tagValueExtract(studyObj.StudyDescription ?? 'Study').replace(/[\s/]/g, '_');
+        const retrieveAETitle = pacs_tagValueExtract(studyObj.RetrieveAETitle ?? '');
+        const pacsName = retrieveAETitle || fallbackPacsName;
+        const seriesArr = (Array.isArray(studyObj.series) ? studyObj.series :
+            Array.isArray(studyObj.Series) ? studyObj.Series :
+                Array.isArray(studyObj.results) ? studyObj.results :
+                    []);
+        for (const seriesObj of seriesArr) {
+            if (!seriesObj || typeof seriesObj !== 'object')
+                continue;
+            const seriesUID = pacs_tagValueExtract(seriesObj.SeriesInstanceUID ?? seriesObj.uid);
+            if (!seriesUID)
+                continue;
+            if (targetSeriesUID && seriesUID !== targetSeriesUID)
+                continue;
+            const seriesLabel = pacs_tagValueExtract(seriesObj.SeriesDescription ?? 'Series').replace(/[\s/]/g, '_');
+            const expectedFiles = Number(pacs_tagValueExtract(seriesObj.NumberOfSeriesRelatedInstances ?? '0')) || 0;
+            infos.push({
+                label: `${queryLabel}|${studyLabel}|${seriesLabel}`,
+                seriesLabel,
+                studyLabel,
+                queryLabel,
+                seriesUID,
+                studyUID,
+                pacsName,
+                expectedFiles,
+            });
+        }
+    }
+    return infos;
+}
+/**
+ * Resolves the CUBE FS folder path and actual file count for a series.
+ *
+ * Retries up to `maxAttempts` times with `retryDelayMs` between attempts
+ * to handle the timing gap between LONK completion and pacsseries DB indexing.
+ *
+ * @param seriesUID - DICOM SeriesInstanceUID.
+ * @param pacsClient - ChRIS API client with getPACSSeriesList and getPACSFiles.
+ * @param maxAttempts - Number of attempts before giving up (default 4).
+ * @param retryDelayMs - Delay between attempts in ms (default 2000).
+ * @returns SeriesCubePath on success, or null if not found.
+ */
+export async function series_cubePathGet(seriesUID, pacsClient, maxAttempts = 4, retryDelayMs = 2_000) {
+    const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            if (attempt > 0)
+                await sleep(retryDelayMs);
+            const seriesList = await pacsClient.getPACSSeriesList({ SeriesInstanceUID: seriesUID, limit: 1 });
+            const items = seriesList.getItems();
+            if (items.length === 0)
+                continue;
+            const series = items[0];
+            const raw = series?.data?.folder_path;
+            if (!raw)
+                continue;
+            // Display path has leading slash; fname query uses raw (API stores without leading slash)
+            const folderPath = raw.startsWith('/') ? raw : `/${raw}`;
+            const fnameQuery = raw.startsWith('/') ? raw.slice(1) : raw;
+            const fileList = await pacsClient.getPACSFiles({ fname: fnameQuery, limit: 1 });
+            const fileCount = Math.max(0, fileList.totalCount);
+            return { folderPath, fileCount };
+        }
+        catch {
+            // retry
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=pacsUtils.js.map

package/dist/builtins/net/pacsUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pacsUtils.js","sourceRoot":"","sources":["../../../src/builtins/net/pacsUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAsC5G;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,GAA4B,GAA8B,CAAC;QAClE,IAAI,OAAO,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,MAAc;IAC1D,MAAM,aAAa,GAAW,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5E,OAAO,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAwB;IAC/D,MAAM,GAAG,GAAkB,QAAQ,IAAI,MAAM,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1F,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,aAAa,GAAG,MAAM,gBAAgB,EAAE,CAAC;QAC/C,IAAI,aAAa,CAAC,EAAE,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,MAAM,gBAAgB,EAAE,CAAC;QAC5C,IAAI,UAAU,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7D,IAAI,GAAG,EAAE,UAAU;gBAAE,OAAO,GAAG,CAAC,UAAU,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAe,EACf,gBAAwB,EACxB,YAAoB,MAAM;IAE1B,MAAM,SAAS,GAAW,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC;IAC5E,MAAM,KAAK,GAAa,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE7D,IACE,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK;QAClB,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM;QACnB,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EACtB,CAAC;QACD,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,SAAS,4BAA4B,OAAO,EAAE,CAAC,CAAC;QAClF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,WAAW,GAAW,KAAK,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,QAAQ,GAA2B,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxE,MAAM,OAAO,GAAW,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7D,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,SAAS,iCAAiC,WAAW,EAAE,CAAC,CAAC;QAC3F,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,UAAU,GAAW,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAElE,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC5D,IAAI,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACnD,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,SAAS,wCAAwC,OAAO,EAAE,CAAC,CAAC;QAC9F,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAY,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;IAC9C,IAAI,aAAsB,CAAC;IAC3B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,GAA4B,GAA8B,CAAC;QAClE,aAAa;YACX,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC5B,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBAC5B,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;wBAC5B,GAAG,CAAC;IACR,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,GAAG,CAAC;IACtB,CAAC;IACD,MAAM,OAAO,GACX,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAA8B,CAAC;IAEhG,MAAM,cAAc,GAAkB,KAAK,CAAC,MAAM,IAAI,CAAC;QACrD,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;QAClC,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,eAAe,GAAkB,KAAK,CAAC,MAAM,IAAI,CAAC;QACtD,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;QACnC,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,KAAK,GAAqB,EAAE,CAAC;IAEnC,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,SAAS;QAExD,MAAM,QAAQ,GAAW,oBAAoB,CAAC,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzF,IAAI,cAAc,IAAI,QAAQ,KAAK,cAAc;YAAE,SAAS;QAE5D,MAAM,UAAU,GAAW,oBAAoB,CAAC,QAAQ,CAAC,gBAAgB,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7G,MAAM,eAAe,GAAW,oBAAoB,CAAC,QAAQ,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;QACrF,MAAM,QAAQ,GAAW,eAAe,IAAI,gBAAgB,CAAC;QAE7D,MAAM,SAAS,GAA8B,CAC3C,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAClD,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAClD,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBACpD,EAAE,CAC0B,CAAC;QAE/B,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,SAAS;YAE1D,MAAM,SAAS,GAAW,oBAAoB,CAAC,SAAS,CAAC,iBAAiB,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;YAC7F,IAAI,CAAC,SAAS;gBAAE,SAAS;YACzB,IAAI,eAAe,IAAI,SAAS,KAAK,eAAe;gBAAE,SAAS;YAE/D,MAAM,WAAW,GAAW,oBAAoB,CAAC,SAAS,CAAC,iBAAiB,IAAI,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACjH,MAAM,aAAa,GAAW,MAAM,CAAC,oBAAoB,CAAC,SAAS,CAAC,8BAA8B,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;YAEjH,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE,GAAG,UAAU,IAAI,UAAU,IAAI,WAAW,EAAE;gBACnD,WAAW;gBACX,UAAU;gBACV,UAAU;gBACV,SAAS;gBACT,QAAQ;gBACR,QAAQ;gBACR,aAAa;aACd,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,UAA2B,EAC3B,cAAsB,CAAC,EACvB,eAAuB,KAAK;IAE5B,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAoB,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAEtG,KAAK,IAAI,OAAO,GAAW,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAC/D,IAAI,CAAC;YACH,IAAI,OAAO,GAAG,CAAC;gBAAE,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;YAE3C,MAAM,UAAU,GACd,MAAM,UAAU,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACjF,MAAM,KAAK,GAAmB,UAAU,CAAC,QAAQ,EAAE,CAAC;YACpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEjC,MAAM,MAAM,GAAwC,KAAK,CAAC,CAAC,CAAwC,CAAC;YACpG,MAAM,GAAG,GAAuB,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC;YAC1D,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,0FAA0F;YAC1F,MAAM,UAAU,GAAW,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;YACjE,MAAM,UAAU,GAAW,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAEpE,MAAM,QAAQ,GACZ,MAAM,UAAU,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACjE,MAAM,SAAS,GAAW,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;YAE3D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ;QACV,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/builtins/net/query.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @file Builtin query command.
+ *
+ * Creates a PACS query, polls until the result is populated, displays the found
+ * studies/series, and prints the VFS path for downstream `pull` or `cd` use.
+ *
+ * Also exports `pacsQuery_createAndWait` for reuse by `builtin_pull`.
+ *
+ * @module
+ */
+import { PACSQueryDecodedResult } from '@fnndsc/cumin';
+/**
+ * Result of a successful query-create-and-wait operation.
+ *
+ * @property queryId - ID of the created PACSQuery.
+ * @property vfsPath - Full `/net/pacs/queries/<id>_<desc>` path.
+ * @property decoded - Decoded query result payload.
+ */
+export interface QueryCreateResult {
+    queryId: number;
+    vfsPath: string;
+    decoded: PACSQueryDecodedResult;
+}
+/**
+ * Parses a comma-separated `Key:Value[,Key:Value]` expression into an object.
+ * Falls back to JSON parse if the string starts with `{`.
+ *
+ * @param expr - Query expression string.
+ * @returns Parsed key-value record, or null if invalid.
+ */
+export declare function queryExpr_parse(expr: string): Record<string, string> | null;
+/**
+ * Builds the VFS path for a query, matching the PacsVfsProvider folder-naming logic.
+ *
+ * @param queryId - The numeric query ID.
+ * @param queryObj - The parsed query key-value pairs.
+ * @param username - Optional username to embed in the folder name.
+ * @returns Absolute VFS path string.
+ */
+export declare function queryVfsPath_build(queryId: number, queryObj: Record<string, string>, username?: string): string;
+/**
+ * Creates a PACS query and blocks until the result is populated or timeout.
+ *
+ * @param queryExpr - Comma-separated `Key:Value` string or JSON object string.
+ * @param title - Title for the new PACSQuery record.
+ * @param pacsserver - PACS server ID or identifier string.
+ * @param onStatus - Optional callback called each poll tick with a status message.
+ * @returns QueryCreateResult on success, or null on failure/timeout.
+ */
+export declare function pacsQuery_createAndWait(queryExpr: string, title: string, pacsserver: string, onStatus?: (msg: string) => void): Promise<QueryCreateResult | null>;
+/**
+ * Creates a PACS query, waits for results, displays findings, and prints the VFS path.
+ *
+ * @param args - `<queryExpression> [--title <title>] [--pacsserver <id>] [--table] [--help]`
+ * @example
+ * query PatientID:1234
+ * query 'PatientID:1234,StudyDate:20240101' --title 'Hip DDH Jan 2024'
+ * query AccessionNumber:12345678 --table
+ */
+export declare function builtin_query(args: string[]): Promise<void>;

package/dist/builtins/net/query.js

@@ -0,0 +1,324 @@
+/**
+ * @file Builtin query command.
+ *
+ * Creates a PACS query, polls until the result is populated, displays the found
+ * studies/series, and prints the VFS path for downstream `pull` or `cd` use.
+ *
+ * Also exports `pacsQuery_createAndWait` for reuse by `builtin_pull`.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+import { errorStack, chrisContext, Context, pacsQuery_get, pacsQuery_resultDecode, pacsQueries_create, pacsServers_list, } from '@fnndsc/cumin';
+import { screen } from '@fnndsc/chili/screen/screen.js';
+import { spinner } from '../../lib/spinner.js';
+import { args_checkHasHelpFlag, help_show } from '../help.js';
+const QUERY_POLL_INTERVAL_MS = 2_000;
+const QUERY_TIMEOUT_MS = 60_000;
+/**
+ * Parses a comma-separated `Key:Value[,Key:Value]` expression into an object.
+ * Falls back to JSON parse if the string starts with `{`.
+ *
+ * @param expr - Query expression string.
+ * @returns Parsed key-value record, or null if invalid.
+ */
+export function queryExpr_parse(expr) {
+    if (expr.trimStart().startsWith('{')) {
+        try {
+            const parsed = JSON.parse(expr);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            // fall through
+        }
+        return null;
+    }
+    const result = {};
+    for (const part of expr.split(',')) {
+        const colonIdx = part.indexOf(':');
+        if (colonIdx < 1)
+            return null;
+        const key = part.slice(0, colonIdx).trim();
+        const value = part.slice(colonIdx + 1).trim();
+        if (!key || !value)
+            return null;
+        result[key] = value;
+    }
+    return Object.keys(result).length > 0 ? result : null;
+}
+/**
+ * Builds the VFS path for a query, matching the PacsVfsProvider folder-naming logic.
+ *
+ * @param queryId - The numeric query ID.
+ * @param queryObj - The parsed query key-value pairs.
+ * @param username - Optional username to embed in the folder name.
+ * @returns Absolute VFS path string.
+ */
+export function queryVfsPath_build(queryId, queryObj, username) {
+    const parts = Object.entries(queryObj)
+        .filter(([, v]) => v.trim().length > 0)
+        .map(([k, v]) => `${k}:${v}`);
+    const desc = parts.join('_') || 'query';
+    const userSuffix = username ? `_${username}` : '';
+    return `/net/pacs/queries/${desc}_qid:${queryId}${userSuffix}`;
+}
+/**
+ * Creates a PACS query and blocks until the result is populated or timeout.
+ *
+ * @param queryExpr - Comma-separated `Key:Value` string or JSON object string.
+ * @param title - Title for the new PACSQuery record.
+ * @param pacsserver - PACS server ID or identifier string.
+ * @param onStatus - Optional callback called each poll tick with a status message.
+ * @returns QueryCreateResult on success, or null on failure/timeout.
+ */
+export async function pacsQuery_createAndWait(queryExpr, title, pacsserver, onStatus) {
+    const queryObj = queryExpr_parse(queryExpr);
+    if (!queryObj) {
+        errorStack.stack_push('error', `query: Invalid expression: "${queryExpr}". Use Key:Value or JSON.`);
+        return null;
+    }
+    const payload = {
+        title,
+        query: JSON.stringify(queryObj),
+    };
+    const createResult = await pacsQueries_create(pacsserver, payload);
+    if (!createResult.ok) {
+        return null;
+    }
+    const queryId = createResult.value.id;
+    const ownerUsername = typeof createResult.value.owner_username === 'string' ? createResult.value.owner_username : undefined;
+    const vfsPath = queryVfsPath_build(queryId, queryObj, ownerUsername);
+    const deadline = Date.now() + QUERY_TIMEOUT_MS;
+    const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+    let succeededWithoutPayload = 0;
+    while (Date.now() < deadline) {
+        const statusResult = await pacsQuery_get(queryId);
+        const status = statusResult.ok ? (statusResult.value.status ?? 'pending') : 'pending';
+        onStatus?.(`Query ${queryId} — ${status}`);
+        const decodeResult = await pacsQuery_resultDecode(queryId);
+        if (decodeResult.ok && decodeResult.value.json !== undefined) {
+            return { queryId, vfsPath, decoded: decodeResult.value };
+        }
+        if (!decodeResult.ok) {
+            // A missing payload is the expected state while polling; drop the
+            // error the probe pushed so the stack doesn't fill with one copy
+            // per poll tick.
+            errorStack.stack_pop();
+        }
+        // A succeeded query with no stored payload means the PACS matched
+        // nothing; a couple of grace polls cover result-write lag.
+        if (status === 'succeeded' && ++succeededWithoutPayload >= 2) {
+            return { queryId, vfsPath, decoded: { raw: '' } };
+        }
+        await sleep(QUERY_POLL_INTERVAL_MS);
+    }
+    errorStack.stack_push('error', `query: Timed out waiting for query ${queryId} result.`);
+    return null;
+}
+/**
+ * Renders decoded PACS query JSON into a human-readable study/series summary.
+ *
+ * @param decoded - Decoded query result from `pacsQuery_resultDecode`.
+ * @returns Formatted multi-line string, or null if no displayable content.
+ */
+function queryResult_render(decoded) {
+    const payload = decoded.json;
+    if (!payload || typeof payload !== 'object')
+        return null;
+    const tagVal = (v) => {
+        if (v && typeof v === 'object' && 'value' in v) {
+            return String(v.value ?? '');
+        }
+        return String(v ?? '');
+    };
+    const lines = [];
+    const payloadArr = Array.isArray(payload) ? payload : [payload];
+    let totalSeries = 0;
+    payloadArr.forEach((studyRaw, sIdx) => {
+        if (!studyRaw || typeof studyRaw !== 'object')
+            return;
+        const study = studyRaw;
+        const studyDesc = tagVal(study.StudyDescription ?? '');
+        const patientName = tagVal(study.PatientName ?? study.patient_name ?? '');
+        const patientId = tagVal(study.PatientID ?? study.patient_id ?? '');
+        const studyDate = tagVal(study.StudyDate ?? '');
+        const modalities = tagVal(study.ModalitiesInStudy ?? '');
+        const accession = tagVal(study.AccessionNumber ?? '');
+        lines.push(chalk.bold.cyan(`  Study ${sIdx + 1}: ${studyDesc || '(no description)'}`));
+        if (patientName)
+            lines.push(chalk.gray(`    Patient:   ${patientName}${patientId ? ` (ID: ${patientId})` : ''}`));
+        if (studyDate)
+            lines.push(chalk.gray(`    Date:      ${studyDate}`));
+        if (modalities)
+            lines.push(chalk.gray(`    Modality:  ${modalities}`));
+        if (accession)
+            lines.push(chalk.gray(`    Accession: ${accession}`));
+        const seriesArr = Array.isArray(study.series) ? study.series :
+            Array.isArray(study.Series) ? study.Series :
+                Array.isArray(study.results) ? study.results :
+                    [];
+        if (seriesArr.length > 0) {
+            lines.push('');
+            seriesArr.forEach((seriesRaw, rIdx) => {
+                if (!seriesRaw || typeof seriesRaw !== 'object')
+                    return;
+                const series = seriesRaw;
+                const desc = tagVal(series.SeriesDescription ?? '');
+                const mod = tagVal(series.Modality ?? '');
+                const count = tagVal(series.NumberOfSeriesRelatedInstances ?? '');
+                const countStr = count ? chalk.gray(` (${count} files)`) : '';
+                const modStr = mod ? chalk.yellow(` [${mod}]`) : '';
+                lines.push(`    ${chalk.white(`Series ${rIdx + 1}:`)} ${desc || '(no description)'}${modStr}${countStr}`);
+                totalSeries++;
+            });
+        }
+        lines.push('');
+    });
+    if (lines.length === 0)
+        return null;
+    lines.unshift(chalk.gray(`  ${payloadArr.length} study/studies, ${totalSeries} series`));
+    lines.unshift('');
+    return lines.join('\n');
+}
+/**
+ * Renders decoded PACS query JSON as a per-study table with one row per series.
+ *
+ * Columns: Study, #, Description, Modality, Files.
+ *
+ * @param decoded - Decoded query result from `pacsQuery_resultDecode`.
+ * @param title - Optional title shown above the table.
+ * @returns Formatted table string, or null if no displayable content.
+ */
+function queryResult_renderTable(decoded, title) {
+    const payload = decoded.json;
+    if (!payload || typeof payload !== 'object')
+        return null;
+    const tagVal = (v) => {
+        if (v && typeof v === 'object' && 'value' in v) {
+            return String(v.value ?? '');
+        }
+        return String(v ?? '');
+    };
+    const rows = [];
+    const payloadArr = Array.isArray(payload) ? payload : [payload];
+    payloadArr.forEach((studyRaw, sIdx) => {
+        if (!studyRaw || typeof studyRaw !== 'object')
+            return;
+        const study = studyRaw;
+        const studyLabel = tagVal(study.StudyDescription ?? `Study ${sIdx + 1}`);
+        const accession = tagVal(study.AccessionNumber ?? '');
+        const studyDisplay = accession ? `${studyLabel} [${accession}]` : studyLabel;
+        const seriesArr = Array.isArray(study.series) ? study.series :
+            Array.isArray(study.Series) ? study.Series :
+                Array.isArray(study.results) ? study.results :
+                    [];
+        seriesArr.forEach((seriesRaw, rIdx) => {
+            if (!seriesRaw || typeof seriesRaw !== 'object')
+                return;
+            const series = seriesRaw;
+            rows.push({
+                Study: studyDisplay,
+                '#': String(rIdx + 1),
+                Description: tagVal(series.SeriesDescription ?? ''),
+                Modality: tagVal(series.Modality ?? ''),
+                Files: tagVal(series.NumberOfSeriesRelatedInstances ?? ''),
+            });
+        });
+    });
+    if (rows.length === 0)
+        return null;
+    return screen.table_output(rows, { title: { title: title ?? 'Query Results' } });
+}
+/**
+ * Creates a PACS query, waits for results, displays findings, and prints the VFS path.
+ *
+ * @param args - `<queryExpression> [--title <title>] [--pacsserver <id>] [--table] [--help]`
+ * @example
+ * query PatientID:1234
+ * query 'PatientID:1234,StudyDate:20240101' --title 'Hip DDH Jan 2024'
+ * query AccessionNumber:12345678 --table
+ */
+export async function builtin_query(args) {
+    if (args_checkHasHelpFlag(args, 'query')) {
+        help_show('query');
+        return;
+    }
+    let title = `Query ${Date.now()}`;
+    let pacsserverOverride = null;
+    let tableMode = false;
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--title' && i + 1 < args.length) {
+            title = args[++i];
+        }
+        else if (args[i] === '--pacsserver' && i + 1 < args.length) {
+            pacsserverOverride = args[++i];
+        }
+        else if (args[i] === '--table') {
+            tableMode = true;
+        }
+        else if (!args[i].startsWith('--')) {
+            positional.push(args[i]);
+        }
+    }
+    if (positional.length === 0) {
+        console.error(chalk.red('query: Missing query expression. Usage: query <Key:Value[,...]> [--title <title>]'));
+        process.exitCode = 1;
+        return;
+    }
+    const queryExpr = positional.join(' ');
+    // Validate expression early
+    if (!queryExpr_parse(queryExpr)) {
+        console.error(chalk.red(`query: Invalid expression: "${queryExpr}". Use Key:Value pairs (e.g. PatientID:1234) or JSON.`));
+        process.exitCode = 1;
+        return;
+    }
+    // Resolve PACS server
+    let pacsserver = pacsserverOverride ?? await chrisContext.current_get(Context.PACSserver);
+    if (!pacsserver) {
+        const serversResult = await pacsServers_list();
+        if (serversResult.ok && serversResult.value.length > 0) {
+            pacsserver = String(serversResult.value[0].id);
+        }
+        else {
+            console.error(chalk.red('query: No PACS server available. Set one with: pacs connect <id>'));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    spinner.start(`Querying PACS for ${queryExpr}...`, true);
+    const result = await pacsQuery_createAndWait(queryExpr, title, pacsserver, (msg) => spinner.updateMessage(msg));
+    spinner.stop();
+    if (!result) {
+        const errs = errorStack.stack_getAll?.() ?? [];
+        if (errs.length) {
+            // Print the stack directly: in -c/-f mode nothing else will.
+            errs.forEach((err) => {
+                const msg = typeof err === 'string' ? err : (err.message ?? String(err));
+                console.error(chalk.red(msg));
+            });
+        }
+        else {
+            console.error(chalk.red('query: Failed — check connection and PACS server context.'));
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const rendered = tableMode
+        ? queryResult_renderTable(result.decoded, title !== `Query ${Date.now()}` ? title : undefined)
+        : queryResult_render(result.decoded);
+    if (!rendered) {
+        // Nothing matched: browsing or pulling the empty query would be
+        // meaningless, so no hints.
+        console.log(chalk.yellow(`⚠ Query ${result.queryId} complete — no studies found.`));
+        return;
+    }
+    console.log(chalk.green(`✓ Query ${result.queryId} complete`));
+    console.log(rendered);
+    console.log(chalk.bold(`  VFS path: ${chalk.cyan(result.vfsPath)}`));
+    console.log(chalk.gray(`  cd ${result.vfsPath}`));
+    console.log(chalk.gray(`  pull ${result.vfsPath}`));
+}
+//# sourceMappingURL=query.js.map

package/dist/builtins/net/query.js.map

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

package/dist/builtins/parametersofplugin.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file Builtin that lists the parameters of a plugin.
+ *
+ * @module
+ */
+/**
+ * Handles the 'parametersofplugin' builtin command.
+ * This command displays information about plugin parameters.
+ *
+ * @param args - Arguments passed to the command.
+ * @returns A Promise that resolves once the command has been processed.
+ */
+export declare function builtin_parametersofplugin(args: string[]): Promise<void>;

package/dist/builtins/parametersofplugin.js

@@ -0,0 +1,43 @@
+/**
+ * @file Builtin that lists the parameters of a plugin.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+import { commandArgs_process } from './utils.js';
+import { PluginContextGroupHandler } from '@fnndsc/chili/plugins/pluginGroupHandler.js';
+/**
+ * Handles the 'parametersofplugin' builtin command.
+ * This command displays information about plugin parameters.
+ *
+ * @param args - Arguments passed to the command.
+ * @returns A Promise that resolves once the command has been processed.
+ */
+export async function builtin_parametersofplugin(args) {
+    const parsedArgs = commandArgs_process(args);
+    const subcommand = parsedArgs._[0]; // e.g., 'list', 'fieldslist'
+    const pluginIdFromArgs = parsedArgs['plugin-id'];
+    if (!subcommand) {
+        console.log(chalk.red('Usage: parametersofplugin <list|fieldslist> [--plugin-id <id>] ...'));
+        return;
+    }
+    try {
+        // Instantiate the specialized handler
+        const handler = await PluginContextGroupHandler.handler_create('parametersofplugin', pluginIdFromArgs ? Number(pluginIdFromArgs) : undefined);
+        if (subcommand === 'list') {
+            // Use the specialized man-page style listing for parameters
+            await handler.parameters_listMan(parsedArgs);
+        }
+        else if (subcommand === 'fieldslist') {
+            await handler.parameters_fieldsList();
+        }
+        else {
+            console.log(chalk.yellow(`Unknown parametersofplugin subcommand: ${subcommand}`));
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.error(chalk.red(`Error in parametersofplugin: ${msg}`));
+    }
+}
+//# sourceMappingURL=parametersofplugin.js.map