@fnndsc/salsa 3.5.1 → 3.6.1

package/dist/pipelines/index.js

@@ -11,18 +11,44 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pipelineDiagram_get = void 0;
+exports.pipelineInvocation_prepare = exports.pipelineManifest_get = exports.pipelineDiagram_get = void 0;
 exports.pipelines_list = pipelines_list;
 exports.pipelines_listAll = pipelines_listAll;
 exports.pipelineFields_get = pipelineFields_get;
 exports.pipelines_getAll = pipelines_getAll;
+exports.pipelineManifestBySlug_get = pipelineManifestBySlug_get;
 exports.pipeline_run = pipeline_run;
 exports.pipeline_sourceGet = pipeline_sourceGet;
 exports.pipeline_getContent = pipeline_getContent;
 const cumin_1 = require("@fnndsc/cumin");
 var diagram_js_1 = require("./diagram.js");
 Object.defineProperty(exports, "pipelineDiagram_get", { enumerable: true, get: function () { return diagram_js_1.pipelineDiagram_get; } });
+var manifest_js_1 = require("./manifest.js");
+Object.defineProperty(exports, "pipelineManifest_get", { enumerable: true, get: function () { return manifest_js_1.pipelineManifest_get; } });
+var invocation_js_1 = require("./invocation.js");
+Object.defineProperty(exports, "pipelineInvocation_prepare", { enumerable: true, get: function () { return invocation_js_1.pipelineInvocation_prepare; } });
 const axios_1 = __importDefault(require("axios"));
+const manifest_js_2 = require("./manifest.js");
+const invocation_js_2 = require("./invocation.js");
+const PIPELINE_SLUG_TTL_MS = 5 * 60 * 1000;
+const pipelineSlugCaches = new WeakMap();
+function pipelineSlugCache_get(client) {
+    let cache = pipelineSlugCaches.get(client);
+    if (cache === undefined) {
+        cache = new Map();
+        pipelineSlugCaches.set(client, cache);
+    }
+    return cache;
+}
+function pipelineSlug_create(pipeline, sourceFilename) {
+    const sourceBase = sourceFilename
+        ?.split('/').pop()?.replace(/\.(ya?ml)$/i, '');
+    const generatedBase = pipeline.name
+        .replace(/[^a-zA-Z0-9]/g, '_')
+        .replace(/_+/g, '_')
+        .replace(/^_|_$/g, '');
+    return `${sourceBase ?? generatedBase}_id${pipeline.id}`;
+}
 /**
  * Lists registered pipelines, optionally filtered by name substring.
  * Returns FilteredResourceData for table rendering compatibility.
@@ -69,75 +95,111 @@ async function pipelines_getAll() {
         cumin_1.errorStack.stack_push('error', 'Not connected to ChRIS');
         return (0, cumin_1.Err)();
     }
-    const [pipelinesResult, sourceFilesResponse] = await Promise.all([
+    const [pipelinesResult, sourceFilesPage] = await Promise.all([
         (0, cumin_1.pipelines_list)(),
-        client.getPipelineSourceFiles({ limit: 1000 }).catch(() => null),
+        (0, cumin_1.pipelineSourceFilesPage_get)(client, { limit: 1000 })
+            .catch(() => null),
     ]);
     if (!pipelinesResult.ok)
         return (0, cumin_1.Err)();
-    const idToSlug = new Map();
-    if (sourceFilesResponse) {
-        for (const item of sourceFilesResponse.getItems()) {
-            const { fname, pipeline_id } = item.data;
+    const idToSourceFilename = new Map();
+    if (sourceFilesPage) {
+        for (const row of sourceFilesPage.data) {
+            const { fname, pipeline_id } = row;
             if (pipeline_id && fname) {
-                const base = fname.split('/').pop() ?? '';
-                const slug = base.replace(/\.(ya?ml)$/i, '');
-                idToSlug.set(pipeline_id, slug);
+                idToSourceFilename.set(pipeline_id, fname);
             }
         }
     }
-    const records = pipelinesResult.value.map((pipeline) => {
-        const sourceSlug = idToSlug.get(pipeline.id);
-        const generatedSlug = pipeline.name
-            .replace(/[^a-zA-Z0-9]/g, '_')
-            .replace(/_+/g, '_')
-            .replace(/^_|_$/g, '');
-        const base = sourceSlug ?? generatedSlug;
-        return {
-            ...pipeline,
-            slug: `${base}_id${pipeline.id}`,
-        };
-    });
+    const records = pipelinesResult.value.map((pipeline) => ({
+        ...pipeline,
+        slug: pipelineSlug_create(pipeline, idToSourceFilename.get(pipeline.id)),
+    }));
     return (0, cumin_1.Ok)(records);
 }
 /**
- * Runs a pipeline by name or ID, attaching it to a previous plugin instance.
+ * Project one exact Pipeline executable slug without listing every Pipeline.
  *
- * @param nameOrId - Pipeline name or numeric ID string.
- * @param previousPluginInstId - The plugin instance to attach the pipeline root to.
- * @param computeOverride - Optional compute resource name applied to all nodes.
- * @returns Result containing workflow ID and created plugin instance IDs.
+ * The stable `_id<N>` suffix identifies the candidate Pipeline. The targeted
+ * source-file lookup then verifies the complete slug before it is accepted.
+ *
+ * @param slug - Exact Pipeline basename exposed in `/bin`.
+ * @returns The registered invocation manifest for the exact Pipeline slug.
  */
