@fnndsc/brasa 0.33.4 → 0.35.0

package/dist/core/sink.js

@@ -22,7 +22,6 @@
  * @module
  */
 import { AsyncLocalStorage } from 'node:async_hooks';
-import { runtimeOutput_set } from '@fnndsc/cumin/runtime-output';
 import { NullProgressRenderer } from './progress.js';
 /**
  * Sink that writes both channels to the process's standard output.
@@ -217,13 +216,6 @@ let hostSink = new StdoutSink();
  * at once without their output stomping a shared global.
  */
 const sinkScope = new AsyncLocalStorage();
-// Lower layers report operational notices through Cumin's narrow port. The
-// callback resolves the sink at write time, preserving each invocation's
-// AsyncLocalStorage scope rather than pinning output to one terminal.
-runtimeOutput_set({
-    data_write: (chunk) => { sink_get().data_write(chunk); },
-    err_write: (chunk) => { sink_get().err_write(chunk); },
-});
 /**
  * Returns the sink in effect for the current async context.
  *

package/dist/core/sink.js.map

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

package/dist/core/surface.d.ts

@@ -23,186 +23,10 @@
  * @see docs/calypso.adoc — "Interactivity is a declared surface capability".
  * @module
  */
-/**
- * What interaction an attached surface can provide.
- *
- * @property hiddenInput - The surface can read a line without echoing it
- *   (password entry).
- * @property localEdit - The surface can open content in a local editor and
- *   return the edited result.
- * @property tty - The surface is an interactive terminal (as opposed to a
- *   pipe, a script, or a headless host).
- * @property color - The surface renders ANSI colour. A colour terminal and a
- *   browser console both do; a bare pipe or a file does not. A command that
- *   can render richly with colour and plainly without it — an image thumbnail
- *   as ANSI half-blocks or an ASCII ramp — reads this to choose, and the
- *   plain rendering is always the floor.
- * @property pipeSegments - The surface can run a pipeline's non-first
- *   segments (`... | grep foo`) through its own tools. Nothing ever spawns on
- *   a daemon host: the local CLI runs segments in-process, a remote CLI runs
- *   them on the client machine, and a browser surface lacks the capability
- *   and fails such pipelines with a clear message.
- * @property shellCommands - The surface can run a `!`-prefixed host-shell
- *   command on its own machine. A daemon delegates this capability to the
- *   command's originating surface and never launches the process itself.
- * @property fileDelivery - The surface can put a file where its operator can
- *   reach it. What that means is the surface's business — a path on the local
- *   CLI's disk, a path on a remote CLI's client machine, a saved file in a
- *   browser — but never the daemon host's disk.
- * @property engineFilesystem - The surface's operator sits at the same
- *   filesystem the engine runs on, so a path the engine resolves is a path
- *   they can open. True only for an in-process local shell. When false, a
- *   builtin that would write to disk must deliver through the surface instead,
- *   because the engine's disk is somebody else's machine.
- * @property localFilesystem - The surface can put many files into a directory
- *   structure of its own. True for any shell, remote included; false for a
- *   browser, which has no directory to fill and can only accept files one at a
- *   time. It answers a different question from `engineFilesystem`: not *whose*
- *   disk, but whether there is one at all.
- */
-export interface SurfaceCapabilities {
-    hiddenInput: boolean;
-    localEdit: boolean;
-    tty: boolean;
-    color: boolean;
-    pipeSegments: boolean;
-    shellCommands: boolean;
-    fileDelivery: boolean;
-    engineFilesystem: boolean;
-    localFilesystem: boolean;
-}
-/**
- * A request to prompt the user for a line of input.
- *
- * `wants` is what the question is asking FOR, so a surface can choose the
- * instrument that answers it — a browser to walk for a location, a masked
- * field for a secret, two capsules for a yes/no — rather than reading the
- * wording and guessing. A terminal ignores all of it and reads a line,
- * which is why every field beyond `message` is optional.
- *
- * @property message - The prompt text to display.
- * @property hidden - When true, the entered text is not echoed; requires the
- *   `hiddenInput` capability. Kept beside `wants` because it is what an
- *   older surface reads.
- * @property wants - The kind of value that answers this.
- * @property path - Where browsing starts and what to compose, for a `path`.
- * @property commit - The word the committing control should read.
- */
-export interface PromptRequest {
-    message: string;
-    hidden?: boolean;
-    wants?: PromptKind;
-    path?: PromptPath;
-    commit?: string;
-}
-/**
- * Content handed to a surface's local editor.
- *
- * @property content - The text to open in the editor.
- * @property extension - Optional filename extension (e.g. `.txt`, `.json`) so
- *   the editor can apply the right syntax mode.
- */
-export interface LocalEditRequest {
-    content: string;
-    extension?: string;
-    /** The file being edited; an editor that stays open saves back to it. */
-    path?: string;
-}
 export type { FileDeliverRequest, FileDeliverResult, PromptKind, PromptPath } from '@fnndsc/menu';
