@decaf-ts/ui-decorators 0.21.0 → 0.21.1

package/lib/esm/graph/reader.js

@@ -1,313 +0,0 @@
-import { Metadata } from "@decaf-ts/decoration";
-import { Model } from "@decaf-ts/decorator-validation";
-import { ValidationKeys } from "@decaf-ts/decorator-validation";
-import { UIKeys } from "./../ui/constants.js";
-import { GraphKeys, } from "./constants.js";
-import { PortDirection } from "./constants.js";
-import { resolveEffectiveColor, resolveEffectiveIcon } from "./constants.js";
-import "./../model/overrides.js";
-function resolveModel(model) {
-    const resolved = Metadata.constr(model);
-    if (typeof resolved === "function")
-        return resolved;
-    const fallback = model.constructor;
-    if (typeof fallback === "function")
-        return fallback;
-    return model;
-}
-function asString(value) {
-    if (value === undefined || value === null)
-        return undefined;
-    return typeof value === "string" ? value : String(value);
-}
-function pickLabel(element, prop, fallback) {
-    const elementLabel = asString(element?.props?.label ?? element?.props?.name);
-    return (elementLabel ??
-        asString(prop?.name) ??
-        fallback ??
-        "");
-}
-function resolveNestedModelConstructor(model, property, validation) {
-    // 1. Explicit `model` option on @input({ model: SomeSchema }) — survives
-    //    bundler tree-shaking because the class is referenced in the decorator
-    //    call, not just in TypeScript's __metadata("design:type", ...).
-    const graph = graphPortMetadataOf(model, property);
-    if (graph?.model && typeof graph.model === "function" && Model.isModel(graph.model)) {
-        return graph.model;
-    }
-    // 2. TypeScript design:type metadata (fragile — bundlers may replace with
-    //    Object when the class is tree-shaken).
-    const directType = Metadata.type(model, property);
-    if (typeof directType === "function" && Model.isModel(directType)) {
-        return directType;
-    }
-    const designTypes = (Metadata.getPropDesignTypes?.(model, property)?.designTypes ||
-        []);
-    for (const candidate of designTypes) {
-        if (typeof candidate === "function" && Model.isModel(candidate)) {
-            return candidate;
-        }
-    }
-    const customTypes = validation?.[ValidationKeys.TYPE]?.customTypes || [];
-    for (const candidate of customTypes) {
-        if (typeof candidate === "function" && Model.isModel(candidate)) {
-            return candidate;
-        }
-    }
-    return undefined;
-}
-function prefixGraphPortPath(port, prefix) {
-    const path = [prefix, port.path ?? port.property].filter(Boolean).join(".");
-    return {
-        ...port,
-        path,
-        children: port.children?.map((child) => prefixGraphPortPath(child, path)),
-    };
-}
-export function graphNodeMetadataOf(model) {
-    const resolved = resolveModel(model);
-    return Metadata.get(resolved, GraphKeys.NODE);
-}
-export function graphWorkflowMetadataOf(model) {
-    const resolved = resolveModel(model);
-    return Metadata.get(resolved, GraphKeys.GRAPH);
-}
-export function graphPortMetadataOf(model, property) {
-    const resolved = resolveModel(model);
-    return Metadata.get(resolved, Metadata.key(GraphKeys.PORT, String(property)));
-}
-export function graphPortDefinitionOf(model, property) {
-    return graphPortDefinitionOfInternal(resolveModel(model), String(property));
-}
-/**
- * Returns the flattened ports of a Schema-typed `@input` / `@output` property
- * (a "Schema port group"). The Schema's own `@input` / `@output` properties
- * whose direction matches `direction` are spliced into the result UNPREFIXED
- * (no `<schemaProp>.` prefix). The carrier property itself is not a port.
- *
- * Returns `undefined` when the property is not a Schema group (not
- * `graph.schema`, or not Schema-typed), so the caller falls back to the legacy
- * single-port / composite expansion path.
- */
-function schemaGroupPorts(resolved, propertyKey, direction, visited = new Set()) {
-    const graph = graphPortMetadataOf(resolved, propertyKey);
-    if (!graph?.schema)
-        return undefined;
-    const validation = Metadata.validationFor(resolved, propertyKey);
-    const nestedModel = resolveNestedModelConstructor(resolved, propertyKey, validation);
-    if (!nestedModel)
-        return undefined;
-    if (visited.has(nestedModel))
-        return []; // cycle guard — stop recursing
-    const nextVisited = new Set(visited);
-    nextVisited.add(resolved);
-    nextVisited.add(nestedModel);
-    const childPorts = graphPortsOfInternal(nestedModel, nextVisited);
-    return childPorts.filter((child) => child.direction === direction);
-}
-function graphPortDefinitionOfInternal(resolved, propertyKey, visited = new Set()) {
-    const graph = graphPortMetadataOf(resolved, propertyKey);
-    if (!graph)
-        return undefined;
-    // Schema port group (@input / @output on a Schema-typed property): the
-    // carrier is not a port — its Schema's matching-direction ports are spliced
-    // into the parent by graphPortsOfInternal. The singular reader returns
-    // undefined for the carrier.
-    const validation = Metadata.validationFor(resolved, propertyKey);
-    const nestedModel = resolveNestedModelConstructor(resolved, propertyKey, validation);
-    if (graph.schema && nestedModel)
-        return undefined;
-    const element = (Model.uiElementOf(resolved, propertyKey) ||
-        undefined);
-    const uiProp = Model.uiDecorationOf(resolved, propertyKey, UIKeys.PROP);
-    const designType = Metadata.type(resolved, propertyKey);
-    const typeName = asString(validation?.[ValidationKeys.TYPE]?.customTypes?.[0]?.name ??
-        element?.props?.type ??
-        uiProp?.type ??
-        designType?.name);
-    const shouldExpand = !!graph.expand || (!!nestedModel && !visited.has(nestedModel));
-    const children = shouldExpand && nestedModel
-        ? (() => {
-            const nextVisited = new Set(visited);
-            nextVisited.add(resolved);
-            nextVisited.add(nestedModel);
-            return graphPortsOfInternal(nestedModel, nextVisited).map((child) => prefixGraphPortPath(child, propertyKey));
-        })()
-        : undefined;
-    return {
-        property: propertyKey,
-        path: propertyKey,
-        direction: graph.direction,
-        name: propertyKey,
-        label: pickLabel(element, uiProp, propertyKey),
-        type: typeName?.toLowerCase(),
-        required: !!validation?.[ValidationKeys.REQUIRED],
-        hidden: !!Model.uiIsHidden(resolved, propertyKey),
-        designType: designType?.name,
-        element,
-        prop: uiProp,
-        validation,
-        graph,
-        connectionRules: graph.connectionRules,
-        composite: !!children?.length,
-        children,
-        model: nestedModel?.name,
-    };
-}
-export function graphPortsOf(model) {
-    return graphPortsOfInternal(resolveModel(model));
-}
-function graphPortsOfInternal(resolved, visited = new Set()) {
-    const properties = Metadata.properties(resolved) || [];
-    const result = [];
-    for (const property of properties) {
-        const key = String(property);
-        const graph = graphPortMetadataOf(resolved, key);
-        // Schema port group: splice the Schema's matching-direction ports
-        // (unprefixed) instead of emitting the carrier.
-        if (graph?.schema) {
-            const groupPorts = schemaGroupPorts(resolved, key, graph.direction, visited);
-            if (groupPorts) {
-                result.push(...groupPorts);
-                continue;
-            }
-        }
-        const port = graphPortDefinitionOfInternal(resolved, key, visited);
-        if (port)
-            result.push(port);
-    }
-    return result;
-}
-export function graphLeafPortsOf(ports) {
-    return ports.flatMap((port) => port.children && port.children.length ? graphLeafPortsOf(port.children) : [port]);
-}
-export function graphWorkflowInputLeafPortsOf(model) {
-    return graphLeafPortsOf(graphWorkflowDefinitionOf(model).inputs);
-}
-export function graphWorkflowOutputLeafPortsOf(model) {
-    return graphLeafPortsOf(graphWorkflowDefinitionOf(model).outputs);
-}
-export function graphDefinitionOf(model) {
-    const resolved = resolveModel(model);
-    const ui = Model.uiModelOf(resolved);
-    const graph = graphNodeMetadataOf(resolved) || {};
-    const tag = ui?.tag || resolved.name;
-    const ports = graphPortsOf(resolved);
-    const portGroups = resolvePortGroups(resolved, graph);
-    return {
-        name: resolved.name,
-        tag,
-        kind: graph.kind || tag,
-        category: graph.category,
-        color: graph.color,
-        effectiveColor: resolveEffectiveColor(graph.color, graph.category),
-        group: graph.group,
-        height: graph.height,
-        icon: graph.icon,
-        effectiveIcon: resolveEffectiveIcon(graph.icon, graph.category),
-        labels: graph.labels || [],
-        maxChildren: graph.maxChildren,
-        minWidth: graph.minWidth,
-        width: graph.width,
-        shape: graph.shape,
-        cornerRadius: graph.cornerRadius,
-        sizeRules: graph.sizeRules,
-        props: ui?.props,
-        ui,
-        graph,
-        ports,
-        portGroups,
-    };
-}
-/**
- * Builds the effective `portGroups` list for a node: starts from the declared
- * `GraphNodeMetadata.portGroups` and ensures every Schema-typed `@input` /
- * `@output` property not explicitly listed gets a default
- * `{ property, toggle: "all" }` entry. Non-Schema-typed `@input` / `@output`
- * properties are not groups and are ignored.
- */
-function resolvePortGroups(resolved, graph) {
-    const declared = graph.portGroups || [];
-    const declaredByProperty = new Map(declared.map((g) => [g.property, g]));
-    const groups = [];
-    const properties = Metadata.properties(resolved) || [];
-    for (const property of properties) {
-        const key = String(property);
-        const portMeta = graphPortMetadataOf(resolved, key);
-        if (!portMeta?.schema)
-            continue;
-        const validation = Metadata.validationFor(resolved, key);
-        const nestedModel = resolveNestedModelConstructor(resolved, key, validation);
-        if (!nestedModel)
-            continue; // not Schema-typed — not a group
-        const declaredGroup = declaredByProperty.get(key);
-        groups.push(declaredGroup
-            ? { ...declaredGroup, toggle: declaredGroup.toggle ?? "all" }
-            : { property: key, toggle: "all" });
-    }
-    // also keep declared groups that don't correspond to a Schema property
-    // (defensive — lets callers carry labels for future groups)
-    for (const g of declared) {
-        if (!groups.some((x) => x.property === g.property))
-            groups.push(g);
-    }
-    return groups.length ? groups : undefined;
-}
-/**
- * Detects an already-resolved {@link GraphWorkflowDefinition} — the plain-object
- * shape returned by {@link graphWorkflowDefinitionOf}, as opposed to a decorated
- * workflow class or model instance.
- *
- * Resolved definitions are values, not models: `resolveModel` maps them to
- * `Object`, so without this guard `graphWorkflowDefinitionOf` would rebuild an
- * empty definition and silently drop `nodes`/`relations`. Loop bodies already
- * resolved by the caller (e.g. `for-angular`'s `metadata.loop.body`) rely on
- * this round-trip.
- */
-export function isGraphWorkflowDefinition(value) {
-    if (!value || typeof value !== "object")
-        return false;
-    const candidate = value;
-    return (typeof candidate.kind === "string" &&
-        Array.isArray(candidate.nodes) &&
-        Array.isArray(candidate.relations) &&
-        Array.isArray(candidate.inputs) &&
-        Array.isArray(candidate.outputs) &&
-        !!candidate.workflow &&
-        typeof candidate.workflow === "object");
-}
-export function graphWorkflowDefinitionOf(model) {
-    if (isGraphWorkflowDefinition(model))
-        return model;
-    const resolved = resolveModel(model);
-    const workflow = graphWorkflowMetadataOf(resolved) || {};
-    const node = graphDefinitionOf(resolved);
-    const inputs = workflow.inputs ||
-        node.ports.filter((port) => port.direction === PortDirection.INPUT);
-    const outputs = workflow.outputs ||
-        node.ports.filter((port) => port.direction === PortDirection.OUTPUT);
-    const connections = workflow.connections ||
-        node.ports.filter((port) => port.direction === PortDirection.CONNECTION);
-    return {
-        ...node,
-        kind: workflow.kind || node.kind,
-        category: workflow.category ?? node.category,
-        color: workflow.color ?? node.color,
-        effectiveColor: resolveEffectiveColor(workflow.color ?? node.color, workflow.category ?? node.category),
-        group: workflow.group ?? node.group,
-        height: workflow.height ?? node.height,
-        icon: workflow.icon ?? node.icon,
-        effectiveIcon: resolveEffectiveIcon(workflow.icon ?? node.icon, workflow.category ?? node.category),
-        labels: workflow.labels || node.labels,
-        maxChildren: workflow.maxChildren ?? node.maxChildren,
-        minWidth: workflow.minWidth ?? node.minWidth,
-        width: workflow.width ?? node.width,
-        inputs,
-        outputs,
-        connections,
-        nodes: workflow.nodes || [],
-        relations: workflow.relations || [],
-        workflow,
-    };
-}
-//# sourceMappingURL=reader.js.map

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

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

