@decaf-ts/integrations 0.7.0 → 0.9.0

package/lib/esm/graph/engine/catalog/GraphNodeCatalogue.js

@@ -0,0 +1,265 @@
+import { assertGraphNodeManifestSerializable, cloneGraphJsonValue, isGraphCredentialRequirement, isGraphNodeMethodManifest, isGraphUnsafeObjectKey, } from "@decaf-ts/ui-decorators/graph";
+import { GraphNodeRegistrationError, GraphNodeNotFoundError, } from "./GraphCatalogueErrors.js";
+import { GraphNodeMethodRegistry } from "./GraphNodeMethodRegistry.js";
+import { GraphNodeManifestResolver } from "./GraphNodeManifestResolver.js";
+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 GraphNodeRegistrationError(`Manifest for kind '${kind}' has a ${scope} with an empty port id`);
+    }
+    if (isGraphUnsafeObjectKey(id)) {
+        throw new 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 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 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 GraphNodeRegistrationError(`Manifest for kind '${kind}' has a parameter with an empty id`);
+        }
+        if (isGraphUnsafeObjectKey(id)) {
+            throw new GraphNodeRegistrationError(`Manifest for kind '${kind}' has a parameter with unsafe id '${id}'`);
+        }
+        if (ids.has(id)) {
+            throw new 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 GraphNodeRegistrationError(`Manifest for kind '${kind}' has a dynamic-port rule without a parameter reference`);
+        }
+        if (!parameterIds.has(rule.parameter)) {
+            throw new GraphNodeRegistrationError(`Manifest for kind '${kind}' has a dynamic-port rule referencing missing parameter '${rule.parameter}'`);
+        }
+        if (rule.type === "togglePort") {
+            if (!rule.port) {
+                throw new 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 GraphNodeRegistrationError(`Manifest for kind '${kind}' has a repeatFromParameter rule without a portIdTemplate`);
+        }
+    }
+}
+function validateCredentials(kind, manifest) {
+    for (const credential of manifest.credentials ?? []) {
+        if (!isGraphCredentialRequirement(credential)) {
+            throw new GraphNodeRegistrationError(`Manifest for kind '${kind}' has a malformed credential requirement`);
+        }
+        if (!credential.type) {
+            throw new GraphNodeRegistrationError(`Manifest for kind '${kind}' has a credential requirement with an empty type`);
+        }
+    }
+}
+function validateMethodDeclarations(kind, manifest) {
+    for (const declaration of manifest.methods ?? []) {
+        if (!isGraphNodeMethodManifest(declaration)) {
+            throw new GraphNodeRegistrationError(`Manifest for kind '${kind}' has a malformed method declaration`);
+        }
+    }
+}
+function assertValidRegistration(registration) {
+    if (!registration || typeof registration !== "object") {
+        throw new GraphNodeRegistrationError("Graph node registration is required");
+    }
+    if (!registration.manifest || typeof registration.manifest !== "object") {
+        throw new GraphNodeRegistrationError("Graph node registration is missing a manifest");
+    }
+    if (!registration.executor || typeof registration.executor.execute !== "function") {
+        throw new 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).
+ */
+export class GraphNodeCatalogue {
+    constructor() {
+        this.entries = new Map();
+        this.resolver = new 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 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 GraphNodeRegistrationError(`Graph node kind '${kind}' is already registered; pass { replace: true } to replace it`);
+        }
+        try {
+            assertGraphNodeManifestSerializable(manifest);
+        }
+        catch (e) {
+            throw new 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(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 GraphNodeRegistrationError("Graph executor kind is required");
+        }
+        if (!executor || typeof executor.execute !== "function") {
+            throw new 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(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 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 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);
+    }
+}
+//# sourceMappingURL=GraphNodeCatalogue.js.map

package/lib/esm/graph/engine/catalog/GraphNodeCatalogue.js.map

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

package/lib/esm/graph/engine/catalog/GraphNodeManifestResolver.js

@@ -0,0 +1,162 @@
+import { cloneGraphJsonValue, isGraphJsonSafeValue, } from "@decaf-ts/ui-decorators/graph";
+import { isGraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
+import { GraphNodeRegistrationError } from "./GraphCatalogueErrors.js";
+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.
+ */
+export 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
+                    ? 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 = 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.
+ */
+export 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 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}.
+ */
+export class GraphNodeManifestResolver {
+    async resolve(kind, manifest, provider, instance, context) {
+        if (provider) {
+            const resolved = await provider(instance, context);
+            if (!isGraphResolvedNodeManifest(resolved)) {
+                throw new GraphNodeRegistrationError(`resolveManifest provider for kind '${kind}' returned a value that does not conform to GraphResolvedNodeManifest`);
+            }
+            if (!isGraphJsonSafeValue(resolved)) {
+                throw new GraphNodeRegistrationError(`resolveManifest provider for kind '${kind}' returned a non-JSON-safe resolved manifest`);
+            }
+            return cloneGraphJsonValue(resolved);
+        }
+        return resolveGraphNodeManifest(manifest, instance.parameters ?? {});
+    }
+}
+//# sourceMappingURL=GraphNodeManifestResolver.js.map

package/lib/esm/graph/engine/catalog/GraphNodeManifestResolver.js.map

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

package/lib/esm/graph/engine/catalog/GraphNodeMethodRegistry.js

@@ -0,0 +1,59 @@
+import { GraphNodeRegistrationError, GraphNodeMethodNotFoundError, } from "./GraphCatalogueErrors.js";
+/**
+ * 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.
+ */
+export 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 GraphNodeRegistrationError(`Method declaration for kind '${this.kind}' is missing a name`);
+            }
+            if (this.declarations.has(declaration.name)) {
+                throw new 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 GraphNodeRegistrationError(`Method implementation '${name}' for kind '${this.kind}' is not a function`);
+            }
+            if (!this.declarations.has(name)) {
+                throw new 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 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 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);
+    }
+}
+//# sourceMappingURL=GraphNodeMethodRegistry.js.map

