@fnndsc/brasa 0.49.0 → 0.50.0

package/dist/core/holds.js

@@ -0,0 +1,74 @@
+/**
+ * @file What a line holds of the session while it runs.
+ *
+ * Lines from several surfaces share one session, and one line's work must
+ * not stop another's: a listing read in a browser should not wait behind a
+ * PACS pull typed in a console. So a host runs lines side by side unless
+ * they change the same piece of the session, and asks the kernel, before
+ * a line runs, what it holds (#1273). A line holds what its commands hold:
+ * nothing for a read, the working directory for `cd`, the cohort for
+ * `gather`. Whatever cannot be read off the line (a command that has not
+ * said, a host shell, a capture inside a word) holds the whole session, as
+ * every line did before.
+ *
+ * @module
+ */
+import { commandHolds_get } from './commandRegistry.js';
+import { pipes_parse } from './preprocess.js';
+import { semicolons_parse } from '../lib/semicolonParser.js';
+import { assignment_parse } from './variables.js';
+import { jobletLine_parse } from './joblets.js';
+/**
+ * What a line holds of the session while it runs.
+ *
+ * @param line - The line, as the operator typed it.
+ * @returns The pieces its commands change (none for a read), or 'all'.
+ */
+export function lineHolds_get(line) {
+    // A line sent to the background only starts a joblet, which takes its
+    // own hold when it runs.
+    if (jobletLine_parse(line) !== null)
+        return [];
+    const pieces = new Set();
+    for (const command of semicolons_parse(line)) {
+        const held = commandLine_holds(command.trim());
+        if (held === 'all')
+            return 'all';
+        for (const piece of held)
+            pieces.add(piece);
+    }
+    return [...pieces];
+}
+/**
+ * What one command line (no semicolons) holds.
+ *
+ * @param command - The trimmed command line.
+ * @returns Its pieces, or 'all'.
+ */
+function commandLine_holds(command) {
+    if (command === '')
+        return [];
+    // A host shell may do anything, the session's own tools included.
+    if (command.startsWith('!'))
+        return 'all';
+    const assignment = assignment_parse(command);
+    if (assignment !== null) {
+        // A store is one step: the assignment holds what its capture holds.
+        if ('capture' in assignment)
+            return lineHolds_get(assignment.capture);
+        return 'literal' in assignment && !/\$\(|`/.test(assignment.literal) ? [] : 'all';
+    }
+    if (/\$\(|`/.test(command))
+        return 'all';
+    const pieces = new Set();
+    for (const segment of pipes_parse(command)) {
+        const name = segment.trim().split(/\s+/)[0] ?? '';
+        const held = commandHolds_get(name);
+        if (held === null)
+            return 'all';
+        for (const piece of held)
+            pieces.add(piece);
+    }
+    return [...pieces];
+}
+//# sourceMappingURL=holds.js.map

package/dist/core/holds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"holds.js","sourceRoot":"","sources":["../../src/core/holds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAqB,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAmB,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKhD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,sEAAsE;IACtE,yBAAyB;IACzB,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAsB,IAAI,GAAG,EAAE,CAAC;IAC5C,KAAK,MAAM,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAc,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,IAAI,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,OAAe;IACxC,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,kEAAkE;IAClE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,UAAU,GAAsB,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChE,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,oEAAoE;QACpE,IAAI,SAAS,IAAI,UAAU;YAAE,OAAO,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACtE,OAAO,SAAS,IAAI,UAAU,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACpF,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,MAAM,GAAsB,IAAI,GAAG,EAAE,CAAC;IAC5C,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAW,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAmC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;AACrB,CAAC"}

package/dist/core/joblets.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @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 { type CommandEnvelope } from '@fnndsc/menu';
+import { type JobSource } from './runner.js';
+import { type PromptRequest } from './surface.js';
+/** The runner source joblets are kept in: `/proc/joblets/<N>`. */
+export declare const JOBLETS_SOURCE_ID: string;
+/** A question a joblet waits on, until someone `fg`s it. */
+export interface JobletQuestion {
+    request: PromptRequest;
+    answer(text: string): void;
+    refuse(reason: Error): void;
+}
+/** The joblets' source, which the core gives every session's runner. */
+export declare const jobletsSource: JobSource;
+/**
+ * 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 declare function jobletLine_parse(line: string): string | null;
+/**
+ * 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 declare function joblet_start(line: string): Promise<CommandEnvelope>;
+/**
+ * The question a joblet waits on now, if any.
+ *
+ * @param number - The joblet.
+ * @returns Its question, or null.
+ */
+export declare function jobletQuestion_get(number: number): JobletQuestion | 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 declare function jobletQuestion_await(number: number, until: Promise<unknown>): Promise<JobletQuestion | null>;
+/** A joblet still running, as a restart's warning counts it. */
+export interface JobletRunning {
+    number: number;
+    line: string;
+    waiting: boolean;
+}
+/**
+ * The joblets running now: what a restart would end.
+ *
+ * @returns Them, by number.
+ */
+export declare function joblets_running(): JobletRunning[];
+/**
+ * Whether a joblet waits on an answer.
+ *
+ * @param number - The joblet.
+ * @returns True while it waits.
+ */
+export declare function joblet_isWaiting(number: number): boolean;
+/**
+ * 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 declare function jobletWord_parse(word: string): number | null;

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).
  *