package/lib/esm/graph/registry.js

@@ -1,59 +0,0 @@
-/**
- * @module ui-decorators/graph/registry
- * @summary Node and workflow class registries.
- * @description Module-level registries that track every `@node`-decorated and
- * `@graph`-decorated constructor. The `@node` and `@graph` decorators call
- * {@link registerNode} / {@link registerWorkflow} as a side-effect; consumers
- * discover all decorated classes via {@link graphNodes} / {@link graphWorkflows}
- * or the `Metadata.nodes()` / `Metadata.workflows()` accessors.
- *
- * This follows the same pattern as `Injectables` (`injectable-decorators`)
- * which maintains its own `InjectablesRegistry` rather than using the private
- * `Metadata.innerGet`/`innerSet` helpers.
- */
-/**
- * Internal registry of all `@node`-decorated constructors.
- */
-const NODE_REGISTRY = new Set();
-/**
- * Internal registry of all `@graph`-decorated constructors.
- */
-const WORKFLOW_REGISTRY = new Set();
-/**
- * Appends a constructor to the node registry. Called by the `@node` decorator.
- * Idempotent — re-decorating the same class does not duplicate the entry.
- * @param ctor The `@node`-decorated constructor.
- */
-export function registerNode(ctor) {
-    NODE_REGISTRY.add(ctor);
-}
-/**
- * Appends a constructor to the workflow registry. Called by the `@graph`
- * decorator. Idempotent.
- * @param ctor The `@graph`-decorated constructor.
- */
-export function registerWorkflow(ctor) {
-    WORKFLOW_REGISTRY.add(ctor);
-}
-/**
- * Returns all `@node`-decorated constructors.
- * @returns A fresh array of constructors (mutable; does not expose the internal set).
- */
-export function graphNodes() {
-    return [...NODE_REGISTRY];
-}
-/**
- * Returns all `@graph`-decorated constructors.
- * @returns A fresh array of constructors.
- */
-export function graphWorkflows() {
-    return [...WORKFLOW_REGISTRY];
-}
-/**
- * Clears both registries. Intended for tests only.
- */
-export function resetGraphRegistries() {
-    NODE_REGISTRY.clear();
-    WORKFLOW_REGISTRY.clear();
-}
-//# sourceMappingURL=registry.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/graph/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;GAEG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAe,CAAC;AAE7C;;GAEG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAe,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAiB;IAC5C,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,aAAa,CAAC,KAAK,EAAE,CAAC;IACtB,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/lib/esm/graph/snapshot.js

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

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

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