-import type { FileDeliverRequest, FileDeliverResult, PromptKind, PromptPath } from '@fnndsc/menu';
-/**
- * The outcome of a local edit.
- *
- * @property content - The content after editing.
- * @property changed - Whether the content differs from what was opened.
- */
-export interface LocalEditResult {
-    content: string;
-    changed: boolean;
-    /**
-     * The surface opened an editor that stays open (a browser pane) instead of
-     * returning the edited text. The command has nothing to save: every save
-     * made in that editor runs as its own command line.
-     */
-    opened?: boolean;
-}
-/**
- * The interaction seam a host installs. Builtins reach it through
- * {@link surface_get}; hosts declare their capabilities and back the
- * prompt and local-edit operations with whatever their surface supports.
- */
-/** Another surface on the same session, as the host sees it. */
-export interface SurfacePeer {
-    /** The host's name for it. */
-    id: string;
-    /** A terminal or a browser. */
-    kind: 'chell' | 'browser';
-    /** Whether it is the surface running the current command. */
-    you: boolean;
-}
-export interface Surface {
-    /** What this surface can do; read by builtins before they interact. */
-    readonly capabilities: SurfaceCapabilities;
-    /**
-     * The surfaces attached to this session, when the host knows of more than
-     * itself (a daemon does; a local shell is alone). Absent means unknown.
-     */
-    peers?(): SurfacePeer[];
-    /**
-     * Prompts for a line of input.
-     *
-     * @param request - The prompt message and whether to hide the input.
-     * @returns The entered line, trimmed.
-     * @throws {CapabilityError} When hidden input is requested but the surface
-     *   lacks the `hiddenInput` capability, or the surface cannot prompt.
-     */
-    prompt(request: PromptRequest): Promise<string>;
-    /**
-     * Runs one pipeline segment against an input, returning its output. Where
-     * this runs is the surface's business — in-process for the local CLI, on
-     * the client machine for a remote CLI — but never on a daemon host.
-     *
-     * @param command - The segment command line (e.g. `grep foo`).
-     * @param input - The bytes to feed the segment on stdin.
-     * @returns The segment's stdout.
-     * @throws {CapabilityError} When the surface lacks the `pipeSegments`
-     *   capability.
-     */
-    pipeSegment(command: string, input: Buffer): Promise<Buffer>;
-    /**
-     * Runs one host-shell command on the surface machine.
-     *
-     * @param command - The shell command without the leading `!`.
-     * @returns The process exit code.
-     * @throws {CapabilityError} When the surface lacks `shellCommands`.
-     */
-    shellCommand(command: string): Promise<number>;
-    /**
-     * Opens content in the surface's local editor and returns the result. The
-     * editor mechanics are the surface's business — a temp file and `$EDITOR`
-     * for the local CLI, the client's editor for a remote CLI, an editor
-     * component in a browser.
-     *
-     * @param request - The content to edit and an optional extension.
-     * @returns The edited content and whether it changed.
-     * @throws {CapabilityError} When the surface lacks the `localEdit`
-     *   capability.
-     */
-    localEdit(request: LocalEditRequest): Promise<LocalEditResult>;
-    /**
-     * Places one file where this surface's operator can reach it.
-     *
-     * The mechanics are the surface's: a write to the resolved path for the
-     * local CLI, a write on the client machine for a remote CLI, a saved file
-     * for a browser. A daemon never writes to its own disk on a surface's
-     * behalf, for the same reason it never spawns a shell there.
-     *
-     * @param request - What to deliver and where the operator asked for it.
-     * @returns Where it landed and how large it was.
-     * @throws {CapabilityError} When the surface lacks `fileDelivery`.
-     */
-    fileDeliver(request: FileDeliverRequest): Promise<FileDeliverResult>;
-}
+import type { FileDeliverRequest, FileDeliverResult } from '@fnndsc/menu';
+import type { SurfaceCapabilities, PromptRequest, LocalEditRequest, LocalEditResult, Surface } from '@fnndsc/menu/surface';
+export type { SurfaceCapabilities, PromptRequest, LocalEditRequest, LocalEditResult, SurfacePeer, Surface } from '@fnndsc/menu/surface';
 /**
  * Raised when a builtin requests an interaction the attached surface cannot
  * provide. Carries the capability name so a host can present it uniformly.

package/dist/core/surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/core/surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA0MH;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,mDAAmD;IACnC,UAAU,CAA4B;IAEtD;;;OAGG;IACH,YAAY,UAAqC,EAAE,OAAe;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAC1B,kBAAkB;IACF,YAAY,GAAwB;QAClD,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,KAAK;QAChB,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,KAAK;QACZ,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,YAAY,EAAE,KAAK;QACnB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;KACvB,CAAC;IAEF,kBAAkB;IACX,MAAM,CAAC,QAAuB;QACnC,MAAM,IAAI,eAAe,CAAC,KAAK,EAAE,uCAAuC,CAAC,CAAC;IAC5E,CAAC;IAED,kBAAkB;IACX,WAAW,CAAC,QAAgB,EAAE,MAAc;QACjD,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,4CAA4C,CAAC,CAAC;IAC1F,CAAC;IAED,kBAAkB;IACX,YAAY,CAAC,QAAgB;QAClC,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,yCAAyC,CAAC,CAAC;IACxF,CAAC;IAED,kBAAkB;IACX,SAAS,CAAC,QAA0B;QACzC,MAAM,IAAI,eAAe,CAAC,WAAW,EAAE,0CAA0C,CAAC,CAAC;IACrF,CAAC;IAED,kBAAkB;IACX,WAAW,CAAC,QAA4B;QAC7C,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,qCAAqC,CAAC,CAAC;IACnF,CAAC;CACF;AAED,0EAA0E;AAC1E,IAAI,aAAa,GAAY,IAAI,eAAe,EAAE,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,QAAQ,GAAY,aAAa,CAAC;IACxC,aAAa,GAAG,OAAO,CAAC;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAqC,EACrC,OAAe;IAEf,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/core/surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAuBH;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,mDAAmD;IACnC,UAAU,CAA4B;IAEtD;;;OAGG;IACH,YAAY,UAAqC,EAAE,OAAe;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAC1B,kBAAkB;IACF,YAAY,GAAwB;QAClD,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE,KAAK;QAChB,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,KAAK;QACZ,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,YAAY,EAAE,KAAK;QACnB,gBAAgB,EAAE,KAAK;QACvB,eAAe,EAAE,KAAK;KACvB,CAAC;IAEF,kBAAkB;IACX,MAAM,CAAC,QAAuB;QACnC,MAAM,IAAI,eAAe,CAAC,KAAK,EAAE,uCAAuC,CAAC,CAAC;IAC5E,CAAC;IAED,kBAAkB;IACX,WAAW,CAAC,QAAgB,EAAE,MAAc;QACjD,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,4CAA4C,CAAC,CAAC;IAC1F,CAAC;IAED,kBAAkB;IACX,YAAY,CAAC,QAAgB;QAClC,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,yCAAyC,CAAC,CAAC;IACxF,CAAC;IAED,kBAAkB;IACX,SAAS,CAAC,QAA0B;QACzC,MAAM,IAAI,eAAe,CAAC,WAAW,EAAE,0CAA0C,CAAC,CAAC;IACrF,CAAC;IAED,kBAAkB;IACX,WAAW,CAAC,QAA4B;QAC7C,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,qCAAqC,CAAC,CAAC;IACnF,CAAC;CACF;AAED,0EAA0E;AAC1E,IAAI,aAAa,GAAY,IAAI,eAAe,EAAE,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,QAAQ,GAAY,aAAa,CAAC;IACxC,aAAa,GAAG,OAAO,CAAC;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAqC,EACrC,OAAe;IAEf,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/core/taskWatch.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @file Watching any backend's task: the core asks its source until the task
+ * is over, and tells every surface how the watch stands (`live`, `settled`,
+ * or `stale` when the source cannot answer).
+ *
+ * A backend that watches its own subjects (ChRIS's feeds) answers first; this
+ * watch is for a task the backend leaves to the core.
+ *
+ * @module
+ */
+import { type WatchState } from '@fnndsc/menu';
+import type { TaskSource } from './backend.js';
+/** How soon a watched task is asked again while it changes, and at most how long between asks. */
+export declare const TASK_WATCH_FLOOR_MS: number;
+export declare const TASK_WATCH_CAP_MS: number;
+/**
+ * The task a subject names: `/proc/<source>/<id>`, in one of the sources.
+ *
+ * @param subject - The subject.
+ * @param sources - The session's task sources.
+ * @returns The source and the task's id, or null when no source has that name.
+ */
+export declare function taskSubject_parse(subject: string, sources: ReadonlyArray<TaskSource>): {
+    source: TaskSource;
+    id: string;
+} | null;
+/**
+ * Starts or stops one owner's watch of a task.
+ *
+ * @param subject - The task's path, `/proc/<source>/<id>`.
+ * @param owner - Who watches (a surface).
+ * @param on - Start, or stop.
+ * @param sources - The session's task sources.
+ * @returns The watch's state, or null when the subject names no task source.
+ */
+export declare function taskWatch_set(subject: string, owner: string, on: boolean, sources: ReadonlyArray<TaskSource>): WatchState | null;
+/**
+ * Ends every watch an owner holds (a surface that went away).
+ *
+ * @param owner - The owner.
+ */
+export declare function taskWatch_release(owner: string): void;

