@fnndsc/brasa 0.49.1 → 0.50.0

package/dist/core/joblets.js

@@ -0,0 +1,363 @@
+/**
+ * @file Joblets: lines run in the background, `line &` (#1273).
+ *
+ * A long line (a PACS pull, a feed's creation, a teardown) need not hold the
+ * console it was typed in. Ended with `&`, it runs as a joblet: the runner
+ * keeps it as `/proc/joblets/<N>`, its output goes to its log rather than to
+ * a console someone is typing in, and its surface hears one line when it
+ * starts (`[1] pull … &`) and one when it ends (`[1]+ Done  pull …`).
+ *
+ * A joblet is a subshell, as POSIX's is: it stands where its line was typed
+ * and starts with that line's variables, and its own `cd`s and assignments
+ * stay inside it. What lives in CUBE (a feed, the cohort) is shared, and a
+ * joblet holds what its line changes while it works, as a foreground line
+ * does, so it waits for, and is waited for by, the lines it conflicts with.
+ *
+ * A joblet that needs an answer pauses and says so (`[1]+ Waiting for an
+ * answer: … · fg %1 to answer`), as a POSIX background job that reads the
+ * terminal is stopped: a question asked out of the blue in a console would
+ * be answered by accident. `fg %1`, from any surface, asks it there.
+ *
+ * Joblets belong to the session: they outlive the surface that started them,
+ * and a daemon restart ends them, their logs kept ("ended by restart").
+ *
+ * @module
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { EventEmitter } from 'node:events';
+import { envelope_error, envelope_ok, taskState_isOver } from '@fnndsc/menu';
+import { ambient_publish } from './ambient.js';
+import { commandCancellation_abort } from './cancellation.js';
+import { lineHolds_get } from './holds.js';
+import { lineOrigin_get } from './lineOrigin.js';
+import { JobRefusal, runner_get } from './runner.js';
+import { ansi_strip, sinkScope_run } from './sink.js';
+import { surfaceInstalled_get, surfaceScope_run } from './surface.js';
+import { variableScope_fork } from './variables.js';
+import { quoteOpen_find } from '../lib/quoting.js';
+import { cwdScope_run } from '../session/cwdScope.js';
+import { session } from '../session/index.js';
+/** The runner source joblets are kept in: `/proc/joblets/<N>`. */
+export const JOBLETS_SOURCE_ID = 'joblets';
+/**
+ * Runs work outside every line's scope, as the kernel stood when it loaded:
+ * a joblet is its own line, not part of the one that started it.
+ */
+const rootContext_run = AsyncLocalStorage.snapshot();
+const running = new Map();
+const asking = new EventEmitter();
+asking.setMaxListeners(0);
+/**
+ * The line a joblet ends with, as its surface and `joblets` print it.
+ *
+ * @param record - The joblet's record.
+ * @returns The notice.
+ */
+function jobletNotice_render(record) {
+    if (record.state === 'done')
+        return `[${record.id}]+ Done  ${record.label}`;
+    if (record.state === 'cancelled')
+        return `[${record.id}]+ Stopped  ${record.label}`;
+    const exit = record.data.exit;
+    return `[${record.id}]+ Failed (exit ${typeof exit === 'number' ? exit : 1}): ${record.outcome ?? record.label}`;
+}
+/** The joblets' source, which the core gives every session's runner. */
+export const jobletsSource = {
+    id: JOBLETS_SOURCE_ID,
+    label: 'joblets',
+    // A joblet runs the session's own lines, which need no tier in front.
+    ungated: true,
+    interrupted: 'ended by restart',
+    notice: jobletNotice_render,
+};
+/**
+ * The line a `&` sends to the background, when the line ends with one.
+ *
+ * @param line - The line as typed.
+ * @returns The line without its `&`, or null when it is not one (`&&`,
+ *   `\&`, a `&` inside quotes, a bare `&`).
+ */
+export function jobletLine_parse(line) {
+    const trimmed = line.trimEnd();
+    if (!trimmed.endsWith('&') || trimmed.endsWith('&&'))
+        return null;
+    const body = trimmed.slice(0, -1);
+    if (body.endsWith('\\') || quoteOpen_find(body) !== null)
+        return null;
+    const command = body.trim();
+    return command === '' ? null : command;
+}
+/**
+ * Publishes a line to the surface a joblet came from.
+ *
+ * @param origin - The surface.
+ * @param text - The line.
+ */
+function notice_publish(origin, text, model) {
+    ambient_publish({ kind: 'envelope', envelope: envelope_ok(`${text}\n`, model), origin });
+}
+/** A sink that writes a joblet's output to its log, a line at a time. */
+class JobletLogSink {
+    write;
+    progress;
+    relay;
+    pending = '';
+    /**
+     * @param write - Writes one line to the log.
+     * @param progress - Says how far the joblet has come, on its task.
+     * @param relay - Hands a progress event to the joblet's surface.
+     */
+    constructor(write, progress, relay) {
+        this.write = write;
+        this.progress = progress;
+        this.relay = relay;
+    }
+    /** @inheritdoc */
+    data_write(chunk) {
+        this.text_take(typeof chunk === 'string' ? chunk : chunk.toString('utf-8'));
+    }
+    /** @inheritdoc */
+    err_write(chunk) {
+        this.text_take(typeof chunk === 'string' ? chunk : chunk.toString('utf-8'));
+    }
+    /** @inheritdoc */
+    status_write(_text) {
+        // A status line is for whoever watches now; a log keeps what happened.
+    }
+    /** @inheritdoc */
+    progress_write(event) {
+        // The surface it came from follows it as it would a line in front.
+        this.relay(event);
+        // A count goes on the joblet's task, where a tile or a watch reads it.
+        if (event.current === undefined)
+            return;
+        this.progress({ current: event.current, total: event.total ?? null, ...(event.unit !== undefined ? { unit: event.unit } : {}) });
+    }
+    /** @inheritdoc */
+    event_write(_kind, _data) {
+        // An event is live by contract.
+    }
+    /** Writes what is left of a line without its newline. */
+    flush() {
+        if (this.pending !== '')
+            this.write(this.pending);
+        this.pending = '';
+    }
+    /**
+     * Splits text into the log's lines, keeping a part-line for the next chunk.
+     *
+     * @param text - The text.
+     */
+    text_take(text) {
+        const lines = ansi_strip(this.pending + text).split('\n');
+        this.pending = lines.pop() ?? '';
+        for (const line of lines)
+            this.write(line);
+    }
+}
+/**
+ * The number a new joblet takes: one past the highest still running, as a
+ * shell numbers its jobs.
+ *
+ * @param runner - The session's runner.
+ * @returns The number.
+ */
+function jobletNumber_next(runner) {
+    const numbers = runner.jobs_list(JOBLETS_SOURCE_ID)
+        .filter((record) => !taskState_isOver(record.state))
+        .map((record) => Number(record.id))
+        .filter((number) => Number.isInteger(number));
+    return numbers.length === 0 ? 1 : Math.max(...numbers) + 1;
+}
+/**
+ * Starts a line as a joblet.
+ *
+ * @param line - The line, without its `&`.
+ * @returns The start notice, `[1] line &`, or why it could not start.
+ */
+export async function joblet_start(line) {
+    const runner = runner_get();
+    if (runner === null)
+        return envelope_error('', undefined, `${line}: this session runs no joblets\n`);
+    const number = jobletNumber_next(runner);
+    const joblet = { number, line, origin: lineOrigin_get(), question: null };
+    // Where the line was typed: the joblet stands there whatever moves later.
+    const cwd = await session.getCWD();
+    try {
+        const started = runner.job_start(JOBLETS_SOURCE_ID, String(number), line, (context) => {
+            running.set(number, joblet);
+            return rootContext_run(() => joblet_run(joblet, context, cwd))
+                .finally(() => { running.delete(number); });
+        }, { origin: joblet.origin });
+        void started.finished;
+    }
+    catch (error) {
+        if (error instanceof JobRefusal)
+            return envelope_error('', undefined, `${error.message}\n`);
+        throw error;
+    }
+    return envelope_ok(`[${number}] ${line} &\n`, { kind: 'joblet.started', data: { number, line, path: `/proc/${JOBLETS_SOURCE_ID}/${number}` } });
+}
+/**
+ * A joblet's work: its line, run as a line of its own, writing to its log.
+ *
+ * @param joblet - The joblet.
+ * @param context - What the runner hands it.
+ * @param cwd - Where it stands.
+ */
+async function joblet_run(joblet, context, cwd) {
+    const { line_execute } = await import('./engine.js');
+    const host = surfaceInstalled_get();
+    let release = null;
+    const hold_take = async () => {
+        release = host.hold !== undefined ? await host.hold(lineHolds_get(joblet.line)) : null;
+    };
+    const hold_give = () => {
+        const giving = release;
+        release = null;
+        giving?.();
+    };
+    const key = `joblet-${joblet.number}`;
+    context.signal.addEventListener('abort', () => {
+        commandCancellation_abort(key);
+        joblet.question?.refuse(new Error('the joblet was stopped'));
+    }, { once: true });
+    const standIn = jobletSurface_make(joblet, context, hold_take, hold_give);
+    const sink = new JobletLogSink((text) => context.log_write(text), (progress) => context.progress_set(progress), (event) => ambient_publish({ kind: 'progress', origin: joblet.origin, id: key, progress: event }));
+    let exit = 0;
+    await hold_take();
+    let envelopes;
+    try {
+        envelopes = await sinkScope_run(sink, () => surfaceScope_run(standIn, () => variableScope_fork(() => cwdScope_run(() => line_execute(joblet.line, { origin: `joblet:${joblet.number}`, id: key, ended: (code) => { exit = code; } }), cwd))));
+    }
+    finally {
+        hold_give();
+    }
+    // What the line answered with goes to the log after what it printed, and
+    // a model it answered with (a cohort its pull brought home) to its surface,
+    // whose views take it as they would from a line in front.
+    for (const envelope of envelopes) {
+        if (envelope.model !== undefined)
+            ambient_publish({ kind: 'envelope', envelope: { status: envelope.status, rendered: '', model: envelope.model }, origin: joblet.origin });
+        if (envelope.rendered !== '')
+            sink.data_write(envelope.rendered.endsWith('\n') ? envelope.rendered : `${envelope.rendered}\n`);
+        if (envelope.renderedErr)
+            sink.err_write(envelope.renderedErr.endsWith('\n') ? envelope.renderedErr : `${envelope.renderedErr}\n`);
+    }
+    sink.flush();
+    const failed = exit !== 0 || envelopes.some((envelope) => envelope.status === 'error');
+    if (!failed)
+        return;
+    context.data_set('exit', exit === 0 ? 1 : exit);
+    const lastErr = envelopes.map((envelope) => ansi_strip(envelope.renderedErr ?? '')).join('').trim().split('\n').pop() ?? '';
+    throw new Error(lastErr !== '' ? lastErr : `exit ${exit === 0 ? 1 : exit}`);
+}
+/**
+ * The surface a joblet runs under: the host's, except that a question
+ * pauses the joblet until someone `fg`s it, giving up what it holds while
+ * it waits.
+ *
+ * @param joblet - The joblet.
+ * @param context - Its runner context.
+ * @param hold_take - Takes its hold again.
+ * @param hold_give - Gives its hold up.
+ * @returns The stand-in.
+ */
+function jobletSurface_make(joblet, context, hold_take, hold_give) {
+    const question_pause = async (request) => {
+        if (context.signal.aborted)
+            throw new Error('the joblet was stopped');
+        hold_give();
+        notice_publish(joblet.origin, `[${joblet.number}]+ Waiting for an answer: ${request.message.trim()} · fg %${joblet.number} to answer`, { kind: 'joblet.waiting', data: { number: joblet.number, line: joblet.line, question: request.message } });
+        context.log_write(`waiting for an answer: ${request.message.trim()}`);
+        try {
+            return await new Promise((resolve, reject) => {
+                joblet.question = {
+                    request,
+                    answer: (text) => { joblet.question = null; resolve(text); },
+                    refuse: (reason) => { joblet.question = null; reject(reason); },
+                };
+                asking.emit(`asked:${joblet.number}`);
+            });
+        }
+        finally {
+            await hold_take();
+        }
+    };
+    return new Proxy(surfaceInstalled_get(), {
+        get: (_target, property) => {
+            if (property === 'prompt')
+                return question_pause;
+            const host = surfaceInstalled_get();
+            const value = Reflect.get(host, property);
+            return typeof value === 'function' ? value.bind(host) : value;
+        },
+    });
+}
+/**
+ * The question a joblet waits on now, if any.
+ *
+ * @param number - The joblet.
+ * @returns Its question, or null.
+ */
+export function jobletQuestion_get(number) {
+    return running.get(number)?.question ?? null;
+}
+/**
+ * Waits until a joblet asks a question, or the wait is called off.
+ *
+ * @param number - The joblet.
+ * @param until - Calls the wait off when it settles.
+ * @returns The question, or null when called off first.
+ */
+export async function jobletQuestion_await(number, until) {
+    const now = jobletQuestion_get(number);
+    if (now !== null)
+        return now;
+    let heard = null;
+    const asked = new Promise((resolve) => {
+        heard = () => resolve('asked');
+        asking.once(`asked:${number}`, heard);
+    });
+    const outcome = await Promise.race([asked, until.then(() => 'off', () => 'off')]);
+    if (heard !== null)
+        asking.off(`asked:${number}`, heard);
+    return outcome === 'asked' ? jobletQuestion_get(number) : null;
+}
+/**
+ * The joblets running now: what a restart would end.
+ *
+ * @returns Them, by number.
+ */
+export function joblets_running() {
+    return [...running.values()]
+        .sort((a, b) => a.number - b.number)
+        .map((joblet) => ({ number: joblet.number, line: joblet.line, waiting: joblet.question !== null }));
+}
+/**
+ * Whether a joblet waits on an answer.
+ *
+ * @param number - The joblet.
+ * @returns True while it waits.
+ */
+export function joblet_isWaiting(number) {
+    return jobletQuestion_get(number) !== null;
+}
+/**
+ * The joblet a word names: `%3`, `%%`/`%+` (the most recent), or `3`.
+ *
+ * @param word - The word.
+ * @returns The joblet's number, or null when the word names none.
+ */
+export function jobletWord_parse(word) {
+    const runner = runner_get();
+    if (word === '%%' || word === '%+' || word === '%') {
+        const numbers = (runner?.jobs_list(JOBLETS_SOURCE_ID) ?? []).map((record) => Number(record.id)).filter(Number.isInteger);
+        const live = numbers.filter((number) => running.has(number));
+        const pool = live.length > 0 ? live : numbers;
+        return pool.length === 0 ? null : Math.max(...pool);
+    }
+    const match = word.match(/^%?(\d+)$/);
+    return match === null ? null : Number(match[1]);
+}
+//# sourceMappingURL=joblets.js.map