-async function pipeline_run(nameOrId, previousPluginInstId, computeOverride) {
-    const pipelineResult = await (0, cumin_1.pipeline_resolve)(nameOrId);
-    if (!pipelineResult.ok)
+async function pipelineManifestBySlug_get(slug) {
+    const match = slug.match(/_id(\d+)$/);
+    if (match === null)
         return (0, cumin_1.Err)();
-    const pipeline = pipelineResult.value;
-    const options = { previousPluginInstId };
-    if (computeOverride) {
-        const client = await cumin_1.chrisConnection.client_get();
-        if (!client) {
-            cumin_1.errorStack.stack_push('error', 'Not connected to ChRIS');
+    const pipelineID = Number(match[1]);
+    const client = await cumin_1.chrisConnection.client_get();
+    if (!client) {
+        cumin_1.errorStack.stack_push('error', 'Not connected to ChRIS');
+        return (0, cumin_1.Err)();
+    }
+    const cache = pipelineSlugCache_get(client);
+    const cached = cache.get(slug);
+    if (cached !== undefined && cached.expiresAt > Date.now()) {
+        return (0, manifest_js_2.pipelineManifestForPipeline_get)(cached.record, cached.resource, { detail: 'registered' });
+    }
+    if (cached !== undefined)
+        cache.delete(slug);
+    try {
+        const [pipelineHandle, sourcePage] = await Promise.all([
+            (0, cumin_1.pipeline_get)(client, pipelineID),
+            (0, cumin_1.pipelineSourceFilesPage_get)(client, { pipeline_id: pipelineID, limit: 1000 }),
+        ]);
+        if (pipelineHandle === null || pipelineHandle.data === null)
             return (0, cumin_1.Err)();
-        }
-        try {
-            const pipelineObj = await client.getPipeline(pipeline.id);
-            if (pipelineObj) {
-                const pipingsResponse = await pipelineObj.getPluginPipings({ limit: 1000 });
-                const pipings = pipingsResponse.getItems();
-                options.nodeOverrides = pipings.map((p) => ({
-                    piping_id: p.data.id,
-                    compute_resource_name: computeOverride,
-                }));
-            }
-        }
-        catch (error) {
-            const msg = error instanceof Error ? error.message : String(error);
-            cumin_1.errorStack.stack_push('error', `pipeline_run: compute override failed: ${msg}`);
+        const pipeline = pipelineHandle.data;
+        const sourceRows = sourcePage.data;
+        const source = sourceRows.find((row) => row.pipeline_id === pipelineID)
+            ?? sourceRows.find((row) => row.pipeline_name === pipeline.name)
+            ?? (sourceRows.length === 1 ? sourceRows[0] : undefined);
+        const exactSlug = pipelineSlug_create(pipeline, source?.fname);
+        if (exactSlug !== slug)
             return (0, cumin_1.Err)();
-        }
+        const record = { ...pipeline, slug: exactSlug };
+        cache.set(slug, {
+            record,
+            resource: pipelineHandle,
+            expiresAt: Date.now() + PIPELINE_SLUG_TTL_MS,
+        });
+        return (0, manifest_js_2.pipelineManifestForPipeline_get)(record, pipelineHandle, { detail: 'registered' });
     }
-    return (0, cumin_1.pipeline_createWorkflow)(pipeline.id, options);
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        cumin_1.errorStack.stack_push('error', `pipelineManifestBySlug_get: ${message}`);
+        return (0, cumin_1.Err)();
+    }
+}
+/**
+ * Run a pipeline by name or ID, attaching it to a previous plugin instance.
+ *
+ * @param nameOrId - Pipeline name or numeric ID string.
+ * @param previousPluginInstId - Plugin instance to which pipeline roots attach.
+ * @param invocationOptions - Runtime overlays, or the legacy global compute string.
+ * @returns Result containing Workflow ID and created plugin instance IDs.
+ */
+async function pipeline_run(nameOrId, previousPluginInstId, invocationOptions = {}) {
+    const normalized = typeof invocationOptions === 'string'
+        ? { globalCompute: invocationOptions }
+        : invocationOptions;
+    const manifestResult = await (0, manifest_js_2.pipelineManifest_get)(nameOrId);
+    if (!manifestResult.ok)
+        return (0, cumin_1.Err)();
+    const prepared = (0, invocation_js_2.pipelineInvocation_prepare)({
+        manifest: manifestResult.value,
+        globalCompute: normalized.globalCompute,
+        parameterFile: normalized.parameterFile,
+        cliBindings: normalized.cliBindings,
+    });
+    if (!prepared.ok)
+        return (0, cumin_1.Err)();
+    const options = {
+        previousPluginInstId,
+        nodeOverrides: prepared.value.nodeOverrides,
+    };
+    return (0, cumin_1.pipeline_createWorkflow)(prepared.value.pipelineID, options);
 }
 /**
  * Fetches the YAML source of a registered pipeline by searching /PIPELINES/ for
@@ -157,13 +219,12 @@ async function pipeline_sourceGet(nameOrId) {
         return (0, cumin_1.Err)();
     }
     try {
-        const sourceFiles = await client.getPipelineSourceFiles({ pipeline_id: pipeline.id, limit: 1 });
-        const items = sourceFiles.getItems();
-        if (items.length === 0) {
+        const sourcePage = await (0, cumin_1.pipelineSourceFilesPage_get)(client, { pipeline_id: pipeline.id, limit: 1 });
+        if (sourcePage.data.length === 0) {
             cumin_1.errorStack.stack_push('error', `No source file registered for pipeline '${pipeline.name}' (id=${pipeline.id})`);
             return (0, cumin_1.Err)();
         }
-        return (0, cumin_1.pipelineFile_getTextByPath)('/' + items[0].data.fname);
+        return (0, cumin_1.pipelineFile_getTextByPath)('/' + sourcePage.data[0].fname);
     }
     catch (error) {
         const msg = error instanceof Error ? error.message : String(error);

package/dist/pipelines/index.js.map

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

package/dist/pipelines/invocation.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @file Pure preparation of one registered Pipeline Workflow invocation.
+ *
+ * This module validates sparse or complete YAML overlays, applies global/file/CLI
+ * precedence, and produces the complete `nodes_info` payload CUBE expects. It
+ * assumes the manifest has already been fetched from the authenticated CUBE.
+ *
+ * @module
+ */
+import { Result } from '@fnndsc/cumin';
+import type { PipelineManifest } from './manifest.js';
+/** Hosted plugin parameter schema used to validate one runtime binding. */
+export interface PipelineParameterDefinition {
+    /** Hosted parameter name. */
+    name: string;
+    /** CUBE parameter type. */
+    type: string;
+    /** Whether the hosted plugin permits omission. */
+    optional: boolean;
+    /** Plugin-declared default. */
+    default?: unknown;
+    /** Plugin-declared help text. */
+    help?: string;
+}
+/** Surface-neutral binding of one value to one pipeline node field. */
+export interface PipelineInvocationBinding {
+    /** Unique node title or exact `@<piping-id>` selector. */
+    node: string;
+    /** Hosted parameter name or reserved execution-control name. */
+    field: string;
+    /** Typed runtime value. */
+    value: unknown;
+}
+/** Complete CUBE `nodes_info` entry for one plugin piping. */
+export interface PreparedWorkflowNode {
+    /** CUBE plugin piping ID. */
+    piping_id: number;
+    /** Authored node title. */
+    title: string;
+    /** Effective compute placement. */
+    compute_resource_name: string;
+    /** Effective CPU limit. */
+    cpu_limit?: unknown;
+    /** Effective memory limit. */
+    memory_limit?: unknown;
+    /** Effective GPU limit. */
+    gpu_limit?: unknown;
+    /** Effective worker count. */
+    number_of_workers?: unknown;
+    /** Complete registered parameter values plus runtime overrides. */
+    plugin_parameter_defaults: Array<{
+        name: string;
+        default: unknown;
+    }>;
+}
+/** Fully resolved Pipeline Workflow creation input. */
+export interface PreparedPipelineInvocation {
+    /** Registered Pipeline ID. */
+    pipelineID: number;
+    /** Complete merged Workflow node override set. */
+    nodeOverrides: PreparedWorkflowNode[];
+}
+/** Inputs accepted by pure pipeline invocation preparation. */
+export interface PipelineInvocationPrepareOptions {
+    /** Selected registered Pipeline manifest. */
+    manifest: PipelineManifest;
+    /** Baseline compute placement for every piping. */
+    globalCompute?: string;
+    /** Parsed CFS YAML overlay. */
+    parameterFile?: unknown;
+    /** Explicit node-qualified command or GUI bindings. */
+    cliBindings?: PipelineInvocationBinding[];
+}
+/**
+ * Build the complete `nodes_info` override set for one Workflow invocation.
+ *
+ * @param options - Registered manifest and optional global, file, and CLI overlays.
+ * @returns Prepared invocation, or an error after strict validation fails.
+ */
+export declare function pipelineInvocation_prepare(options: PipelineInvocationPrepareOptions): Result<PreparedPipelineInvocation>;

package/dist/pipelines/invocation.js

@@ -0,0 +1,290 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pipelineInvocation_prepare = pipelineInvocation_prepare;
+/**
+ * @file Pure preparation of one registered Pipeline Workflow invocation.
+ *
+ * This module validates sparse or complete YAML overlays, applies global/file/CLI
+ * precedence, and produces the complete `nodes_info` payload CUBE expects. It
+ * assumes the manifest has already been fetched from the authenticated CUBE.
+ *
+ * @module
+ */
+const cumin_1 = require("@fnndsc/cumin");
+const EXECUTION_FIELDS = new Set([
+    'compute_resource_name',
+    'cpu_limit',
+    'memory_limit',
+    'gpu_limit',
+    'number_of_workers',
+]);
+const DOCUMENT_FIELDS = new Set(['name', 'pipeline_id', 'plugin_tree']);
+const PLUGIN_TREE_FIELDS = new Set(['root_index', 'tree']);
+const NODE_FIELDS = new Set([
+    'piping_id', 'title', 'plugin_name', 'plugin_version',
+    'compute_resource_name', 'cpu_limit', 'memory_limit', 'gpu_limit', 'number_of_workers',
+    'plugin_parameter_defaults', 'child_indices',
+]);
+const PARAMETER_FIELDS = new Set(['name', 'default']);
+function record_is(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function fields_validate(record, allowed, location) {
+    const unknown = Object.keys(record).find((field) => !allowed.has(field));
+    if (unknown === undefined)
+        return true;
+    cumin_1.errorStack.stack_push('error', `Unknown ${location} field '${unknown}'.`);
+    return false;
+}
+function node_resolve(nodes, selector) {
+    if (selector.startsWith('@') && /^@\d+$/.test(selector)) {
+        const pipingID = Number(selector.slice(1));
+        return nodes.find((node) => node.pipingID === pipingID) ?? null;
+    }
+    const matches = nodes.filter((node) => node.title === selector);
+    return matches.length === 1 ? matches[0] : null;
+}
+function executionField_set(node, field, value) {
+    if (field === 'compute_resource_name')
+        node.compute_resource_name = String(value);
+    else if (field === 'cpu_limit')
+        node.cpu_limit = value;
+    else if (field === 'memory_limit')
+        node.memory_limit = value;
+    else if (field === 'gpu_limit')
+        node.gpu_limit = value;
+    else if (field === 'number_of_workers')
+        node.number_of_workers = value;
+}
+function executionValue_isValid(field, value) {
+    if (field === 'compute_resource_name')
+        return typeof value === 'string' && value.trim().length > 0;
+    if (field === 'gpu_limit' || field === 'number_of_workers') {
+        return typeof value === 'number' && Number.isInteger(value) && value >= 0;
+    }
+    return (typeof value === 'number' && Number.isFinite(value) && value >= 0) ||
+        (typeof value === 'string' && value.trim().length > 0);
+}
+function parameter_set(node, name, value) {
+    const current = node.plugin_parameter_defaults
+        .find((parameter) => parameter.name === name);
+    if (current)
+        current.default = value;
+    else
+        node.plugin_parameter_defaults.push({ name, default: value });
+}
+function parameter_known(node, name) {
+    if (node.parameterDefinitions !== undefined) {
+        return node.parameterDefinitions.some((parameter) => parameter.name === name);
+    }
+    return node.parameterDefaults.some((parameter) => parameter.name === name);
+}
+function parameter_valueValid(node, name, value) {
+    const definition = node.parameterDefinitions
+        ?.find((parameter) => parameter.name === name);
+    if (!definition || value === null || value === undefined)
+        return true;
+    const type = definition.type.toLowerCase();
+    if (type === 'integer' || type === 'int')
+        return typeof value === 'number' && Number.isInteger(value);
+    if (type === 'float' || type === 'number')
+        return typeof value === 'number' && Number.isFinite(value);
+    if (type === 'boolean' || type === 'bool')
+        return typeof value === 'boolean';
+    if (type === 'str' || type === 'string' || type === 'path' || type === 'unextpath') {
+        return typeof value === 'string';
+    }
+    return false;
+}
+/**
+ * Build the complete `nodes_info` override set for one Workflow invocation.
+ *
+ * @param options - Registered manifest and optional global, file, and CLI overlays.
+ * @returns Prepared invocation, or an error after strict validation fails.
+ */
+function pipelineInvocation_prepare(options) {
+    const manifest = options.manifest;
+    const nodes = manifest.nodes;
+    const preparedByID = new Map();
+    for (const node of nodes) {
+        preparedByID.set(node.pipingID, {
+            piping_id: node.pipingID,
+            title: node.title,
+            compute_resource_name: options.globalCompute ?? node.computeResourceName,
+            cpu_limit: node.cpuLimit,
+            memory_limit: node.memoryLimit,
+            gpu_limit: node.gpuLimit,
+            number_of_workers: node.numberOfWorkers,
+            plugin_parameter_defaults: node.parameterDefaults.map((parameter) => ({
+                name: parameter.name,
+                default: parameter.value,
+            })),
+        });
+    }
+    if (options.parameterFile !== undefined) {
+        if (!record_is(options.parameterFile)) {
+            cumin_1.errorStack.stack_push('error', 'Parameter file must contain a YAML mapping.');
+            return (0, cumin_1.Err)();
+        }
+        const document = options.parameterFile;
+        if (!fields_validate(document, DOCUMENT_FIELDS, 'parameter-file'))
+            return (0, cumin_1.Err)();
+        if (document.name !== undefined && document.name !== manifest.name) {
+            cumin_1.errorStack.stack_push('error', `Parameter file names pipeline '${String(document.name)}', not '${manifest.name}'.`);
+            return (0, cumin_1.Err)();
+        }
+        if (document.pipeline_id !== undefined && document.pipeline_id !== manifest.pipelineID) {
+            cumin_1.errorStack.stack_push('error', `Parameter file pipeline_id ${String(document.pipeline_id)} does not match ${manifest.pipelineID}.`);
+            return (0, cumin_1.Err)();
+        }
+        const pluginTree = document.plugin_tree;
+        if (record_is(pluginTree) && !fields_validate(pluginTree, PLUGIN_TREE_FIELDS, 'plugin_tree'))
+            return (0, cumin_1.Err)();
+        if (record_is(pluginTree) && pluginTree.root_index !== undefined) {
+            const expectedRootIndex = manifest.nodes.findIndex((node) => node.pipingID === manifest.rootIDs[0]);
+            if (pluginTree.root_index !== expectedRootIndex) {
+                cumin_1.errorStack.stack_push('error', 'Parameter-file root_index does not match the registered pipeline.');
+                return (0, cumin_1.Err)();
+            }
+        }
+        const tree = record_is(pluginTree) ? pluginTree.tree : undefined;
+        if (!Array.isArray(tree)) {
+            cumin_1.errorStack.stack_push('error', 'Parameter file must contain plugin_tree.tree.');
+            return (0, cumin_1.Err)();
+        }
+        const fileBindingsSeen = new Set();
+        for (const rawNode of tree) {
+            if (!record_is(rawNode)) {
+                cumin_1.errorStack.stack_push('error', 'Each parameter-file node must be a mapping.');
+                return (0, cumin_1.Err)();
+            }
+            if (!fields_validate(rawNode, NODE_FIELDS, 'pipeline node'))
+                return (0, cumin_1.Err)();
+            const selector = rawNode.piping_id !== undefined
+                ? `@${String(rawNode.piping_id)}`
+                : String(rawNode.title ?? '');
+            const source = node_resolve(nodes, selector);
+            if (!source) {
+                cumin_1.errorStack.stack_push('error', `Unknown or ambiguous pipeline node '${selector}'.`);
+                return (0, cumin_1.Err)();
+            }
+            if (rawNode.title !== undefined && rawNode.title !== source.title) {
+                cumin_1.errorStack.stack_push('error', `Node title assertion does not match piping ${source.pipingID}.`);
+                return (0, cumin_1.Err)();
+            }
+            if (rawNode.plugin_name !== undefined && rawNode.plugin_name !== source.pluginName) {
+                cumin_1.errorStack.stack_push('error', `Plugin assertion does not match node '${source.title}'.`);
+                return (0, cumin_1.Err)();
+            }
+            if (rawNode.plugin_version !== undefined && rawNode.plugin_version !== source.pluginVersion) {
+                cumin_1.errorStack.stack_push('error', `Plugin version assertion does not match node '${source.title}'.`);
+                return (0, cumin_1.Err)();
+            }
+            if (rawNode.child_indices !== undefined) {
+                if (!Array.isArray(rawNode.child_indices))
+                    return (0, cumin_1.Err)();
+                const expectedChildren = manifest.nodes
+                    .map((candidate, index) => [candidate, index])
+                    .filter(([candidate]) => candidate.parentID === source.pipingID)
+                    .map(([, index]) => index);
+                const supplied = rawNode.child_indices;
+                if (supplied.length !== expectedChildren.length || supplied.some((value, index) => value !== expectedChildren[index])) {
+                    cumin_1.errorStack.stack_push('error', `child_indices assertion does not match node '${source.title}'.`);
+                    return (0, cumin_1.Err)();
+                }
+            }
+            const prepared = preparedByID.get(source.pipingID);
+            for (const field of EXECUTION_FIELDS) {
+                if (rawNode[field] !== undefined) {
+                    if (!executionValue_isValid(field, rawNode[field])) {
+                        cumin_1.errorStack.stack_push('error', `Invalid ${field} value on node '${source.title}'.`);
+                        return (0, cumin_1.Err)();
+                    }
+                    const bindingKey = `${source.pipingID}.${field}`;
+                    if (fileBindingsSeen.has(bindingKey)) {
+                        cumin_1.errorStack.stack_push('error', `Duplicate parameter-file binding '${source.title}.${field}'.`);
+                        return (0, cumin_1.Err)();
+                    }
+                    fileBindingsSeen.add(bindingKey);
+                    executionField_set(prepared, field, rawNode[field]);
+                }
+            }
+            const defaults = rawNode.plugin_parameter_defaults;
+            if (defaults !== undefined) {
+                if (!Array.isArray(defaults))
+                    return (0, cumin_1.Err)();
+                for (const rawParameter of defaults) {
+                    if (!record_is(rawParameter) || typeof rawParameter.name !== 'string')
+                        return (0, cumin_1.Err)();
+                    if (!fields_validate(rawParameter, PARAMETER_FIELDS, 'parameter'))
+                        return (0, cumin_1.Err)();
+                    if (rawParameter.name === 'plugininstances') {
+                        const registered = source.parameterDefaults.find((parameter) => parameter.name === 'plugininstances');
+                        if (!registered || rawParameter.default !== registered.value) {
+                            cumin_1.errorStack.stack_push('error', 'plugininstances encodes pipeline topology and cannot be overridden.');
+                            return (0, cumin_1.Err)();
+                        }
+                        continue;
+                    }
+                    if (!parameter_known(source, rawParameter.name)) {
+                        cumin_1.errorStack.stack_push('error', `Unknown parameter '${rawParameter.name}' on node '${source.title}'.`);
+                        return (0, cumin_1.Err)();
+                    }
+                    if (!parameter_valueValid(source, rawParameter.name, rawParameter.default)) {
+                        cumin_1.errorStack.stack_push('error', `Invalid ${rawParameter.name} value on node '${source.title}'.`);
+                        return (0, cumin_1.Err)();
+                    }
+                    const bindingKey = `${source.pipingID}.${rawParameter.name}`;
+                    if (fileBindingsSeen.has(bindingKey)) {
+                        cumin_1.errorStack.stack_push('error', `Duplicate parameter-file binding '${source.title}.${rawParameter.name}'.`);
+                        return (0, cumin_1.Err)();
+                    }
+                    fileBindingsSeen.add(bindingKey);
+                    parameter_set(prepared, rawParameter.name, rawParameter.default);
+                }
+            }
+        }
+    }
+    for (const binding of options.cliBindings ?? []) {
+        const source = node_resolve(nodes, binding.node);
+        if (!source) {
+            cumin_1.errorStack.stack_push('error', `Unknown or ambiguous pipeline node '${binding.node}'.`);
+            return (0, cumin_1.Err)();
+        }
+        const prepared = preparedByID.get(source.pipingID);
+        if (EXECUTION_FIELDS.has(binding.field)) {
+            if (!executionValue_isValid(binding.field, binding.value)) {
+                cumin_1.errorStack.stack_push('error', `Invalid ${binding.field} value on node '${source.title}'.`);
+                return (0, cumin_1.Err)();
+            }
+            executionField_set(prepared, binding.field, binding.value);
+        }
+        else {
+            if (binding.field === 'plugininstances') {
+                cumin_1.errorStack.stack_push('error', 'plugininstances encodes pipeline topology and cannot be overridden.');
+                return (0, cumin_1.Err)();
+            }
+            if (!parameter_known(source, binding.field)) {
+                cumin_1.errorStack.stack_push('error', `Unknown parameter '${binding.field}' on node '${source.title}'.`);
+                return (0, cumin_1.Err)();
+            }
+            if (!parameter_valueValid(source, binding.field, binding.value)) {
+                cumin_1.errorStack.stack_push('error', `Invalid ${binding.field} value on node '${source.title}'.`);
+                return (0, cumin_1.Err)();
+            }
+            parameter_set(prepared, binding.field, binding.value);
+        }
+    }
+    let computeInvalid = false;
+    for (const source of nodes) {
+        const effective = preparedByID.get(source.pipingID).compute_resource_name;
+        if (source.computeResources !== undefined && !source.computeResources.includes(effective)) {
+            cumin_1.errorStack.stack_push('error', `Node '${source.title}' (${source.pluginName} v${source.pluginVersion}) is not registered on compute '${effective}'.`);
+            computeInvalid = true;
+        }
+    }
+    if (computeInvalid)
+        return (0, cumin_1.Err)();
+    return (0, cumin_1.Ok)({ pipelineID: manifest.pipelineID, nodeOverrides: [...preparedByID.values()] });
+}
+//# sourceMappingURL=invocation.js.map