package/dist/core/taskWatch.js

@@ -0,0 +1,142 @@
+/**
+ * @file Watching any backend's task: the core asks its source until the task
+ * is over, and tells every surface how the watch stands (`live`, `settled`,
+ * or `stale` when the source cannot answer).
+ *
+ * A backend that watches its own subjects (ChRIS's feeds) answers first; this
+ * watch is for a task the backend leaves to the core.
+ *
+ * @module
+ */
+import { taskState_isOver } from '@fnndsc/menu';
+import { ambient_publish } from './ambient.js';
+/** How soon a watched task is asked again while it changes, and at most how long between asks. */
+export const TASK_WATCH_FLOOR_MS = 3000;
+export const TASK_WATCH_CAP_MS = 30000;
+const watches = new Map();
+/**
+ * The task a subject names: `/proc/<source>/<id>`, in one of the sources.
+ *
+ * @param subject - The subject.
+ * @param sources - The session's task sources.
+ * @returns The source and the task's id, or null when no source has that name.
+ */
+export function taskSubject_parse(subject, sources) {
+    const match = /^\/proc\/([^/]+)\/([^/]+)\/?$/.exec(subject.trim());
+    if (match === null)
+        return null;
+    const source = sources.find((candidate) => candidate.id === match[1]);
+    return source === undefined ? null : { source, id: match[2] };
+}
+/**
+ * Records a watch's state, and tells the surfaces when it changed.
+ *
+ * @param watch - The watch.
+ * @param state - Its state now.
+ */
+function state_set(watch, state) {
+    if (watch.state === state)
+        return;
+    watch.state = state;
+    ambient_publish({ kind: 'watched', subject: watch.subject, state });
+}
+/**
+ * Asks the source once: over is settled (and the watch ends), a source that
+ * cannot answer or no longer has the task is stale, anything else live, asked
+ * again sooner when it changed.
+ *
+ * @param watch - The watch.
+ */
+async function watch_tick(watch) {
+    let task;
+    let answered = true;
+    try {
+        task = (await watch.source.list()).find((candidate) => candidate.id === watch.id);
+    }
+    catch {
+        answered = false;
+    }
+    if (!watches.has(watch.subject))
+        return;
+    if (!answered || task === undefined) {
+        state_set(watch, 'stale');
+        watch.delayMs = TASK_WATCH_CAP_MS;
+    }
+    else if (taskState_isOver(task.state)) {
+        state_set(watch, 'settled');
+        watch_stop(watch);
+        return;
+    }
+    else {
+        const now = JSON.stringify(task);
+        const changed = now !== watch.last;
+        watch.last = now;
+        state_set(watch, 'live');
+        watch.delayMs = changed ? TASK_WATCH_FLOOR_MS : Math.min(TASK_WATCH_CAP_MS, watch.delayMs * 2);
+    }
+    watch.timer = setTimeout(() => {
+        watch.timer = null;
+        void watch_tick(watch);
+    }, watch.delayMs);
+    watch.timer.unref();
+}
+/**
+ * Ends a watch.
+ *
+ * @param watch - The watch.
+ */
+function watch_stop(watch) {
+    if (watch.timer)
+        clearTimeout(watch.timer);
+    watch.timer = null;
+    watches.delete(watch.subject);
+}
+/**
+ * Starts or stops one owner's watch of a task.
+ *
+ * @param subject - The task's path, `/proc/<source>/<id>`.
+ * @param owner - Who watches (a surface).
+ * @param on - Start, or stop.
+ * @param sources - The session's task sources.
+ * @returns The watch's state, or null when the subject names no task source.
+ */
+export function taskWatch_set(subject, owner, on, sources) {
+    const named = taskSubject_parse(subject, sources);
+    if (named === null)
+        return null;
+    const key = `/proc/${named.source.id}/${named.id}`;
+    const existing = watches.get(key);
+    if (!on) {
+        if (existing) {
+            existing.owners.delete(owner);
+            if (existing.owners.size === 0)
+                watch_stop(existing);
+            return existing.state;
+        }
+        return 'settled';
+    }
+    if (existing) {
+        existing.owners.add(owner);
+        return existing.state;
+    }
+    const watch = {
+        subject: key, source: named.source, id: named.id, owners: new Set([owner]),
+        state: 'live', last: null, delayMs: TASK_WATCH_FLOOR_MS, timer: null,
+    };
+    watches.set(key, watch);
+    void watch_tick(watch);
+    return watch.state;
+}
+/**
+ * Ends every watch an owner holds (a surface that went away).
+ *
+ * @param owner - The owner.
+ */
+export function taskWatch_release(owner) {
+    for (const watch of Array.from(watches.values())) {
+        watch.owners.delete(owner);
+        if (watch.owners.size === 0)
+            watch_stop(watch);
+    }
+}
+//# sourceMappingURL=taskWatch.js.map

