@decaf-ts/ui-decorators 0.20.9 → 0.21.1

package/lib/esm/graph/document/GraphWorkflowDocumentBuilder.js

@@ -1,303 +0,0 @@
-import { ValidationError } from "@decaf-ts/db-decorators";
-import { isGraphJsonSafeValue, isGraphUnsafeObjectKey, } from "./GraphJsonValue.js";
-import { isGraphEndpoint, isGraphNodeEndpoint, isGraphWorkflowEndpoint } from "./GraphEndpoint.js";
-import { isGraphInputBinding } from "./GraphNodeBinding.js";
-import { isGraphValueSchema } from "./../catalog/GraphValueSchema.js";
-/**
- * Fluent builder for the canonical {@link GraphWorkflowDocument}
- * (DECAF-50 §4.4.4). Collects boundary ports, node instances, edges, and
- * optional settings/metadata/UI state, then validates and freezes a
- * defensively-copied document on {@link GraphWorkflowDocumentBuilder.build}.
- */
-export class GraphWorkflowDocumentBuilder {
-    /**
-     * @param id Document id.
-     * @param name Optional document name; defaults to an empty string.
-     */
-    constructor(id, name) {
-        this.document = {
-            id,
-            name: name ?? "",
-            inputs: [],
-            outputs: [],
-            nodes: [],
-            edges: [],
-        };
-    }
-    /** Appends a workflow input port. */
-    addInput(port) {
-        this.document.inputs.push(port);
-        return this;
-    }
-    /** Appends a workflow output port. */
-    addOutput(port) {
-        this.document.outputs.push(port);
-        return this;
-    }
-    /** Appends a node instance, defaulting `parameters` to an empty object. */
-    addNode(node) {
-        this.document.nodes.push({
-            ...node,
-            parameters: node.parameters ?? {},
-        });
-        return this;
-    }
-    /** Appends an edge instance. */
-    addEdge(edge) {
-        this.document.edges.push(edge);
-        return this;
-    }
-    /** Sets (or clears) the document's free-form settings bag. */
-    setSettings(settings) {
-        this.document.settings = settings;
-        return this;
-    }
-    /** Sets (or clears) the document's metadata bag. */
-    setMetadata(metadata) {
-        this.document.metadata = metadata;
-        return this;
-    }
-    /** Sets (or clears) the document's editor UI state. */
-    setUi(ui) {
-        this.document.ui = ui;
-        return this;
-    }
-    /**
-     * Validates the accumulated document with
-     * {@link assertGraphWorkflowDocumentValid} and returns a deep-ish copy:
-     * ports, nodes, and edges are cloned per entry, and the optional
-     * `settings`/`metadata`/`ui` bags are only present when explicitly set, so
-     * callers never observe builder-internal `undefined` fields.
-     *
-     * @throws ValidationError when the document fails validation.
-     */
-    build() {
-        assertGraphWorkflowDocumentValid(this.document);
-        const document = {
-            id: this.document.id,
-            name: this.document.name,
-            inputs: this.document.inputs.map((port) => ({ ...port })),
-            outputs: this.document.outputs.map((port) => ({ ...port })),
-            nodes: this.document.nodes.map((node) => ({ ...node })),
-            edges: this.document.edges.map((edge) => ({ ...edge })),
-        };
-        if (this.document.settings !== undefined) {
-            document.settings = this.document.settings;
-        }
-        if (this.document.metadata !== undefined) {
-            document.metadata = this.document.metadata;
-        }
-        if (this.document.ui !== undefined) {
-            document.ui = this.document.ui;
-        }
-        return document;
-    }
-}
-/**
- * Structural validation gate for a canonical {@link GraphWorkflowDocument}
- * (shared by the frontend builder and the backend nine-stage validator,
- * DECAF-50 §4.8 stage 1 shape rules). Checks unique port/node/edge ids,
- * valid schemas, binding shapes, edge endpoints, and recursively validates
- * nested loop-body documents.
- *
- * @throws ValidationError describing the first invalid aspect found.
- */
-export function assertGraphWorkflowDocumentValid(document, context = { seen: [] }) {
-    if (context.seen.includes(document)) {
-        throw new ValidationError(`Document '${describeDocument(document)}' contains a loop body that references itself (cyclic document)`);
-    }
-    if (typeof document.id !== "string" || !document.id) {
-        throw new ValidationError("Document 'id' is required and must be a non-empty string");
-    }
-    if (typeof document.name !== "string" || !document.name) {
-        throw new ValidationError("Document 'name' is required and must be a non-empty string");
-    }
-    const workflowPorts = new Set();
-    for (const port of [...document.inputs, ...document.outputs]) {
-        if (typeof port.id !== "string" || !port.id) {
-            throw new ValidationError("Workflow port 'id' is required and must be a non-empty string");
-        }
-        if (workflowPorts.has(port.id)) {
-            throw new ValidationError(`Workflow port '${port.id}' is declared more than once; workflow port ids must be unique`);
-        }
-        if (port.schema !== undefined && !isGraphValueSchema(port.schema)) {
-            throw new ValidationError(`Workflow port '${port.id}' schema must be a valid GraphValueSchema`);
-        }
-        workflowPorts.add(port.id);
-    }
-    const nestedContext = {
-        seen: [...context.seen, document],
-    };
-    const nodeIds = new Set();
-    for (const node of document.nodes) {
-        assertGraphNodeValid(node, nodeIds);
-    }
-    for (const node of document.nodes) {
-        if (node.loop) {
-            assertGraphLoopConfigurationValid(node, node.loop, nestedContext);
-        }
-    }
-    const edgeIds = new Set();
-    for (const edge of document.edges) {
-        assertGraphEdgeValid(edge, edgeIds);
-    }
-    for (const edge of document.edges) {
-        assertEdgeEndpoint(edge.source, document, workflowPorts, nodeIds, `Edge '${edge.id}' source`);
-        assertEdgeEndpoint(edge.target, document, workflowPorts, nodeIds, `Edge '${edge.id}' target`);
-    }
-    if (document.settings !== undefined && !isGraphJsonSafeValue(document.settings)) {
-        throw new ValidationError("Document settings must be JSON-safe (a map of JSON-safe values)");
-    }
-    if (document.metadata !== undefined && !isGraphJsonSafeValue(document.metadata)) {
-        throw new ValidationError("Document metadata must be JSON-safe: functions, class instances, undefined, NaN/Infinity, symbol keys, or unsafe prototype keys are not allowed");
-    }
-    if (document.ui !== undefined && !isGraphJsonSafeValue(document.ui)) {
-        throw new ValidationError("Document ui must be JSON-safe: functions, class instances, undefined, NaN/Infinity, symbol keys, or unsafe prototype keys are not allowed");
-    }
-}
-function describeDocument(document) {
-    const id = document?.["id"];
-    return typeof id === "string" ? id : "<unnamed document>";
-}
-function assertGraphNodeValid(node, nodeIds) {
-    if (typeof node.id !== "string" || !node.id) {
-        throw new ValidationError("Node 'id' is required and must be a non-empty string");
-    }
-    if (nodeIds.has(node.id)) {
-        throw new ValidationError(`Node id '${node.id}' is declared more than once; node ids must be unique`);
-    }
-    if (typeof node.kind !== "string" || !node.kind) {
-        throw new ValidationError(`Node '${node.id}' must declare a non-empty string 'kind'`);
-    }
-    if (node.parameters === undefined || node.parameters === null) {
-        throw new ValidationError(`Node '${node.id}' parameters must be present (an empty object when there are none)`);
-    }
-    nodeIds.add(node.id);
-    if (node.inputBindings) {
-        for (const [key, binding] of Object.entries(node.inputBindings)) {
-            if (isGraphUnsafeObjectKey(key)) {
-                throw new ValidationError(`Node '${node.id}' input binding key '${key}' is not allowed (unsafe prototype-pollutant key)`);
-            }
-            if (!isGraphInputBinding(binding)) {
-                throw new ValidationError(`Node '${node.id}' input binding for '${key}' must be a valid GraphInputBinding (edge, literal, or expression)`);
-            }
-            if (binding.mode === "literal" && !isGraphJsonSafeValue(binding.value)) {
-                throw new ValidationError(`Node '${node.id}' literal binding for '${key}' must contain JSON-safe values`);
-            }
-            if (binding.mode === "expression" && !binding.expression) {
-                throw new ValidationError(`Node '${node.id}' expression binding for '${key}' must contain a non-empty expression`);
-            }
-        }
-    }
-    if (node.outputBindings) {
-        for (const [key, binding] of Object.entries(node.outputBindings)) {
-            if (isGraphUnsafeObjectKey(key)) {
-                throw new ValidationError(`Node '${node.id}' output binding key '${key}' is not allowed (unsafe prototype-pollutant key)`);
-            }
-            if (!binding || typeof binding !== "object" || Array.isArray(binding)) {
-                throw new ValidationError(`Node '${node.id}' output binding for '${key}' must be an object with enabled and alias settings`);
-            }
-        }
-    }
-    if (!isGraphJsonSafeValue(node.parameters)) {
-        throw new ValidationError(`Node '${node.id}' parameters must be JSON-safe: functions, class instances, undefined, NaN/Infinity, symbol keys, or unsafe prototype keys are not allowed`);
-    }
-}
-function assertGraphLoopConfigurationValid(node, config, context) {
-    if (!config.body || typeof config.body !== "object") {
-        throw new ValidationError(`Node '${node.id}' loop configuration requires a body document`);
-    }
-    assertGraphWorkflowDocumentValid(config.body, context);
-    if (config.maxIterations !== undefined &&
-        (!Number.isFinite(config.maxIterations) || config.maxIterations <= 0)) {
-        throw new ValidationError(`Node '${node.id}' loop maxIterations must be a positive number`);
-    }
-    if (config.timeoutMs !== undefined &&
-        (typeof config.timeoutMs !== "number" || config.timeoutMs <= 0)) {
-        throw new ValidationError(`Node '${node.id}' loop timeoutMs must be a positive number in milliseconds`);
-    }
-    if (config.concurrency !== undefined &&
-        (typeof config.concurrency !== "number" || config.concurrency <= 0)) {
-        throw new ValidationError(`Node '${node.id}' loop concurrency must be a positive number`);
-    }
-    for (const mappings of [config.inputMappings, config.outputMappings]) {
-        if (!mappings)
-            continue;
-        for (const [key, reference] of Object.entries(mappings)) {
-            if (isGraphUnsafeObjectKey(key)) {
-                throw new ValidationError(`Node '${node.id}' loop mapping key '${key}' is not allowed (unsafe prototype-pollutant key)`);
-            }
-            assertGraphValueReferenceShape(reference, node.id, key);
-        }
-    }
-}
-function assertGraphValueReferenceShape(reference, nodeId, mappingKey) {
-    if (!reference || typeof reference !== "object") {
-        throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' must reference a workflow port, node port, literal, or expression`);
-    }
-    switch (reference.source) {
-        case "workflow":
-            if (typeof reference.port !== "string" || !reference.port) {
-                throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' referencing a workflow must reference a port identifier`);
-            }
-            break;
-        case "node":
-            if (typeof reference.nodeId !== "string" ||
-                !reference.nodeId ||
-                typeof reference.port !== "string" ||
-                !reference.port) {
-                throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' referencing a node must reference a node id and a port`);
-            }
-            break;
-        case "literal":
-            if (!isGraphJsonSafeValue(reference.value)) {
-                throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' literal references must be JSON-safe values`);
-            }
-            break;
-        case "expression":
-            if (typeof reference.expression !== "string" || !reference.expression) {
-                throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' expression references must be non-empty expressions`);
-            }
-            break;
-        default:
-            throw new ValidationError(`Node '${nodeId}' loop mapping '${mappingKey}' must use a workflow, node, literal, or expression reference source`);
-    }
-}
-function assertGraphEdgeValid(edge, edgeIds) {
-    if (typeof edge.id !== "string" || !edge.id) {
-        throw new ValidationError("Edge 'id' is required and must be a non-empty string");
-    }
-    if (edgeIds.has(edge.id)) {
-        throw new ValidationError(`Edge id '${edge.id}' is declared more than once; edge ids must be unique`);
-    }
-    if (!isGraphEndpoint(edge.source)) {
-        throw new ValidationError(`Edge '${edge.id}' source endpoint is not a valid GraphEndpoint`);
-    }
-    if (!isGraphEndpoint(edge.target)) {
-        throw new ValidationError(`Edge '${edge.id}' target endpoint is not a valid GraphEndpoint`);
-    }
-    if (edge.type !== "data" && edge.type !== "connection") {
-        throw new ValidationError(`Edge '${edge.id}' type '${String(edge.type)}' is not a valid edge type (data or connection are allowed)`);
-    }
-    edgeIds.add(edge.id);
-    if (!isGraphJsonSafeValue(edge)) {
-        throw new ValidationError(`Edge '${edge.id}' contains values that are not JSON-safe: functions, class instances, undefined, NaN/Infinity, symbol keys, or unsafe prototype keys are not allowed`);
-    }
-}
-function assertEdgeEndpoint(endpoint, document, workflowPorts, nodeIds, context) {
-    if (isGraphWorkflowEndpoint(endpoint)) {
-        if (!workflowPorts.has(endpoint.port)) {
-            throw new ValidationError(`${context} references workflow port '${endpoint.port}' which is not declared on the document`);
-        }
-        return;
-    }
-    if (isGraphNodeEndpoint(endpoint)) {
-        if (!nodeIds.has(endpoint.nodeId)) {
-            throw new ValidationError(`${context} references node '${endpoint.nodeId}' which is not part of the document`);
-        }
-        if (typeof endpoint.port !== "string" || !endpoint.port) {
-            throw new ValidationError(`${context} node endpoints must reference a non-empty port identifier`);
-        }
-    }
-}
-//# sourceMappingURL=GraphWorkflowDocumentBuilder.js.map

