@decaf-ts/integrations 0.7.0 → 0.9.0

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":";;;AA+CA,4DA2DC;AAOD,4DA0BC;AA3ID,yDAA2F;AAC3F,yDAA4E;AAC5E,uEAAuE;AACvE,SAAS,YAAY,CAAC,IAAI,EAAE,IAAI;IAC5B,IAAI,CAAC,IAAI;QACL,OAAO,SAAS,CAAC;IACrB,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;YACvC,OAAO,SAAS,CAAC;QACrB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AACD,SAAS,oBAAoB,CAAC,QAAQ,EAAE,MAAM;IAC1C,OAAO,QAAQ;SACV,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;SAC9B,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SAC5C,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AACD,SAAS,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK;IACvC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa;QAC/B,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC;QACxC,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,EAAE,GAAG,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC;QAC3C,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,CAAC,KAAK,CAAC,CAAC;IAClB,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AACD,SAAS,kBAAkB,CAAC,UAAU,EAAE,SAAS;IAC7C,QAAQ,SAAS,EAAE,CAAC;QAChB,KAAK,OAAO;YACR,OAAO,UAAU,CAAC,MAAM,CAAC;QAC7B,KAAK,QAAQ;YACT,OAAO,UAAU,CAAC,OAAO,CAAC;QAC9B;YACI,OAAO,UAAU,CAAC,WAAW,CAAC;IACtC,CAAC;AACL,CAAC;AACD;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAC,QAAQ,EAAE,UAAU;IACzD,MAAM,UAAU,GAAG;QACf,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,EAAE;KAClB,CAAC;IACF,MAAM,IAAI,GAAG;QACT,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,UAAU,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;KAC3E,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;YACjB,OAAO,KAAK,CAAC;QACjB,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACrB,SAAS;YACb,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/D,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBAC1B,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC1D,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,cAAc,EAAE;oBACrD,EAAE;oBACF,KAAK;oBACL,KAAK,EAAE,KAAK,IAAI,EAAE;iBACrB,CAAC,CAAC;gBACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC;oBAC9B,OAAO;gBACX,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW;oBACzB,CAAC,CAAC,IAAA,2BAAmB,EAAC,IAAI,CAAC,WAAW,CAAC;oBACvC,CAAC,CAAC;wBACE,EAAE,EAAE,MAAM;wBACV,KAAK,EAAE,KAAK,IAAI,MAAM;wBACtB,SAAS,EAAE,IAAI,CAAC,SAAS;qBAC5B,CAAC;gBACN,MAAM,IAAI,GAAG,IAAI,CAAC;gBAClB,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC;gBACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;gBAChC,IAAI,KAAK;oBACL,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;QACP,CAAC;aACI,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM;gBACrB,SAAS;YACb,MAAM,IAAI,GAAG,IAAA,2BAAmB,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC/B,SAAS;YACb,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;IACL,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AACD;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAC,QAAQ,EAAE,UAAU;IACzD,MAAM,OAAO,GAAG,wBAAwB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG;QACb,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/C,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;QAClD,UAAU,EAAE,QAAQ,CAAC,UAAU;KAClC,CAAC;IACF,MAAM,WAAW,GAAG;QAChB,GAAG,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC;QAC/B,GAAG,OAAO,CAAC,WAAW;KACzB,CAAC;IACF,IAAI,WAAW,CAAC,MAAM;QAClB,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;IACvC,IAAI,QAAQ,CAAC,YAAY,EAAE,MAAM;QAC7B,QAAQ,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;IAClD,IAAI,QAAQ,CAAC,WAAW,EAAE,MAAM;QAC5B,QAAQ,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;IAChD,IAAI,QAAQ,CAAC,YAAY,EAAE,MAAM;QAC7B,QAAQ,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;IAClD,IAAI,QAAQ,CAAC,QAAQ;QACjB,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC1C,IAAI,QAAQ,CAAC,QAAQ;QACjB,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC1C,OAAO,IAAA,2BAAmB,EAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AACD;;;;;GAKG;AACH,MAAa,yBAAyB;IAClC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO;QACrD,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,IAAI,CAAC,IAAA,mCAA2B,EAAC,QAAQ,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,oDAA0B,CAAC,sCAAsC,IAAI,uEAAuE,CAAC,CAAC;YAC5J,CAAC;YACD,IAAI,CAAC,IAAA,4BAAoB,EAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,oDAA0B,CAAC,sCAAsC,IAAI,8CAA8C,CAAC,CAAC;YACnI,CAAC;YACD,OAAO,IAAA,2BAAmB,EAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;CACJ;AAdD,8DAcC;AACD,qDAAqD"}

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphNodeMethodRegistry = void 0;
+const GraphCatalogueErrors_js_1 = require("./GraphCatalogueErrors.cjs");
+/**
+ * Per-kind registry of declared node methods (DECAF-50 §4.12): validates at
+ * construction that every declared method has an implementation and no
+ * implementation exists without a declaration, then serves declarations and
+ * implementations by name.
+ */
+class GraphNodeMethodRegistry {
+    constructor(kind, declared, provided = {}) {
+        this.kind = kind;
+        this.declarations = new Map();
+        this.implementations = new Map();
+        for (const declaration of declared) {
+            if (typeof declaration?.name !== "string" || !declaration.name) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Method declaration for kind '${this.kind}' is missing a name`);
+            }
+            if (this.declarations.has(declaration.name)) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Kind '${this.kind}' declares duplicate method '${declaration.name}'`);
+            }
+            this.declarations.set(declaration.name, declaration);
+        }
+        for (const [name, implementation] of Object.entries(provided)) {
+            if (typeof implementation !== "function") {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Method implementation '${name}' for kind '${this.kind}' is not a function`);
+            }
+            if (!this.declarations.has(name)) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Kind '${this.kind}' implements method '${name}' which is not declared by its manifest`);
+            }
+            this.implementations.set(name, implementation);
+        }
+        for (const name of this.declarations.keys()) {
+            if (!this.implementations.has(name)) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Kind '${this.kind}' declares method '${name}' with no implementation`);
+            }
+        }
+    }
+    /** Whether a method with the given name is declared. */
+    has(name) {
+        return this.declarations.has(name);
+    }
+    /** Returns the method's declaration; throws {@link GraphNodeMethodNotFoundError} when undeclared. */
+    getDeclaration(name) {
+        const declaration = this.declarations.get(name);
+        if (!declaration) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeMethodNotFoundError(`Kind '${this.kind}' does not declare method '${name}'`);
+        }
+        return declaration;
+    }
+    /** Returns the method's implementation (asserting it is declared first). */
+    get(name) {
+        this.getDeclaration(name);
+        return this.implementations.get(name);
+    }
+    /** Lists all declarations, sorted by method name. */
+    list() {
+        return [...this.declarations.values()].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+    }
+}
+exports.GraphNodeMethodRegistry = GraphNodeMethodRegistry;
+//# sourceMappingURL=GraphNodeMethodRegistry.js.map
+//# sourceMappingURL=GraphNodeMethodRegistry.cjs.map

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

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

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineGraphNode = defineGraphNode;
+exports.declaredGraphNodeMethods = declaredGraphNodeMethods;
+/**
+ * Identity helper that types a registration payload as a
+ * {@link GraphNodeRegistration} for catalogue registration.
+ */
+function defineGraphNode(registration) {
+    return registration;
+}
+/** Returns the method manifests declared by a node manifest. */
+function declaredGraphNodeMethods(manifest) {
+    return manifest.methods ?? [];
+}
+//# sourceMappingURL=GraphNodeRegistration.js.map
+//# sourceMappingURL=GraphNodeRegistration.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/catalog/GraphNodeRegistration.cjs","sourceRoot":"","sources":["graph/engine/catalog/GraphNodeRegistration.js"],"names":[],"mappings":";;AAIA,0CAEC;AAED,4DAEC;AAVD;;;GAGG;AACH,SAAgB,eAAe,CAAC,YAAY;IACxC,OAAO,YAAY,CAAC;AACxB,CAAC;AACD,gEAAgE;AAChE,SAAgB,wBAAwB,CAAC,QAAQ;IAC7C,OAAO,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;AAClC,CAAC;AACD,iDAAiD"}

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

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./GraphCatalogueErrors.cjs"), exports);
+__exportStar(require("./GraphNodeRegistration.cjs"), exports);
+__exportStar(require("./GraphNodeMethodRegistry.cjs"), exports);
+__exportStar(require("./GraphNodeManifestResolver.cjs"), exports);
+__exportStar(require("./GraphNodeCatalogue.cjs"), exports);
+__exportStar(require("./GraphBuiltInRegistrations.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/catalog/index.cjs","sourceRoot":"","sources":["graph/engine/catalog/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,6DAA2C;AAC3C,+DAA6C;AAC7C,iEAA+C;AAC/C,0DAAwC;AACxC,iEAA+C;AAC/C,iCAAiC"}

package/lib/cjs/graph/engine/constants.cjs

@@ -6,8 +6,8 @@ exports.GRAPH_LOOP_KIND = exports.GraphConditionType = exports.GraphPinningStrat
  * @summary Graph execution engine-private constants and enums.
  * @description Engine-only constants, default limits, and enumerations.
  * Frontend-safe enums (`GraphExecutionStatus`, `GraphExecutionEventType`)
- * live in `../shared/constants`; engine modules import shared symbols from
- * there and engine-private symbols from here.
+ * live in `@decaf-ts/ui-decorators/graph`; engine modules import shared
+ * symbols from there and engine-private symbols from here.
  */
 /**
  * Boundary identifier used as the node id for workflow-level input/output ports.

package/lib/cjs/graph/engine/errors/GraphExecutionError.cjs

@@ -20,6 +20,7 @@ class GraphExecutionError extends db_decorators_1.InternalError {
         super(message, GraphExecutionError.name, 500);
         this.graphCode = graphCode;
         this.details = details;
+        this.name = this.constructor.name;
     }
 }
 exports.GraphExecutionError = GraphExecutionError;

package/lib/cjs/graph/engine/errors/GraphExecutionError.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"graph/engine/errors/GraphExecutionError.cjs","sourceRoot":"","sources":["graph/engine/errors/GraphExecutionError.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,2DAAwD;AACxD;;;;;;;GAOG;AACH,MAAa,mBAAoB,SAAQ,6BAAa;IAClD,YAAY,OAAO,EAAE,SAAS,GAAG,uBAAuB,EAAE,OAAO;QAC7D,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;CACJ;AAND,kDAMC;AACD,+CAA+C"}
+{"version":3,"file":"graph/engine/errors/GraphExecutionError.cjs","sourceRoot":"","sources":["graph/engine/errors/GraphExecutionError.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,2DAAwD;AACxD;;;;;;;GAOG;AACH,MAAa,mBAAoB,SAAQ,6BAAa;IAClD,YAAY,OAAO,EAAE,SAAS,GAAG,uBAAuB,EAAE,OAAO;QAC7D,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACtC,CAAC;CACJ;AAPD,kDAOC;AACD,+CAA+C"}

package/lib/cjs/graph/engine/errors/GraphRunCancelledError.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphRunCancelledError = void 0;
+const GraphExecutionError_js_1 = require("./GraphExecutionError.cjs");
+/**
+ * Thrown when a graph run is cancelled before completion: carries the run id
+ * under the `GRAPH_RUN_CANCELLED` code so run lifecycle bookkeeping can
+ * distinguish cancellation from failure.
+ */
+class GraphRunCancelledError extends GraphExecutionError_js_1.GraphExecutionError {
+    constructor(runId) {
+        super(`Graph run '${runId}' was cancelled`, "GRAPH_RUN_CANCELLED", { runId });
+        this.name = GraphRunCancelledError.name;
+    }
+}
+exports.GraphRunCancelledError = GraphRunCancelledError;
+//# sourceMappingURL=GraphRunCancelledError.js.map
+//# sourceMappingURL=GraphRunCancelledError.cjs.map

package/lib/cjs/graph/engine/errors/GraphRunCancelledError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/errors/GraphRunCancelledError.cjs","sourceRoot":"","sources":["graph/engine/errors/GraphRunCancelledError.js"],"names":[],"mappings":";;;AAAA,qEAA+D;AAC/D;;;;GAIG;AACH,MAAa,sBAAuB,SAAQ,4CAAmB;IAC3D,YAAY,KAAK;QACb,KAAK,CAAC,cAAc,KAAK,iBAAiB,EAAE,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;IAC5C,CAAC;CACJ;AALD,wDAKC;AACD,kDAAkD"}

package/lib/cjs/graph/engine/errors/index.cjs

@@ -28,5 +28,6 @@ __exportStar(require("./GraphPortError.cjs"), exports);
 __exportStar(require("./GraphStoreError.cjs"), exports);
 __exportStar(require("./GraphTopologyError.cjs"), exports);
 __exportStar(require("./GraphBreakSignal.cjs"), exports);
+__exportStar(require("./GraphRunCancelledError.cjs"), exports);
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.cjs.map