@decaf-ts/integrations 0.10.5 → 0.11.0

package/lib/types/blob/ipfs/IpfsBlobStoreService.d.cts

@@ -1,61 +0,0 @@
-/**
- * @module integrations/blob/ipfs/service
- * @summary IPFS blob store service.
- * @description Blob store backed by an IPFS (Kubo) node. Because the blob API is key/value CRUD-like
- * and IPFS is content-addressed, an IpfsKeyIndex maps logical keys to CIDs.
- */
-import { type KuboRPCClient } from "kubo-rpc-client";
-import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
-import { BlobStoreService } from "../core/BlobStoreService.d.cts";
-import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobUrlOptions, BlobUrlResult, BlobValue, IpfsBlobStoreServiceConfig } from "../core/BlobTypes.d.cts";
-/**
- * @description IPFS blob store service registered as `blob-ipfs`
- * @summary Stores blobs on an IPFS (Kubo) node via `kubo-rpc-client`. Because
- * the blob API is key/value CRUD-like and IPFS is content-addressed, an
- * `IpfsKeyIndex` maps logical keys to CIDs; when `encryptedOnly` is set only
- * encrypted payloads are accepted.
- * @class IpfsBlobStoreService
- * @memberOf module:integrations/blob/ipfs/service
- */
-export declare class IpfsBlobStoreService extends BlobStoreService<KuboRPCClient, IpfsBlobStoreServiceConfig> {
-    /**
-     * @description The key index mapping logical keys to IPFS CIDs
-     * @summary Created in `initialize()` from the configured `keyIndex` provider.
-     * @type {IpfsKeyIndex}
-     * @private
-     */
-    private index;
-    /**
-     * @description Builds the IPFS blob config from the environment
-     * @summary Reads the `blobs.ipfs` environment slice; considered
-     * unconfigured when no `sourceId` is set, which keeps the auto-boot
-     * fallback (see `getConfigFromArgs`) resolving to `undefined`.
-     * @return {IpfsBlobStoreServiceConfig | undefined} The environment-derived config, or `undefined` when unconfigured
-     */
-    protected configFromEnvironment(): IpfsBlobStoreServiceConfig | undefined;
-    /**
-     * @description Initializes the IPFS Kubo RPC client and key index
-     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
-     * then the `blobs.ipfs` environment slice). When no config resolves during
-     * a context-bearing auto-boot of an unconfigured provider, returns
-     * `skipInitialization()` so `Service.boot` does not throw; an explicit
-     * `initialize()` with no resolvable config still throws a
-     * `ValidationError`. Connects to the Kubo node at the configured `apiUrl`
-     * (default `http://localhost:5001`) and creates the `IpfsKeyIndex`.
-     * @param {...ContextualArgs<any>} args - An optional `IpfsBlobStoreServiceConfig`, optionally followed by a decaf `Context`
-     * @return {Promise<{config: IpfsBlobStoreServiceConfig, client: KuboRPCClient}>} The resolved config and the Kubo RPC client
-     */
-    initialize(...args: ContextualArgs<any>): Promise<{
-        config: IpfsBlobStoreServiceConfig;
-        client: KuboRPCClient;
-    }>;
-    put(key: BlobKey, value: BlobValue, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
-    get(key: BlobKey, options?: BlobGetOptions, ...args: MaybeContextualArg<any>): Promise<BlobGetResult>;
-    has(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<boolean>;
-    stat(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<BlobMetadata>;
-    delete(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<void>;
-    copy(fromKey: BlobKey, toKey: BlobKey, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
-    list(options?: BlobListOptions, ...args: MaybeContextualArg<any>): Promise<BlobListResult>;
-    url(key: BlobKey, options?: BlobUrlOptions, ...args: MaybeContextualArg<any>): Promise<BlobUrlResult>;
-    protected parseError(error: unknown): Error;
-}

package/lib/types/blob/ipfs/IpfsBlobStoreService.d.mts

@@ -1,61 +0,0 @@
-/**
- * @module integrations/blob/ipfs/service
- * @summary IPFS blob store service.
- * @description Blob store backed by an IPFS (Kubo) node. Because the blob API is key/value CRUD-like
- * and IPFS is content-addressed, an IpfsKeyIndex maps logical keys to CIDs.
- */
-import { type KuboRPCClient } from "kubo-rpc-client";
-import { type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
-import { BlobStoreService } from "../core/BlobStoreService.d.mts";
-import type { BlobGetOptions, BlobGetResult, BlobKey, BlobListOptions, BlobListResult, BlobMetadata, BlobPutOptions, BlobPutResult, BlobUrlOptions, BlobUrlResult, BlobValue, IpfsBlobStoreServiceConfig } from "../core/BlobTypes.d.mts";
-/**
- * @description IPFS blob store service registered as `blob-ipfs`
- * @summary Stores blobs on an IPFS (Kubo) node via `kubo-rpc-client`. Because
- * the blob API is key/value CRUD-like and IPFS is content-addressed, an
- * `IpfsKeyIndex` maps logical keys to CIDs; when `encryptedOnly` is set only
- * encrypted payloads are accepted.
- * @class IpfsBlobStoreService
- * @memberOf module:integrations/blob/ipfs/service
- */
-export declare class IpfsBlobStoreService extends BlobStoreService<KuboRPCClient, IpfsBlobStoreServiceConfig> {
-    /**
-     * @description The key index mapping logical keys to IPFS CIDs
-     * @summary Created in `initialize()` from the configured `keyIndex` provider.
-     * @type {IpfsKeyIndex}
-     * @private
-     */
-    private index;
-    /**
-     * @description Builds the IPFS blob config from the environment
-     * @summary Reads the `blobs.ipfs` environment slice; considered
-     * unconfigured when no `sourceId` is set, which keeps the auto-boot
-     * fallback (see `getConfigFromArgs`) resolving to `undefined`.
-     * @return {IpfsBlobStoreServiceConfig | undefined} The environment-derived config, or `undefined` when unconfigured
-     */
-    protected configFromEnvironment(): IpfsBlobStoreServiceConfig | undefined;
-    /**
-     * @description Initializes the IPFS Kubo RPC client and key index
-     * @summary Resolves the config via `getConfigFromArgs` (explicit config,
-     * then the `blobs.ipfs` environment slice). When no config resolves during
-     * a context-bearing auto-boot of an unconfigured provider, returns
-     * `skipInitialization()` so `Service.boot` does not throw; an explicit
-     * `initialize()` with no resolvable config still throws a
-     * `ValidationError`. Connects to the Kubo node at the configured `apiUrl`
-     * (default `http://localhost:5001`) and creates the `IpfsKeyIndex`.
-     * @param {...ContextualArgs<any>} args - An optional `IpfsBlobStoreServiceConfig`, optionally followed by a decaf `Context`
-     * @return {Promise<{config: IpfsBlobStoreServiceConfig, client: KuboRPCClient}>} The resolved config and the Kubo RPC client
-     */
-    initialize(...args: ContextualArgs<any>): Promise<{
-        config: IpfsBlobStoreServiceConfig;
-        client: KuboRPCClient;
-    }>;
-    put(key: BlobKey, value: BlobValue, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
-    get(key: BlobKey, options?: BlobGetOptions, ...args: MaybeContextualArg<any>): Promise<BlobGetResult>;
-    has(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<boolean>;
-    stat(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<BlobMetadata>;
-    delete(key: BlobKey, ...args: MaybeContextualArg<any>): Promise<void>;
-    copy(fromKey: BlobKey, toKey: BlobKey, options?: BlobPutOptions, ...args: MaybeContextualArg<any>): Promise<BlobPutResult>;
-    list(options?: BlobListOptions, ...args: MaybeContextualArg<any>): Promise<BlobListResult>;
-    url(key: BlobKey, options?: BlobUrlOptions, ...args: MaybeContextualArg<any>): Promise<BlobUrlResult>;
-    protected parseError(error: unknown): Error;
-}

package/lib/types/blob/ipfs/IpfsKeyIndex.d.cts

@@ -1,9 +0,0 @@
-import type { BlobListResult, BlobMetadata, IpfsKeyIndexConfig } from "../core/BlobTypes.d.cts";
-export interface IpfsKeyIndex {
-    get(key: string): Promise<string | undefined>;
-    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
-    stat(key: string): Promise<BlobMetadata>;
-}
-export declare function createIpfsKeyIndex(config: IpfsKeyIndexConfig): IpfsKeyIndex;

package/lib/types/blob/ipfs/IpfsKeyIndex.d.mts

@@ -1,9 +0,0 @@
-import type { BlobListResult, BlobMetadata, IpfsKeyIndexConfig } from "../core/BlobTypes.d.mts";
-export interface IpfsKeyIndex {
-    get(key: string): Promise<string | undefined>;
-    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
-    stat(key: string): Promise<BlobMetadata>;
-}
-export declare function createIpfsKeyIndex(config: IpfsKeyIndexConfig): IpfsKeyIndex;

package/lib/types/blob/ipfs/LocalJsonIpfsKeyIndex.d.cts

@@ -1,11 +0,0 @@
-import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.cts";
-import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.cts";
-export declare class LocalJsonIpfsKeyIndex implements IpfsKeyIndex {
-    private readonly path;
-    constructor(path: string);
-    get(key: string): Promise<string | undefined>;
-    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
-    stat(key: string): Promise<BlobMetadata>;
-}

package/lib/types/blob/ipfs/LocalJsonIpfsKeyIndex.d.mts

@@ -1,11 +0,0 @@
-import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.mts";
-import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.mts";
-export declare class LocalJsonIpfsKeyIndex implements IpfsKeyIndex {
-    private readonly path;
-    constructor(path: string);
-    get(key: string): Promise<string | undefined>;
-    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
-    stat(key: string): Promise<BlobMetadata>;
-}

package/lib/types/blob/ipfs/MemoryIpfsKeyIndex.d.cts

@@ -1,15 +0,0 @@
-/**
- * @module integrations/blob/ipfs/memory-index
- * @summary In-memory IPFS key index.
- * @description Process-local Map-backed key index for tests and examples.
- */
-import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.cts";
-import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.cts";
-export declare class MemoryIpfsKeyIndex implements IpfsKeyIndex {
-    private readonly values;
-    get(key: string): Promise<string | undefined>;
-    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
-    stat(key: string): Promise<BlobMetadata>;
-}

package/lib/types/blob/ipfs/MemoryIpfsKeyIndex.d.mts

@@ -1,15 +0,0 @@
-/**
- * @module integrations/blob/ipfs/memory-index
- * @summary In-memory IPFS key index.
- * @description Process-local Map-backed key index for tests and examples.
- */
-import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.mts";
-import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.mts";
-export declare class MemoryIpfsKeyIndex implements IpfsKeyIndex {
-    private readonly values;
-    get(key: string): Promise<string | undefined>;
-    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
-    stat(key: string): Promise<BlobMetadata>;
-}

package/lib/types/blob/ipfs/PostgresIpfsKeyIndex.d.cts

@@ -1,11 +0,0 @@
-import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.cts";
-import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.cts";
-export declare class PostgresIpfsKeyIndex implements IpfsKeyIndex {
-    private readonly connectionRef;
-    constructor(connectionRef: string);
-    get(key: string): Promise<string | undefined>;
-    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
-    stat(key: string): Promise<BlobMetadata>;
-}

package/lib/types/blob/ipfs/PostgresIpfsKeyIndex.d.mts

@@ -1,11 +0,0 @@
-import type { BlobListResult, BlobMetadata } from "../core/BlobTypes.d.mts";
-import type { IpfsKeyIndex } from "./IpfsKeyIndex.d.mts";
-export declare class PostgresIpfsKeyIndex implements IpfsKeyIndex {
-    private readonly connectionRef;
-    constructor(connectionRef: string);
-    get(key: string): Promise<string | undefined>;
-    set(key: string, cid: string, metadata?: BlobMetadata): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix?: string, limit?: number, cursor?: string): Promise<BlobListResult>;
-    stat(key: string): Promise<BlobMetadata>;
-}

package/lib/types/blob/ipfs/index.d.cts

@@ -1,11 +0,0 @@
-/**
- * @module integrations/blob/ipfs
- * @summary IPFS blob store exports.
- * @description Re-exports the IPFS blob store service and key-index abstraction.
- */
-export * from "./IpfsBlobStoreService.d.cts";
-export * from "./IpfsBlobEnvironment.d.cts";
-export * from "./IpfsKeyIndex.d.cts";
-export * from "./MemoryIpfsKeyIndex.d.cts";
-export * from "./PostgresIpfsKeyIndex.d.cts";
-export * from "./LocalJsonIpfsKeyIndex.d.cts";

package/lib/types/blob/ipfs/index.d.mts

@@ -1,11 +0,0 @@
-/**
- * @module integrations/blob/ipfs
- * @summary IPFS blob store exports.
- * @description Re-exports the IPFS blob store service and key-index abstraction.
- */
-export * from "./IpfsBlobStoreService.d.mts";
-export * from "./IpfsBlobEnvironment.d.mts";
-export * from "./IpfsKeyIndex.d.mts";
-export * from "./MemoryIpfsKeyIndex.d.mts";
-export * from "./PostgresIpfsKeyIndex.d.mts";
-export * from "./LocalJsonIpfsKeyIndex.d.mts";

package/lib/types/graph/engine/catalog/GraphBuiltInRegistrations.d.cts

@@ -1,17 +0,0 @@
-import { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.cts";
-import { GraphNodeCatalogue } from "./GraphNodeCatalogue.d.cts";
-import { type GraphNodeRegistration } from "./GraphNodeRegistration.d.cts";
-/**
- * Builds the built-in node registrations (DECAF-50 §4.12): every built-in
- * manifest from {@link GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND} that has a
- * default executor, paired with that executor as a
- * {@link GraphNodeRegistration}. Engine-bound executors (loops, switch) are
- * only included when an `engine` is provided.
- */
-export declare function builtInGraphNodeRegistrations(engine?: GraphExecutionEngine): GraphNodeRegistration[];
-/**
- * Registers all built-in graph nodes (see
- * {@link builtInGraphNodeRegistrations}) into the given
- * {@link GraphNodeCatalogue} and returns it for chaining.
- */
-export declare function registerBuiltInGraphNodes(catalogue: GraphNodeCatalogue, engine?: GraphExecutionEngine): GraphNodeCatalogue;

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

@@ -1,17 +0,0 @@
-import { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.mts";
-import { GraphNodeCatalogue } from "./GraphNodeCatalogue.d.mts";
-import { type GraphNodeRegistration } from "./GraphNodeRegistration.d.mts";
-/**
- * Builds the built-in node registrations (DECAF-50 §4.12): every built-in
- * manifest from {@link GRAPH_BUILT_IN_NODE_MANIFESTS_BY_KIND} that has a
- * default executor, paired with that executor as a
- * {@link GraphNodeRegistration}. Engine-bound executors (loops, switch) are
- * only included when an `engine` is provided.
- */
-export declare function builtInGraphNodeRegistrations(engine?: GraphExecutionEngine): GraphNodeRegistration[];
-/**
- * Registers all built-in graph nodes (see
- * {@link builtInGraphNodeRegistrations}) into the given
- * {@link GraphNodeCatalogue} and returns it for chaining.
- */
-export declare function registerBuiltInGraphNodes(catalogue: GraphNodeCatalogue, engine?: GraphExecutionEngine): GraphNodeCatalogue;

package/lib/types/graph/engine/catalog/GraphCatalogueErrors.d.cts

@@ -1,13 +0,0 @@
-import { InternalError, NotFoundError } from "@decaf-ts/db-decorators";
-/** Thrown when a node registration or its manifest fails catalogue validation (e.g. invalid ports, unsafe ids, duplicate kinds). */
-export declare class GraphNodeRegistrationError extends InternalError {
-    constructor(msg: string | Error | unknown);
-}
-/** Thrown when a node kind is not registered in the backend catalogue. */
-export declare class GraphNodeNotFoundError extends NotFoundError {
-    constructor(msg: string | Error | unknown);
-}
-/** Thrown when a declared node method is not registered for a node kind. */
-export declare class GraphNodeMethodNotFoundError extends NotFoundError {
-    constructor(msg: string | Error | unknown);
-}

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

@@ -1,13 +0,0 @@
-import { InternalError, NotFoundError } from "@decaf-ts/db-decorators";
-/** Thrown when a node registration or its manifest fails catalogue validation (e.g. invalid ports, unsafe ids, duplicate kinds). */
-export declare class GraphNodeRegistrationError extends InternalError {
-    constructor(msg: string | Error | unknown);
-}
-/** Thrown when a node kind is not registered in the backend catalogue. */
-export declare class GraphNodeNotFoundError extends NotFoundError {
-    constructor(msg: string | Error | unknown);
-}
-/** Thrown when a declared node method is not registered for a node kind. */
-export declare class GraphNodeMethodNotFoundError extends NotFoundError {
-    constructor(msg: string | Error | unknown);
-}

package/lib/types/graph/engine/catalog/GraphNodeCatalogue.d.cts

@@ -1,71 +0,0 @@
-/**
- * @module integrations/graph/engine/catalog/GraphNodeCatalogue
- * @summary Trusted backend node catalogue (DECAF-50 §4.10–§4.12).
- * @description The single registry of node kinds the nine-stage validator
- * resolves against and the execution engine pulls executors from.
- * Registrations are validated fail-fast on
- * {@link GraphNodeCatalogue.register} (manifest serializability, static
- * ports, parameters, dynamic-port rules, credentials, method declarations)
- * and manifests are served as JSON-safe clones — never class instances.
- */
-import type { GraphNodeManifest, GraphNodeMethodManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeInstance } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.cts";
-import type { GraphCatalogueQueryContext, GraphNodeResolutionContext, GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeMethod, GraphNodeRegistration, GraphNodeRegistrationOptions } from "./GraphNodeRegistration.d.cts";
-/**
- * Backend-side trusted node catalogue (DECAF-50 §4.10–§4.12): the single
- * registry of node kinds the nine-stage validator resolves against and the
- * execution engine pulls executors from. Registrations are validated on
- * {@link GraphNodeCatalogue.register} (manifest serializability, static
- * ports, parameters, dynamic-port rules, credentials, method declarations)
- * and manifests are served as JSON-safe clones — never class instances.
- * Supports the transition path via
- * {@link GraphNodeCatalogue.registerExecutor}, which creates placeholder
- * manifests with lenient policies for legacy executor-only registrations
- * (removed at cutover, P7).
- */
-export declare class GraphNodeCatalogue {
-    private readonly entries;
-    private readonly resolver;
-    /**
-     * Validates and registers a node kind. Throws
-     * {@link GraphNodeRegistrationError} on invalid manifests, and on duplicate
-     * kinds unless `options.replace` is set.
-     */
-    register(registration: GraphNodeRegistration, options?: GraphNodeRegistrationOptions): this;
-    /**
-     * Registers an executor for a kind. When the kind has no manifest yet, a
-     * placeholder manifest is created with transition-leniency policies
-     * (`allowUndeclaredParameters`/`allowUnknownOutputs`, DECAF-50 §4.18) that
-     * are removed at cutover (P7).
-     */
-    registerExecutor(kind: string, executor: GraphNodeExecutor): this;
-    /** Removes a kind registration. */
-    unregister(kind: string): this;
-    /** Whether a kind is registered. */
-    has(kind: string): boolean;
-    private entry;
-    /** Returns a JSON-safe clone of the kind's registered manifest. */
-    getManifest(kind: string): GraphNodeManifest;
-    /** Returns the kind's registered executor. */
-    getExecutor(kind: string): GraphNodeExecutor;
-    /** Returns the declared method manifest for a kind, if declared. */
-    getMethodDeclaration(kind: string, method: string): GraphNodeMethodManifest;
-    /** Returns the registered method implementation for a kind. */
-    getMethod(kind: string, method: string): GraphNodeMethod;
-    /** Lists all method declarations registered for a kind. */
-    listMethodDeclarations(kind: string): GraphNodeMethodManifest[];
-    /** Lists registered manifests, optionally filtered by kind and display category. */
-    listManifests(context?: GraphCatalogueQueryContext): GraphNodeManifest[];
-    /** Lists all registered kinds, sorted. */
-    listKinds(): string[];
-    /** Number of registered kinds. */
-    get size(): number;
-    /**
-     * Resolves the effective manifest for a node instance (dynamic ports
-     * expanded, instance context applied) as a
-     * {@link GraphResolvedNodeManifest}.
-     */
-    resolveManifest(kind: string, instance: GraphNodeInstance, context?: GraphNodeResolutionContext): Promise<GraphResolvedNodeManifest>;
-}

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

@@ -1,71 +0,0 @@
-/**
- * @module integrations/graph/engine/catalog/GraphNodeCatalogue
- * @summary Trusted backend node catalogue (DECAF-50 §4.10–§4.12).
- * @description The single registry of node kinds the nine-stage validator
- * resolves against and the execution engine pulls executors from.
- * Registrations are validated fail-fast on
- * {@link GraphNodeCatalogue.register} (manifest serializability, static
- * ports, parameters, dynamic-port rules, credentials, method declarations)
- * and manifests are served as JSON-safe clones — never class instances.
- */
-import type { GraphNodeManifest, GraphNodeMethodManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeInstance } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.mts";
-import type { GraphCatalogueQueryContext, GraphNodeResolutionContext, GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeMethod, GraphNodeRegistration, GraphNodeRegistrationOptions } from "./GraphNodeRegistration.d.mts";
-/**
- * Backend-side trusted node catalogue (DECAF-50 §4.10–§4.12): the single
- * registry of node kinds the nine-stage validator resolves against and the
- * execution engine pulls executors from. Registrations are validated on
- * {@link GraphNodeCatalogue.register} (manifest serializability, static
- * ports, parameters, dynamic-port rules, credentials, method declarations)
- * and manifests are served as JSON-safe clones — never class instances.
- * Supports the transition path via
- * {@link GraphNodeCatalogue.registerExecutor}, which creates placeholder
- * manifests with lenient policies for legacy executor-only registrations
- * (removed at cutover, P7).
- */
-export declare class GraphNodeCatalogue {
-    private readonly entries;
-    private readonly resolver;
-    /**
-     * Validates and registers a node kind. Throws
-     * {@link GraphNodeRegistrationError} on invalid manifests, and on duplicate
-     * kinds unless `options.replace` is set.
-     */
-    register(registration: GraphNodeRegistration, options?: GraphNodeRegistrationOptions): this;
-    /**
-     * Registers an executor for a kind. When the kind has no manifest yet, a
-     * placeholder manifest is created with transition-leniency policies
-     * (`allowUndeclaredParameters`/`allowUnknownOutputs`, DECAF-50 §4.18) that
-     * are removed at cutover (P7).
-     */
-    registerExecutor(kind: string, executor: GraphNodeExecutor): this;
-    /** Removes a kind registration. */
-    unregister(kind: string): this;
-    /** Whether a kind is registered. */
-    has(kind: string): boolean;
-    private entry;
-    /** Returns a JSON-safe clone of the kind's registered manifest. */
-    getManifest(kind: string): GraphNodeManifest;
-    /** Returns the kind's registered executor. */
-    getExecutor(kind: string): GraphNodeExecutor;
-    /** Returns the declared method manifest for a kind, if declared. */
-    getMethodDeclaration(kind: string, method: string): GraphNodeMethodManifest;
-    /** Returns the registered method implementation for a kind. */
-    getMethod(kind: string, method: string): GraphNodeMethod;
-    /** Lists all method declarations registered for a kind. */
-    listMethodDeclarations(kind: string): GraphNodeMethodManifest[];
-    /** Lists registered manifests, optionally filtered by kind and display category. */
-    listManifests(context?: GraphCatalogueQueryContext): GraphNodeManifest[];
-    /** Lists all registered kinds, sorted. */
-    listKinds(): string[];
-    /** Number of registered kinds. */
-    get size(): number;
-    /**
-     * Resolves the effective manifest for a node instance (dynamic ports
-     * expanded, instance context applied) as a
-     * {@link GraphResolvedNodeManifest}.
-     */
-    resolveManifest(kind: string, instance: GraphNodeInstance, context?: GraphNodeResolutionContext): Promise<GraphResolvedNodeManifest>;
-}

package/lib/types/graph/engine/catalog/GraphNodeManifestResolver.d.cts

@@ -1,42 +0,0 @@
-/**
- * @module integrations/graph/engine/catalog/GraphNodeManifestResolver
- * @summary Manifest resolution against node instances (DECAF-50 §4.11).
- * @description Expands a manifest's `dynamicPorts` rules against the
- * instance's parameter values and resolves the effective
- * {@link GraphResolvedNodeManifest} — static plus expanded dynamic ports,
- * JSON-safe cloned, with credentials/capabilities/policies/metadata carried
- * over.
- */
-import type { GraphJsonValue, GraphNodeManifest, GraphPortManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeInstance } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeResolutionContext, GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphResolvedManifestProvider } from "./GraphNodeRegistration.d.cts";
-/** Result of expanding a manifest's dynamic-port rules: concrete input/output/connection ports. */
-export interface GraphDynamicPortResolution {
-    inputs: GraphPortManifest[];
-    outputs: GraphPortManifest[];
-    connections: GraphPortManifest[];
-}
-/**
- * Expands a manifest's `dynamicPorts` rules (DECAF-50 §4.11) against the
- * given parameter values — e.g. `repeatFromParameter` turns each array item
- * into a concrete port with a templated id/label. Static ports are never
- * duplicated; expanded ports are appended per direction.
- */
-export declare function resolveGraphDynamicPorts(manifest: Pick<GraphNodeManifest, "dynamicPorts" | "inputs" | "outputs" | "connections">, parameters: Record<string, GraphJsonValue>): GraphDynamicPortResolution;
-/**
- * Resolves a manifest against parameter values into a
- * {@link GraphResolvedNodeManifest}: static ports plus expanded dynamic
- * ports, with credentials/capabilities/policies/metadata carried over. The
- * result is a JSON-safe clone.
- */
-export declare function resolveGraphNodeManifest(manifest: GraphNodeManifest, parameters: Record<string, GraphJsonValue>): GraphResolvedNodeManifest;
-/**
- * Resolves the effective manifest for a node instance. Prefers the
- * registration's `resolveManifest` provider (validated for shape and JSON
- * safety) and falls back to static-plus-dynamic resolution via
- * {@link resolveGraphNodeManifest}.
- */
-export declare class GraphNodeManifestResolver {
-    resolve(kind: string, manifest: GraphNodeManifest, provider: GraphResolvedManifestProvider | undefined, instance: GraphNodeInstance, context?: GraphNodeResolutionContext): Promise<GraphResolvedNodeManifest>;
-}

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

@@ -1,42 +0,0 @@
-/**
- * @module integrations/graph/engine/catalog/GraphNodeManifestResolver
- * @summary Manifest resolution against node instances (DECAF-50 §4.11).
- * @description Expands a manifest's `dynamicPorts` rules against the
- * instance's parameter values and resolves the effective
- * {@link GraphResolvedNodeManifest} — static plus expanded dynamic ports,
- * JSON-safe cloned, with credentials/capabilities/policies/metadata carried
- * over.
- */
-import type { GraphJsonValue, GraphNodeManifest, GraphPortManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeInstance } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeResolutionContext, GraphResolvedNodeManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphResolvedManifestProvider } from "./GraphNodeRegistration.d.mts";
-/** Result of expanding a manifest's dynamic-port rules: concrete input/output/connection ports. */
-export interface GraphDynamicPortResolution {
-    inputs: GraphPortManifest[];
-    outputs: GraphPortManifest[];
-    connections: GraphPortManifest[];
-}
-/**
- * Expands a manifest's `dynamicPorts` rules (DECAF-50 §4.11) against the
- * given parameter values — e.g. `repeatFromParameter` turns each array item
- * into a concrete port with a templated id/label. Static ports are never
- * duplicated; expanded ports are appended per direction.
- */
-export declare function resolveGraphDynamicPorts(manifest: Pick<GraphNodeManifest, "dynamicPorts" | "inputs" | "outputs" | "connections">, parameters: Record<string, GraphJsonValue>): GraphDynamicPortResolution;
-/**
- * Resolves a manifest against parameter values into a
- * {@link GraphResolvedNodeManifest}: static ports plus expanded dynamic
- * ports, with credentials/capabilities/policies/metadata carried over. The
- * result is a JSON-safe clone.
- */
-export declare function resolveGraphNodeManifest(manifest: GraphNodeManifest, parameters: Record<string, GraphJsonValue>): GraphResolvedNodeManifest;
-/**
- * Resolves the effective manifest for a node instance. Prefers the
- * registration's `resolveManifest` provider (validated for shape and JSON
- * safety) and falls back to static-plus-dynamic resolution via
- * {@link resolveGraphNodeManifest}.
- */
-export declare class GraphNodeManifestResolver {
-    resolve(kind: string, manifest: GraphNodeManifest, provider: GraphResolvedManifestProvider | undefined, instance: GraphNodeInstance, context?: GraphNodeResolutionContext): Promise<GraphResolvedNodeManifest>;
-}

package/lib/types/graph/engine/catalog/GraphNodeMethodRegistry.d.cts

@@ -1,22 +0,0 @@
-import type { GraphNodeMethodManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeMethod } from "./GraphNodeRegistration.d.cts";
-/**
- * Per-kind registry of declared node methods (DECAF-50 §4.12): validates at
- * construction that every declared method has an implementation and no
- * implementation exists without a declaration, then serves declarations and
- * implementations by name.
- */
-export declare class GraphNodeMethodRegistry {
-    private readonly kind;
-    private readonly declarations;
-    private readonly implementations;
-    constructor(kind: string, declared: GraphNodeMethodManifest[], provided?: Record<string, GraphNodeMethod>);
-    /** Whether a method with the given name is declared. */
-    has(name: string): boolean;
-    /** Returns the method's declaration; throws {@link GraphNodeMethodNotFoundError} when undeclared. */
-    getDeclaration(name: string): GraphNodeMethodManifest;
-    /** Returns the method's implementation (asserting it is declared first). */
-    get(name: string): GraphNodeMethod;
-    /** Lists all declarations, sorted by method name. */
-    list(): GraphNodeMethodManifest[];
-}

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

@@ -1,22 +0,0 @@
-import type { GraphNodeMethodManifest } from "@decaf-ts/ui-decorators/graph";
-import type { GraphNodeMethod } from "./GraphNodeRegistration.d.mts";
-/**
- * Per-kind registry of declared node methods (DECAF-50 §4.12): validates at
- * construction that every declared method has an implementation and no
- * implementation exists without a declaration, then serves declarations and
- * implementations by name.
- */
-export declare class GraphNodeMethodRegistry {
-    private readonly kind;
-    private readonly declarations;
-    private readonly implementations;
-    constructor(kind: string, declared: GraphNodeMethodManifest[], provided?: Record<string, GraphNodeMethod>);
-    /** Whether a method with the given name is declared. */
-    has(name: string): boolean;
-    /** Returns the method's declaration; throws {@link GraphNodeMethodNotFoundError} when undeclared. */
-    getDeclaration(name: string): GraphNodeMethodManifest;
-    /** Returns the method's implementation (asserting it is declared first). */
-    get(name: string): GraphNodeMethod;
-    /** Lists all declarations, sorted by method name. */
-    list(): GraphNodeMethodManifest[];
-}