package/lib/esm/graph/document/GraphWorkflowDocumentBuilder.js.map

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

package/lib/esm/graph/document/GraphWorkflowDocumentReader.js

@@ -1,62 +0,0 @@
-import { isGraphUnsafeObjectKey } from "./GraphJsonValue.js";
-import { isGraphWorkflowDocumentShape } from "./GraphWorkflowDocument.js";
-export function graphWorkflowDocumentOf(value) {
-    if (!isGraphWorkflowDocumentShape(value))
-        return undefined;
-    return value;
-}
-export function graphWorkflowNodeOf(document, nodeId) {
-    return document?.nodes.find((node) => node.id === nodeId);
-}
-export function graphWorkflowEdgeOf(document, edgeId) {
-    return document?.edges.find((edge) => edge.id === edgeId);
-}
-export function graphWorkflowPortsOf(document) {
-    const inputs = document?.inputs ?? [];
-    const outputs = document?.outputs ?? [];
-    return { inputs, outputs };
-}
-export function graphWorkflowSettingsOf(document) {
-    return { ...(document?.settings ?? {}) };
-}
-export function graphWorkflowEdgesOf(document) {
-    return document?.edges ?? [];
-}
-export function graphWorkflowNodeEdgesOf(document, nodeId) {
-    return (document?.edges ?? []).filter((edge) => graphNodeEndpointId(edge.source) === nodeId || graphNodeEndpointId(edge.target) === nodeId);
-}
-export function graphNodeEndpointId(endpoint) {
-    if (endpoint && endpoint.scope === "node") {
-        return endpoint.nodeId;
-    }
-    return undefined;
-}
-export function graphWorkflowNodeUiOf(document, nodeId) {
-    return graphWorkflowNodeOf(document, nodeId)?.ui;
-}
-export function graphWorkflowUiOf(document) {
-    return document.ui ?? undefined;
-}
-export function graphWorkflowUiValueOf(document, key) {
-    const ui = graphWorkflowUiOf(document);
-    if (!ui || isGraphUnsafeObjectKey(key))
-        return undefined;
-    return ui[key];
-}
-export function graphWorkflowDocumentSettingOf(document, key) {
-    return hasSetting(document?.settings, key)
-        ? document.settings[key]
-        : undefined;
-}
-export function graphWorkflowDocumentMetadataValueOf(document, key) {
-    if (!document?.metadata ||
-        isGraphUnsafeObjectKey(key) ||
-        !(key in document.metadata)) {
-        return undefined;
-    }
-    return document.metadata[key];
-}
-function hasSetting(settings, key) {
-    return Boolean(settings) && !isGraphUnsafeObjectKey(key) && key in settings;
-}
-//# sourceMappingURL=GraphWorkflowDocumentReader.js.map

