@decaf-ts/integrations 0.10.8 → 0.12.0

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

@@ -1,162 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphWorkflowDocumentValidator
- * @summary Nine-stage backend workflow-document validation gate (DECAF-50 §4.8).
- * @description Validates a canonical {@link GraphWorkflowDocument} and, when
- * valid, resolves it into a backend-only {@link GraphResolvedWorkflow} — the
- * only input the {@link GraphExecutionPlanner} accepts. The nine stages run
- * in the EXACT normative order 1→9:
- *
- * 1. workflow structure (shape, JSON safety, unique ids, backend-enforced
- *    limits, forbidden definition/executor fields, recursive nested loop-body
- *    validation),
- * 2. kind resolution against the trusted backend catalogue,
- * 3. parameters (declared-ness, required presence, typing, metadata keys,
- *    disabled behavior, binding shapes),
- * 4. dynamic ports (binding ids refer to effective ports),
- * 5. edge endpoints (existence, direction, data/structural compatibility,
- *    boundary routing),
- * 6. connection policy (policies, counts, duplicates, self-connections),
- * 7. topology (acyclicity, binding satisfaction, required-value
- *    satisfiability),
- * 8. credential-reference authorization (existence, authorization, type
- *    match, no plain secrets),
- * 9. capability validation.
- *
- * Issues accumulate as structured {@link GraphValidationIssue}s — validation
- * never fails abruptly; a document with any issue is reported invalid and is
- * never resolved. Fail-fast consumers (the execution engine) throw
- * {@link GraphDocumentValidationError} on invalid results.
- */
-import type { GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeCatalogue } from "../catalog/GraphNodeCatalogue.d.cts";
-import type { GraphNodeResolutionContext } from "@decaf-ts/ui-decorators/graph";
-import type { GraphCredentialAuthorizer } from "./GraphCredentialReferenceValidator.d.cts";
-import type { GraphWorkflowValidationResult } from "./GraphValidationIssue.d.cts";
-import type { GraphResolvedWorkflow } from "./GraphResolvedWorkflow.d.cts";
-/**
- * Backend-enforced, configurable document resource limits (DECAF-50 §4.8).
- * Mirrors the persistence-boundary limits; every value is overridable.
- */
-export interface GraphWorkflowDocumentValidationLimits {
-    /** Maximum serialized size of the document in bytes. */
-    maxDocumentBytes?: number;
-    /** Maximum nested loop-body document depth (root document is depth 0). */
-    maxNestingDepth?: number;
-    /** Maximum node instances per document level. */
-    maxNodes?: number;
-    /** Maximum edge instances per document level. */
-    maxEdges?: number;
-}
-/**
- * Default resource limits (technical governance delegates the numbers to
- * implementation; these match the persistence boundary defaults).
- */
-export declare const DEFAULT_GRAPH_WORKFLOW_VALIDATION_LIMITS: Required<GraphWorkflowDocumentValidationLimits>;
-/**
- * Field keys that must never appear on a workflow document or any of its
- * structural records: client input resembling node definitions, executors,
- * authoritative ports, or frontend component definitions is rejected before
- * kind resolution (the planner must never see raw definitions).
- */
-export declare const GRAPH_DOCUMENT_FORBIDDEN_FIELD_KEYS: readonly string[];
-/**
- * Options controlling the nine-stage validation gate.
- */
-export interface GraphWorkflowDocumentValidatorOptions {
-    /** Trusted backend kind catalogue (required). */
-    catalogue: GraphNodeCatalogue;
-    /** Backend-enforced resource limits; defaults to {@link DEFAULT_GRAPH_WORKFLOW_VALIDATION_LIMITS}. */
-    limits?: GraphWorkflowDocumentValidationLimits;
-    /** Pluggable credential existence/authorization hook (DECAF-50 §4.16). */
-    credentialAuthorizer?: GraphCredentialAuthorizer;
-    /** Extra context passed to manifest resolution (credentials, request context). */
-    resolutionContext?: GraphNodeResolutionContext;
-    /**
-     * Transition leniency (§4.18): when `true`, a port with an incoming edge
-     * may also carry a literal binding. Defaults to `false` (conflicting
-     * literal+edge bindings are rejected).
-     */
-    allowLiteralAndEdgeBindings?: boolean;
-}
-/**
- * Returns `true` when the value structurally looks like a resolved workflow
- * (resolved node instances + resolved edges + lookup maps over a canonical
- * document). Used as the planner's runtime input guard.
- */
-export declare function isGraphResolvedWorkflow(value: unknown): value is GraphResolvedWorkflow;
-/**
- * The nine-stage backend validation gate (DECAF-50 §4.8).
- *
- * Usage: `const result = await validator.validate(document);` — inspect
- * `result.issues` (structured, in stage order) and `result.resolved` (present
- * only when valid). Use {@link GraphWorkflowDocumentValidator.validateOrThrow}
- * for the fail-fast engine path.
- */
-export declare class GraphWorkflowDocumentValidator {
-    private readonly options;
-    private readonly nodeValidator;
-    private readonly parameterValidator;
-    private readonly edgeValidator;
-    private readonly connectionPolicyValidator;
-    private readonly credentialValidator;
-    constructor(options: GraphWorkflowDocumentValidatorOptions);
-    /**
-     * Fail-fast variant of {@link validate}: resolves the document or throws
-     * {@link GraphDocumentValidationError} carrying every structured issue.
-     */
-    validateOrThrow(document: GraphWorkflowDocument): Promise<GraphResolvedWorkflow>;
-    /**
-     * Runs the nine validation stages in the exact normative order 1→9 and,
-     * when the document is fully valid, resolves it against the backend
-     * catalogue.
-     *
-     * @param document - The canonical workflow document to validate.
-     * @param depth - Current nesting depth (root is 0); enforced against
-     *   `limits.maxNestingDepth` and used to guard recursive loop-body
-     *   validation.
-     * @returns The validation result with accumulated issues and, when valid,
-     *   the resolved workflow.
-     */
-    validate(document: GraphWorkflowDocument, depth?: number): Promise<GraphWorkflowValidationResult>;
-    /**
-     * Stage 1 — document structure. Returns `true` when the document is
-     * structurally sound enough to continue (shape and JSON safety are
-     * hard preconditions); all other findings accumulate as issues.
-     */
-    private validateStructure;
-    /**
-     * Stage 1 — unique node, edge, workflow-input and workflow-output ids.
-     */
-    private validateUniqueIds;
-    /**
-     * Stage 1 — backend-enforced configurable limits: document size, nesting
-     * depth, node count, edge count.
-     */
-    private validateLimits;
-    /**
-     * Stage 1 — recursive nested-workflow validation. Every loop body runs
-     * through the full nine-stage gate; nested issues are merged with a path
-     * prefix identifying the owning loop node.
-     */
-    private validateNestedBodies;
-    /**
-     * Stage 7 — acyclicity (DECAF-32 preserved). Kahn's algorithm over the
-     * resolved executable nodes; connection and data edges both count as
-     * dependencies. Loop constructs are excepted because their bodies are
-     * separate nested documents, validated recursively.
-     */
-    private validateAcyclicity;
-    /**
-     * Stage 7 — required values must be satisfiable: every required workflow
-     * output port must be routable from at least one node output.
-     */
-    private validateRequiredWorkflowOutputs;
-    /**
-     * Stage 9 — capability validation. Declared manifest capabilities must be
-     * known values, and document features that require a capability may only be
-     * used on kinds declaring it (loop configuration requires the `loop`
-     * capability). Lenient transition manifests (legacy executor-only
-     * registrations) are exempt until cutover (§4.18).
-     */
-    private validateCapabilities;
-}

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

