@fnndsc/brasa 0.23.2 → 0.25.0

package/dist/session/answer.js

@@ -0,0 +1,163 @@
+/**
+ * @file The session's last answer, so a row can be named by its number.
+ *
+ * An operator reads a listing and wants to act on the third row. Until now
+ * the only way to say which row was to repeat its address, which for a PACS
+ * series is a line of text nobody types by hand — so acting on what you can
+ * see was a surface gesture, and a scripted session could not do it at all.
+ *
+ * A command that answers with rows records them here, and `@3` resolves
+ * against the most recent one. The numbering belongs to the MODEL rather
+ * than to any rendering of it: a console table and a graphical pane show the
+ * same answer differently, and an index that meant different rows on
+ * different surfaces would be worse than no index at all.
+ *
+ * What a row IS differs by listing, and each one says: a path for files and
+ * PACS series, a feed id for feeds, an instance id for jobs. A verb then
+ * receives the operand it already takes.
+ *
+ * @module
+ */
+import { ambient_publish } from '../core/ambient.js';
+/** Every kind an answer may carry, for a refusal that lists them. */
+export const ANSWER_KINDS = ['PAT', 'STD', 'SER', 'FIL', 'DIR'];
+/** Model kind to the rows it holds. */
+const adapters = new Map();
+/** The session's last answer, or null before anything has listed. */
+let held = null;
+/** Whether an index has been resolved against the held answer this line. */
+let consulted = false;
+/** Rises with each answer, so a surface can tell newer from older. */
+let sequence = 0;
+/** Past this many rows the addresses stay in the kernel and off the wire. */
+const VALUES_ON_THE_WIRE_MAX = 500;
+/**
+ * Registers what a model kind's rows are.
+ *
+ * @param kind - The envelope model kind.
+ * @param adapter - Reads the rows out of that model.
+ */
+export function answerAdapter_register(kind, adapter) {
+    adapters.set(kind, adapter);
+}
+/**
+ * Notes an answer, when the model is one whose rows can be numbered.
+ *
+ * @param kind - The envelope model kind.
+ * @param data - The model's payload.
+ * @param source - The line that produced it.
+ */
+export function answer_note(kind, data, source) {
+    const adapter = adapters.get(kind);
+    if (adapter === undefined)
+        return;
+    const rows = adapter(data);
+    // An answer with no rows does not replace one that has them: `ls` on an
+    // empty folder should not silently un-number the listing just read.
+    if (rows === null || rows.length === 0)
+        return;
+    sequence += 1;
+    held = { source, rows };
+    // A surface cannot light the index pills on the right listing unless it is
+    // told which one the numbers now count. Pills that lie are worse than none.
+    ambient_publish({
+        kind: 'numbered',
+        id: sequence,
+        source,
+        rows: rows.length,
+        // A surface matches a row by its address and draws the code, so the
+        // handles travel — up to a cap, past which a listing is numbered in the
+        // kernel and unnumbered on screen rather than flooding the wire.
+        handles: rows.length <= VALUES_ON_THE_WIRE_MAX ? answerHandles_get() : [],
+    });
+}
+/**
+ * The row a handle names.
+ *
+ * @param handle - The kind and 1-based ordinal the operator wrote.
+ * @returns The row, or null when nothing is numbered, the kind is absent
+ *   from the answer, or the ordinal is past that kind's end.
+ */
+export function answerRow_get(handle) {
+    if (held === null)
+        return null;
+    const ofKind = held.rows.filter((row) => row.kind === handle.kind);
+    const row = ofKind[handle.ordinal - 1];
+    if (row === undefined)
+        return null;
+    consulted = true;
+    return row;
+}
+/**
+ * How many rows of a kind the answer holds, for a refusal that says so.
+ *
+ * @param kind - The kind asked about.
+ * @returns The count, zero when nothing is numbered.
+ */
+export function answerKind_count(kind) {
+    if (held === null)
+        return 0;
+    return held.rows.filter((row) => row.kind === kind).length;
+}
+/**
+ * Every row's handle beside its address, in answer order.
+ *
+ * A surface finds each of its rows by address and draws the code the
+ * operator would type.
+ *
+ * @returns The handles.
+ */
+export function answerHandles_get() {
+    if (held === null)
+        return [];
+    const seen = new Map();
+    return held.rows.map((row) => {
+        const ordinal = (seen.get(row.kind) ?? 0) + 1;
+        seen.set(row.kind, ordinal);
+        return { kind: row.kind, ordinal, address: row.address ?? row.values[0] ?? '' };
+    });
+}
+/**
+ * What is currently numbered, for a surface that lights its index pills.
+ *
+ * @returns The held answer, or null when nothing has listed.
+ */
+export function answer_get() {
+    return held;
+}
+/**
+ * Takes the note that an index was resolved, for the line's readout.
+ *
+ * A line that acts on a number says which listing it counted — the standing
+ * rule that a readout which acts says so.
+ *
+ * @returns What was consulted, or null when this line used no index.
+ */
+export function answerConsulted_take() {
+    if (!consulted || held === null)
+        return null;
+    consulted = false;
+    return held;
+}
+/** Forgets the answer, for a test that needs a session that has listed nothing. */
+export function answer_forget() {
+    held = null;
+    consulted = false;
+    sequence = 0;
+}
+/**
+ * Which answer is numbered, for a surface attaching late.
+ *
+ * @returns The current numbering, or null when nothing has listed.
+ */
+export function numbering_get() {
+    if (held === null)
+        return null;
+    return {
+        id: sequence,
+        source: held.source,
+        rows: held.rows.length,
+        handles: held.rows.length <= VALUES_ON_THE_WIRE_MAX ? answerHandles_get() : [],
+    };
+}
+//# sourceMappingURL=answer.js.map