package/lib/esm/graph/document/GraphWorkflowDocumentReader.js.map

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

package/lib/esm/graph/document/GraphWorkflowDocumentSerializer.js

@@ -1,63 +0,0 @@
-import { ValidationError } from "@decaf-ts/db-decorators";
-import { isGraphJsonSafeValue } from "./GraphJsonValue.js";
-import { isGraphWorkflowDocumentShape } from "./GraphWorkflowDocument.js";
-import { assertGraphWorkflowDocumentValid } from "./GraphWorkflowDocumentBuilder.js";
-export function graphWorkflowDocumentSerializer(document) {
-    if (!isGraphWorkflowDocumentShape(document)) {
-        throw new ValidationError("Cannot serialize a graph workflow document: the value is not a canonical GraphWorkflowDocument shape");
-    }
-    try {
-        return JSON.stringify(document, null, 2);
-    }
-    catch (e) {
-        throw new ValidationError(`Cannot serialize graph workflow document '${document.id}': ${String(e)}`);
-    }
-}
-export function graphWorkflowDocumentDeserializer(serialised) {
-    let parsed;
-    try {
-        parsed = JSON.parse(serialised);
-    }
-    catch (e) {
-        throw new ValidationError(`Serialized graph workflow document is not valid JSON: ${String(e)}`);
-    }
-    if (!isGraphJsonSafeValue(parsed)) {
-        throw new ValidationError("Serialized graph workflow document contains JSON-unsafe values: functions, non-JSON objects, NaN/Infinity, symbol keys, unsafe prototype keys are rejected");
-    }
-    if (!isGraphWorkflowDocumentShape(parsed)) {
-        throw new ValidationError("Serialized graph workflow document is not shaped as a canonical GraphWorkflowDocument (id, name, inputs, outputs, nodes and edges are required)");
-    }
-    const document = parsed;
-    assertGraphWorkflowDocumentValid(document);
-    return document;
-}
-export function graphJsonSerializer(value, indentation) {
-    if (!isGraphJsonSafeValue(value)) {
-        throw new ValidationError("Cannot serialize a value: functions, class instances, undefined, NaN/Infinity, symbol keys, unsafe prototype keys, or cycles are not allowed");
-    }
-    try {
-        return JSON.stringify(value, null, indentation);
-    }
-    catch (e) {
-        throw new ValidationError(`Cannot serialize JSON-safe value: ${String(e)} (cycles and circular structures are not allowed inside graph JSON)`);
-    }
-}
-export function graphJsonParser(serialised) {
-    if (typeof serialised !== "string") {
-        if (typeof serialised === "object" && serialised !== null)
-            return serialised;
-        throw new ValidationError("Graph JSON parser accepts serialized strings (pass an object only when restoring a known-safe value)");
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(serialised);
-    }
-    catch (e) {
-        throw new ValidationError(`Serialized graph JSON is not valid JSON: ${String(e)}`);
-    }
-    if (!isGraphJsonSafeValue(parsed)) {
-        throw new ValidationError("Serialized graph JSON contains JSON-unsafe values: functions, non-JSON objects, NaN/Infinity, symbol keys, unsafe prototype keys are rejected");
-    }
-    return parsed;
-}
-//# sourceMappingURL=GraphWorkflowDocumentSerializer.js.map