@@ -1,162 +0,0 @@
-/**
- * @module integrations/graph/engine/validation/GraphWorkflowDocumentValidator
- * @summary Nine-stage backend workflow-document validation gate (DECAF-50 §4.8).
- * @description Validates a canonical {@link GraphWorkflowDocument} and, when
- * valid, resolves it into a backend-only {@link GraphResolvedWorkflow} — the
- * only input the {@link GraphExecutionPlanner} accepts. The nine stages run
- * in the EXACT normative order 1→9:
- *
- * 1. workflow structure (shape, JSON safety, unique ids, backend-enforced
- *    limits, forbidden definition/executor fields, recursive nested loop-body
- *    validation),
- * 2. kind resolution against the trusted backend catalogue,
- * 3. parameters (declared-ness, required presence, typing, metadata keys,
- *    disabled behavior, binding shapes),
- * 4. dynamic ports (binding ids refer to effective ports),
- * 5. edge endpoints (existence, direction, data/structural compatibility,
- *    boundary routing),
- * 6. connection policy (policies, counts, duplicates, self-connections),
- * 7. topology (acyclicity, binding satisfaction, required-value
- *    satisfiability),
- * 8. credential-reference authorization (existence, authorization, type
- *    match, no plain secrets),
- * 9. capability validation.
- *
- * Issues accumulate as structured {@link GraphValidationIssue}s — validation
- * never fails abruptly; a document with any issue is reported invalid and is
- * never resolved. Fail-fast consumers (the execution engine) throw
- * {@link GraphDocumentValidationError} on invalid results.
- */
-import type { GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeCatalogue } from "../catalog/GraphNodeCatalogue.d.mts";
-import type { GraphNodeResolutionContext } from "@decaf-ts/ui-decorators/graph";
-import type { GraphCredentialAuthorizer } from "./GraphCredentialReferenceValidator.d.mts";
-import type { GraphWorkflowValidationResult } from "./GraphValidationIssue.d.mts";
-import type { GraphResolvedWorkflow } from "./GraphResolvedWorkflow.d.mts";
-/**
- * Backend-enforced, configurable document resource limits (DECAF-50 §4.8).
- * Mirrors the persistence-boundary limits; every value is overridable.
- */
-export interface GraphWorkflowDocumentValidationLimits {
-    /** Maximum serialized size of the document in bytes. */
-    maxDocumentBytes?: number;
-    /** Maximum nested loop-body document depth (root document is depth 0). */
-    maxNestingDepth?: number;
-    /** Maximum node instances per document level. */
-    maxNodes?: number;
-    /** Maximum edge instances per document level. */
-    maxEdges?: number;
-}
-/**
- * Default resource limits (technical governance delegates the numbers to
- * implementation; these match the persistence boundary defaults).
- */
-export declare const DEFAULT_GRAPH_WORKFLOW_VALIDATION_LIMITS: Required<GraphWorkflowDocumentValidationLimits>;
-/**
- * Field keys that must never appear on a workflow document or any of its
- * structural records: client input resembling node definitions, executors,
- * authoritative ports, or frontend component definitions is rejected before
- * kind resolution (the planner must never see raw definitions).
- */
-export declare const GRAPH_DOCUMENT_FORBIDDEN_FIELD_KEYS: readonly string[];
-/**
- * Options controlling the nine-stage validation gate.
- */
-export interface GraphWorkflowDocumentValidatorOptions {
-    /** Trusted backend kind catalogue (required). */
-    catalogue: GraphNodeCatalogue;
-    /** Backend-enforced resource limits; defaults to {@link DEFAULT_GRAPH_WORKFLOW_VALIDATION_LIMITS}. */
-    limits?: GraphWorkflowDocumentValidationLimits;
-    /** Pluggable credential existence/authorization hook (DECAF-50 §4.16). */
-    credentialAuthorizer?: GraphCredentialAuthorizer;
-    /** Extra context passed to manifest resolution (credentials, request context). */
-    resolutionContext?: GraphNodeResolutionContext;
-    /**
-     * Transition leniency (§4.18): when `true`, a port with an incoming edge
-     * may also carry a literal binding. Defaults to `false` (conflicting
-     * literal+edge bindings are rejected).
-     */
-    allowLiteralAndEdgeBindings?: boolean;
-}
-/**
- * Returns `true` when the value structurally looks like a resolved workflow
- * (resolved node instances + resolved edges + lookup maps over a canonical
- * document). Used as the planner's runtime input guard.
- */
-export declare function isGraphResolvedWorkflow(value: unknown): value is GraphResolvedWorkflow;
-/**
- * The nine-stage backend validation gate (DECAF-50 §4.8).
- *
- * Usage: `const result = await validator.validate(document);` — inspect
- * `result.issues` (structured, in stage order) and `result.resolved` (present
- * only when valid). Use {@link GraphWorkflowDocumentValidator.validateOrThrow}
- * for the fail-fast engine path.
- */
-export declare class GraphWorkflowDocumentValidator {
-    private readonly options;
-    private readonly nodeValidator;
-    private readonly parameterValidator;
-    private readonly edgeValidator;
-    private readonly connectionPolicyValidator;
-    private readonly credentialValidator;
-    constructor(options: GraphWorkflowDocumentValidatorOptions);
-    /**
-     * Fail-fast variant of {@link validate}: resolves the document or throws
-     * {@link GraphDocumentValidationError} carrying every structured issue.
-     */
-    validateOrThrow(document: GraphWorkflowDocument): Promise<GraphResolvedWorkflow>;
-    /**
-     * Runs the nine validation stages in the exact normative order 1→9 and,
-     * when the document is fully valid, resolves it against the backend
-     * catalogue.
-     *
-     * @param document - The canonical workflow document to validate.
-     * @param depth - Current nesting depth (root is 0); enforced against
-     *   `limits.maxNestingDepth` and used to guard recursive loop-body
-     *   validation.
-     * @returns The validation result with accumulated issues and, when valid,
-     *   the resolved workflow.
-     */
-    validate(document: GraphWorkflowDocument, depth?: number): Promise<GraphWorkflowValidationResult>;
-    /**
-     * Stage 1 — document structure. Returns `true` when the document is
-     * structurally sound enough to continue (shape and JSON safety are
-     * hard preconditions); all other findings accumulate as issues.
-     */
-    private validateStructure;
-    /**
-     * Stage 1 — unique node, edge, workflow-input and workflow-output ids.
-     */
-    private validateUniqueIds;
-    /**
-     * Stage 1 — backend-enforced configurable limits: document size, nesting
-     * depth, node count, edge count.
-     */
-    private validateLimits;
-    /**
-     * Stage 1 — recursive nested-workflow validation. Every loop body runs
-     * through the full nine-stage gate; nested issues are merged with a path
-     * prefix identifying the owning loop node.
-     */
-    private validateNestedBodies;
-    /**
-     * Stage 7 — acyclicity (DECAF-32 preserved). Kahn's algorithm over the
-     * resolved executable nodes; connection and data edges both count as
-     * dependencies. Loop constructs are excepted because their bodies are
-     * separate nested documents, validated recursively.
-     */
-    private validateAcyclicity;
-    /**
-     * Stage 7 — required values must be satisfiable: every required workflow
-     * output port must be routable from at least one node output.
-     */
-    private validateRequiredWorkflowOutputs;
-    /**
-     * Stage 9 — capability validation. Declared manifest capabilities must be
-     * known values, and document features that require a capability may only be
-     * used on kinds declaring it (loop configuration requires the `loop`
-     * capability). Lenient transition manifests (legacy executor-only
-     * registrations) are exempt until cutover (§4.18).
-     */
-    private validateCapabilities;
-}

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