package/dist/session/answer.js.map

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

package/dist/session/answerAdapters.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Registers the adapters. Called once, when the engine is created.
+ */
+export declare function answerAdapters_register(): void;

package/dist/session/answerAdapters.js

@@ -0,0 +1,106 @@
+/**
+ * @file What each listing's rows are, for numbering.
+ *
+ * One adapter per model kind, registered once. A listing that has no adapter
+ * simply has no numbers, which is the honest default: a model whose rows
+ * nobody has said how to name cannot be acted on by index.
+ *
+ * @module
+ */
+import path from 'path';
+import { patientAddress_of } from '@fnndsc/menu';
+import { answerAdapter_register } from './answer.js';
+/**
+ * Registers the adapters. Called once, when the engine is created.
+ */
+export function answerAdapters_register() {
+    // A file listing's rows are paths, in the order the listing rendered them,
+    // flattened across targets the way `ls a b` prints them.
+    answerAdapter_register('fs.listing', (data) => {
+        if (!Array.isArray(data))
+            return null;
+        const rows = [];
+        for (const listing of data) {
+            if (listing === null || typeof listing !== 'object' || !Array.isArray(listing.items))
+                continue;
+            for (const item of listing.items) {
+                rows.push({
+                    kind: item.type === 'dir' ? 'DIR' : 'FIL',
+                    values: [path.posix.join(listing.path, item.name)],
+                    label: item.name,
+                });
+            }
+        }
+        return rows;
+    });
+    // A PACS answer numbers its PATIENTS, its STUDIES and its SERIES, each in
+    // its own sequence. A patient hands over every series of every study of
+    // theirs, a study hands over its series — what the surface's GATHER on
+    // each hands over — so `pull @PAT001` and `gather add @STD001` act on the
+    // whole of it, while `@SER003` names one series. A patient the PACS
+    // answered nothing for has nothing to hand and wears no number.
+    answerAdapter_register('pacs.query', (data) => {
+        const model = data;
+        if (model === null || !Array.isArray(model.studies))
+            return null;
+        const rows = [];
+        // An answer that names its patients is taken at its word; one that does
+        // not (a single question, an older daemon) has a patient for every
+        // study's patient, in the studies' order — the same rows the surface
+        // derives, so the numbers land on them.
+        const patients = Array.isArray(model.patients) && model.patients.length > 0
+            ? model.patients
+            : model.studies.reduce((seen, study) => {
+                if (!seen.some((one) => one.patientId === study.patientId)) {
+                    seen.push({ patientId: study.patientId, ...(study.patientName !== undefined ? { patientName: study.patientName } : {}) });
+                }
+                return seen;
+            }, []);
+        for (const patient of patients) {
+            const theirs = model.studies.filter((study) => study.patientId === patient.patientId && (patient.server === undefined || study.server === undefined || study.server === patient.server));
+            const seriesPaths = theirs
+                .flatMap((study) => (Array.isArray(study.series) ? study.series : []))
+                .map((one) => one.vfsPath)
+                .filter((one) => typeof one === 'string');
+            if (seriesPaths.length === 0)
+                continue;
+            rows.push({ kind: 'PAT', address: patientAddress_of(patient), values: seriesPaths, label: patient.patientName || patient.patientId });
+        }
+        for (const study of model.studies) {
+            const series = Array.isArray(study.series) ? study.series : [];
+            const seriesPaths = series
+                .map((one) => one.vfsPath)
+                .filter((one) => typeof one === 'string');
+            if (typeof study.vfsPath === 'string') {
+                rows.push({
+                    kind: 'STD',
+                    // The study's own path leads, as the address a surface matches on;
+                    // its series follow, as what a verb is handed.
+                    values: [study.vfsPath, ...seriesPaths],
+                    label: study.description || 'study',
+                });
+            }
+            for (const one of series) {
+                if (typeof one.vfsPath !== 'string')
+                    continue;
+                rows.push({ kind: 'SER', values: [one.vfsPath], label: one.description || one.modality || 'series' });
+            }
+        }
+        return rows;
+    });
+    // The cohort's rows are its members, which is what makes `gather remove @2`
+    // read the same way as every other numbered act.
+    answerAdapter_register('gather.cohort', (data) => {
+        const state = data;
+        if (state === null || !Array.isArray(state.series))
+            return null;
+        return state.series
+            .filter((member) => typeof member.vfsPath === 'string')
+            .map((member) => ({
+            kind: member.kind === 'dir' ? 'DIR' : member.kind === 'file' ? 'FIL' : 'SER',
+            values: [member.vfsPath],
+            label: member.description ?? path.posix.basename(member.vfsPath),
+        }));
+    });
+}
+//# sourceMappingURL=answerAdapters.js.map