package/lib/esm/graph/document/GraphWorkflowDocumentSerializer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphWorkflowDocumentSerializer.js","sourceRoot":"","sources":["../../../../src/graph/document/GraphWorkflowDocumentSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,4BAAyB;AAExD,OAAO,EAAE,4BAA4B,EAAE,mCAAgC;AACvE,OAAO,EAAE,gCAAgC,EAAE,0CAAuC;AAElF,MAAM,UAAU,+BAA+B,CAC7C,QAA+B;IAE/B,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,eAAe,CACvB,sGAAsG,CACvG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACvB,6CAA6C,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,UAAkB;IAElB,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACvB,yDAAyD,MAAM,CAAC,CAAC,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,eAAe,CACvB,4JAA4J,CAC7J,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,4BAA4B,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,eAAe,CACvB,iJAAiJ,CAClJ,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAA0C,CAAC;IAC5D,gCAAgC,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,WAAoB;IACtE,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,eAAe,CACvB,8IAA8I,CAC/I,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACvB,qCAAqC,MAAM,CAAC,CAAC,CAAC,qEAAqE,CACpH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAA4B;IAC1D,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,UAAU,CAAC;QAC7E,MAAM,IAAI,eAAe,CACvB,sGAAsG,CACvG,CAAC;IACJ,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACvB,4CAA4C,MAAM,CAAC,CAAC,CAAC,EAAE,CACxD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,eAAe,CACvB,+IAA+I,CAChJ,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/esm/graph/document/GraphWorkflowUiState.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=GraphWorkflowUiState.js.map