@@ -1,20 +0,0 @@
-/**
- * @module integrations/graph/validation
- * @summary Graph validation utilities.
- * @description Re-exports the legacy definition/port/value validators plus
- * the DECAF-50 §4.8 nine-stage document validation gate, structured issues,
- * resolved-workflow types, and the normative validation error hierarchy.
- */
-export * from "./GraphDefinitionValidator.d.cts";
-export * from "./GraphPortSchemaResolver.d.cts";
-export * from "./GraphValueValidator.d.cts";
-export * from "./GraphValidationIssue.d.cts";
-export * from "./GraphValidationErrors.d.cts";
-export * from "./GraphResolvedWorkflow.d.cts";
-export * from "./GraphNodeInstanceValidator.d.cts";
-export * from "./GraphParameterValidator.d.cts";
-export * from "./GraphEdgeInstanceValidator.d.cts";
-export * from "./GraphConnectionPolicyValidator.d.cts";
-export * from "./GraphCredentialReferenceValidator.d.cts";
-export * from "./GraphWorkflowDocumentValidator.d.cts";
-export * from "./GraphLooseNodeValidation.d.cts";

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

@@ -1,20 +0,0 @@
-/**
- * @module integrations/graph/validation
- * @summary Graph validation utilities.
- * @description Re-exports the legacy definition/port/value validators plus
- * the DECAF-50 §4.8 nine-stage document validation gate, structured issues,
- * resolved-workflow types, and the normative validation error hierarchy.
- */
-export * from "./GraphDefinitionValidator.d.mts";
-export * from "./GraphPortSchemaResolver.d.mts";
-export * from "./GraphValueValidator.d.mts";
-export * from "./GraphValidationIssue.d.mts";
-export * from "./GraphValidationErrors.d.mts";
-export * from "./GraphResolvedWorkflow.d.mts";
-export * from "./GraphNodeInstanceValidator.d.mts";
-export * from "./GraphParameterValidator.d.mts";
-export * from "./GraphEdgeInstanceValidator.d.mts";
-export * from "./GraphConnectionPolicyValidator.d.mts";
-export * from "./GraphCredentialReferenceValidator.d.mts";
-export * from "./GraphWorkflowDocumentValidator.d.mts";
-export * from "./GraphLooseNodeValidation.d.mts";

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