package/dist/session/answerAdapters.js.map

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

package/dist/session/recent.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @file What a pronoun in a manifest refers to.
+ *
+ * A workflow says "process what I just gathered" and "check the feed that
+ * made", which means something in the session has to remember what the last
+ * act produced. These are not new state: they are the addresses the kernel
+ * already handed back, kept for the length of the session so a later line
+ * can name them without the operator copying an id out of a readout.
+ *
+ * Deliberately small and deliberately not persisted. A pronoun refers to
+ * what THIS session did; a manifest replayed in a new session refers to
+ * what that session does, which is the only reading that can be right.
+ *
+ * @module
+ */
+/**
+ * Notes the feed work just landed in.
+ *
+ * @param id - The feed's id.
+ */
+export declare function recentFeed_note(id: number): void;
+/**
+ * The feed the session most recently worked in.
+ *
+ * @returns The feed id, or null when this session has made none.
+ */
+export declare function recentFeed_get(): number | null;
+/**
+ * Notes the runs just scheduled.
+ *
+ * @param ids - The plugin instance ids, in the order they were scheduled.
+ */
+export declare function recentRuns_note(ids: number[]): void;
+/**
+ * The runs the session most recently scheduled.
+ *
+ * @returns The instance ids, empty when this session has scheduled none.
+ */
+export declare function recentRuns_get(): number[];
+/**
+ * Notes where a run's output will land.
+ *
+ * This is what makes a chain expressible: the next act works on what the
+ * last one produced, and only the kernel knows where CUBE put it.
+ *
+ * @param place - The run's output directory.
+ */
+export declare function recentRunPlace_note(place: string): void;
+/**
+ * Where the session's most recent run writes.
+ *
+ * @returns The output directory, or null when this session has run nothing.
+ */
+export declare function recentRunPlace_get(): string | null;
+/**
+ * Notes where a PACS answer was written.
+ *
+ * @param path - The query's projection path.
+ */
+export declare function recentQuery_note(path: string): void;
+/**
+ * Where the session's most recent PACS answer lives.
+ *
+ * @returns The query path, or null when this session has asked nothing.
+ */
+export declare function recentQuery_get(): string | null;
+/** Forgets everything, for a test that needs a session with no history. */
+export declare function recent_forget(): void;