package/lib/esm/graph/engine/catalog/GraphNodeMethodRegistry.js.map

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

package/lib/esm/graph/engine/catalog/GraphNodeRegistration.js

@@ -0,0 +1,12 @@
+/**
+ * Identity helper that types a registration payload as a
+ * {@link GraphNodeRegistration} for catalogue registration.
+ */
+export function defineGraphNode(registration) {
+    return registration;
+}
+/** Returns the method manifests declared by a node manifest. */
+export function declaredGraphNodeMethods(manifest) {
+    return manifest.methods ?? [];
+}
+//# sourceMappingURL=GraphNodeRegistration.js.map

package/lib/esm/graph/engine/catalog/GraphNodeRegistration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphNodeRegistration.js","sourceRoot":"","sources":["../../../../../src/graph/engine/catalog/GraphNodeRegistration.ts"],"names":[],"mappings":"AAkFA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAmC;IAEnC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,wBAAwB,CACtC,QAA2B;IAE3B,OAAO,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/lib/esm/graph/engine/catalog/index.js

@@ -0,0 +1,7 @@
+export * from "./GraphCatalogueErrors.js";
+export * from "./GraphNodeRegistration.js";
+export * from "./GraphNodeMethodRegistry.js";
+export * from "./GraphNodeManifestResolver.js";
+export * from "./GraphNodeCatalogue.js";
+export * from "./GraphBuiltInRegistrations.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/graph/engine/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/catalog/index.ts"],"names":[],"mappings":"AAAA,0CAAuC;AACvC,2CAAwC;AACxC,6CAA0C;AAC1C,+CAA4C;AAC5C,wCAAqC;AACrC,+CAA4C"}

package/lib/esm/graph/engine/constants.js

@@ -3,8 +3,8 @@
  * @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/esm/graph/engine/errors/GraphExecutionError.js

@@ -17,6 +17,7 @@ export class GraphExecutionError extends InternalError {
         super(message, GraphExecutionError.name, 500);
         this.graphCode = graphCode;
         this.details = details;
+        this.name = this.constructor.name;
     }
 }
 //# sourceMappingURL=GraphExecutionError.js.map

package/lib/esm/graph/engine/errors/GraphExecutionError.js.map