package/lib/esm/graph/types.js

@@ -1,2 +0,0 @@
-export { PortDirection } from "./constants.js";
-//# sourceMappingURL=types.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/graph/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,uBAAoB"}

package/lib/types/graph/GraphExecutionStateMapper.d.cts

@@ -1,66 +0,0 @@
-/**
- * @module ui-decorators/graph/GraphExecutionStateMapper
- * @summary Maps engine state to the frontend-safe visual-state contract.
- * @description Pure, engine-agnostic helpers that derive
- * `GraphVisualState` values from engine execution signals. Frontend
- * bundles may import this from `@decaf-ts/ui-decorators/graph` (no
- * engine runtime dependency); a future Mastra/NestJS driver maps its own
- * runtime states onto `GraphVisualState` with the same rules.
- */
-import type { GraphExecutionEvent } from "./types.d.cts";
-import { GraphExecutionStatus, GraphVisualState } from "./constants.d.cts";
-/**
- * Maps an engine execution `GraphExecutionStatus` to the shared visual
- * state. `CACHED` collapses onto `GraphVisualState.SUCCEEDED` for
- * rendering; `CANCELLED`/`PENDING`/`PLANNING` yield `IDLE`.
- *
- * @param status - The engine execution status, if any.
- * @returns The visual state for the node/edge.
- */
-export declare function mapExecutionStatus(status?: GraphExecutionStatus): GraphVisualState;
-/**
- * Options describing a single node's position within a run (DECAF-48 §4.4).
- */
-export interface GraphVisualStateDerivation {
-    /** Whether the node has already executed (any terminal engine status). */
-    executed: boolean;
-    /** Whether the node is currently running. */
-    running: boolean;
-    /** Whether the node completed successfully (or from cache). */
-    succeeded?: boolean;
-    /** Whether the node failed. */
-    failed?: boolean;
-    /** Number of incoming edges that have completed value routing. */
-    completedUpstreams?: number;
-    /** Total number of incoming edges for the node. */
-    upstreamCount?: number;
-    /** Whether the node is reachable from the workflow inputs in the plan. */
-    reachable?: boolean;
-    /** Whether the whole run has failed (unexecuted nodes then fade/disable). */
-    runFailed?: boolean;
-}
-/**
- * Derives the visual state for one node from its execution signals.
- *
- * Rules (DECAF-48 §4.4 / Req-5/Req-6):
- * - currently running → `GraphVisualState.RUNNING`
- * - failed → `GraphVisualState.FAILED`
- * - executed and succeeded (or from cache) → `GraphVisualState.SUCCEEDED`
- * - unexecuted and reachable with incomplete upstream deps → `GraphVisualState.BLOCKED`
- * - unexecuted with `runFailed` → `GraphVisualState.SKIPPED` (faded/disabled)
- * - otherwise → `GraphVisualState.IDLE`
- *
- * @param options - The node execution signals.
- * @returns The derived visual state.
- */
-export declare function deriveNodeVisualState(options: GraphVisualStateDerivation): GraphVisualState;
-/**
- * Translates a `GraphExecutionEvent` into a node visual state when the
- * event carries enough information. Used by contract conformance checks and
- * engine-agnostic consumers that derive state from the shared event stream.
- *
- * @param event - The graph execution event.
- * @returns The corresponding `GraphVisualState`, or `IDLE` when the
- * event does not indicate a specific visual transition.
- */
-export declare function visualStateOfEvent(event: GraphExecutionEvent): GraphVisualState;

