@fnndsc/salsa 4.4.4 → 4.5.0

package/dist/plugins/index.d.ts

@@ -145,3 +145,10 @@ export * from './plugin_register.js';
 export * from './peer_search.js';
 export * from './store_import.js';
 export * from './plugin_executeInPlace.js';
+export * from './plugin_add.js';
+export * from './plugin_docker.js';
+export * from './plugin_index.js';
+export * from './plugin_sync.js';
+export * from './plugin_validate.js';
+export * from './pool.js';
+export * from './tar_read.js';

package/dist/plugins/index.js

@@ -285,4 +285,11 @@ __exportStar(require("./plugin_register.js"), exports);
 __exportStar(require("./peer_search.js"), exports);
 __exportStar(require("./store_import.js"), exports);
 __exportStar(require("./plugin_executeInPlace.js"), exports);
+__exportStar(require("./plugin_add.js"), exports);
+__exportStar(require("./plugin_docker.js"), exports);
+__exportStar(require("./plugin_index.js"), exports);
+__exportStar(require("./plugin_sync.js"), exports);
+__exportStar(require("./plugin_validate.js"), exports);
+__exportStar(require("./pool.js"), exports);
+__exportStar(require("./tar_read.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

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

package/dist/plugins/plugin_add.d.ts

@@ -0,0 +1,173 @@
+/**
+ * @file Registering one plugin in the connected CUBE: `plugin add`.
+ *
+ * One verb, four ways in:
+ *
+ * - **a descriptor** (`plugin add --json <file>`): the descriptor's text goes
+ *   straight to CUBE's administrative upload, unless that name and version
+ *   are already registered;
+ * - **a URL** of a plugin in another CUBE: passed through as the upload's
+ *   `plugin_store_url`, and CUBE fetches the plugin itself;
+ * - **a name** or **an image**: registered already? then nothing to do;
+ *   else looked up in the peer store and imported from it; else the
+ *   image's own descriptor is read out of it with docker and uploaded.
+ *
+ * Every path registers through one upload ({@link plugin_addDescriptor}
+ * for descriptors), which `plugin sync` shares, and every refusal carries
+ * CUBE's own reason. Compute resources default to all the CUBE has, as
+ * `plugin add` always did; a failed read of them is a failure, never a
+ * guess at `host`.
+ *
+ * Key components:
+ * - PluginAddOutcome / PluginAddResult: what an add did.
+ * - PluginAddOptions: compute resources, peer store, administrator credentials.
+ * - pluginInput_detect: whether an input is a URL, an image or a name.
+ * - computeNames_resolve: the compute resources a plugin is registered on.
+ * - plugin_addDescriptor: upload one descriptor's text (shared with sync).
+ * - plugin_addJson: `plugin add --json`.
+ * - plugin_add: `plugin add <name|image|url>`.
+ *
+ * Typical usage:
+ * ```ts
+ * const result: PluginAddResult = await plugin_add('pl-dircopy', { store: storeUrl }, (line: string): void => sink(line));
+ * ```
+ *
+ * Dependencies: cumin (CUBE reads and the administrative upload), the peer
+ * store search, and docker on the host for the image path.
+ *
+ * @module
+ */
+import { type Result } from '@fnndsc/cumin';
+import { type DockerRun } from './plugin_docker.js';
+import { type AdminCredentials } from './store_import.js';
+/** What an add did. */
+export type PluginAddOutcome = 'installed' | 'already_exists' | 'failed';
+/** Writes one progress line where the operator can see it. */
+export type PluginAddNote = (line: string) => void;
+/**
+ * What `plugin add` was asked to do it with.
+ *
+ * @example
+ * ```ts
+ * const options: PluginAddOptions = { compute: 'host,gpu', store: 'https://cube.chrisproject.org/api/v1/' };
+ * ```
+ */
+export interface PluginAddOptions {
+    /** Compute resources, comma-separated; all the CUBE has when absent. */
+    readonly compute?: string;
+    /** The peer store to search; the caller's configured store. */
+    readonly store?: string;
+    /** Administrator username, for a non-interactive upload. */
+    readonly adminUser?: string;
+    /** Administrator password, for a non-interactive upload. */
+    readonly adminPassword?: string;
+    /** The plugin's repository, when an image's descriptor leaves it out. */
+    readonly publicRepo?: string;
+}
+/**
+ * What an add did, and to which plugin.
+ *
+ * @example
+ * ```ts
+ * const result: PluginAddResult = { outcome: 'installed', name: 'pl-dircopy', version: '2.1.1' };
+ * ```
+ */
+export interface PluginAddResult {
+    /** The outcome. */
+    readonly outcome: PluginAddOutcome;
+    /** The plugin's name, when known. */
+    readonly name?: string;
+    /** The plugin's version, when known. */
+    readonly version?: string;
+    /** Why it failed, when it did (also on the error stack). */
+    readonly reason?: string;
+}
+/**
+ * What an input names.
+ *
+ * @example
+ * ```ts
+ * pluginInput_detect('fnndsc/pl-dircopy:2.1.1'); // { kind: 'image', value: …, name: 'pl-dircopy', version: '2.1.1' }
+ * ```
+ */
+export interface PluginInput {
+    /** A plugin URL in another CUBE, an image reference, or a plugin name. */
+    readonly kind: 'url' | 'image' | 'name';
+    /** The input, trimmed. */
+    readonly value: string;
+    /** The plugin name it implies. */
+    readonly name: string;
+    /** The version it implies, when it names one. */
+    readonly version?: string;
+}
+/**
+ * Detects what an input names.
+ *
+ * A URL starts with `http://` or `https://`; an image holds `/` or `:`;
+ * anything else is a plugin name, `pl-x-v1.2.3` naming a version.
+ *
+ * @param input - The input as typed.
+ * @returns What it names.
+ *
+ * @example
+ * ```ts
+ * pluginInput_detect('pl-dircopy-v2.1.1'); // { kind: 'name', value: 'pl-dircopy', name: 'pl-dircopy', version: '2.1.1' }
+ * ```
+ */
+export declare function pluginInput_detect(input: string): PluginInput;
+/**
+ * Resolves the compute resources a plugin is registered on.
+ *
+ * @param compute - Comma-separated names; all the CUBE's resources when absent.
+ * @returns The names, or an error on the error stack (an unknown name, or the
+ *   CUBE's resources could not be read — never a guess).
+ *
+ * @example
+ * ```ts
+ * const names: Result<string[]> = await computeNames_resolve('host');
+ * ```
+ */
+export declare function computeNames_resolve(compute?: string): Promise<Result<string[]>>;
+/**
+ * Uploads one descriptor's text through CUBE's administrative upload.
+ *
+ * @param descriptor - The descriptor's JSON text.
+ * @param computeNames - Compute resources to register it on.
+ * @param creds - Administrator credentials; the session when absent.
+ * @returns The registered plugin's fields, or an error on the error stack.
+ *
+ * @example
+ * ```ts
+ * const added: Result<Record<string, unknown>> = await plugin_addDescriptor(text, ['host']);
+ * ```
+ */
+export declare function plugin_addDescriptor(descriptor: string, computeNames: string[], creds?: AdminCredentials): Promise<Result<Record<string, unknown>>>;
+/**
+ * Registers one descriptor file's plugin: `plugin add --json`.
+ *
+ * @param text - The descriptor's JSON text.
+ * @param options - Compute resources and credentials.
+ * @param note - Where progress lines go.
+ * @returns What the add did.
+ *
+ * @example
+ * ```ts
+ * const result: PluginAddResult = await plugin_addJson(readFileSync('pl-x.json', 'utf8'), {}, console.log);
+ * ```
+ */
+export declare function plugin_addJson(text: string, options: PluginAddOptions, note: PluginAddNote): Promise<PluginAddResult>;
+/**
+ * Registers a plugin named by a URL, an image or a name: `plugin add`.
+ *
+ * @param input - The URL, image reference or plugin name.
+ * @param options - Compute resources, peer store and credentials.
+ * @param note - Where progress lines go.
+ * @param run - The docker seam, for the image path.
+ * @returns What the add did.
+ *
+ * @example
+ * ```ts
+ * const result: PluginAddResult = await plugin_add('fnndsc/pl-dircopy:2.1.1', {}, console.log);
+ * ```
+ */
+export declare function plugin_add(input: string, options: PluginAddOptions, note: PluginAddNote, run?: DockerRun): Promise<PluginAddResult>;

package/dist/plugins/plugin_add.js

@@ -0,0 +1,325 @@
+"use strict";
+/**
+ * @file Registering one plugin in the connected CUBE: `plugin add`.
+ *
+ * One verb, four ways in:
+ *
+ * - **a descriptor** (`plugin add --json <file>`): the descriptor's text goes
+ *   straight to CUBE's administrative upload, unless that name and version
+ *   are already registered;
+ * - **a URL** of a plugin in another CUBE: passed through as the upload's
+ *   `plugin_store_url`, and CUBE fetches the plugin itself;
+ * - **a name** or **an image**: registered already? then nothing to do;
+ *   else looked up in the peer store and imported from it; else the
+ *   image's own descriptor is read out of it with docker and uploaded.
+ *
+ * Every path registers through one upload ({@link plugin_addDescriptor}
+ * for descriptors), which `plugin sync` shares, and every refusal carries
+ * CUBE's own reason. Compute resources default to all the CUBE has, as
+ * `plugin add` always did; a failed read of them is a failure, never a
+ * guess at `host`.
+ *
+ * Key components:
+ * - PluginAddOutcome / PluginAddResult: what an add did.
+ * - PluginAddOptions: compute resources, peer store, administrator credentials.
+ * - pluginInput_detect: whether an input is a URL, an image or a name.
+ * - computeNames_resolve: the compute resources a plugin is registered on.
+ * - plugin_addDescriptor: upload one descriptor's text (shared with sync).
+ * - plugin_addJson: `plugin add --json`.
+ * - plugin_add: `plugin add <name|image|url>`.
+ *
+ * Typical usage:
+ * ```ts
+ * const result: PluginAddResult = await plugin_add('pl-dircopy', { store: storeUrl }, (line: string): void => sink(line));
+ * ```
+ *
+ * Dependencies: cumin (CUBE reads and the administrative upload), the peer
+ * store search, and docker on the host for the image path.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pluginInput_detect = pluginInput_detect;
+exports.computeNames_resolve = computeNames_resolve;
+exports.plugin_addDescriptor = plugin_addDescriptor;
+exports.plugin_addJson = plugin_addJson;
+exports.plugin_add = plugin_add;
+const cumin_1 = require("@fnndsc/cumin");
+const plugin_docker_js_1 = require("./plugin_docker.js");
+const peer_search_js_1 = require("./peer_search.js");
+const plugin_register_js_1 = require("./plugin_register.js");
+const store_import_js_1 = require("./store_import.js");
+/**
+ * Detects what an input names.
+ *
+ * A URL starts with `http://` or `https://`; an image holds `/` or `:`;
+ * anything else is a plugin name, `pl-x-v1.2.3` naming a version.
+ *
+ * @param input - The input as typed.
+ * @returns What it names.
+ *
+ * @example
+ * ```ts
+ * pluginInput_detect('pl-dircopy-v2.1.1'); // { kind: 'name', value: 'pl-dircopy', name: 'pl-dircopy', version: '2.1.1' }
+ * ```
+ */
+function pluginInput_detect(input) {
+    const value = input.trim();
+    if (/^https?:\/\//.test(value))
+        return { kind: 'url', value, name: value };
+    if (value.includes('/') || value.includes(':')) {
+        const last = value.split('@')[0]?.split('/').pop() ?? value;
+        const colon = last.indexOf(':');
+        const name = colon === -1 ? last : last.slice(0, colon);
+        return colon === -1 ? { kind: 'image', value, name } : { kind: 'image', value, name, version: last.slice(colon + 1) };
+    }
+    const marker = value.lastIndexOf('-v');
+    if (marker > 0 && /^[0-9.]+$/.test(value.slice(marker + 2))) {
+        const name = value.slice(0, marker);
+        return { kind: 'name', value: name, name, version: value.slice(marker + 2) };
+    }
+    return { kind: 'name', value, name: value };
+}
+/**
+ * Resolves the compute resources a plugin is registered on.
+ *
+ * @param compute - Comma-separated names; all the CUBE's resources when absent.
+ * @returns The names, or an error on the error stack (an unknown name, or the
+ *   CUBE's resources could not be read — never a guess).
+ *
+ * @example
+ * ```ts
+ * const names: Result<string[]> = await computeNames_resolve('host');
+ * ```
+ */
+async function computeNames_resolve(compute) {
+    if (compute !== undefined && compute.trim() !== '') {
+        const names = (0, cumin_1.computeResourceNames_parse)(compute);
+        const valid = await (0, cumin_1.computeResources_validate)(names);
+        return valid.ok ? (0, cumin_1.Ok)(names) : (0, cumin_1.Err)();
+    }
+    const all = await (0, cumin_1.computeResources_getAll)();
+    if (!all.ok) {
+        cumin_1.errorStack.stack_push('error', 'Could not read the compute resources; not guessing. Name them with --compute.');
+        return (0, cumin_1.Err)();
+    }
+    if (all.value.length === 0) {
+        cumin_1.errorStack.stack_push('error', 'This CUBE has no compute resources to register plugins on.');
+        return (0, cumin_1.Err)();
+    }
+    return (0, cumin_1.Ok)(all.value.map((resource) => resource.name));
+}
+/**
+ * Uploads one descriptor's text through CUBE's administrative upload.
+ *
+ * @param descriptor - The descriptor's JSON text.
+ * @param computeNames - Compute resources to register it on.
+ * @param creds - Administrator credentials; the session when absent.
+ * @returns The registered plugin's fields, or an error on the error stack.
+ *
+ * @example
+ * ```ts
+ * const added: Result<Record<string, unknown>> = await plugin_addDescriptor(text, ['host']);
+ * ```
+ */
+async function plugin_addDescriptor(descriptor, computeNames, creds) {
+    const token = await adminToken_get(creds);
+    return (0, cumin_1.pluginAdmin_upload)({ descriptor }, computeNames, token);
+}
+/**
+ * Registers one descriptor file's plugin: `plugin add --json`.
+ *
+ * @param text - The descriptor's JSON text.
+ * @param options - Compute resources and credentials.
+ * @param note - Where progress lines go.
+ * @returns What the add did.
+ *
+ * @example
+ * ```ts
+ * const result: PluginAddResult = await plugin_addJson(readFileSync('pl-x.json', 'utf8'), {}, console.log);
+ * ```
+ */
+async function plugin_addJson(text, options, note) {
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch (error) {
+        return addFailure_record(`the descriptor is not JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const record = data !== null && typeof data === 'object' && !Array.isArray(data) ? data : {};
+    const name = typeof record['name'] === 'string' ? record['name'] : undefined;
+    const version = typeof record['version'] === 'string' ? record['version'] : undefined;
+    if (name === undefined || version === undefined)
+        return addFailure_record('the descriptor names no plugin name and version');
+    const computes = await computeNames_resolve(options.compute);
+    if (!computes.ok)
+        return { outcome: 'failed', name, version };
+    if (await pluginVersion_isRegistered(name, version))
+        return { outcome: 'already_exists', name, version };
+    note(`Registering ${name} ${version} on ${computes.value.join(', ')}…`);
+    const added = await plugin_addDescriptor(text, computes.value, creds_build(options));
+    return added.ok ? { outcome: 'installed', name, version } : { outcome: 'failed', name, version };
+}
+/**
+ * Registers a plugin named by a URL, an image or a name: `plugin add`.
+ *
+ * @param input - The URL, image reference or plugin name.
+ * @param options - Compute resources, peer store and credentials.
+ * @param note - Where progress lines go.
+ * @param run - The docker seam, for the image path.
+ * @returns What the add did.
+ *
+ * @example
+ * ```ts
+ * const result: PluginAddResult = await plugin_add('fnndsc/pl-dircopy:2.1.1', {}, console.log);
+ * ```
+ */
+async function plugin_add(input, options, note, run = plugin_docker_js_1.docker_run) {
+    const detected = pluginInput_detect(input);
+    const computes = await computeNames_resolve(options.compute);
+    if (!computes.ok)
+        return { outcome: 'failed' };
+    if (detected.kind === 'url') {
+        note(`Asking CUBE to register the plugin at ${detected.value}…`);
+        const token = await adminToken_get(creds_build(options));
+        const added = await (0, cumin_1.pluginAdmin_upload)({ storeUrl: detected.value }, computes.value, token);
+        if (!added.ok)
+            return { outcome: 'failed' };
+        return pluginRegistered_result(added.value);
+    }
+    const existing = await (0, plugin_register_js_1.plugin_checkExists)(detected.kind === 'image' ? detected.value : detected.name);
+    if (existing !== null && (detected.version === undefined || existing['version'] === detected.version)) {
+        return { outcome: 'already_exists', name: detected.name, ...(detected.version === undefined ? {} : { version: detected.version }) };
+    }
+    note(`Searching the peer store for ${detected.name}…`);
+    const peerStores = options.store === undefined ? undefined : [options.store];
+    const found = await (0, peer_search_js_1.plugins_searchPeers)(detected.name, detected.version, peerStores);
+    if (found !== null) {
+        note(`Found in ${found.storeName}; importing.`);
+        const imported = await (0, store_import_js_1.plugin_importFromStore)('', found.plugin, computes.value, creds_build(options));
+        if (imported.success)
+            return pluginRegistered_result(imported.plugin ?? {});
+        return addFailure_record(imported.errorMessage ?? 'the peer store import failed', detected);
+    }
+    const image = detected.kind === 'image' ? detected.value : `${detected.name}:latest`;
+    note(`Not in the peer store; reading the descriptor out of ${image}.`);
+    return pluginFromImage_add(image, computes.value, options, run);
+}
+/**
+ * Registers a plugin from its image's own descriptor.
+ *
+ * @param image - The image reference.
+ * @param computeNames - Compute resources to register it on.
+ * @param options - Credentials and the repository to fill in.
+ * @param run - The docker seam.
+ * @returns What the add did.
+ */
+async function pluginFromImage_add(image, computeNames, options, run) {
+    if (!await (0, plugin_docker_js_1.docker_isAvailable)(run))
+        return addFailure_record('docker is not installed or not running on this host');
+    const missing = await (0, plugin_docker_js_1.dockerImage_ensure)(image, run);
+    if (missing !== null)
+        return addFailure_record(missing);
+    const descriptor = await (0, plugin_docker_js_1.descriptorFromImage_extract)(image, options.publicRepo, run);
+    if (descriptor === null)
+        return addFailure_record(`${image} printed no plugin descriptor (is it a ChRIS plugin?)`);
+    descriptorGaps_fill(descriptor, image, options.publicRepo);
+    const added = await plugin_addDescriptor(JSON.stringify(descriptor), computeNames, creds_build(options));
+    if (!added.ok)
+        return { outcome: 'failed', name: String(descriptor['name']) };
+    return pluginRegistered_result(added.value);
+}
+/**
+ * Fills what an image's descriptor may leave out: its name, image and repository.
+ *
+ * @param descriptor - The descriptor, changed in place.
+ * @param image - The image it came from.
+ * @param publicRepo - The repository the operator named, when any.
+ */
+function descriptorGaps_fill(descriptor, image, publicRepo) {
+    if (typeof descriptor['name'] !== 'string' || descriptor['name'] === '')
+        descriptor['name'] = pluginInput_detect(image).name;
+    if (typeof descriptor['dock_image'] !== 'string' || descriptor['dock_image'] === '')
+        descriptor['dock_image'] = image;
+    if (typeof descriptor['public_repo'] !== 'string' || descriptor['public_repo'] === '') {
+        if (publicRepo !== undefined)
+            descriptor['public_repo'] = publicRepo;
+    }
+}
+/**
+ * Reports whether a name and version are registered in the connected CUBE.
+ *
+ * @param name - The plugin name.
+ * @param version - The version.
+ * @returns True when CUBE holds that version.
+ */
+async function pluginVersion_isRegistered(name, version) {
+    const client = await cumin_1.chrisConnection.client_get();
+    if (client === null)
+        return false;
+    try {
+        return (await (0, cumin_1.plugin_find)(client, name, version)) !== null;
+    }
+    catch {
+        // A failed read is not "registered": the upload that follows answers
+        // with CUBE's own refusal if the version is there after all.
+        return false;
+    }
+}
+/**
+ * Builds the result of a registration from CUBE's answer.
+ *
+ * @param plugin - The registered plugin's fields.
+ * @returns An installed result naming it.
+ */
+function pluginRegistered_result(plugin) {
+    const name = plugin['name'];
+    const version = plugin['version'];
+    return {
+        outcome: 'installed',
+        ...(typeof name === 'string' ? { name } : {}),
+        ...(typeof version === 'string' ? { version } : {}),
+    };
+}
+/**
+ * Records a failure on the error stack and as a result.
+ *
+ * @param reason - Why the add failed.
+ * @param input - The input, for the plugin's name.
+ * @returns A failed result carrying the reason.
+ */
+function addFailure_record(reason, input) {
+    cumin_1.errorStack.stack_push('error', reason);
+    return { outcome: 'failed', reason, ...(input === undefined ? {} : { name: input.name }) };
+}
+/**
+ * Builds administrator credentials from the options, when both halves are given.
+ *
+ * @param options - The add options.
+ * @returns The credentials, or undefined to upload as the session.
+ */
+function creds_build(options) {
+    return options.adminUser && options.adminPassword ? { username: options.adminUser, password: options.adminPassword } : undefined;
+}
+/**
+ * Gets an administrator token for credentials.
+ *
+ * @param creds - The credentials; none means the session uploads.
+ * @returns The token, or undefined when there are no credentials or the login failed (a warning says so).
+ */
+async function adminToken_get(creds) {
+    if (creds?.username === undefined || creds.password === undefined)
+        return undefined;
+    const url = await cumin_1.chrisConnection.chrisURL_get();
+    if (!url)
+        return undefined;
+    try {
+        return await cumin_1.Client.getAuthToken(`${url.endsWith('/') ? url : `${url}/`}auth-token/`, creds.username, creds.password);
+    }
+    catch (error) {
+        cumin_1.errorStack.stack_push('warning', `Failed to get admin token: ${error instanceof Error ? error.message : String(error)}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=plugin_add.js.map

package/dist/plugins/plugin_add.js.map

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

package/dist/plugins/plugin_docker.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @file Reading a plugin's descriptor out of its container image.
+ *
+ * The last way `plugin add` finds a descriptor: pull the image (or use the
+ * local copy) and ask it, trying the three ways ChRIS plugins have printed
+ * one over the years, in chrisomatic's order — `chris_plugin_info` with the
+ * image named, `chris_plugin_info` bare, and the old chrisapp `<CMD> --json`.
+ *
+ * Every docker call is an argument vector run without a shell: an image
+ * reference is operator input and never reaches a command line as text.
+ *
+ * Key components:
+ * - DockerRun: the seam that runs one docker command (tests stub it).
+ * - docker_isAvailable: whether a docker daemon answers.
+ * - dockerImage_ensure: the image locally, pulled when absent.
+ * - descriptorFromImage_extract: the image's descriptor JSON, by the three ways.
+ *
+ * Typical usage:
+ * ```ts
+ * if (await docker_isAvailable() && await dockerImage_ensure(image)) {
+ *   const descriptor: Record<string, unknown> | null = await descriptorFromImage_extract(image);
+ * }
+ * ```
+ *
+ * Dependencies: Node.js `child_process`; a `docker` CLI on the host.
+ *
+ * @module
+ */
+/** What one docker command answered. */
+export interface DockerAnswer {
+    /** True when the command exited zero. */
+    readonly ok: boolean;
+    /** Its standard output, trimmed. */
+    readonly stdout: string;
+    /** Its standard error or failure message, trimmed. */
+    readonly stderr: string;
+}
+/** Runs one docker command from its argument vector. */
+export type DockerRun = (args: readonly string[]) => Promise<DockerAnswer>;
+/**
+ * Runs `docker` with an argument vector, no shell.
+ *
+ * @param args - The arguments after `docker`.
+ * @returns What it answered; never throws.
+ *
+ * @example
+ * ```ts
+ * const answer: DockerAnswer = await docker_run(['image', 'inspect', 'alpine']);
+ * ```
+ */
+export declare const docker_run: DockerRun;
+/**
+ * Reports whether a docker daemon answers.
+ *
+ * @param run - The docker seam.
+ * @returns True when `docker info` succeeds.
+ *
+ * @example
+ * ```ts
+ * await docker_isAvailable(); // false on a host without docker
+ * ```
+ */
+export declare function docker_isAvailable(run?: DockerRun): Promise<boolean>;
+/**
+ * Makes sure an image is present locally, pulling it when it is not.
+ *
+ * @param image - The image reference.
+ * @param run - The docker seam.
+ * @returns Null when the image is present; else why it could not be had.
+ *
+ * @example
+ * ```ts
+ * await dockerImage_ensure('fnndsc/pl-dircopy:2.1.1'); // null
+ * ```
+ */
+export declare function dockerImage_ensure(image: string, run?: DockerRun): Promise<string | null>;
+/**
+ * Reads a plugin's descriptor out of its image.
+ *
+ * @param image - The image reference.
+ * @param publicRepo - The plugin's repository, passed to `chris_plugin_info` when known.
+ * @param run - The docker seam.
+ * @returns The descriptor, or null when none of the three ways printed one.
+ *
+ * @example
+ * ```ts
+ * const descriptor: Record<string, unknown> | null = await descriptorFromImage_extract('fnndsc/pl-dircopy:2.1.1');
+ * ```
+ */
+export declare function descriptorFromImage_extract(image: string, publicRepo?: string, run?: DockerRun): Promise<Record<string, unknown> | null>;