@decaf-ts/integrations 0.8.0 → 0.10.0

package/lib/cjs/graph/engine/catalog/GraphBuiltInRegistrations.cjs

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.builtInGraphNodeRegistrations = builtInGraphNodeRegistrations;
+exports.registerBuiltInGraphNodes = registerBuiltInGraphNodes;
+const index_js_1 = require("./../execution/index.cjs");
+const index_js_2 = require("./../loops/index.cjs");
+const graph_1 = require("@decaf-ts/ui-decorators/graph");
+const GraphNodeRegistration_js_1 = require("./GraphNodeRegistration.cjs");
+function executorOf(fn) {
+    return { execute: fn };
+}
+function forwardOutput(outputKey, inputKey = "value") {
+    return executorOf((request) => ({
+        [outputKey]: request.inputs[inputKey] ?? request.inputs,
+    }));
+}
+function triggerPayloadExecutor() {
+    return executorOf((request) => ({ payload: request.inputs["payload"] ?? null }));
+}
+function defaultFlowExecutors() {
+    return {
+        "core.flow.map": executorOf((request) => ({
+            result: { mapped: request.inputs["value"] ?? request.inputs },
+        })),
+        "core.flow.delay": forwardOutput("valueOut"),
+        "core.flow.return": forwardOutput("result"),
+        "core.flow.merge": forwardOutput("merged", "values"),
+        "core.flow.if": forwardOutput("then"),
+        "core.flow.parallel": executorOf((request) => ({
+            branches: [request.inputs["value"] ?? request.inputs],
+        })),
+        "core.flow.errorBoundary": forwardOutput("result"),
+        "core.flow.humanApproval": forwardOutput("approved"),
+        "core.flow.break": new index_js_1.BreakGraphNodeExecutor(),
+        "core.agent": executorOf((request) => ({
+            response: `[Agent response] ${String(request.inputs["prompt"] ?? "")}`,
+            actions: [],
+        })),
+    };
+}
+function defaultTriggerExecutors() {
+    return {
+        "core.trigger.manual": triggerPayloadExecutor(),
+        "core.trigger.webhook": triggerPayloadExecutor(),
+        "core.trigger.schedule": triggerPayloadExecutor(),
+        "core.trigger.event": triggerPayloadExecutor(),
+        "core.trigger.form": triggerPayloadExecutor(),
+        "core.trigger.chat": executorOf((request) => ({
+            message: request.inputs["message"] ?? null,
+            sessionId: request.inputs["sessionId"] ?? null,
+            userId: request.inputs["userId"] ?? null,
+        })),
+    };
+}
+function engineBoundExecutors(engine) {
+    return {
+        "core.flow.code": new index_js_1.CodeGraphNodeExecutor(engine),
+        "core.flow.log": new index_js_1.LogGraphNodeExecutor(),
+        "core.utility.log": new index_js_1.LogGraphNodeExecutor(),
+        "core.flow.switch": new index_js_1.SwitchGraphNodeExecutor(engine),
+        "core.loop.foreach": new index_js_2.ForeachGraphNodeExecutor(engine),
+        "core.loop.while": new index_js_2.WhileGraphNodeExecutor(engine),
+        "core.loop.until": new index_js_2.UntilGraphNodeExecutor(engine),
+    };
+}
+/**
+ * Builds the built-in node registrations (DECAF-50 §4.12): every built-in
+ * manifest from {@link GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND} that has a
+ * default executor, paired with that executor as a
+ * {@link GraphNodeRegistration}. Engine-bound executors (loops, switch) are
+ * only included when an `engine` is provided.
+ */
+function builtInGraphNodeRegistrations(engine) {
+    const executors = {
+        ...defaultTriggerExecutors(),
+        ...defaultFlowExecutors(),
+        ...(engine ? engineBoundExecutors(engine) : {}),
+    };
+    const registrations = [];
+    for (const [kind, manifest] of Object.entries(graph_1.GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND)) {
+        const executor = executors[kind];
+        if (!executor)
+            continue;
+        registrations.push((0, GraphNodeRegistration_js_1.defineGraphNode)({ manifest, executor }));
+    }
+    return registrations;
+}
+/**
+ * Registers all built-in graph nodes (see
+ * {@link builtInGraphNodeRegistrations}) into the given
+ * {@link GraphNodeCatalogue} and returns it for chaining.
+ */
+function registerBuiltInGraphNodes(catalogue, engine) {
+    for (const registration of builtInGraphNodeRegistrations(engine)) {
+        catalogue.register(registration);
+    }
+    return catalogue;
+}
+//# sourceMappingURL=GraphBuiltInRegistrations.js.map
+//# sourceMappingURL=GraphBuiltInRegistrations.cjs.map