package/lib/types/graph/GraphExecutionStateMapper.d.mts

@@ -1,66 +0,0 @@
-/**
- * @module ui-decorators/graph/GraphExecutionStateMapper
- * @summary Maps engine state to the frontend-safe visual-state contract.
- * @description Pure, engine-agnostic helpers that derive
- * `GraphVisualState` values from engine execution signals. Frontend
- * bundles may import this from `@decaf-ts/ui-decorators/graph` (no
- * engine runtime dependency); a future Mastra/NestJS driver maps its own
- * runtime states onto `GraphVisualState` with the same rules.
- */
-import type { GraphExecutionEvent } from "./types.d.mts";
-import { GraphExecutionStatus, GraphVisualState } from "./constants.d.mts";
-/**
- * Maps an engine execution `GraphExecutionStatus` to the shared visual
- * state. `CACHED` collapses onto `GraphVisualState.SUCCEEDED` for
- * rendering; `CANCELLED`/`PENDING`/`PLANNING` yield `IDLE`.
- *
- * @param status - The engine execution status, if any.
- * @returns The visual state for the node/edge.
- */
-export declare function mapExecutionStatus(status?: GraphExecutionStatus): GraphVisualState;
-/**
- * Options describing a single node's position within a run (DECAF-48 §4.4).
- */
-export interface GraphVisualStateDerivation {
-    /** Whether the node has already executed (any terminal engine status). */
-    executed: boolean;
-    /** Whether the node is currently running. */
-    running: boolean;
-    /** Whether the node completed successfully (or from cache). */
-    succeeded?: boolean;
-    /** Whether the node failed. */
-    failed?: boolean;
-    /** Number of incoming edges that have completed value routing. */
-    completedUpstreams?: number;
-    /** Total number of incoming edges for the node. */
-    upstreamCount?: number;
-    /** Whether the node is reachable from the workflow inputs in the plan. */
-    reachable?: boolean;
-    /** Whether the whole run has failed (unexecuted nodes then fade/disable). */
-    runFailed?: boolean;
-}
-/**
- * Derives the visual state for one node from its execution signals.
- *
- * Rules (DECAF-48 §4.4 / Req-5/Req-6):
- * - currently running → `GraphVisualState.RUNNING`
- * - failed → `GraphVisualState.FAILED`
- * - executed and succeeded (or from cache) → `GraphVisualState.SUCCEEDED`
- * - unexecuted and reachable with incomplete upstream deps → `GraphVisualState.BLOCKED`
- * - unexecuted with `runFailed` → `GraphVisualState.SKIPPED` (faded/disabled)
- * - otherwise → `GraphVisualState.IDLE`
- *
- * @param options - The node execution signals.
- * @returns The derived visual state.
- */
-export declare function deriveNodeVisualState(options: GraphVisualStateDerivation): GraphVisualState;
-/**
- * Translates a `GraphExecutionEvent` into a node visual state when the
- * event carries enough information. Used by contract conformance checks and
- * engine-agnostic consumers that derive state from the shared event stream.
- *
- * @param event - The graph execution event.
- * @returns The corresponding `GraphVisualState`, or `IDLE` when the
- * event does not indicate a specific visual transition.
- */
-export declare function visualStateOfEvent(event: GraphExecutionEvent): GraphVisualState;