package/lib/esm/graph/document/GraphWorkflowUiState.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphWorkflowUiState.js","sourceRoot":"","sources":["../../../../src/graph/document/GraphWorkflowUiState.ts"],"names":[],"mappings":""}

package/lib/esm/graph/document/index.js

@@ -1,13 +0,0 @@
-export * from "./GraphDecoratedWorkflowCompiler.js";
-export * from "./GraphEdgeInstance.js";
-export * from "./GraphEndpoint.js";
-export * from "./GraphJsonValue.js";
-export * from "./GraphLoopConfiguration.js";
-export * from "./GraphNodeBinding.js";
-export * from "./GraphNodeInstance.js";
-export * from "./GraphWorkflowDocument.js";
-export * from "./GraphWorkflowDocumentBuilder.js";
-export * from "./GraphWorkflowDocumentReader.js";
-export * from "./GraphWorkflowDocumentSerializer.js";
-export * from "./GraphWorkflowUiState.js";
-//# sourceMappingURL=index.js.map

package/lib/esm/graph/document/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/graph/document/index.ts"],"names":[],"mappings":"AAAA,oDAAiD;AACjD,uCAAoC;AACpC,mCAAgC;AAChC,oCAAiC;AACjC,4CAAyC;AACzC,sCAAmC;AACnC,uCAAoC;AACpC,2CAAwC;AACxC,kDAA+C;AAC/C,iDAA8C;AAC9C,qDAAkD;AAClD,0CAAuC"}