package/dist/session/recent.js

@@ -0,0 +1,99 @@
+/**
+ * @file What a pronoun in a manifest refers to.
+ *
+ * A workflow says "process what I just gathered" and "check the feed that
+ * made", which means something in the session has to remember what the last
+ * act produced. These are not new state: they are the addresses the kernel
+ * already handed back, kept for the length of the session so a later line
+ * can name them without the operator copying an id out of a readout.
+ *
+ * Deliberately small and deliberately not persisted. A pronoun refers to
+ * what THIS session did; a manifest replayed in a new session refers to
+ * what that session does, which is the only reading that can be right.
+ *
+ * @module
+ */
+/** The feed the session most recently created work in. */
+let feedID = null;
+/** The runs the session most recently scheduled. */
+let instanceIDs = [];
+/** The PACS query the session most recently asked. */
+let queryPath = null;
+/** Where the session's most recent run writes its output. */
+let runPlace = null;
+/**
+ * Notes the feed work just landed in.
+ *
+ * @param id - The feed's id.
+ */
+export function recentFeed_note(id) {
+    feedID = id;
+}
+/**
+ * The feed the session most recently worked in.
+ *
+ * @returns The feed id, or null when this session has made none.
+ */
+export function recentFeed_get() {
+    return feedID;
+}
+/**
+ * Notes the runs just scheduled.
+ *
+ * @param ids - The plugin instance ids, in the order they were scheduled.
+ */
+export function recentRuns_note(ids) {
+    if (ids.length > 0)
+        instanceIDs = [...ids];
+}
+/**
+ * The runs the session most recently scheduled.
+ *
+ * @returns The instance ids, empty when this session has scheduled none.
+ */
+export function recentRuns_get() {
+    return [...instanceIDs];
+}
+/**
+ * Notes where a run's output will land.
+ *
+ * This is what makes a chain expressible: the next act works on what the
+ * last one produced, and only the kernel knows where CUBE put it.
+ *
+ * @param place - The run's output directory.
+ */
+export function recentRunPlace_note(place) {
+    runPlace = place;
+}
+/**
+ * Where the session's most recent run writes.
+ *
+ * @returns The output directory, or null when this session has run nothing.
+ */
+export function recentRunPlace_get() {
+    return runPlace;
+}
+/**
+ * Notes where a PACS answer was written.
+ *
+ * @param path - The query's projection path.
+ */
+export function recentQuery_note(path) {
+    queryPath = path;
+}
+/**
+ * Where the session's most recent PACS answer lives.
+ *
+ * @returns The query path, or null when this session has asked nothing.
+ */
+export function recentQuery_get() {
+    return queryPath;
+}
+/** Forgets everything, for a test that needs a session with no history. */
+export function recent_forget() {
+    feedID = null;
+    instanceIDs = [];
+    queryPath = null;
+    runPlace = null;
+}
+//# sourceMappingURL=recent.js.map

