@fnndsc/brasa 0.49.0 → 0.50.0

package/dist/session/answer.d.ts

@@ -10,7 +10,11 @@
  * 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.
+ * different renderings would be worse than no index at all.
+ *
+ * Each surface keeps its own last answer: a listing read on one surface
+ * does not renumber the rows another is about to act on (#1273). A line
+ * counts against the answer of the surface it came from.
  *
  * 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
@@ -65,13 +69,6 @@ export interface NumberedHandle {
     ordinal: number;
     address: string;
 }
-/** What a surface is told about the numbering. */
-export interface Numbering {
-    id: number;
-    source: string;
-    rows: number;
-    handles: NumberedHandle[];
-}
 /** The answer a session most recently gave, with the line that asked. */
 export interface SessionAnswer {
     /** The line that produced it, for the readout that says what was numbered. */
@@ -216,8 +213,8 @@ export declare function answerConsulted_take(): SessionAnswer | null;
 /** Forgets the answer, for a test that needs a session that has listed nothing. */
 export declare function answer_forget(): void;
 /**
- * Which answer is numbered, for a surface attaching late.
+ * Forgets one surface's answer, when the surface has gone.
  *
- * @returns The current numbering, or null when nothing has listed.
+ * @param origin - The surface's origin.
  */
-export declare function numbering_get(): Numbering | null;
+export declare function answerOrigin_forget(origin: string): void;

package/dist/session/answer.js

@@ -10,7 +10,11 @@
  * 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.
+ * different renderings would be worse than no index at all.
+ *
+ * Each surface keeps its own last answer: a listing read on one surface
+ * does not renumber the rows another is about to act on (#1273). A line
+ * counts against the answer of the surface it came from.
  *
  * 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
@@ -19,12 +23,19 @@
  * @module
  */
 import { ambient_publish } from '../core/ambient.js';
+import { lineOrigin_get } from '../core/lineOrigin.js';
 /** 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;
+/** Each surface's last answer, by the origin its lines carry. */
+const answers = new Map();
+/** The running line's surface's answer, or undefined before it has listed. */
+function origin_answer() {
+    return answers.get(lineOrigin_get());
+}
+/** The running line's surface's last answer, or null before it has listed. */
+function held_get() {
+    return origin_answer()?.held ?? null;
+}
 /** 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. */
@@ -55,11 +66,14 @@ export function answer_note(kind, data, source) {
     if (rows === null || rows.length === 0)
         return;
     sequence += 1;
-    held = { source, rows, kind, data };
+    const origin = lineOrigin_get();
+    answers.set(origin, { held: { source, rows, kind, data }, consulted: false });
     // 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.
+    // Only the surface whose line listed is told: the others' numbers stand.
     ambient_publish({
         kind: 'numbered',
+        origin,
         id: sequence,
         source,
         rows: rows.length,
@@ -77,15 +91,17 @@ export function answer_note(kind, data, source) {
  *   from the answer, or the ordinal is past that kind's end.
  */
 export function answerRow_get(handle) {
-    if (held === null)
+    const mine = origin_answer();
+    if (mine === undefined)
         return null;
+    const held = mine.held;
     // By the number the row wears, which a filtered listing keeps (#1100).
     const numbered = rows_number(held.rows, held.data);
     const at = numbered.findIndex((one) => one.kind === handle.kind && one.ordinal === handle.ordinal);
     const row = at < 0 ? undefined : held.rows[at];
     if (row === undefined)
         return null;
-    consulted = true;
+    mine.consulted = true;
     return row;
 }
 /**
@@ -95,6 +111,7 @@ export function answerRow_get(handle) {
  * @returns The count, zero when nothing is numbered.
  */
 export function answerKind_count(kind) {
+    const held = held_get();
     if (held === null)
         return 0;
     return held.rows.filter((row) => row.kind === kind).length;
@@ -108,6 +125,7 @@ export function answerKind_count(kind) {
  * @returns The handles.
  */
 export function answerHandles_get() {
+    const held = held_get();
     return held === null ? [] : rows_number(held.rows, held.data);
 }
 /** Numbers a listing's rows already wore, kept with the listing's data (a filtered listing). */
@@ -241,7 +259,7 @@ export function numberedFooter_render(handles) {
  * @returns The held answer, or null when nothing has listed.
  */
 export function answer_get() {
-    return held;
+    return held_get();
 }
 /**
  * Takes the note that an index was resolved, for the line's readout.
@@ -252,30 +270,23 @@ export function answer_get() {
  * @returns What was consulted, or null when this line used no index.
  */
 export function answerConsulted_take() {
-    if (!consulted || held === null)
+    const mine = origin_answer();
+    if (mine === undefined || !mine.consulted)
         return null;
-    consulted = false;
-    return held;
+    mine.consulted = false;
+    return mine.held;
 }
 /** Forgets the answer, for a test that needs a session that has listed nothing. */
 export function answer_forget() {
-    held = null;
-    consulted = false;
+    answers.clear();
     sequence = 0;
 }
 /**
- * Which answer is numbered, for a surface attaching late.
+ * Forgets one surface's answer, when the surface has gone.
  *
- * @returns The current numbering, or null when nothing has listed.
+ * @param origin - The surface's origin.
  */
-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() : [],
-    };
+export function answerOrigin_forget(origin) {
+    answers.delete(origin);
 }
 //# sourceMappingURL=answer.js.map

package/dist/session/answer.js.map

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

package/dist/session/cwdScope.d.ts

@@ -0,0 +1,25 @@
+/** Where a line stands, once it has asked. */
+export interface LineCwd {
+    cwd: string | null;
+    /**
+     * Whether its `cd` is its own: a joblet's is, as a subshell's is, and the
+     * session stays where it was.
+     */
+    own: boolean;
+}
+/**
+ * Runs a line standing where the session stands when it first asks.
+ *
+ * @param operation - The line.
+ * @param cwd - Where it stands from the start, its `cd`s its own (a
+ *   joblet, where it was started); null to read the session's when it first
+ *   asks, its `cd`s the session's.
+ * @returns What the line returns.
+ */
+export declare function cwdScope_run<T>(operation: () => Promise<T>, cwd?: string | null): Promise<T>;
+/**
+ * Where the running line stands.
+ *
+ * @returns Its slot, or undefined outside any line.
+ */
+export declare function lineCwd_get(): LineCwd | undefined;

package/dist/session/cwdScope.js

@@ -0,0 +1,36 @@
+/**
+ * @file The working directory a line stands in.
+ *
+ * It is read once, when the line first asks, and kept for the rest of it.
+ * Lines run side by side, and a read that began in one folder must not
+ * finish in another because a `cd` ran beside it (#1273). A line's own `cd`
+ * moves it, and the session with it (`session.setCWD`).
+ *
+ * @module
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+const cwdScope = new AsyncLocalStorage();
+/**
+ * Runs a line standing where the session stands when it first asks.
+ *
+ * @param operation - The line.
+ * @param cwd - Where it stands from the start, its `cd`s its own (a
+ *   joblet, where it was started); null to read the session's when it first
+ *   asks, its `cd`s the session's.
+ * @returns What the line returns.
+ */
+export async function cwdScope_run(operation, cwd = null) {
+    // A line inside one that already stands somewhere (a joblet's) stands there too.
+    if (cwd === null && cwdScope.getStore() !== undefined)
+        return await operation();
+    return await cwdScope.run({ cwd, own: cwd !== null }, operation);
+}
+/**
+ * Where the running line stands.
+ *
+ * @returns Its slot, or undefined outside any line.
+ */
+export function lineCwd_get() {
+    return cwdScope.getStore();
+}
+//# sourceMappingURL=cwdScope.js.map

package/dist/session/cwdScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwdScope.js","sourceRoot":"","sources":["../../src/session/cwdScope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAYrD,MAAM,QAAQ,GAA+B,IAAI,iBAAiB,EAAW,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,SAA2B,EAAE,MAAqB,IAAI;IAC1F,iFAAiF;IACjF,IAAI,GAAG,KAAK,IAAI,IAAI,QAAQ,CAAC,QAAQ,EAAE,KAAK,SAAS;QAAE,OAAO,MAAM,SAAS,EAAE,CAAC;IAChF,OAAO,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;AAC7B,CAAC"}

package/dist/session/index.js

@@ -1,4 +1,5 @@
 import { backend_get } from '../core/backend.js';
+import { lineCwd_get } from './cwdScope.js';
 /**
  * Manages the shell session state (Connection, Context).
  */
@@ -38,16 +39,25 @@ export class Session {
      * always honoured, `/` included, since the operator put it there.
      */
     async getCWD() {
+        const line = lineCwd_get();
+        if (line?.cwd)
+            return line.cwd;
         const stored = await backend_get().session.cwd_load();
-        if (stored)
-            return stored;
-        return backend_get().session.home_get();
+        const cwd = stored ? stored : await backend_get().session.home_get();
+        if (line !== undefined)
+            line.cwd = cwd;
+        return cwd;
     }
     /**
      * Set Current Working Directory: the backend stores it for the identity.
      */
     async setCWD(path) {
-        await backend_get().session.cwd_save(path);
+        const line = lineCwd_get();
+        // A joblet's `cd` is its own: the session stays where it was.
+        if (line?.own !== true)
+            await backend_get().session.cwd_save(path);
+        if (line !== undefined)
+            line.cwd = path;
     }
     /**
      * Changes directory as an interactive `cd` operation while retaining the

package/dist/session/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,OAAO,OAAO;IACV,MAAM,CAAC,QAAQ,CAAU;IACzB,QAAQ,GAAY,KAAK,CAAC;IAC1B,aAAa,GAAY,KAAK,CAAC;IAC/B,cAAc,GAAY,KAAK,CAAC;IAChC,YAAY,CAAqB;IACjC,OAAO,GAAkB,IAAI,CAAC;IAEtC;;OAEG;IACH,gBAAuB,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAkB,MAAM,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrE,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,OAAO,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,gBAAgB,CAAC,IAAY;QACjC,MAAM,OAAO,GAAW,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAI,OAAO,KAAK,IAAI;YAAE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAClD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,KAAc;QACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,OAAgB;QAC/B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,OAAgB;QAChC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED;;;;;;;OAOG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAY,OAAO,CAAC,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAgB,MAAM,eAAe,CAAC;AAE1D;;GAEG;AACH,MAAM,OAAO,OAAO;IACV,MAAM,CAAC,QAAQ,CAAU;IACzB,QAAQ,GAAY,KAAK,CAAC;IAC1B,aAAa,GAAY,KAAK,CAAC;IAC/B,cAAc,GAAY,KAAK,CAAC;IAChC,YAAY,CAAqB;IACjC,OAAO,GAAkB,IAAI,CAAC;IAEtC;;OAEG;IACH,gBAAuB,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,GAAwB,WAAW,EAAE,CAAC;QAChD,IAAI,IAAI,EAAE,GAAG;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC;QAC/B,MAAM,MAAM,GAAkB,MAAM,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrE,MAAM,GAAG,GAAW,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC7E,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACvC,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,IAAI,GAAwB,WAAW,EAAE,CAAC;QAChD,8DAA8D;QAC9D,IAAI,IAAI,EAAE,GAAG,KAAK,IAAI;YAAE,MAAM,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;IAC1C,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,gBAAgB,CAAC,IAAY;QACjC,MAAM,OAAO,GAAW,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAI,OAAO,KAAK,IAAI;YAAE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAClD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,KAAc;QACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,OAAgB;QAC/B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,OAAgB;QAChC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED;;;;;;;OAOG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAY,OAAO,CAAC,WAAW,EAAE,CAAC"}

package/dist/session/recorder.d.ts

@@ -24,10 +24,13 @@ export declare function recorder_start(path: string): void;
  * @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;
+/**
+ * Runs a manifest's own lines uncaptured.
+ *
+ * @param operation - The play.
+ * @returns What the play returns.
+ */
+export declare function recorderMuted_run<T>(operation: () => Promise<T>): Promise<T>;
 /**
  * Ends the recording.
  *

package/dist/session/recorder.js

@@ -13,23 +13,19 @@
  *
  * @module
  */
-import { turnPart_register } from '../core/turn.js';
+import { AsyncLocalStorage } from 'node:async_hooks';
 /** 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;
-// A mute is the running manifest's: a command run while it waits on a
-// question is recorded as the operator's own.
-turnPart_register({
-    name: 'recorderMute',
-    save: () => muted,
-    clear: () => { muted = 0; },
-    restore: (saved) => { muted = typeof saved === 'number' ? saved : 0; },
-});
+/**
+ * Work that must not be captured: a played manifest's own lines. The mute
+ * is the manifest's and its lines', so a line another surface runs while it
+ * plays is recorded as the operator's own.
+ */
+const muteScope = new AsyncLocalStorage();
 /**
  * Begins a recording.
  *
@@ -39,7 +35,6 @@ export function recorder_start(path) {
     target = path;
     captured = [];
     startedAt = Date.now();
-    muted = 0;
 }
 /**
  * Notes a line the session ran.
@@ -52,7 +47,7 @@ export function recorder_start(path) {
  * @param line - The line, as it was run.
  */
 export function recorder_note(line) {
-    if (target === null || muted > 0)
+    if (target === null || muteScope.getStore() === true)
         return;
     const trimmed = line.trim();
     if (trimmed.length === 0)
@@ -62,14 +57,14 @@ export function recorder_note(line) {
         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;
+/**
+ * Runs a manifest's own lines uncaptured.
+ *
+ * @param operation - The play.
+ * @returns What the play returns.
+ */
+export async function recorderMuted_run(operation) {
+    return await muteScope.run(true, operation);
 }
 /**
  * Ends the recording.

package/dist/session/recorder.js.map

@@ -1 +1 @@
-{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/session/recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,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;AAEtB,sEAAsE;AACtE,8CAA8C;AAC9C,iBAAiB,CAAC;IAChB,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,GAAY,EAAE,CAAC,KAAK;IAC1B,KAAK,EAAE,GAAS,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,KAAc,EAAQ,EAAE,GAAG,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtF,CAAC,CAAC;AAYH;;;;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"}
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/session/recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,8EAA8E;AAC9E,IAAI,MAAM,GAAkB,IAAI,CAAC;AACjC,wDAAwD;AACxD,IAAI,QAAQ,GAAa,EAAE,CAAC;AAC5B,kCAAkC;AAClC,IAAI,SAAS,GAAW,CAAC,CAAC;AAC1B;;;;GAIG;AACH,MAAM,SAAS,GAA4B,IAAI,iBAAiB,EAAQ,CAAC;AAYzE;;;;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;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,MAAM,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,KAAK,IAAI;QAAE,OAAO;IAC7D,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;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAI,SAA2B;IACpE,OAAO,MAAM,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC9C,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.49.0",
+  "version": "0.50.0",
   "description": "BRASA Runs Abstracted Shell Actions - the hostable ChRIS shell engine (kernel)",
   "repository": {
     "type": "git",
@@ -48,9 +48,9 @@
   "author": "FNNDSC <dev@babyMRI.org>",
   "license": "MIT",
   "dependencies": {
-    "@fnndsc/chili": "^3.8.0",
+    "@fnndsc/chili": "^3.8.1",
     "@fnndsc/fond": "^0.6.0",
-    "@fnndsc/cumin": "^3.29.1",
+    "@fnndsc/cumin": "^3.29.3",
     "@fnndsc/salsa": "^4.4.2",
     "bsd-trek": "^0.4.0",
     "chalk": "^4.1.2",
@@ -58,7 +58,7 @@
     "js-yaml": "^4.1.0",
     "minimatch": "^10.1.1",
     "ws": "^8.21.0",
-    "@fnndsc/menu": "^0.30.0",
+    "@fnndsc/menu": "^0.31.0",
     "@fnndsc/orrery": "^0.7.0"
   },
   "devDependencies": {

package/dist/core/turn.d.ts

@@ -1,61 +0,0 @@
-/**
- * @file A command's turn: the per-command state a command leaves behind when
- * it steps aside to wait on a person, and finds again when it resumes.
- *
- * The session runs one command at a time, but a command waiting on a
- * question gives up its turn (the host's lane), and other commands run to
- * completion before it resumes. Some state is module-level and belongs to
- * whichever command is running: the exit code it has set, a pipe's text or
- * listing not yet taken, the depth of a `play` manifest, a mute on the
- * recorder, the command Ctrl-C cancels. Each such part registers here how to
- * save, clear and restore itself; the host calls `turn_leave` as a command
- * steps aside (so the next command starts clean) and `turn_resume` when it
- * returns (so it finds its own state, not what ran in between).
- *
- * @module
- */
-/** One piece of per-command state, and how to hand it over. */
-export interface TurnPart {
-    /** A name for the part, for diagnostics. */
-    name: string;
-    /** Reads the part as the running command left it. */
-    save: () => unknown;
-    /** Puts the part to its idle value, for the next command. */
-    clear: () => void;
-    /** Puts back what `save` read. */
-    restore: (saved: unknown) => void;
-}
-/** What a command left behind when it stepped aside. */
-export interface TurnState {
-    saved: Map<string, unknown>;
-}
-/**
- * Registers a piece of per-command state. Registering a name again replaces
- * the part (a module loaded twice under test).
- *
- * @param part - The part.
- */
-export declare function turnPart_register(part: TurnPart): void;
-/**
- * The running command steps aside: its state is saved and cleared.
- *
- * @returns What it left behind, for `turn_resume`.
- */
-export declare function turn_leave(): TurnState;
-/**
- * A command resumes: its state is put back, over whatever ran in between.
- *
- * @param state - What it left behind.
- */
-export declare function turn_resume(state: TurnState): void;
-/**
- * Acts on a command that stepped aside, from outside its turn: its state is
- * put in place, the act runs, and the running command's state is put back.
- * All of it is synchronous, so nothing runs in between (a STOP pressed on a
- * command that waits aside).
- *
- * @param state - What the stepped-aside command left behind.
- * @param act - What to do with its state in place.
- * @returns Its state after the act, for its `turn_resume`.
- */
-export declare function turn_within(state: TurnState, act: () => void): TurnState;

package/dist/core/turn.js

@@ -1,83 +0,0 @@
-/**
- * @file A command's turn: the per-command state a command leaves behind when
- * it steps aside to wait on a person, and finds again when it resumes.
- *
- * The session runs one command at a time, but a command waiting on a
- * question gives up its turn (the host's lane), and other commands run to
- * completion before it resumes. Some state is module-level and belongs to
- * whichever command is running: the exit code it has set, a pipe's text or
- * listing not yet taken, the depth of a `play` manifest, a mute on the
- * recorder, the command Ctrl-C cancels. Each such part registers here how to
- * save, clear and restore itself; the host calls `turn_leave` as a command
- * steps aside (so the next command starts clean) and `turn_resume` when it
- * returns (so it finds its own state, not what ran in between).
- *
- * @module
- */
-const parts = new Map();
-/**
- * Registers a piece of per-command state. Registering a name again replaces
- * the part (a module loaded twice under test).
- *
- * @param part - The part.
- */
-export function turnPart_register(part) {
-    parts.set(part.name, part);
-}
-/**
- * The running command steps aside: its state is saved and cleared.
- *
- * @returns What it left behind, for `turn_resume`.
- */
-export function turn_leave() {
-    const saved = new Map();
-    for (const part of parts.values()) {
-        saved.set(part.name, part.save());
-        part.clear();
-    }
-    return { saved };
-}
-/**
- * A command resumes: its state is put back, over whatever ran in between.
- *
- * @param state - What it left behind.
- */
-export function turn_resume(state) {
-    for (const part of parts.values()) {
-        if (state.saved.has(part.name))
-            part.restore(state.saved.get(part.name));
-    }
-}
-/**
- * Acts on a command that stepped aside, from outside its turn: its state is
- * put in place, the act runs, and the running command's state is put back.
- * All of it is synchronous, so nothing runs in between (a STOP pressed on a
- * command that waits aside).
- *
- * @param state - What the stepped-aside command left behind.
- * @param act - What to do with its state in place.
- * @returns Its state after the act, for its `turn_resume`.
- */
-export function turn_within(state, act) {
-    const running = turn_leave();
-    turn_resume(state);
-    try {
-        act();
-    }
-    finally {
-        const after = turn_leave();
-        turn_resume(running);
-        state.saved = after.saved;
-    }
-    return state;
-}
-// The exit code: legacy handlers report failure by setting it, and the
-// engine reads the change across a command. A command that stepped aside
-// must not inherit another's failure, nor lose its own.
-turnPart_register({
-    name: 'exitCode',
-    save: () => process.exitCode,
-    clear: () => { process.exitCode = undefined; },
-    restore: (saved) => { process.exitCode = typeof saved === 'number' ? saved : undefined; },
-});
-//# sourceMappingURL=turn.js.map

package/dist/core/turn.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"turn.js","sourceRoot":"","sources":["../../src/core/turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmBH,MAAM,KAAK,GAA0B,IAAI,GAAG,EAAE,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAyB,IAAI,GAAG,EAAE,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,GAAe;IAC3D,MAAM,OAAO,GAAc,UAAU,EAAE,CAAC;IACxC,WAAW,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,CAAC;QACH,GAAG,EAAE,CAAC;IACR,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,GAAc,UAAU,EAAE,CAAC;QACtC,WAAW,CAAC,OAAO,CAAC,CAAC;QACrB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uEAAuE;AACvE,yEAAyE;AACzE,wDAAwD;AACxD,iBAAiB,CAAC;IAChB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,GAAY,EAAE,CAAC,OAAO,CAAC,QAAQ;IACrC,KAAK,EAAE,GAAS,EAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;IACpD,OAAO,EAAE,CAAC,KAAc,EAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;CACzG,CAAC,CAAC"}