package/lib/esm/graph/index.js

@@ -1,16 +0,0 @@
-import "./../overrides/index.js";
-import "./overrides/index.js";
-export * from "./constants.js";
-export * from "./decorators.js";
-export * from "./registry.js";
-export * from "./overrides/index.js";
-export * from "./snapshot.js";
-export * from "./reader.js";
-export * from "./document/index.js";
-export * from "./catalog/index.js";
-export * from "./types.js";
-export * from "./GraphExecutionStateMapper.js";
-export * from "./GraphResolution.js";
-export * from "./nodes/index.js";
-export * from "./overrides/index.js";
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graph/index.ts"],"names":[],"mappings":"AAAA,iCAAsB;AACtB,8BAAqB;AAErB,+BAA4B;AAC5B,gCAA6B;AAC7B,8BAA2B;AAC3B,qCAA4B;AAC5B,8BAA2B;AAC3B,4BAAyB;AACzB,oCAA2B;AAC3B,mCAA0B;AAC1B,2BAAwB;AACxB,+CAA4C;AAC5C,qCAAkC;AAClC,iCAAwB;AACxB,qCAA4B"}

package/lib/esm/graph/nodes/agents/agent.js

@@ -1,101 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-/**
- * @module ui-decorators/graph/nodes/agents/agent
- * @summary Production Agent node declaration.
- * @description The Agent node is the primary AI agent entrypoint. It is a
- * rectangular node with `@connection()` ports for its structural
- * dependencies: `model` (the LLM), `memory` (the memory store), and
- * `workspace` (the workspace/context). Connections are rendered on the
- * bottom side of the node (DECAF-32 §21.3). Each connection category has a
- * distinct color defined in the category style registry.
- *
- * The single `prompt` input accepts placeholder expressions (§22.4) such as
- * `{{ $input.brief }}` or `{{ $node["Research"].output.summary }}` that are
- * resolved at execution time by the placeholder compiler.
- */
-import { Model, model, required } from "@decaf-ts/decorator-validation";
-import { uielement } from "./../../../ui/decorators.js";
-import { connection, input, node, output } from "./../../decorators.js";
-// Ensure category styles are registered (idempotent).
-import "./../category-styles.js";
-/**
- * Agent node — an AI agent that orchestrates a model, memory, and workspace.
- *
- * The agent has:
- * - `@input` port on the **left**: `prompt` (the task prompt; supports
- *   placeholder expressions like `{{ $input.something }}` per §22.4).
- * - `@output` ports on the **right**: `response` (the agent's output), `actions`
- *   (any actions the agent decided to take).
- * - `@connection` ports on the **bottom**: `model` (LLM), `memory` (memory
- *   store), `workspace` (workspace/context). Each connection has a distinct
- *   category color.
- *
- * The node is rectangular (not rounded) to visually distinguish it from
- * regular processing nodes. The `color` and `icon` are omitted from `@node()`
- * so they are resolved from the `"Agent"` category style.
- */
-let AgentNode = class AgentNode extends Model {
-};
-__decorate([
-    required(),
-    uielement("textarea", {
-        label: "Prompt",
-        placeholder: "Enter task prompt. Supports placeholders like {{ $input.brief }} or {{ $node[\"Research\"].output.summary }}",
-    }),
-    input({ handle: "prompt" }),
-    __metadata("design:type", String)
-], AgentNode.prototype, "prompt", void 0);
-__decorate([
-    required(),
-    uielement("textarea", { label: "Response", placeholder: "Agent response" }),
-    output({ handle: "response" }),
-    __metadata("design:type", String)
-], AgentNode.prototype, "response", void 0);
-__decorate([
-    required(),
-    uielement("textarea", { label: "Actions", placeholder: "Actions taken by the agent" }),
-    output({ handle: "actions" }),
-    __metadata("design:type", Array)
-], AgentNode.prototype, "actions", void 0);
-__decorate([
-    connection({ category: "model", handle: "model" }),
-    __metadata("design:type", Object)
-], AgentNode.prototype, "model", void 0);
-__decorate([
-    connection({ category: "memory", handle: "memory" }),
-    __metadata("design:type", Object)
-], AgentNode.prototype, "memory", void 0);
-__decorate([
-    connection({ category: "workspace", handle: "workspace" }),
-    __metadata("design:type", Object)
-], AgentNode.prototype, "workspace", void 0);
-AgentNode = __decorate([
-    node("core.agent", {
-        kind: "core.agent",
-        category: "Agent",
-        // color and icon omitted — resolved from the "Agent" category style
-        width: 120,
-        height: 140,
-        labels: ["agent", "ai", "orchestrator"],
-        metadata: {
-            title: "Agent",
-            description: "AI agent that orchestrates a model, memory, and workspace to complete a task.",
-            shape: "rectangle",
-        },
-    }),
-    model()
-], AgentNode);
-export { AgentNode };
-/**
- * All built-in agent node constructors.
- */
-export const GRAPH_AGENT_NODES = [AgentNode];
-//# sourceMappingURL=agent.js.map