package/dist/session/recent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent.js","sourceRoot":"","sources":["../../src/session/recent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,0DAA0D;AAC1D,IAAI,MAAM,GAAkB,IAAI,CAAC;AACjC,oDAAoD;AACpD,IAAI,WAAW,GAAa,EAAE,CAAC;AAC/B,sDAAsD;AACtD,IAAI,SAAS,GAAkB,IAAI,CAAC;AACpC,6DAA6D;AAC7D,IAAI,QAAQ,GAAkB,IAAI,CAAC;AAEnC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,MAAM,GAAG,EAAE,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAa;IAC3C,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,WAAW,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,aAAa;IAC3B,MAAM,GAAG,IAAI,CAAC;IACd,WAAW,GAAG,EAAE,CAAC;IACjB,SAAS,GAAG,IAAI,CAAC;IACjB,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/session/recorder.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @file Recording what a session did, as a manifest.
+ *
+ * The workflows worth sharing are the fiddly ones nobody will retype
+ * correctly. A recorder is how one gets written: the operator does the work
+ * once — typing, or pressing on a surface, which is the same thing by law —
+ * and the lines they ran come back as a file someone else can play.
+ *
+ * A recording is a TRANSCRIPT, faithful to what happened. It does not invent
+ * expectations: a file that guessed at assertions would be a fiction, and
+ * adding `expect` lines is the author's act, the one that turns a recording
+ * into a test.
+ *
+ * @module
+ */
+/** What a recording is doing. */
+export interface RecorderState {
+    /** Where it will be written, or null when nothing is recording. */
+    target: string | null;
+    /** How many lines it holds. */
+    lines: number;
+    /** How long it has been running. */
+    elapsedMs: number;
+}
+/**
+ * Begins a recording.
+ *
+ * @param path - Where the manifest will be written.
+ */
+export declare function recorder_start(path: string): void;
+/**
+ * Notes a line the session ran.
+ *
+ * Lines about recording itself are never captured — a manifest that starts
+ * and stops a recording when played is a machine that films its own camera —
+ * and neither are the lines a played manifest runs, which are already in the
+ * file being played.
+ *
+ * @param line - The line, as it was run.
+ */
+export declare function recorder_note(line: string): void;
+/** Stops capturing while a manifest plays its own lines. */
+export declare function recorder_mute(): void;
+/** Resumes capturing after a played manifest finishes. */
+export declare function recorder_unmute(): void;
+/**
+ * Ends the recording.
+ *
+ * @returns Where it was recording and what it captured, or null when nothing was.
+ */
+export declare function recorder_stop(): {
+    target: string;
+    lines: string[];
+    elapsedMs: number;
+} | null;
+/**
+ * What the recorder is doing.
+ *
+ * @returns The current state.
+ */
+export declare function recorder_state(): RecorderState;

package/dist/session/recorder.js