package/lib/cjs/graph/engine/catalog/GraphBuiltInRegistrations.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/catalog/GraphBuiltInRegistrations.cjs","sourceRoot":"","sources":["graph/engine/catalog/GraphBuiltInRegistrations.js"],"names":[],"mappings":"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"}

package/lib/cjs/graph/engine/catalog/GraphCatalogueErrors.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphNodeMethodNotFoundError = exports.GraphNodeNotFoundError = exports.GraphNodeRegistrationError = void 0;
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+/** Thrown when a node registration or its manifest fails catalogue validation (e.g. invalid ports, unsafe ids, duplicate kinds). */
+class GraphNodeRegistrationError extends db_decorators_1.InternalError {
+    constructor(msg) {
+        super(msg, GraphNodeRegistrationError.name, 500);
+    }
+}
+exports.GraphNodeRegistrationError = GraphNodeRegistrationError;
+/** Thrown when a node kind is not registered in the backend catalogue. */
+class GraphNodeNotFoundError extends db_decorators_1.NotFoundError {
+    constructor(msg) {
+        super(msg);
+        this.name = GraphNodeNotFoundError.name;
+    }
+}
+exports.GraphNodeNotFoundError = GraphNodeNotFoundError;
+/** Thrown when a declared node method is not registered for a node kind. */
+class GraphNodeMethodNotFoundError extends db_decorators_1.NotFoundError {
+    constructor(msg) {
+        super(msg);
+        this.name = GraphNodeMethodNotFoundError.name;
+    }
+}
+exports.GraphNodeMethodNotFoundError = GraphNodeMethodNotFoundError;
+//# sourceMappingURL=GraphCatalogueErrors.js.map
+//# sourceMappingURL=GraphCatalogueErrors.cjs.map

package/lib/cjs/graph/engine/catalog/GraphCatalogueErrors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/catalog/GraphCatalogueErrors.cjs","sourceRoot":"","sources":["graph/engine/catalog/GraphCatalogueErrors.js"],"names":[],"mappings":";;;AAAA,2DAAuE;AACvE,oIAAoI;AACpI,MAAa,0BAA2B,SAAQ,6BAAa;IACzD,YAAY,GAAG;QACX,KAAK,CAAC,GAAG,EAAE,0BAA0B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;CACJ;AAJD,gEAIC;AACD,0EAA0E;AAC1E,MAAa,sBAAuB,SAAQ,6BAAa;IACrD,YAAY,GAAG;QACX,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;IAC5C,CAAC;CACJ;AALD,wDAKC;AACD,4EAA4E;AAC5E,MAAa,4BAA6B,SAAQ,6BAAa;IAC3D,YAAY,GAAG;QACX,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC;IAClD,CAAC;CACJ;AALD,oEAKC;AACD,gDAAgD"}