package/lib/esm/graph/nodes/agents/agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../../src/graph/nodes/agents/agent.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,oCAA+B;AACnD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,8BAAyB;AAEnE,sDAAsD;AACtD,iCAA4B;AAE5B;;;;;;;;;;;;;;;GAeG;AAgBI,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,KAAK;CAiCnC,CAAA;AAxBC;IANC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE;QACrB,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,8GAA8G;KAC5H,CAAC;IACD,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;;yCACZ;AAOhB;IAHC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAC3E,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;;2CACb;AAKlB;IAHC,QAAQ,EAAE;IACV,SAAS,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;IACtF,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;;0CACV;AAKpB;IADC,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;;wCACnC;AAGhB;IADC,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;;yCACpC;AAGjB;IADC,UAAU,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;;4CACvC;AAhCT,SAAS;IAfrB,IAAI,CAAC,YAAY,EAAE;QAClB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,OAAO;QACjB,oEAAoE;QACpE,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC;QACvC,QAAQ,EAAE;YACR,KAAK,EAAE,OAAO;YACd,WAAW,EACT,+EAA+E;YACjF,KAAK,EAAE,WAAW;SACnB;KACF,CAAC;IACD,KAAK,EAAE;GACK,SAAS,CAiCrB;;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,CAAU,CAAC"}

package/lib/esm/graph/nodes/base.js

@@ -1,31 +0,0 @@
-/**
- * @module ui-decorators/graph/nodes/base
- * @summary Base class for shared graph node declarations.
- * @description `GraphNode` extends `Model` with an overridable
- * `applyMetadata` static method. Concrete node kinds that support dynamic
- * metadata changes (e.g. `SwitchFlowNode` adding case output ports) override
- * this method to compute their own ports, size, and data patches — the node
- * is exclusively responsible for itself in every way.
- */
-import { Model } from "@decaf-ts/decorator-validation";
-export class GraphNode extends Model {
-    /**
-     * Applies a metadata patch to this node class, returning the resulting
-     * ports, size, and data patches.
-     *
-     * The default implementation returns `null` (no changes). Concrete node
-     * kinds that support dynamic metadata override this to compute their own
-     * ports and size from the metadata — the caller (renderer) simply relays
-     * the result to the diagram model.
-     *
-     * @param _meta - The metadata patch (node-kind-specific, e.g.
-     *   `SwitchNodeMetadata`).
-     * @returns The computed change, or `null` when the node kind does not
-     *   support dynamic metadata.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    static applyMetadata(_meta) {
-        return null;
-    }
-}
-//# sourceMappingURL=base.js.map