@decaf-ts/integrations 0.10.8 → 0.11.0

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

@@ -1,208 +0,0 @@
-/**
- * @module integrations/graph/engine/types
- * @summary Graph execution engine core types.
- * @description Engine-private type aliases and interfaces. Frontend-safe
- * types (`ExprValue`, `ConditionExpression`, `CodeCondition`,
- * `SwitchCaseCondition`, `SwitchCase`, `SwitchNodeMetadata`,
- * `NodeMetadataChange`, `GraphExecutionEvent`, `GraphExecutionErrorPayload`)
- * live in `@decaf-ts/ui-decorators/graph`; engine modules import shared
- * symbols from there and engine-private symbols from here.
- */
-import type { GraphCredentialReference, GraphJsonValue, GraphNodeInstance, GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import type { GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionStatus } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionErrorPayload, GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Unique identifier for a single graph execution run.
- */
-export type GraphRunId = string;
-/**
- * Identifier for a workflow definition.
- */
-export type GraphWorkflowId = string;
-/**
- * Identifier for a node within a workflow.
- */
-export type GraphNodeId = string;
-/**
- * Name of a port on a node or workflow boundary.
- */
-export type GraphPortName = string;
-/**
- * A bag of named values exchanged between nodes and the workflow boundary.
- */
-export type GraphExecutionValues = Record<string, unknown>;
-/**
- * Options that influence a single execution of a workflow.
- */
-export interface GraphExecutionOptions {
-    runId?: GraphRunId;
-    parentRunId?: GraphRunId;
-    workflowId?: GraphWorkflowId;
-    path?: string[];
-    concurrency?: number;
-    failFast?: boolean;
-    validateInputs?: boolean;
-    validateOutputs?: boolean;
-    maxLoopIterations?: number;
-    maxForeachIterations?: number;
-    usePinnedValues?: boolean;
-    writeThroughCache?: boolean;
-    metadata?: Record<string, unknown>;
-    abortSignal?: AbortSignal;
-}
-/**
- * Result of executing a single node.
- */
-export interface GraphNodeExecutionResult {
-    nodeId: GraphNodeId;
-    status: GraphExecutionStatus;
-    inputs: GraphExecutionValues;
-    outputs?: GraphExecutionValues;
-    error?: GraphExecutionErrorPayload;
-    startedAt: Date;
-    finishedAt?: Date;
-    fromCache?: boolean;
-    pinned?: boolean;
-    events: GraphExecutionEvent[];
-}
-/**
- * Result of executing an entire workflow.
- *
- * The executed source of truth is the canonical {@link GraphWorkflowDocument}
- * (never a decorated workflow definition).
- */
-export interface GraphExecutionResult {
-    runId: GraphRunId;
-    parentRunId?: GraphRunId;
-    workflowId: GraphWorkflowId;
-    status: GraphExecutionStatus;
-    document: GraphWorkflowDocument;
-    inputs: GraphExecutionValues;
-    outputs: GraphExecutionValues;
-    nodeResults: Record<GraphNodeId, GraphNodeExecutionResult>;
-    events: GraphExecutionEvent[];
-    startedAt: Date;
-    finishedAt?: Date;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Credential references resolved for a node execution (DECAF-50 §4.9/§4.16).
- * Documents carry references only; secret material never enters the request.
- */
-export type GraphResolvedCredentials = Record<string, GraphCredentialReference>;
-/**
- * Request passed to request-based node executors (DECAF-50 §4.9).
- * Configuration (`parameters`, `credentials`, `metadata`) and input data
- * (`inputs`) are separated.
- */
-export interface GraphNodeExecutionRequest {
-    nodeId: string;
-    kind: string;
-    inputs: GraphExecutionValues;
-    parameters: Record<string, GraphJsonValue>;
-    credentials: GraphResolvedCredentials;
-    metadata?: Record<string, GraphJsonValue>;
-}
-/**
- * Options used to construct a {@link GraphExecutionContext}.
- */
-export interface GraphExecutionContextOptions {
-    runId: GraphRunId;
-    parentRunId?: GraphRunId;
-    workflowId: GraphWorkflowId;
-    document: GraphWorkflowDocument;
-    node: GraphNodeInstance;
-    manifest: GraphResolvedNodeManifest;
-    path: string[];
-    metadata?: Record<string, unknown>;
-}
-/**
- * Metadata describing a loop node's behaviour.
- */
-export interface GraphLoopMetadata {
-    /** The nested loop-body workflow document (DECAF-50 §4.9). */
-    body: GraphWorkflowDocument;
-    maxIterations?: number;
-    timeoutMs?: number;
-    condition?: GraphConditionDefinition;
-    concurrency?: number;
-    inputPort?: string;
-    outputPort?: string;
-    itemPort?: string;
-    resultPort?: string;
-    statePort?: string;
-    /**
-     * How many items are taken from the input list per iteration (foreach only).
-     * Default `1`. When greater than `1`, the body receives a slice (array) on
-     * the item port and the collected result is one entry per slice.
-     */
-    slice?: number;
-}
-/**
- * Definition of a condition evaluated by the loop condition evaluator.
- *
- * When the condition object carries an `op` field (see {@link ConditionExpression}),
- * the {@link GraphConditionEvaluator} dispatches to the {@link ConditionExpressionEvaluator}
- * instead of the built-in `type`-based switch.
- */
-export interface GraphConditionDefinition {
-    type: "truthy" | "falsy" | "equals" | "notEquals" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "exists" | "custom";
-    left?: string;
-    right?: unknown;
-    evaluator?: string;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Pinning metadata attached to a node via `@pinnable()`.
- */
-export interface GraphPinningMetadata {
-    enabled: boolean;
-    ttlMs?: number;
-    strategy: "manual" | "automatic" | "disabled";
-    includeDependencies: boolean;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Options for pinning a node after a completed run.
- */
-export interface GraphPinNodeOptions {
-    document: GraphWorkflowDocument;
-    plan: unknown;
-    result: GraphExecutionResult;
-    nodeId: string;
-    includeDependencies?: boolean;
-    namespace?: string;
-}
-/**
- * Options for unpinning a node.
- */
-export interface GraphUnpinNodeOptions {
-    document: GraphWorkflowDocument;
-    nodeId: string;
-    fingerprint: string;
-    namespace?: string;
-}
-/**
- * A patch applied to a graph workflow snapshot after execution.
- */
-export interface GraphExecutionSnapshotPatch {
-    runId: string;
-    status: GraphExecutionStatus;
-    nodes: Record<string, {
-        status: GraphExecutionStatus;
-        startedAt?: string;
-        finishedAt?: string;
-        error?: GraphExecutionErrorPayload;
-        outputs?: Record<string, unknown>;
-        fromCache?: boolean;
-        pinned?: boolean;
-    }>;
-    edges: Record<string, {
-        status: GraphExecutionStatus;
-        lastValue?: unknown;
-        updatedAt: string;
-    }>;
-    outputs: Record<string, unknown>;
-    events: GraphExecutionEvent[];
-}

package/lib/types/graph/engine/validation/GraphConnectionPolicyValidator.d.cts

@@ -1,32 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphConnectionPolicyValidator
- * @summary Connection-policy validation (DECAF-50 §4.8 stage 6).
- * @description Enforces the connection policies declared on effective ports:
- * allowed/blocked node kinds, allowed port categories, connection counts
- * (`maxConnections`, `allowMultiple`), self-connections (`allowSelf`), and
- * conflicting duplicate edges.
- */
-import type { GraphValidationIssue } from "./GraphValidationIssue.d.cts";
-import type { GraphResolvedWorkflow } from "./GraphResolvedWorkflow.d.cts";
-/**
- * Validates connection policies and edge-level structural conflicts.
- */
-export declare class GraphConnectionPolicyValidator {
-    /**
-     * Stage 6 — connection policies and counts. Operates on the resolved
-     * workflow (stage 5 output). Records issues; never mutates the graph.
-     */
-    validate(workflow: Pick<GraphResolvedWorkflow, "edges" | "nodeById">, issues: GraphValidationIssue[]): void;
-    /**
-     * Conflicting duplicate edges: two edges with identical flattened
-     * endpoints (`source:port -> target:port`) are rejected, whatever their
-     * ids.
-     */
-    private validateDuplicates;
-    /**
-     * Port-declared connection policies: kind allow/block lists, port
-     * categories, self-connections, and connection counts.
-     */
-    private validatePolicies;
-    private validateEdgePolicy;
-}

package/lib/types/graph/engine/validation/GraphConnectionPolicyValidator.d.mts

@@ -1,32 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphConnectionPolicyValidator
- * @summary Connection-policy validation (DECAF-50 §4.8 stage 6).
- * @description Enforces the connection policies declared on effective ports:
- * allowed/blocked node kinds, allowed port categories, connection counts
- * (`maxConnections`, `allowMultiple`), self-connections (`allowSelf`), and
- * conflicting duplicate edges.
- */
-import type { GraphValidationIssue } from "./GraphValidationIssue.d.mts";
-import type { GraphResolvedWorkflow } from "./GraphResolvedWorkflow.d.mts";
-/**
- * Validates connection policies and edge-level structural conflicts.
- */
-export declare class GraphConnectionPolicyValidator {
-    /**
-     * Stage 6 — connection policies and counts. Operates on the resolved
-     * workflow (stage 5 output). Records issues; never mutates the graph.
-     */
-    validate(workflow: Pick<GraphResolvedWorkflow, "edges" | "nodeById">, issues: GraphValidationIssue[]): void;
-    /**
-     * Conflicting duplicate edges: two edges with identical flattened
-     * endpoints (`source:port -> target:port`) are rejected, whatever their
-     * ids.
-     */
-    private validateDuplicates;
-    /**
-     * Port-declared connection policies: kind allow/block lists, port
-     * categories, self-connections, and connection counts.
-     */
-    private validatePolicies;
-    private validateEdgePolicy;
-}

package/lib/types/graph/engine/validation/GraphCredentialReferenceValidator.d.cts

@@ -1,62 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphCredentialReferenceValidator
- * @summary Credential-reference authorization (DECAF-50 §4.8 stage 8).
- * @description Validates that credential references required by node
- * manifests exist, are authorized, and match the declared credential types,
- * and that plain credential secrets never appear in workflow documents.
- *
- * Existence/authorization checks run against a pluggable
- * {@link GraphCredentialAuthorizer} hook; server-side integrations wire the
- * real credential store into it (DECAF-50 §4.16). Without an authorizer,
- * shape and type-match validation still run — silent credential material in
- * documents is rejected unconditionally.
- */
-import type { GraphCredentialReference, GraphCredentialRequirement, GraphNodeInstance } from "@decaf-ts/ui-decorators/graph";
-import type { GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphValidationIssue } from "./GraphValidationIssue.d.cts";
-/**
- * Server-side hook resolving credential references.
- */
-export interface GraphCredentialAuthorizer {
-    /** Returns whether the referenced credential exists. */
-    hasCredential(reference: GraphCredentialReference): Promise<boolean> | boolean;
-    /** Returns whether the reference is authorized for the current context. */
-    authorize(reference: GraphCredentialReference, requirement?: GraphCredentialRequirement): Promise<boolean> | boolean;
-}
-/**
- * Validates credential references and the absence of plain secrets.
- */
-export declare class GraphCredentialReferenceValidator {
-    private readonly authorizer?;
-    constructor(authorizer?: GraphCredentialAuthorizer | undefined);
-    /**
-     * Stage 8 — credential-reference authorization for one resolved node.
-     */
-    validate(node: GraphNodeInstance, manifest: GraphResolvedNodeManifest, issues: GraphValidationIssue[], path: string): Promise<void>;
-    /**
-     * Collects the credential references carried by a node instance:
-     * credential-type parameter values and the `credentials` record in
-     * instance metadata.
-     */
-    private collectReferences;
-    private normalize;
-    private checkType;
-    /**
-     * Plain credential secrets must never appear in workflow documents: any
-     * parameter or metadata key on the secret deny-list is an issue at any
-     * nesting depth (objects and arrays are walked recursively with a depth
-     * cap and cycle guard), as is a credential reference object carrying
-     * extra material (e.g. a `secret` or `value` member).
-     */
-    private scanPlainSecrets;
-    /**
-     * Recursive worker for {@link scanPlainSecrets}: walks one parameter or
-     * metadata value, reporting a `credential.plain-secret` issue when the
-     * current path's key is on the deny-list, and recursing into objects and
-     * arrays otherwise (array items append a `[]` path segment). The
-     * {@link MAX_PLAIN_SECRET_SCAN_DEPTH} cap bounds the walk — deep enough
-     * for legitimate documents, and a guard against pathological/cyclic
-     * input — so nested deny-list keys are caught at any practical depth.
-     */
-    private scanPlainSecretValue;
-}

package/lib/types/graph/engine/validation/GraphCredentialReferenceValidator.d.mts

@@ -1,62 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphCredentialReferenceValidator
- * @summary Credential-reference authorization (DECAF-50 §4.8 stage 8).
- * @description Validates that credential references required by node
- * manifests exist, are authorized, and match the declared credential types,
- * and that plain credential secrets never appear in workflow documents.
- *
- * Existence/authorization checks run against a pluggable
- * {@link GraphCredentialAuthorizer} hook; server-side integrations wire the
- * real credential store into it (DECAF-50 §4.16). Without an authorizer,
- * shape and type-match validation still run — silent credential material in
- * documents is rejected unconditionally.
- */
-import type { GraphCredentialReference, GraphCredentialRequirement, GraphNodeInstance } from "@decaf-ts/ui-decorators/graph";
-import type { GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphValidationIssue } from "./GraphValidationIssue.d.mts";
-/**
- * Server-side hook resolving credential references.
- */
-export interface GraphCredentialAuthorizer {
-    /** Returns whether the referenced credential exists. */
-    hasCredential(reference: GraphCredentialReference): Promise<boolean> | boolean;
-    /** Returns whether the reference is authorized for the current context. */
-    authorize(reference: GraphCredentialReference, requirement?: GraphCredentialRequirement): Promise<boolean> | boolean;
-}
-/**
- * Validates credential references and the absence of plain secrets.
- */
-export declare class GraphCredentialReferenceValidator {
-    private readonly authorizer?;
-    constructor(authorizer?: GraphCredentialAuthorizer | undefined);
-    /**
-     * Stage 8 — credential-reference authorization for one resolved node.
-     */
-    validate(node: GraphNodeInstance, manifest: GraphResolvedNodeManifest, issues: GraphValidationIssue[], path: string): Promise<void>;
-    /**
-     * Collects the credential references carried by a node instance:
-     * credential-type parameter values and the `credentials` record in
-     * instance metadata.
-     */
-    private collectReferences;
-    private normalize;
-    private checkType;
-    /**
-     * Plain credential secrets must never appear in workflow documents: any
-     * parameter or metadata key on the secret deny-list is an issue at any
-     * nesting depth (objects and arrays are walked recursively with a depth
-     * cap and cycle guard), as is a credential reference object carrying
-     * extra material (e.g. a `secret` or `value` member).
-     */
-    private scanPlainSecrets;
-    /**
-     * Recursive worker for {@link scanPlainSecrets}: walks one parameter or
-     * metadata value, reporting a `credential.plain-secret` issue when the
-     * current path's key is on the deny-list, and recursing into objects and
-     * arrays otherwise (array items append a `[]` path segment). The
-     * {@link MAX_PLAIN_SECRET_SCAN_DEPTH} cap bounds the walk — deep enough
-     * for legitimate documents, and a guard against pathological/cyclic
-     * input — so nested deny-list keys are caught at any practical depth.
-     */
-    private scanPlainSecretValue;
-}

package/lib/types/graph/engine/validation/GraphDefinitionValidator.d.cts

@@ -1,23 +0,0 @@
-/**
- * @module integrations/graph/validation/GraphDefinitionValidator
- * @summary Legacy structural checks for decorated workflow definitions.
- * @description Kept for the §4.18 transition. Full workflow validation moved
- * to the nine-stage document gate ({@link GraphWorkflowDocumentValidator});
- * this shim only performs the cheap structural checks that do not require
- * catalogue resolution.
- */
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
-/**
- * Performs cheap structural checks on a legacy {@link GraphWorkflowDefinition}.
- *
- * @deprecated Validate canonical documents with
- *   {@link GraphWorkflowDocumentValidator} instead.
- */
-export declare class GraphDefinitionValidator {
-    /**
-     * Validates the workflow definition structure.
-     *
-     * @throws {GraphInputError} when the workflow has no name or duplicate node ids.
-     */
-    validate(workflow: GraphWorkflowDefinition): void;
-}

package/lib/types/graph/engine/validation/GraphDefinitionValidator.d.mts

@@ -1,23 +0,0 @@
-/**
- * @module integrations/graph/validation/GraphDefinitionValidator
- * @summary Legacy structural checks for decorated workflow definitions.
- * @description Kept for the §4.18 transition. Full workflow validation moved
- * to the nine-stage document gate ({@link GraphWorkflowDocumentValidator});
- * this shim only performs the cheap structural checks that do not require
- * catalogue resolution.
- */
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
-/**
- * Performs cheap structural checks on a legacy {@link GraphWorkflowDefinition}.
- *
- * @deprecated Validate canonical documents with
- *   {@link GraphWorkflowDocumentValidator} instead.
- */
-export declare class GraphDefinitionValidator {
-    /**
-     * Validates the workflow definition structure.
-     *
-     * @throws {GraphInputError} when the workflow has no name or duplicate node ids.
-     */
-    validate(workflow: GraphWorkflowDefinition): void;
-}

package/lib/types/graph/engine/validation/GraphEdgeInstanceValidator.d.cts

@@ -1,32 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphEdgeInstanceValidator
- * @summary Edge endpoint validation (DECAF-50 §4.8 stage 5).
- * @description Validates that edge endpoints exist (nodes, workflow ports,
- * and effective node ports), that source/target directions are valid, that
- * data and structural (connection) edges use compatible ports, and that
- * boundary routing is valid. Produces flattened
- * {@link GraphResolvedEdgeInstance}s for the planner.
- */
-import type { GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import type { GraphResolvedNodeInstance, GraphResolvedEdgeInstance } from "./GraphResolvedWorkflow.d.cts";
-import type { GraphValidationIssue } from "./GraphValidationIssue.d.cts";
-/**
- * Validates edge instances and resolves them into flattened plan edges.
- */
-export declare class GraphEdgeInstanceValidator {
-    /**
-     * Stage 5 — edge endpoints. Returns the resolved (flattened) edges for
-     * every structurally valid edge; invalid edges are skipped (issues
-     * recorded) so the planner only ever sees valid routing.
-     *
-     * Port existence/direction checks are skipped for nodes whose manifest
-     * policy allows undeclared parameters (transition placeholder kinds with
-     * no declared ports) — the catalogue is authoritative and those legacy
-     * registrations declare no port surface to check against.
-     */
-    resolveEdges(document: GraphWorkflowDocument, nodesById: Map<string, GraphResolvedNodeInstance>, issues: GraphValidationIssue[]): GraphResolvedEdgeInstance[];
-    private resolveEndpoint;
-    private validateDirectionAndType;
-    private hasPortDirection;
-    private pushPortIssue;
-}

package/lib/types/graph/engine/validation/GraphEdgeInstanceValidator.d.mts

@@ -1,32 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphEdgeInstanceValidator
- * @summary Edge endpoint validation (DECAF-50 §4.8 stage 5).
- * @description Validates that edge endpoints exist (nodes, workflow ports,
- * and effective node ports), that source/target directions are valid, that
- * data and structural (connection) edges use compatible ports, and that
- * boundary routing is valid. Produces flattened
- * {@link GraphResolvedEdgeInstance}s for the planner.
- */
-import type { GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import type { GraphResolvedNodeInstance, GraphResolvedEdgeInstance } from "./GraphResolvedWorkflow.d.mts";
-import type { GraphValidationIssue } from "./GraphValidationIssue.d.mts";
-/**
- * Validates edge instances and resolves them into flattened plan edges.
- */
-export declare class GraphEdgeInstanceValidator {
-    /**
-     * Stage 5 — edge endpoints. Returns the resolved (flattened) edges for
-     * every structurally valid edge; invalid edges are skipped (issues
-     * recorded) so the planner only ever sees valid routing.
-     *
-     * Port existence/direction checks are skipped for nodes whose manifest
-     * policy allows undeclared parameters (transition placeholder kinds with
-     * no declared ports) — the catalogue is authoritative and those legacy
-     * registrations declare no port surface to check against.
-     */
-    resolveEdges(document: GraphWorkflowDocument, nodesById: Map<string, GraphResolvedNodeInstance>, issues: GraphValidationIssue[]): GraphResolvedEdgeInstance[];
-    private resolveEndpoint;
-    private validateDirectionAndType;
-    private hasPortDirection;
-    private pushPortIssue;
-}

package/lib/types/graph/engine/validation/GraphLooseNodeValidation.d.cts

@@ -1,21 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphLooseNodeValidation
- * @summary Loose-node validation (DECAF-50 §4.26 R2-3 item 8).
- * @description A node connected to nothing is a loose node and fails workflow
- * validation: every node instance must participate in at least one edge
- * (data or connection). The rule is shared by the execution gate
- * ({@link GraphWorkflowDocumentValidator}) and the persistence gate
- * ({@link validateGraphWorkflowDocumentAtBoundary}) so both start and save
- * reject a loose node. Nested loop-body documents are checked recursively.
- */
-import type { GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import type { GraphValidationIssue } from "./GraphValidationIssue.d.cts";
-/**
- * Records a `topology.loose-node` issue for every node instance that no edge
- * references, recursively across nested loop-body documents.
- *
- * @param document - The canonical workflow document to inspect.
- * @param issues - The accumulating issue list.
- * @param path - Dotted path prefix for reported issues.
- */
-export declare function collectLooseNodeIssues(document: GraphWorkflowDocument, issues: GraphValidationIssue[], path?: string): void;

package/lib/types/graph/engine/validation/GraphLooseNodeValidation.d.mts

@@ -1,21 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphLooseNodeValidation
- * @summary Loose-node validation (DECAF-50 §4.26 R2-3 item 8).
- * @description A node connected to nothing is a loose node and fails workflow
- * validation: every node instance must participate in at least one edge
- * (data or connection). The rule is shared by the execution gate
- * ({@link GraphWorkflowDocumentValidator}) and the persistence gate
- * ({@link validateGraphWorkflowDocumentAtBoundary}) so both start and save
- * reject a loose node. Nested loop-body documents are checked recursively.
- */
-import type { GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import type { GraphValidationIssue } from "./GraphValidationIssue.d.mts";
-/**
- * Records a `topology.loose-node` issue for every node instance that no edge
- * references, recursively across nested loop-body documents.
- *
- * @param document - The canonical workflow document to inspect.
- * @param issues - The accumulating issue list.
- * @param path - Dotted path prefix for reported issues.
- */
-export declare function collectLooseNodeIssues(document: GraphWorkflowDocument, issues: GraphValidationIssue[], path?: string): void;

package/lib/types/graph/engine/validation/GraphNodeInstanceValidator.d.cts

@@ -1,37 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphNodeInstanceValidator
- * @summary Kind resolution and dynamic-port validation (DECAF-50 §4.8 stages 2 and 4).
- * @description Stage 2 resolves every node instance against the trusted
- * backend catalogue (kind existence, effective manifest with expanded
- * dynamic ports, paired executor). Stage 4 validates that the effective
- * dynamic ports resolved consistently and that binding ids refer to
- * effective ports.
- */
-import type { GraphNodeInstance } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeCatalogue } from "../catalog/GraphNodeCatalogue.d.cts";
-import type { GraphNodeResolutionContext, GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphValidationIssue } from "./GraphValidationIssue.d.cts";
-import type { GraphResolvedNodeInstance } from "./GraphResolvedWorkflow.d.cts";
-/**
- * Resolves node instances against the backend catalogue and validates the
- * resolved dynamic-port surface.
- */
-export declare class GraphNodeInstanceValidator {
-    private readonly catalogue;
-    constructor(catalogue: GraphNodeCatalogue);
-    /**
-     * Stage 2 — kind resolution. Every node kind must exist in the backend
-     * catalogue; the effective manifest (with dynamic ports expanded from the
-     * instance parameters) and the paired executor are attached to the
-     * resolved node. Nodes that fail resolution are skipped (issues recorded)
-     * and never reach the planner.
-     */
-    resolveNodes(nodes: GraphNodeInstance[], issues: GraphValidationIssue[], resolutionContext?: GraphNodeResolutionContext): Promise<Map<string, GraphResolvedNodeInstance>>;
-    /**
-     * Stage 4 — dynamic ports and binding ids. Verifies that input/output
-     * binding ids refer to ports on the effective (dynamics-expanded) manifest
-     * surface, unless the manifest policy explicitly allows undeclared
-     * parameters (transition placeholder kinds).
-     */
-    validateEffectivePorts(node: GraphNodeInstance, manifest: GraphResolvedNodeManifest, issues: GraphValidationIssue[], path: string): void;
-}

package/lib/types/graph/engine/validation/GraphNodeInstanceValidator.d.mts

@@ -1,37 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphNodeInstanceValidator
- * @summary Kind resolution and dynamic-port validation (DECAF-50 §4.8 stages 2 and 4).
- * @description Stage 2 resolves every node instance against the trusted
- * backend catalogue (kind existence, effective manifest with expanded
- * dynamic ports, paired executor). Stage 4 validates that the effective
- * dynamic ports resolved consistently and that binding ids refer to
- * effective ports.
- */
-import type { GraphNodeInstance } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeCatalogue } from "../catalog/GraphNodeCatalogue.d.mts";
-import type { GraphNodeResolutionContext, GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphValidationIssue } from "./GraphValidationIssue.d.mts";
-import type { GraphResolvedNodeInstance } from "./GraphResolvedWorkflow.d.mts";
-/**
- * Resolves node instances against the backend catalogue and validates the
- * resolved dynamic-port surface.
- */
-export declare class GraphNodeInstanceValidator {
-    private readonly catalogue;
-    constructor(catalogue: GraphNodeCatalogue);
-    /**
-     * Stage 2 — kind resolution. Every node kind must exist in the backend
-     * catalogue; the effective manifest (with dynamic ports expanded from the
-     * instance parameters) and the paired executor are attached to the
-     * resolved node. Nodes that fail resolution are skipped (issues recorded)
-     * and never reach the planner.
-     */
-    resolveNodes(nodes: GraphNodeInstance[], issues: GraphValidationIssue[], resolutionContext?: GraphNodeResolutionContext): Promise<Map<string, GraphResolvedNodeInstance>>;
-    /**
-     * Stage 4 — dynamic ports and binding ids. Verifies that input/output
-     * binding ids refer to ports on the effective (dynamics-expanded) manifest
-     * surface, unless the manifest policy explicitly allows undeclared
-     * parameters (transition placeholder kinds).
-     */
-    validateEffectivePorts(node: GraphNodeInstance, manifest: GraphResolvedNodeManifest, issues: GraphValidationIssue[], path: string): void;
-}