package/lib/cjs/graph/engine/catalog/GraphNodeCatalogue.cjs

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphNodeCatalogue = void 0;
+const graph_1 = require("@decaf-ts/ui-decorators/graph");
+const GraphCatalogueErrors_js_1 = require("./GraphCatalogueErrors.cjs");
+const GraphNodeMethodRegistry_js_1 = require("./GraphNodeMethodRegistry.cjs");
+const GraphNodeManifestResolver_js_1 = require("./GraphNodeManifestResolver.cjs");
+const GRAPH_PORT_BINDING_MODES = ["edge", "literal", "expression"];
+function isGraphPortBindingMode(value) {
+    return GRAPH_PORT_BINDING_MODES.includes(value);
+}
+function assertValidPortId(kind, scope, id) {
+    if (typeof id !== "string" || !id) {
+        throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a ${scope} with an empty port id`);
+    }
+    if ((0, graph_1.isGraphUnsafeObjectKey)(id)) {
+        throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a ${scope} with unsafe port id '${id}'`);
+    }
+}
+function validateStaticPorts(kind, manifest) {
+    const buckets = [
+        ["input", manifest.inputs],
+        ["output", manifest.outputs],
+        ["connection", manifest.connections ?? []],
+    ];
+    for (const [scope, ports] of buckets) {
+        const seen = new Set();
+        for (const port of ports) {
+            assertValidPortId(kind, `${scope} port`, port?.id);
+            if (seen.has(port.id)) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' declares duplicate static ${scope} port id '${port.id}'`);
+            }
+            seen.add(port.id);
+            if (port.defaultMode !== undefined && !isGraphPortBindingMode(port.defaultMode)) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' declares invalid default binding mode '${String(port.defaultMode)}' on ${scope} port '${port.id}'`);
+            }
+        }
+    }
+}
+function validateParameters(kind, manifest) {
+    const ids = new Set();
+    for (const parameter of manifest.parameters) {
+        const id = parameter?.id;
+        if (typeof id !== "string" || !id) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a parameter with an empty id`);
+        }
+        if ((0, graph_1.isGraphUnsafeObjectKey)(id)) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a parameter with unsafe id '${id}'`);
+        }
+        if (ids.has(id)) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' declares duplicate parameter id '${id}'`);
+        }
+        ids.add(id);
+    }
+    return ids;
+}
+function validateDynamicPortRules(kind, manifest, parameterIds) {
+    for (const rule of manifest.dynamicPorts ?? []) {
+        if (!rule || typeof rule.parameter !== "string" || !rule.parameter) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a dynamic-port rule without a parameter reference`);
+        }
+        if (!parameterIds.has(rule.parameter)) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a dynamic-port rule referencing missing parameter '${rule.parameter}'`);
+        }
+        if (rule.type === "togglePort") {
+            if (!rule.port) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a togglePort rule without a port`);
+            }
+            assertValidPortId(kind, "togglePort rule port", rule.port.id);
+        }
+        if (rule.type === "repeatFromParameter" && typeof rule.portIdTemplate !== "string") {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a repeatFromParameter rule without a portIdTemplate`);
+        }
+    }
+}
+function validateCredentials(kind, manifest) {
+    for (const credential of manifest.credentials ?? []) {
+        if (!(0, graph_1.isGraphCredentialRequirement)(credential)) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a malformed credential requirement`);
+        }
+        if (!credential.type) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a credential requirement with an empty type`);
+        }
+    }
+}
+function validateMethodDeclarations(kind, manifest) {
+    for (const declaration of manifest.methods ?? []) {
+        if (!(0, graph_1.isGraphNodeMethodManifest)(declaration)) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' has a malformed method declaration`);
+        }
+    }
+}
+function assertValidRegistration(registration) {
+    if (!registration || typeof registration !== "object") {
+        throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError("Graph node registration is required");
+    }
+    if (!registration.manifest || typeof registration.manifest !== "object") {
+        throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError("Graph node registration is missing a manifest");
+    }
+    if (!registration.executor || typeof registration.executor.execute !== "function") {
+        throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Graph node registration for kind '${String(registration.manifest?.kind)}' is missing an executor`);
+    }
+}
+/**
+ * Backend-side trusted node catalogue (DECAF-50 §4.10–§4.12): the single
+ * registry of node kinds the nine-stage validator resolves against and the
+ * execution engine pulls executors from. Registrations are validated on
+ * {@link GraphNodeCatalogue.register} (manifest serializability, static
+ * ports, parameters, dynamic-port rules, credentials, method declarations)
+ * and manifests are served as JSON-safe clones — never class instances.
+ * Supports the transition path via
+ * {@link GraphNodeCatalogue.registerExecutor}, which creates placeholder
+ * manifests with lenient policies for legacy executor-only registrations
+ * (removed at cutover, P7).
+ */
+class GraphNodeCatalogue {
+    constructor() {
+        this.entries = new Map();
+        this.resolver = new GraphNodeManifestResolver_js_1.GraphNodeManifestResolver();
+    }
+    /**
+     * Validates and registers a node kind. Throws
+     * {@link GraphNodeRegistrationError} on invalid manifests, and on duplicate
+     * kinds unless `options.replace` is set.
+     */
+    register(registration, options = {}) {
+        assertValidRegistration(registration);
+        const manifest = registration.manifest;
+        if (typeof manifest.kind !== "string" || !manifest.kind.trim()) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError("Graph node manifest kind is required and must be a non-empty string");
+        }
+        const kind = manifest.kind;
+        if (this.entries.has(kind) && !options.replace) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Graph node kind '${kind}' is already registered; pass { replace: true } to replace it`);
+        }
+        try {
+            (0, graph_1.assertGraphNodeManifestSerializable)(manifest);
+        }
+        catch (e) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Manifest for kind '${kind}' is not JSON-serializable: ${e.message}`);
+        }
+        validateStaticPorts(kind, manifest);
+        const parameterIds = validateParameters(kind, manifest);
+        validateDynamicPortRules(kind, manifest, parameterIds);
+        validateCredentials(kind, manifest);
+        validateMethodDeclarations(kind, manifest);
+        const methods = new GraphNodeMethodRegistry_js_1.GraphNodeMethodRegistry(kind, manifest.methods ?? [], registration.methods ?? {});
+        this.entries.set(kind, {
+            registration,
+            methods,
+            placeholderManifest: false,
+        });
+        return this;
+    }
+    /**
+     * Registers an executor for a kind. When the kind has no manifest yet, a
+     * placeholder manifest is created with transition-leniency policies
+     * (`allowUndeclaredParameters`/`allowUnknownOutputs`, DECAF-50 §4.18) that
+     * are removed at cutover (P7).
+     */
+    registerExecutor(kind, executor) {
+        if (typeof kind !== "string" || !kind.trim()) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError("Graph executor kind is required");
+        }
+        if (!executor || typeof executor.execute !== "function") {
+            throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Executor registered for kind '${kind}' is missing an execute method`);
+        }
+        const existing = this.entries.get(kind);
+        if (existing) {
+            existing.registration = { ...existing.registration, executor };
+            return this;
+        }
+        const manifest = {
+            kind,
+            display: { name: kind },
+            inputs: [],
+            outputs: [],
+            parameters: [],
+            // Transition leniency (DECAF-50 §4.8/§4.9/§4.18): placeholder manifests
+            // created for legacy executor-only registrations accept undeclared
+            // parameters and unknown outputs until cutover (P7).
+            policies: {
+                allowUndeclaredParameters: true,
+                allowUnknownOutputs: true,
+            },
+        };
+        this.entries.set(kind, {
+            registration: { manifest, executor },
+            methods: new GraphNodeMethodRegistry_js_1.GraphNodeMethodRegistry(kind, [], {}),
+            placeholderManifest: true,
+        });
+        return this;
+    }
+    /** Removes a kind registration. */
+    unregister(kind) {
+        this.entries.delete(kind);
+        return this;
+    }
+    /** Whether a kind is registered. */
+    has(kind) {
+        return this.entries.has(kind);
+    }
+    entry(kind) {
+        const entry = this.entries.get(kind);
+        if (!entry) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeNotFoundError(`No graph node kind '${kind}' is registered in the catalogue`);
+        }
+        return entry;
+    }
+    /** Returns a JSON-safe clone of the kind's registered manifest. */
+    getManifest(kind) {
+        return (0, graph_1.cloneGraphJsonValue)(this.entry(kind).registration.manifest);
+    }
+    /** Returns the kind's registered executor. */
+    getExecutor(kind) {
+        return this.entry(kind).registration.executor;
+    }
+    /** Returns the declared method manifest for a kind, if declared. */
+    getMethodDeclaration(kind, method) {
+        return this.entry(kind).methods.getDeclaration(method);
+    }
+    /** Returns the registered method implementation for a kind. */
+    getMethod(kind, method) {
+        this.entry(kind).methods.getDeclaration(method);
+        return this.entry(kind).methods.get(method);
+    }
+    /** Lists all method declarations registered for a kind. */
+    listMethodDeclarations(kind) {
+        return this.entry(kind).methods.list();
+    }
+    /** Lists registered manifests, optionally filtered by kind and display category. */
+    listManifests(context) {
+        const kinds = [...this.entries.keys()].sort();
+        const categoryFilter = context?.categories?.length
+            ? new Set(context.categories)
+            : undefined;
+        const kindFilter = context?.kinds?.length ? new Set(context.kinds) : undefined;
+        const manifests = [];
+        for (const kind of kinds) {
+            if (kindFilter && !kindFilter.has(kind))
+                continue;
+            const manifest = this.getManifest(kind);
+            if (categoryFilter && !categoryFilter.has(manifest.display.category ?? "")) {
+                continue;
+            }
+            manifests.push(manifest);
+        }
+        return manifests;
+    }
+    /** Lists all registered kinds, sorted. */
+    listKinds() {
+        return [...this.entries.keys()].sort();
+    }
+    /** Number of registered kinds. */
+    get size() {
+        return this.entries.size;
+    }
+    /**
+     * Resolves the effective manifest for a node instance (dynamic ports
+     * expanded, instance context applied) as a
+     * {@link GraphResolvedNodeManifest}.
+     */
+    async resolveManifest(kind, instance, context) {
+        const entry = this.entry(kind);
+        return this.resolver.resolve(kind, entry.registration.manifest, entry.registration.resolveManifest, instance, context);
+    }
+}
+exports.GraphNodeCatalogue = GraphNodeCatalogue;
+//# sourceMappingURL=GraphNodeCatalogue.js.map
+//# sourceMappingURL=GraphNodeCatalogue.cjs.map