package/dist/core/taskWatch.js.map

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

package/dist/core/tasks.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @file A backend's tasks as files: `/proc/<source>/<task>/` holds a task's
+ * fields, one file each, the way `/proc/jobs` holds a job's.
+ *
+ * @module
+ */
+import { type Result, type VFSItem, type VFSProvider, type CpOptions, type VfsOutcome } from '@fnndsc/fond';
+import type { Task } from '@fnndsc/menu';
+import type { TaskSource } from './backend.js';
+/** The files each task's folder holds, in listing order. */
+export declare const TASK_FIELDS: ReadonlyArray<string>;
+/**
+ * A task field's text, as its file reads.
+ *
+ * @param task - The task.
+ * @param field - The field.
+ * @returns The text (empty for a field the task has not got).
+ */
+export declare function taskField_text(task: Task, field: string): string;
+/** One task source, mounted at `/proc/<id>`. */
+export declare class TaskSourceVfsProvider implements VFSProvider {
+    private readonly source;
+    readonly prefix: string;
+    /**
+     * @param source - The source it shows.
+     */
+    constructor(source: TaskSource);
+    /**
+     * The path's parts below the mount: none, a task, or a task's field.
+     *
+     * @param where - The path.
+     * @returns The parts.
+     */
+    private parts_of;
+    /**
+     * A task by id, now.
+     *
+     * @param id - Its id.
+     * @returns It, or undefined.
+     */
+    private task_get;
+    list(where: string): Promise<Result<VFSItem[]>>;
+    read(where: string): Promise<VfsOutcome<string>>;
+    readBinary(where: string): Promise<VfsOutcome<Buffer>>;
+    cp(_src: string, _dest: string, _options: CpOptions): Promise<VfsOutcome>;
+}