@@ -1,12 +0,0 @@
-/**
- * @module integrations/graph
- * @summary Decaf Graph Execution Engine (backend convenience export).
- * @description Re-exports `./engine` (all engine modules). Backend consumers
- * import from `@decaf-ts/integrations/graph` and get a single unified surface.
- *
- * Frontend-safe shared declarations (node kinds, types, constants) live in
- * `@decaf-ts/ui-decorators/graph` — frontend bundles MUST import from there
- * to avoid pulling in the execution engine.
- */
-import "./log/LogParameters";
-export * from "./engine/index.d.cts";

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

@@ -1,12 +0,0 @@
-/**
- * @module integrations/graph
- * @summary Decaf Graph Execution Engine (backend convenience export).
- * @description Re-exports `./engine` (all engine modules). Backend consumers
- * import from `@decaf-ts/integrations/graph` and get a single unified surface.
- *
- * Frontend-safe shared declarations (node kinds, types, constants) live in
- * `@decaf-ts/ui-decorators/graph` — frontend bundles MUST import from there
- * to avoid pulling in the execution engine.
- */
-import "./log/LogParameters";
-export * from "./engine/index.d.mts";

package/lib/types/graph/log/GraphRunLogger.d.cts

@@ -1,76 +0,0 @@
-import type { Logger, LogMeta, StringLike } from "@decaf-ts/logging";
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Signature of the context's event emitter used to forward log entries onto
- * the existing graph execution Observable.
- */
-export type GraphLogForwardFn = (event: Partial<GraphExecutionEvent>) => Promise<void>;
-/**
- * Options for constructing a {@link GraphRunLogger}.
- */
-export interface GraphRunLoggerOptions {
-    runId: string;
-    workflowId: string;
-    nodeId: string;
-    user?: string | null;
-    /**
-     * Callback that forwards a structured log entry to the graph execution
-     * Observable (emits a `GRAPH_RUN_LOG` event). Errors are swallowed.
-     */
-    forward: GraphLogForwardFn;
-}
-/**
- * Logger used by graph node executors (`ctx.logger`).
- *
- * Wraps the shared MiniLogger pipeline so the DECAF-48 attributes render as
- * discrete custom attributes in the formatted output, and forwards each
- * structured entry through {@link GraphRunLoggerOptions.forward} so the SSE
- * log channel (`graph.run.log`) receives the level/message/attributes/
- * timestamp payload.
- */
-export declare class GraphRunLogger implements Logger {
-    private readonly inner;
-    private readonly baseOptions;
-    constructor(options: GraphRunLoggerOptions);
-    /**
-     * Produces the `Partial<LoggingConfig>` carrying the DECAF-48 attributes
-     * so the LogParameter descriptors render them (DECAF-9 §4.6).
-     */
-    private attributeConfig;
-    /** Emits a structured log entry synchronously (forward is fire-and-forget). */
-    private emit;
-    /** @inheritdoc */
-    benchmark(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    fatal(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    critical(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    silly(msg: StringLike, verbosity?: number | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    trace(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    verbose(msg: StringLike, verbosity?: number | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    info(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    error(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    warn(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    debug(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    action(action: string, meta?: LogMeta): void;
-    /** @inheritdoc */
-    action(action: string, code: number, meta?: LogMeta): void;
-    /** @inheritdoc */
-    setConfig(): void;
-    /** @inheritdoc */
-    for(_method?: string | ((...args: any[]) => any) | {
-        new (...args: any[]): any;
-    } | object | Partial<any>, _config?: Partial<any>, ..._args: any[]): this;
-    /** @inheritdoc */
-    clear(): this;
-    /** @inheritdoc */
-    get root(): string[];
-}

package/lib/types/graph/log/GraphRunLogger.d.mts

@@ -1,76 +0,0 @@
-import type { Logger, LogMeta, StringLike } from "@decaf-ts/logging";
-import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
-/**
- * Signature of the context's event emitter used to forward log entries onto
- * the existing graph execution Observable.
- */
-export type GraphLogForwardFn = (event: Partial<GraphExecutionEvent>) => Promise<void>;
-/**
- * Options for constructing a {@link GraphRunLogger}.
- */
-export interface GraphRunLoggerOptions {
-    runId: string;
-    workflowId: string;
-    nodeId: string;
-    user?: string | null;
-    /**
-     * Callback that forwards a structured log entry to the graph execution
-     * Observable (emits a `GRAPH_RUN_LOG` event). Errors are swallowed.
-     */
-    forward: GraphLogForwardFn;
-}
-/**
- * Logger used by graph node executors (`ctx.logger`).
- *
- * Wraps the shared MiniLogger pipeline so the DECAF-48 attributes render as
- * discrete custom attributes in the formatted output, and forwards each
- * structured entry through {@link GraphRunLoggerOptions.forward} so the SSE
- * log channel (`graph.run.log`) receives the level/message/attributes/
- * timestamp payload.
- */
-export declare class GraphRunLogger implements Logger {
-    private readonly inner;
-    private readonly baseOptions;
-    constructor(options: GraphRunLoggerOptions);
-    /**
-     * Produces the `Partial<LoggingConfig>` carrying the DECAF-48 attributes
-     * so the LogParameter descriptors render them (DECAF-9 §4.6).
-     */
-    private attributeConfig;
-    /** Emits a structured log entry synchronously (forward is fire-and-forget). */
-    private emit;
-    /** @inheritdoc */
-    benchmark(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    fatal(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    critical(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    silly(msg: StringLike, verbosity?: number | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    trace(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    verbose(msg: StringLike, verbosity?: number | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    info(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    error(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
-    /** @inheritdoc */
-    warn(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    debug(msg: StringLike, meta?: LogMeta): void;
-    /** @inheritdoc */
-    action(action: string, meta?: LogMeta): void;
-    /** @inheritdoc */
-    action(action: string, code: number, meta?: LogMeta): void;
-    /** @inheritdoc */
-    setConfig(): void;
-    /** @inheritdoc */
-    for(_method?: string | ((...args: any[]) => any) | {
-        new (...args: any[]): any;
-    } | object | Partial<any>, _config?: Partial<any>, ..._args: any[]): this;
-    /** @inheritdoc */
-    clear(): this;
-    /** @inheritdoc */
-    get root(): string[];
-}

package/lib/types/graph/log/LogParameters.d.cts

@@ -1,7 +0,0 @@
-/**
- * Registers the four DECAF-48 run attributes as log parameter descriptors
- * (nodeId / workflowId / runId / user). Rendered only when keyed with a
- * non-null value so one-shot module imports from other packages never leak
- * empty columns.
- */
-export declare function registerGraphRunLogParameters(): void;

package/lib/types/graph/log/LogParameters.d.mts

@@ -1,7 +0,0 @@
-/**
- * Registers the four DECAF-48 run attributes as log parameter descriptors
- * (nodeId / workflowId / runId / user). Rendered only when keyed with a
- * non-null value so one-shot module imports from other packages never leak
- * empty columns.
- */
-export declare function registerGraphRunLogParameters(): void;

package/lib/types/graph/nodes/agents/agent.d.cts

@@ -1,31 +0,0 @@
-import { GraphNode } from "../base.d.cts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.cts";
-/**
- * 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.
- */
-export declare class AgentNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    prompt: string;
-    response: string;
-    actions: unknown[];
-    model: unknown;
-    memory: unknown;
-    workspace: unknown;
-}
-/**
- * All built-in agent node constructors.
- */
-export declare const GRAPH_AGENT_NODES: readonly [typeof AgentNode];

package/lib/types/graph/nodes/agents/agent.d.mts

@@ -1,31 +0,0 @@
-import { GraphNode } from "../base.d.mts";
-import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../engine/types.d.mts";
-/**
- * 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.
- */
-export declare class AgentNode extends GraphNode {
-    static execute(request: GraphNodeExecutionRequest): GraphExecutionValues;
-    prompt: string;
-    response: string;
-    actions: unknown[];
-    model: unknown;
-    memory: unknown;
-    workspace: unknown;
-}
-/**
- * All built-in agent node constructors.
- */
-export declare const GRAPH_AGENT_NODES: readonly [typeof AgentNode];