package/lib/cjs/graph/engine/catalog/GraphNodeCatalogue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/catalog/GraphNodeCatalogue.cjs","sourceRoot":"","sources":["graph/engine/catalog/GraphNodeCatalogue.js"],"names":[],"mappings":"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"}

package/lib/cjs/graph/engine/catalog/GraphNodeManifestResolver.cjs

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphNodeManifestResolver = void 0;
+exports.resolveGraphDynamicPorts = resolveGraphDynamicPorts;
+exports.resolveGraphNodeManifest = resolveGraphNodeManifest;
+const graph_1 = require("@decaf-ts/ui-decorators/graph");
+const graph_2 = require("@decaf-ts/ui-decorators/graph");
+const GraphCatalogueErrors_js_1 = require("./GraphCatalogueErrors.cjs");
+function readItemPath(item, path) {
+    if (!path)
+        return undefined;
+    let current = item;
+    for (const segment of path.split(".")) {
+        if (!current || typeof current !== "object")
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+function expandPortIdTemplate(template, values) {
+    return template
+        .replaceAll("${id}", values.id)
+        .replaceAll("${index}", String(values.index))
+        .replaceAll("${label}", values.label);
+}
+function dynamicPortIdFor(rule, item, index) {
+    const rawId = readItemPath(item, rule.itemIdPath);
+    const rawLabel = rule.itemLabelPath
+        ? readItemPath(item, rule.itemLabelPath)
+        : undefined;
+    const id = (typeof rawId === "string" && rawId) ||
+        (typeof rawId === "number" && Number.isFinite(rawId) && String(rawId)) ||
+        String(index);
+    const label = typeof rawLabel === "string" ? rawLabel : undefined;
+    return { id, label };
+}
+function dynamicPortTargets(resolution, direction) {
+    switch (direction) {
+        case "input":
+            return resolution.inputs;
+        case "output":
+            return resolution.outputs;
+        default:
+            return resolution.connections;
+    }
+}
+/**
+ * Expands a manifest's `dynamicPorts` rules (DECAF-50 §4.11) against the
+ * given parameter values — e.g. `repeatFromParameter` turns each array item
+ * into a concrete port with a templated id/label. Static ports are never
+ * duplicated; expanded ports are appended per direction.
+ */
+function resolveGraphDynamicPorts(manifest, parameters) {
+    const resolution = {
+        inputs: [],
+        outputs: [],
+        connections: [],
+    };
+    const seen = {
+        input: new Set((manifest.inputs ?? []).map((port) => port.id)),
+        output: new Set((manifest.outputs ?? []).map((port) => port.id)),
+        connection: new Set((manifest.connections ?? []).map((port) => port.id)),
+    };
+    const claim = (direction, portId) => {
+        const taken = seen[direction];
+        if (taken.has(portId))
+            return false;
+        taken.add(portId);
+        return true;
+    };
+    for (const rule of manifest.dynamicPorts ?? []) {
+        if (rule.type === "repeatFromParameter") {
+            const value = parameters[rule.parameter];
+            if (!Array.isArray(value))
+                continue;
+            const targets = dynamicPortTargets(resolution, rule.direction);
+            value.forEach((item, index) => {
+                const { id, label } = dynamicPortIdFor(rule, item, index);
+                const portId = expandPortIdTemplate(rule.portIdTemplate, {
+                    id,
+                    index,
+                    label: label ?? id,
+                });
+                if (!claim(rule.direction, portId))
+                    return;
+                const base = rule.defaultPort
+                    ? (0, graph_1.cloneGraphJsonValue)(rule.defaultPort)
+                    : {
+                        id: portId,
+                        label: label ?? portId,
+                        direction: rule.direction,
+                    };
+                const port = base;
+                port.id = portId;
+                port.direction = rule.direction;
+                if (label)
+                    port.label = label;
+                targets.push(port);
+            });
+        }
+        else if (rule.type === "togglePort") {
+            const value = parameters[rule.parameter];
+            if (value !== rule.equals)
+                continue;
+            const port = (0, graph_1.cloneGraphJsonValue)(rule.port);
+            if (!claim(port.direction, port.id))
+                continue;
+            dynamicPortTargets(resolution, port.direction).push(port);
+        }
+    }
+    return resolution;
+}
+/**
+ * Resolves a manifest against parameter values into a
+ * {@link GraphResolvedNodeManifest}: static ports plus expanded dynamic
+ * ports, with credentials/capabilities/policies/metadata carried over. The
+ * result is a JSON-safe clone.
+ */
+function resolveGraphNodeManifest(manifest, parameters) {
+    const dynamic = resolveGraphDynamicPorts(manifest, parameters);
+    const resolved = {
+        kind: manifest.kind,
+        display: manifest.display,
+        inputs: [...manifest.inputs, ...dynamic.inputs],
+        outputs: [...manifest.outputs, ...dynamic.outputs],
+        parameters: manifest.parameters,
+    };
+    const connections = [
+        ...(manifest.connections ?? []),
+        ...dynamic.connections,
+    ];
+    if (connections.length)
+        resolved.connections = connections;
+    if (manifest.dynamicPorts?.length)
+        resolved.dynamicPorts = manifest.dynamicPorts;
+    if (manifest.credentials?.length)
+        resolved.credentials = manifest.credentials;
+    if (manifest.capabilities?.length)
+        resolved.capabilities = manifest.capabilities;
+    if (manifest.policies)
+        resolved.policies = manifest.policies;
+    if (manifest.metadata)
+        resolved.metadata = manifest.metadata;
+    return (0, graph_1.cloneGraphJsonValue)(resolved);
+}
+/**
+ * Resolves the effective manifest for a node instance. Prefers the
+ * registration's `resolveManifest` provider (validated for shape and JSON
+ * safety) and falls back to static-plus-dynamic resolution via
+ * {@link resolveGraphNodeManifest}.
+ */
+class GraphNodeManifestResolver {
+    async resolve(kind, manifest, provider, instance, context) {
+        if (provider) {
+            const resolved = await provider(instance, context);
+            if (!(0, graph_2.isGraphResolvedNodeManifest)(resolved)) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`resolveManifest provider for kind '${kind}' returned a value that does not conform to GraphResolvedNodeManifest`);
+            }
+            if (!(0, graph_1.isGraphJsonSafeValue)(resolved)) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`resolveManifest provider for kind '${kind}' returned a non-JSON-safe resolved manifest`);
+            }
+            return (0, graph_1.cloneGraphJsonValue)(resolved);
+        }
+        return resolveGraphNodeManifest(manifest, instance.parameters ?? {});
+    }
+}
+exports.GraphNodeManifestResolver = GraphNodeManifestResolver;
+//# sourceMappingURL=GraphNodeManifestResolver.js.map
+//# sourceMappingURL=GraphNodeManifestResolver.cjs.map

package/lib/cjs/graph/engine/catalog/GraphNodeManifestResolver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/catalog/GraphNodeManifestResolver.cjs","sourceRoot":"","sources":["graph/engine/catalog/GraphNodeManifestResolver.js"],"names":[],"mappings":"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"}