package/dist/core/tasks.js

@@ -0,0 +1,102 @@
+/**
+ * @file A backend's tasks as files: `/proc/<source>/<task>/` holds a task's
+ * fields, one file each, the way `/proc/jobs` holds a job's.
+ *
+ * @module
+ */
+import { Ok, Err, errorStack, vfs_ok, vfs_fail } from '@fnndsc/fond';
+/** The files each task's folder holds, in listing order. */
+export const TASK_FIELDS = ['label', 'state', 'progress', 'started', 'ended', 'log'];
+/**
+ * A task field's text, as its file reads.
+ *
+ * @param task - The task.
+ * @param field - The field.
+ * @returns The text (empty for a field the task has not got).
+ */
+export function taskField_text(task, field) {
+    switch (field) {
+        case 'label': return `${task.label}\n`;
+        case 'state': return `${task.state}\n`;
+        case 'progress': {
+            if (task.progress === undefined)
+                return '';
+            const of = task.progress.total === null ? '' : `/${task.progress.total}`;
+            return `${task.progress.current}${of}${task.progress.unit ? ` ${task.progress.unit}` : ''}\n`;
+        }
+        case 'started': return task.started ? `${task.started}\n` : '';
+        case 'ended': return task.ended ? `${task.ended}\n` : '';
+        case 'log': return task.logTail ?? '';
+        default: return '';
+    }
+}
+/** One task source, mounted at `/proc/<id>`. */
+export class TaskSourceVfsProvider {
+    source;
+    prefix;
+    /**
+     * @param source - The source it shows.
+     */
+    constructor(source) {
+        this.source = source;
+        this.prefix = `/proc/${source.id}`;
+    }
+    /**
+     * The path's parts below the mount: none, a task, or a task's field.
+     *
+     * @param where - The path.
+     * @returns The parts.
+     */
+    parts_of(where) {
+        return where.slice(this.prefix.length).split('/').filter(Boolean);
+    }
+    /**
+     * A task by id, now.
+     *
+     * @param id - Its id.
+     * @returns It, or undefined.
+     */
+    async task_get(id) {
+        return (await this.source.list()).find((task) => task.id === id);
+    }
+    async list(where) {
+        const parts = this.parts_of(where);
+        const now = new Date().toISOString();
+        if (parts.length === 0) {
+            return Ok((await this.source.list()).map((task) => ({
+                name: task.id, type: 'dir', size: 0, owner: this.source.id, date: task.started ?? now,
+            })));
+        }
+        const task = parts.length === 1 ? await this.task_get(parts[0]) : undefined;
+        if (task === undefined) {
+            errorStack.stack_push('error', `Cannot list ${where}: No such file or directory`);
+            return Err();
+        }
+        return Ok(TASK_FIELDS.map((field) => ({
+            name: field, type: 'file', size: taskField_text(task, field).length, owner: this.source.id, date: task.started ?? now,
+        })));
+    }
+    async read(where) {
+        const parts = this.parts_of(where);
+        if (parts.length < 2)
+            return vfs_fail(parts.length === 0 ? 'EISDIR' : (await this.task_get(parts[0])) ? 'EISDIR' : 'ENOENT');
+        const [id, field] = parts;
+        const task = await this.task_get(id);
+        if (task === undefined || parts.length > 2 || !TASK_FIELDS.includes(field))
+            return vfs_fail('ENOENT');
+        if (field === 'log' && this.source.log) {
+            const whole = await this.source.log(id);
+            if (whole !== null)
+                return vfs_ok(whole);
+        }
+        return vfs_ok(taskField_text(task, field));
+    }
+    async readBinary(where) {
+        const text = await this.read(where);
+        return text.ok ? vfs_ok(Buffer.from(text.value, 'utf-8')) : text;
+    }
+    async cp(_src, _dest, _options) {
+        return vfs_fail('EROFS', `cp: a task is not copied: ${this.prefix} is the ${this.source.label}`);
+    }
+}
+//# sourceMappingURL=tasks.js.map