package/lib/types/graph/GraphResolution.d.cts

@@ -1,53 +0,0 @@
-/**
- * @module ui-decorators/graph/GraphResolution
- * @summary Shared graph manifest-resolution contracts.
- * @description Frontend/backend-shared manifest-resolution types (DECAF-50
- * §4.11): the effective per-node manifest shape consumed by the planner,
- * executor, and the frontend catalogue, plus its structural type guard and
- * the resolution/query contexts. Node/browser compatible — no engine
- * runtime dependency.
- */
-import type { GraphCredentialReference, GraphCredentialRequirement, GraphDynamicPortRule, GraphJsonValue, GraphNodeCapability, GraphNodeDisplayManifest, GraphNodePolicyManifest, GraphParameterDefinition, GraphPortManifest } from "./catalog/index.d.cts";
-/**
- * The effective manifest for one node instance (DECAF-50 §4.11): the
- * published manifest with dynamic ports expanded against the instance's
- * parameters. This is the shape the planner and executor consume — the only
- * input the nine-stage validator's resolved workflow carries per node.
- */
-export interface GraphResolvedNodeManifest {
-    /** Node kind. */
-    kind: string;
-    /** Display metadata (name, category, icon). */
-    display: GraphNodeDisplayManifest;
-    /** Effective input ports (static plus expanded dynamic). */
-    inputs: GraphPortManifest[];
-    /** Effective output ports (static plus expanded dynamic). */
-    outputs: GraphPortManifest[];
-    /** Effective connection ports, when any. */
-    connections?: GraphPortManifest[];
-    /** Declared parameters. */
-    parameters: GraphParameterDefinition[];
-    /** Dynamic-port rules the manifest declares, when any. */
-    dynamicPorts?: GraphDynamicPortRule[];
-    /** Credential requirements, when any. */
-    credentials?: GraphCredentialRequirement[];
-    /** Capabilities, when any. */
-    capabilities?: GraphNodeCapability[];
-    /** Execution policies, when declared. */
-    policies?: GraphNodePolicyManifest;
-    /** Free-form metadata. */
-    metadata?: Record<string, GraphJsonValue>;
-}
-/** Structural type guard for `GraphResolvedNodeManifest`. */
-export declare function isGraphResolvedNodeManifest(value: unknown): value is GraphResolvedNodeManifest;
-/** Context handed to manifest resolution for a node instance: authorized credentials plus caller metadata. */
-export interface GraphNodeResolutionContext {
-    credentials?: GraphCredentialReference[];
-    requestContext?: unknown;
-    metadata?: Record<string, GraphJsonValue>;
-}
-/** Filters for catalogue manifest listing: restrict results to the given display categories and/or kinds. */
-export interface GraphCatalogueQueryContext {
-    categories?: string[];
-    kinds?: string[];
-}