package/dist/core/joblets.js.map

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

package/dist/core/lineOrigin.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @file Which surface a line came from.
+ *
+ * One session serves several surfaces at once: a console, a browser, a
+ * second terminal. What a line leaves behind for the operator who typed it
+ * (the listing `@3` counts) belongs to that operator's surface, not to the
+ * session: a listing one surface reads must not renumber the rows another
+ * is about to act on (#1273).
+ *
+ * The host names the origin when it hands the kernel a line; a line run
+ * inside it (a manifest's, a capture's) inherits it. A line with no host
+ * behind it (a test, a headless script) has the default origin.
+ *
+ * @module
+ */
+/** The origin of a line no host named. */
+export declare const ORIGIN_DEFAULT: string;
+/**
+ * Runs an operation as lines from one origin.
+ *
+ * @param origin - The surface the line came from.
+ * @param operation - The work.
+ * @returns What the operation returns.
+ */
+export declare function lineOrigin_run<T>(origin: string, operation: () => Promise<T>): Promise<T>;
+/**
+ * The origin of the line running now.
+ *
+ * @returns The surface it came from, or {@link ORIGIN_DEFAULT}.
+ */
+export declare function lineOrigin_get(): string;

package/dist/core/lineOrigin.js

@@ -0,0 +1,38 @@
+/**
+ * @file Which surface a line came from.
+ *
+ * One session serves several surfaces at once: a console, a browser, a
+ * second terminal. What a line leaves behind for the operator who typed it
+ * (the listing `@3` counts) belongs to that operator's surface, not to the
+ * session: a listing one surface reads must not renumber the rows another
+ * is about to act on (#1273).
+ *
+ * The host names the origin when it hands the kernel a line; a line run
+ * inside it (a manifest's, a capture's) inherits it. A line with no host
+ * behind it (a test, a headless script) has the default origin.
+ *
+ * @module
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+/** The origin of a line no host named. */
+export const ORIGIN_DEFAULT = '';
+const originScope = new AsyncLocalStorage();
+/**
+ * Runs an operation as lines from one origin.
+ *
+ * @param origin - The surface the line came from.
+ * @param operation - The work.
+ * @returns What the operation returns.
+ */
+export async function lineOrigin_run(origin, operation) {
+    return await originScope.run(origin, operation);
+}
+/**
+ * The origin of the line running now.
+ *
+ * @returns The surface it came from, or {@link ORIGIN_DEFAULT}.
+ */
+export function lineOrigin_get() {
+    return originScope.getStore() ?? ORIGIN_DEFAULT;
+}
+//# sourceMappingURL=lineOrigin.js.map

package/dist/core/lineOrigin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineOrigin.js","sourceRoot":"","sources":["../../src/core/lineOrigin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAW,EAAE,CAAC;AAEzC,MAAM,WAAW,GAA8B,IAAI,iBAAiB,EAAU,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,MAAc,EAAE,SAA2B;IACjF,OAAO,MAAM,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,CAAC,QAAQ,EAAE,IAAI,cAAc,CAAC;AAClD,CAAC"}

package/dist/core/listing.d.ts

@@ -16,6 +16,14 @@ export interface ListingModel {
     kind: string;
     data: unknown;
 }
+/**
+ * Runs a pipe segment with the listing piped into it, in a slot of its own.
+ *
+ * @param model - The previous segment's listing, or null.
+ * @param operation - The segment.
+ * @returns What the segment returned.
+ */
+export declare function listingInScope_run<T>(model: ListingModel | null, operation: () => Promise<T>): Promise<T>;
 /**
  * Hands a listing to the next builtin in a pipe (null clears it).
  *

package/dist/core/listing.js

@@ -12,24 +12,35 @@
  */
 import { answer_get, answerRows_derive } from '../session/answer.js';
 import { answerKinds_get } from './answerKinds.js';
-import { turnPart_register } from './turn.js';
-/** The listing the previous builtin in a pipe produced, for the next to take. */
-let piped = null;
-// A pipe's listing not yet taken belongs to its command, not to one that
-// runs while that command waits on a question.
-turnPart_register({
-    name: 'listingIn',
-    save: () => piped,
-    clear: () => { piped = null; },
-    restore: (saved) => { piped = saved ?? null; },
-});
+import { AsyncLocalStorage } from 'node:async_hooks';
+/** The slot outside any pipe segment's scope (a test, a direct call). */
+const unscoped = { value: null };
+/**
+ * The slot of the pipe segment running on this async path: two lines that
+ * run at once each read their own pipe's input, never the other's (#1273).
+ */
+const pipedScope = new AsyncLocalStorage();
+/** The slot for the work running now. */
+function piped_slot() {
+    return pipedScope.getStore() ?? unscoped;
+}
+/**
+ * Runs a pipe segment with the listing piped into it, in a slot of its own.
+ *
+ * @param model - The previous segment's listing, or null.
+ * @param operation - The segment.
+ * @returns What the segment returned.
+ */
+export async function listingInScope_run(model, operation) {
+    return await pipedScope.run({ value: model }, operation);
+}
 /**
  * Hands a listing to the next builtin in a pipe (null clears it).
  *
  * @param model - The previous segment's model, when it is a listing.
  */
 export function listingIn_set(model) {
-    piped = model;
+    piped_slot().value = model;
 }
 /**
  * Takes the piped listing, once.
@@ -37,8 +48,9 @@ export function listingIn_set(model) {
  * @returns It, or null when nothing was piped in.
  */
 export function listingIn_take() {
-    const taken = piped;
-    piped = null;
+    const slot = piped_slot();
+    const taken = slot.value;
+    slot.value = null;
     return taken;
 }
 /**

package/dist/core/listing.js.map

@@ -1 +1 @@
-{"version":3,"file":"listing.js","sourceRoot":"","sources":["../../src/core/listing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAkB,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAQ9C,iFAAiF;AACjF,IAAI,KAAK,GAAwB,IAAI,CAAC;AAEtC,yEAAyE;AACzE,+CAA+C;AAC/C,iBAAiB,CAAC;IAChB,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,GAAY,EAAE,CAAC,KAAK;IAC1B,KAAK,EAAE,GAAS,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,KAAc,EAAQ,EAAE,GAAG,KAAK,GAAI,KAA6B,IAAI,IAAI,CAAC,CAAC,CAAC;CACvF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAA0B;IACtD,KAAK,GAAG,KAAK,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAwB,KAAK,CAAC;IACzC,KAAK,GAAG,IAAI,CAAC;IACb,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA8B;IAChE,MAAM,MAAM,GAAgB,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAW,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACvI,MAAM,IAAI,GAAgB,IAAI,GAAG,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAmB;IACzD,MAAM,IAAI,GAAuB,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"listing.js","sourceRoot":"","sources":["../../src/core/listing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAkB,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAarD,yEAAyE;AACzE,MAAM,QAAQ,GAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,GAAoC,IAAI,iBAAiB,EAAgB,CAAC;AAE1F,yCAAyC;AACzC,SAAS,UAAU;IACjB,OAAO,UAAU,CAAC,QAAQ,EAAE,IAAI,QAAQ,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAI,KAA0B,EAAE,SAA2B;IACjG,OAAO,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAA0B;IACtD,UAAU,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAiB,UAAU,EAAE,CAAC;IACxC,MAAM,KAAK,GAAwB,IAAI,CAAC,KAAK,CAAC;IAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IAClB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA8B;IAChE,MAAM,MAAM,GAAgB,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAW,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACvI,MAAM,IAAI,GAAgB,IAAI,GAAG,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC9B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAmB;IACzD,MAAM,IAAI,GAAuB,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/core/runner.d.ts

@@ -51,11 +51,19 @@ export type JobRun = (context: JobContext) => Promise<void>;
  * @property resume - Picks a job that was running when the session ended up
  *   again, from its record: the work to go on with, or null when it cannot
  *   go on (it is then marked failed, saying so).
+ * @property ungated - Starting one needs no tier: its work is the session's
+ *   own lines, which the operator may run anyway (a joblet).
+ * @property interrupted - What a job that cannot go on after a restart says.
+ * @property notice - The line every surface (or the job's own, `data.origin`)
+ *   hears when a job ends; the job's path and state when absent.
  */
 export interface JobSource {
     readonly id: string;
     readonly label: string;
     readonly resume?: (record: JobRecord) => JobRun | null;
+    readonly ungated?: boolean;
+    readonly interrupted?: string;
+    readonly notice?: (record: JobRecord) => string;
 }
 /** Why a job did not start. */
 export declare class JobRefusal extends Error {
@@ -88,6 +96,13 @@ export declare class JobRunner {
      * @param allowed - Whether starting a job is allowed now (the `tasks` tier).
      */
     constructor(root: string, sources: ReadonlyArray<JobSource>, allowed?: () => boolean);
+    /**
+     * A job source by id.
+     *
+     * @param id - Its id.
+     * @returns It, or undefined.
+     */
+    private source_find;
     /**
      * A job's key in the map.
      *

package/dist/core/runner.js

@@ -83,6 +83,15 @@ export class JobRunner {
         for (const source of sources)
             this.records_load(source.id);
     }
+    /**
+     * A job source by id.
+     *
+     * @param id - Its id.
+     * @returns It, or undefined.
+     */
+    source_find(id) {
+        return this.sources.find((candidate) => candidate.id === id);
+    }
     /**
      * A job's key in the map.
      *
@@ -190,10 +199,16 @@ export class JobRunner {
         delete entry.controller;
         this.record_save(entry);
         this.events.emit(`end:${this.key_format(entry.record.source, entry.record.id)}`, entry.record);
-        // Every surface hears a job end, as it hears a chime: a line and its model.
+        // Every surface hears a job end, as it hears a chime: a line and its
+        // model. A job that names the surface it was started on tells it alone.
+        const source = this.source_find(entry.record.source);
+        const notice = source?.notice?.(entry.record)
+            ?? `/proc/${entry.record.source}/${entry.record.id}: ${entry.record.state}${entry.record.state === 'done' ? '' : ` (${entry.record.outcome ?? ''})`}`;
+        const origin = entry.record.data.origin;
         ambient_publish({
             kind: 'envelope',
-            envelope: envelope_ok(`/proc/${entry.record.source}/${entry.record.id}: ${entry.record.state}${entry.record.state === 'done' ? '' : ` (${entry.record.outcome ?? ''})`}\n`, { kind: JOB_MODEL_KIND, data: { ...entry.record } }),
+            envelope: envelope_ok(`${notice}\n`, { kind: JOB_MODEL_KIND, data: { ...entry.record } }),
+            ...(typeof origin === 'string' ? { origin } : {}),
         });
         return entry.record;
     }
@@ -209,10 +224,11 @@ export class JobRunner {
      * @throws JobRefusal - Without the `tasks` tier, for an unknown source, or while that id still runs.
      */
     job_start(source, id, label, run, data = {}) {
-        if (!this.allowed())
-            throw new JobRefusal(`${id}: Operation not permitted: starting a task needs the tasks tier (calypso --host-control tasks)`);
-        if (!this.sources.some((candidate) => candidate.id === source))
+        const kind = this.source_find(source);
+        if (kind === undefined)
             throw new JobRefusal(`${id}: no task source ${source}`);
+        if (kind.ungated !== true && !this.allowed())
+            throw new JobRefusal(`${id}: Operation not permitted: starting a task needs the tasks tier (calypso --host-control tasks)`);
         if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(id))
             throw new JobRefusal(`${id}: a task's name is letters, digits, '.', '_' and '-'`);
         const existing = this.entries.get(this.key_format(source, id));
@@ -240,10 +256,12 @@ export class JobRunner {
                 continue;
             const source = this.sources.find((candidate) => candidate.id === entry.record.source);
             const run = source?.resume?.(entry.record) ?? null;
-            if (run === null || !this.allowed()) {
+            if (run === null || (source?.ungated !== true && !this.allowed())) {
                 entry.record.state = 'failed';
                 entry.record.ended = new Date().toISOString();
-                entry.record.outcome = run === null ? 'interrupted: the session ended while it ran, and it cannot be picked up again' : 'interrupted: the session restarted without the tasks tier';
+                entry.record.outcome = run === null
+                    ? source?.interrupted ?? 'interrupted: the session ended while it ran, and it cannot be picked up again'
+                    : 'interrupted: the session restarted without the tasks tier';
                 this.log_append(entry, `failed: ${entry.record.outcome}`);
                 this.record_save(entry);
                 continue;