package/dist/core/tasks.js.map

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

package/dist/core.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @file `@fnndsc/brasa/core`: the engine with no backend installed.
+ *
+ * The package root installs ChRIS for every consumer. This entry installs
+ * nothing: a host hands `engine_create` the backend its session runs over
+ * (the null backend here, or its own), and none of the ChRIS packages load
+ * unless that backend loads them.
+ *
+ * @module
+ */
+export * from './core/engine.js';
+export * from './core/dispatch.js';
+export * from './core/backend.js';
+export * from './core/sink.js';
+export * from './core/surface.js';
+export * from './core/question.js';
+export * from './core/progress.js';
+export * from './core/commandRegistry.js';
+export * from './core/tasks.js';
+export * from './core/version.js';
+export * from './logo/brain.js';
+export { nullBackend_make, type NullBackendOptions } from './null/backend.js';

package/dist/core.js

@@ -0,0 +1,23 @@
+/**
+ * @file `@fnndsc/brasa/core`: the engine with no backend installed.
+ *
+ * The package root installs ChRIS for every consumer. This entry installs
+ * nothing: a host hands `engine_create` the backend its session runs over
+ * (the null backend here, or its own), and none of the ChRIS packages load
+ * unless that backend loads them.
+ *
+ * @module
+ */
+export * from './core/engine.js';
+export * from './core/dispatch.js';
+export * from './core/backend.js';
+export * from './core/sink.js';
+export * from './core/surface.js';
+export * from './core/question.js';
+export * from './core/progress.js';
+export * from './core/commandRegistry.js';
+export * from './core/tasks.js';
+export * from './core/version.js';
+export * from './logo/brain.js';
+export { nullBackend_make } from './null/backend.js';
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAA2B,MAAM,mBAAmB,CAAC"}