package/lib/types/graph/GraphResolution.d.mts

@@ -1,53 +0,0 @@
-/**
- * @module ui-decorators/graph/GraphResolution
- * @summary Shared graph manifest-resolution contracts.
- * @description Frontend/backend-shared manifest-resolution types (DECAF-50
- * §4.11): the effective per-node manifest shape consumed by the planner,
- * executor, and the frontend catalogue, plus its structural type guard and
- * the resolution/query contexts. Node/browser compatible — no engine
- * runtime dependency.
- */
-import type { GraphCredentialReference, GraphCredentialRequirement, GraphDynamicPortRule, GraphJsonValue, GraphNodeCapability, GraphNodeDisplayManifest, GraphNodePolicyManifest, GraphParameterDefinition, GraphPortManifest } from "./catalog/index.d.mts";
-/**
- * The effective manifest for one node instance (DECAF-50 §4.11): the
- * published manifest with dynamic ports expanded against the instance's
- * parameters. This is the shape the planner and executor consume — the only
- * input the nine-stage validator's resolved workflow carries per node.
- */
-export interface GraphResolvedNodeManifest {
-    /** Node kind. */
-    kind: string;
-    /** Display metadata (name, category, icon). */
-    display: GraphNodeDisplayManifest;
-    /** Effective input ports (static plus expanded dynamic). */
-    inputs: GraphPortManifest[];
-    /** Effective output ports (static plus expanded dynamic). */
-    outputs: GraphPortManifest[];
-    /** Effective connection ports, when any. */
-    connections?: GraphPortManifest[];
-    /** Declared parameters. */
-    parameters: GraphParameterDefinition[];
-    /** Dynamic-port rules the manifest declares, when any. */
-    dynamicPorts?: GraphDynamicPortRule[];
-    /** Credential requirements, when any. */
-    credentials?: GraphCredentialRequirement[];
-    /** Capabilities, when any. */
-    capabilities?: GraphNodeCapability[];
-    /** Execution policies, when declared. */
-    policies?: GraphNodePolicyManifest;
-    /** Free-form metadata. */
-    metadata?: Record<string, GraphJsonValue>;
-}
-/** Structural type guard for `GraphResolvedNodeManifest`. */
-export declare function isGraphResolvedNodeManifest(value: unknown): value is GraphResolvedNodeManifest;
-/** Context handed to manifest resolution for a node instance: authorized credentials plus caller metadata. */
-export interface GraphNodeResolutionContext {
-    credentials?: GraphCredentialReference[];
-    requestContext?: unknown;
-    metadata?: Record<string, GraphJsonValue>;
-}
-/** Filters for catalogue manifest listing: restrict results to the given display categories and/or kinds. */
-export interface GraphCatalogueQueryContext {
-    categories?: string[];
-    kinds?: string[];
-}

package/lib/types/graph/catalog/GraphConnectionPolicy.d.cts

@@ -1,9 +0,0 @@
-export interface GraphConnectionPolicy {
-    allowSelf?: boolean;
-    allowMultiple?: boolean;
-    allowedNodeKinds?: string[];
-    blockedNodeKinds?: string[];
-    allowedPortCategories?: string[];
-    maxConnections?: number;
-}
-export declare function isGraphConnectionPolicy(value: unknown): value is GraphConnectionPolicy;