@@ -1 +1 @@
-{"version":3,"file":"GraphExecutionError.js","sourceRoot":"","sources":["../../../../../src/graph/engine/errors/GraphExecutionError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAIpD,YACE,OAAe,EACf,SAAS,GAAG,uBAAuB,EACnC,OAAiB;QAEjB,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;IACzB,CAAC;CACF"}
+{"version":3,"file":"GraphExecutionError.js","sourceRoot":"","sources":["../../../../../src/graph/engine/errors/GraphExecutionError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAIpD,YACE,OAAe,EACf,SAAS,GAAG,uBAAuB,EACnC,OAAiB;QAEjB,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;IACpC,CAAC;CACF"}

package/lib/esm/graph/engine/errors/GraphRunCancelledError.js

@@ -0,0 +1,13 @@
+import { GraphExecutionError } from "./GraphExecutionError.js";
+/**
+ * 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.
+ */
+export class GraphRunCancelledError extends GraphExecutionError {
+    constructor(runId) {
+        super(`Graph run '${runId}' was cancelled`, "GRAPH_RUN_CANCELLED", { runId });
+        this.name = GraphRunCancelledError.name;
+    }
+}
+//# sourceMappingURL=GraphRunCancelledError.js.map

package/lib/esm/graph/engine/errors/GraphRunCancelledError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphRunCancelledError.js","sourceRoot":"","sources":["../../../../../src/graph/engine/errors/GraphRunCancelledError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iCAA8B;AAE5D;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,mBAAmB;IAC7D,YAAY,KAAa;QACvB,KAAK,CACH,cAAc,KAAK,iBAAiB,EACpC,qBAAqB,EACrB,EAAE,KAAK,EAAE,CACV,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;IAC1C,CAAC;CACF"}

package/lib/esm/graph/engine/errors/index.js

@@ -12,4 +12,5 @@ export * from "./GraphPortError.js";
 export * from "./GraphStoreError.js";
 export * from "./GraphTopologyError.js";
 export * from "./GraphBreakSignal.js";
+export * from "./GraphRunCancelledError.js";
 //# sourceMappingURL=index.js.map

package/lib/esm/graph/engine/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yCAAsC;AACtC,qCAAkC;AAClC,qCAAkC;AAClC,yCAAsC;AACtC,uCAAoC;AACpC,oCAAiC;AACjC,qCAAkC;AAClC,wCAAqC;AACrC,sCAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yCAAsC;AACtC,qCAAkC;AAClC,qCAAkC;AAClC,yCAAsC;AACtC,uCAAoC;AACpC,oCAAiC;AACjC,qCAAkC;AAClC,wCAAqC;AACrC,sCAAmC;AACnC,4CAAyC"}

package/lib/esm/graph/engine/events/GraphExecutionEventEmitter.js.map

@@ -1 +1 @@
-{"version":3,"file":"GraphExecutionEventEmitter.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/GraphExecutionEventEmitter.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QAEmB,cAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IA8BjE,CAAC;IA5BC,iEAAiE;IACjE,OAAO,CAAC,QAAgC;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,gDAAgD;IAChD,SAAS,CAAC,QAAgC;QACxC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,KAA0B;QAC9C,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAChD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"GraphExecutionEventEmitter.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/GraphExecutionEventEmitter.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QAEmB,cAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IA8BjE,CAAC;IA5BC,iEAAiE;IACjE,OAAO,CAAC,QAAgC;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,gDAAgD;IAChD,SAAS,CAAC,QAAgC;QACxC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,KAA0B;QAC9C,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAChD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}

package/lib/esm/graph/engine/events/GraphExecutionEventFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"GraphExecutionEventFactory.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/GraphExecutionEventFactory.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QACU,aAAQ,GAAG,CAAC,CAAC;IA6BvB,CAAC;IA3BC;;;;;OAKG;IACH,MAAM,CACJ,IAAgE;QAEhE,OAAO;YACL,GAAG,IAAI;YACP,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;YACxB,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,aAAa;QACnB,OAAO,CACL,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;YACjC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"GraphExecutionEventFactory.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/GraphExecutionEventFactory.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QACU,aAAQ,GAAG,CAAC,CAAC;IA6BvB,CAAC;IA3BC;;;;;OAKG;IACH,MAAM,CACJ,IAAgE;QAEhE,OAAO;YACL,GAAG,IAAI;YACP,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;YACxB,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,aAAa;QACnB,OAAO,CACL,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;YACjC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;CACF"}

package/lib/esm/graph/engine/events/index.js

@@ -3,7 +3,6 @@
  * @summary Graph execution event pipeline.
  * @description Re-exports the observer interface, event emitter, and event factory.
  */
-export * from "./GraphExecutionEvent.js";
 export * from "./GraphExecutionObserver.js";
 export * from "./GraphExecutionEventEmitter.js";
 export * from "./GraphExecutionEventFactory.js";

package/lib/esm/graph/engine/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yCAAsC;AACtC,4CAAyC;AACzC,gDAA6C;AAC7C,gDAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,4CAAyC;AACzC,gDAA6C;AAC7C,gDAA6C"}