@@ -0,0 +1,95 @@
+/**
+ * @file Recording what a session did, as a manifest.
+ *
+ * The workflows worth sharing are the fiddly ones nobody will retype
+ * correctly. A recorder is how one gets written: the operator does the work
+ * once — typing, or pressing on a surface, which is the same thing by law —
+ * and the lines they ran come back as a file someone else can play.
+ *
+ * A recording is a TRANSCRIPT, faithful to what happened. It does not invent
+ * expectations: a file that guessed at assertions would be a fiction, and
+ * adding `expect` lines is the author's act, the one that turns a recording
+ * into a test.
+ *
+ * @module
+ */
+/** Where the recording will be written, or null when nothing is recording. */
+let target = null;
+/** The lines captured so far, in the order they ran. */
+let captured = [];
+/** When the recording started. */
+let startedAt = 0;
+/** Depth of work that must not be captured: a played manifest's own lines. */
+let muted = 0;
+/**
+ * Begins a recording.
+ *
+ * @param path - Where the manifest will be written.
+ */
+export function recorder_start(path) {
+    target = path;
+    captured = [];
+    startedAt = Date.now();
+    muted = 0;
+}
+/**
+ * Notes a line the session ran.
+ *
+ * Lines about recording itself are never captured — a manifest that starts
+ * and stops a recording when played is a machine that films its own camera —
+ * and neither are the lines a played manifest runs, which are already in the
+ * file being played.
+ *
+ * @param line - The line, as it was run.
+ */
+export function recorder_note(line) {
+    if (target === null || muted > 0)
+        return;
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+        return;
+    const verb = trimmed.split(/\s+/)[0];
+    if (verb === 'record' || verb === 'play')
+        return;
+    captured.push(trimmed);
+}
+/** Stops capturing while a manifest plays its own lines. */
+export function recorder_mute() {
+    muted += 1;
+}
+/** Resumes capturing after a played manifest finishes. */
+export function recorder_unmute() {
+    if (muted > 0)
+        muted -= 1;
+}
+/**
+ * Ends the recording.
+ *
+ * @returns Where it was recording and what it captured, or null when nothing was.
+ */
+export function recorder_stop() {
+    if (target === null)
+        return null;
+    const held = {
+        target,
+        lines: [...captured],
+        elapsedMs: Date.now() - startedAt,
+    };
+    target = null;
+    captured = [];
+    startedAt = 0;
+    return held;
+}
+/**
+ * What the recorder is doing.
+ *
+ * @returns The current state.
+ */
+export function recorder_state() {
+    return {
+        target,
+        lines: captured.length,
+        elapsedMs: target === null ? 0 : Date.now() - startedAt,
+    };
+}
+//# sourceMappingURL=recorder.js.map

package/dist/session/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/session/recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,8EAA8E;AAC9E,IAAI,MAAM,GAAkB,IAAI,CAAC;AACjC,wDAAwD;AACxD,IAAI,QAAQ,GAAa,EAAE,CAAC;AAC5B,kCAAkC;AAClC,IAAI,SAAS,GAAW,CAAC,CAAC;AAC1B,8EAA8E;AAC9E,IAAI,KAAK,GAAW,CAAC,CAAC;AAYtB;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,GAAG,IAAI,CAAC;IACd,QAAQ,GAAG,EAAE,CAAC;IACd,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,GAAG,CAAC,CAAC;AACZ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO;IACzC,MAAM,OAAO,GAAW,IAAI,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACjC,MAAM,IAAI,GAAW,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO;IACjD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa;IAC3B,KAAK,IAAI,CAAC,CAAC;AACb,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,eAAe;IAC7B,IAAI,KAAK,GAAG,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,IAAI,GAA2D;QACnE,MAAM;QACN,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC;QACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KAClC,CAAC;IACF,MAAM,GAAG,IAAI,CAAC;IACd,QAAQ,GAAG,EAAE,CAAC;IACd,SAAS,GAAG,CAAC,CAAC;IACd,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,MAAM;QACN,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KACxD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fnndsc/brasa",
-  "version": "0.23.2",
+  "version": "0.25.0",
   "description": "BRASA Runs Abstracted Shell Actions - the hostable ChRIS shell engine (kernel)",
   "repository": {
     "type": "git",
@@ -43,15 +43,15 @@
   "author": "FNNDSC <dev@babyMRI.org>",
   "license": "MIT",
   "dependencies": {
-    "@fnndsc/chili": "^3.6.6",
-    "@fnndsc/cumin": "^3.22.1",
-    "@fnndsc/salsa": "^3.18.1",
+    "@fnndsc/chili": "^3.6.7",
+    "@fnndsc/cumin": "^3.23.1",
+    "@fnndsc/salsa": "^3.18.2",
     "chalk": "^4.1.2",
     "cli-highlight": "^2.1.11",
     "js-yaml": "^4.1.0",
     "minimatch": "^10.1.1",
     "ws": "^8.21.0",
-    "@fnndsc/menu": "^0.9.0"
+    "@fnndsc/menu": "^0.11.0"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",