@flutchai/flutch-sdk 0.1.27 → 0.2.1

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { JSONSchema7 } from 'json-schema';
 import * as _nestjs_common from '@nestjs/common';
-import { OnModuleInit, Logger, Type, CanActivate, ExecutionContext, DynamicModule } from '@nestjs/common';
+import { OnModuleInit, Logger, CanActivate, ExecutionContext, Type, DynamicModule } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
 import { HumanMessage, AIMessage, AIMessageChunk } from '@langchain/core/messages';
 import { BaseChannel, CompiledStateGraph, LangGraphRunnableConfig } from '@langchain/langgraph';
@@ -506,132 +506,6 @@ declare class GraphManifestValidator {
     static validateOrThrow(manifest: any): void;
 }
 
-interface IGraphTraceEvent {
-    type: string;
-    name?: string;
-    channel?: string;
-    nodeName?: string;
-    timestamp: number;
-    metadata?: Record<string, unknown>;
-    data?: Record<string, unknown>;
-}
-
-interface VersionRoute {
-    version: string;
-    builderClass: Type<AbstractGraphBuilder<any>>;
-    isDefault?: boolean;
-}
-interface VersioningConfig {
-    baseGraphType: string;
-    versions: VersionRoute[];
-    defaultVersionStrategy?: "latest" | "explicit";
-}
-interface VersionResolution {
-    version: string;
-    builderClass: Type<AbstractGraphBuilder<any>>;
-    fullGraphType: string;
-}
-interface VersionResolutionOptions {
-    requestedVersion?: string;
-    strict?: boolean;
-}
-
-declare class VersionedGraphService {
-    private readonly logger;
-    private readonly versionConfigs;
-    constructor();
-    registerVersioning(config: VersioningConfig): void;
-    resolveVersion(graphType: string, options?: VersionResolutionOptions): Promise<VersionResolution>;
-    createVersionedBuilder(graphType: string, moduleRef?: ModuleRef, options?: VersionResolutionOptions): Promise<AbstractGraphBuilder<any>>;
-    getAvailableVersions(baseGraphType: string): string[];
-    isVersionSupported(graphType: string, options?: VersionResolutionOptions): boolean;
-    private findBestVersionRoute;
-    private isVersionCompatible;
-    getVersioningInfo(baseGraphType: string): VersioningConfig | null;
-}
-
-interface IGraphTracer {
-    log(data: any): void;
-    error(data: any): void;
-}
-interface IUsageRecorder {
-    recordModelExecution(record: any): void;
-}
-
-type MappedChannels<T> = {
-    [K in keyof T]: BaseChannel<T[K], T[K]>;
-};
-declare global {
-    namespace GraphTypes {
-        interface Registry {
-        }
-    }
-}
-type IGraphTypeRegistry = GraphTypes.Registry;
-interface IGenericGraphType {
-    Params: any;
-    State: any;
-    Config: any;
-    Input: any;
-    Definition: any;
-    ConfigDefinition: any;
-    InputDefinition: any;
-    StateValues: any;
-    ConfigValues: any;
-    InputValues: any;
-    OutputValues: any;
-}
-type CompiledGraphFor<T extends string> = T extends keyof IGraphTypeRegistry ? CompiledStateGraph<IGraphTypeRegistry[T]["State"], IGraphTypeRegistry[T]["State"], string, IGraphTypeRegistry[T]["Input"], IGraphTypeRegistry[T]["State"], IGraphTypeRegistry[T]["Config"]> : CompiledStateGraph<any, any, string, any, any, any>;
-interface IGraphBuilder<T extends string> {
-    buildGraph(config?: any): Promise<CompiledGraphFor<T>>;
-}
-interface IGraphCompiler {
-    getConfiguredGraph<T extends string>(type: T, thread?: any): Promise<CompiledGraphFor<T>>;
-}
-type BaseGraphState = {};
-interface IGraphMetadata {
-    workflowType: string;
-    version: string;
-}
-interface IGraphConfigurable<TGraphSettings = any> {
-    thread_id?: string;
-    metadata?: IGraphMetadata;
-    graphSettings: TGraphSettings;
-    userId?: string;
-    agentId?: string;
-}
-type IGraphRunnableConfig<TGraphSettings = any> = LangGraphRunnableConfig<IGraphConfigurable<TGraphSettings>> & {
-    configurable: IGraphConfigurable<TGraphSettings>;
-};
-type StrictGraphRunnableConfig<TGraphSettings = any> = LangGraphRunnableConfig<TGraphSettings> & {
-    configurable: IGraphConfigurable<TGraphSettings>;
-};
-interface LLMConfig {
-    modelId: string;
-    temperature?: number;
-    maxTokens?: number;
-    prompt?: string;
-}
-interface IGraphTypeMetadata {
-    type: string;
-    metadata: {
-        title: string;
-        description: string;
-        detailedDescription: string;
-        icon?: string;
-        recommendations?: string[];
-        tags?: string[];
-        category?: string;
-    };
-    schema: {
-        properties: Record<string, any>;
-        required: string[];
-    };
-    defaultSettings: any;
-    formFields?: any[];
-}
-type IGraphMetadataRegistry = Record<string, IGraphTypeMetadata>;
-
 declare class CallbackStore {
     private readonly redis;
     private readonly isProduction;
@@ -957,6 +831,141 @@ declare class CallbackController {
     handleCallback(req: CallbackRequest): Promise<CallbackResult>;
 }
 
+declare abstract class ExternalGraphBuilder<V extends string = string> extends AbstractGraphBuilder<V> {
+    protected callbackRegistry: CallbackRegistry;
+    protected endpointRegistry: EndpointRegistry;
+    constructor();
+    protected registerCallbacks(): Promise<void>;
+    protected registerEndpoints(): Promise<void>;
+    protected registerEndpointsManually(endpoints: EndpointDescriptor[]): void;
+}
+
+interface IGraphTraceEvent {
+    type: string;
+    name?: string;
+    channel?: string;
+    nodeName?: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+    data?: Record<string, unknown>;
+}
+
+interface VersionRoute {
+    version: string;
+    builderClass: Type<AbstractGraphBuilder<any>>;
+    isDefault?: boolean;
+}
+interface VersioningConfig {
+    baseGraphType: string;
+    versions: VersionRoute[];
+    defaultVersionStrategy?: "latest" | "explicit";
+}
+interface VersionResolution {
+    version: string;
+    builderClass: Type<AbstractGraphBuilder<any>>;
+    fullGraphType: string;
+}
+interface VersionResolutionOptions {
+    requestedVersion?: string;
+    strict?: boolean;
+}
+
+declare class VersionedGraphService {
+    private readonly logger;
+    private readonly versionConfigs;
+    constructor();
+    registerVersioning(config: VersioningConfig): void;
+    resolveVersion(graphType: string, options?: VersionResolutionOptions): Promise<VersionResolution>;
+    createVersionedBuilder(graphType: string, moduleRef?: ModuleRef, options?: VersionResolutionOptions): Promise<AbstractGraphBuilder<any>>;
+    getAvailableVersions(baseGraphType: string): string[];
+    isVersionSupported(graphType: string, options?: VersionResolutionOptions): boolean;
+    private findBestVersionRoute;
+    private isVersionCompatible;
+    getVersioningInfo(baseGraphType: string): VersioningConfig | null;
+}
+
+interface IGraphTracer {
+    log(data: any): void;
+    error(data: any): void;
+}
+interface IUsageRecorder {
+    recordModelExecution(record: any): void;
+}
+
+type MappedChannels<T> = {
+    [K in keyof T]: BaseChannel<T[K], T[K]>;
+};
+declare global {
+    namespace GraphTypes {
+        interface Registry {
+        }
+    }
+}
+type IGraphTypeRegistry = GraphTypes.Registry;
+interface IGenericGraphType {
+    Params: any;
+    State: any;
+    Config: any;
+    Input: any;
+    Definition: any;
+    ConfigDefinition: any;
+    InputDefinition: any;
+    StateValues: any;
+    ConfigValues: any;
+    InputValues: any;
+    OutputValues: any;
+}
+type CompiledGraphFor<T extends string> = T extends keyof IGraphTypeRegistry ? CompiledStateGraph<IGraphTypeRegistry[T]["State"], IGraphTypeRegistry[T]["State"], string, IGraphTypeRegistry[T]["Input"], IGraphTypeRegistry[T]["State"], IGraphTypeRegistry[T]["Config"]> : CompiledStateGraph<any, any, string, any, any, any>;
+interface IGraphBuilder<T extends string> {
+    buildGraph(config?: any): Promise<CompiledGraphFor<T>>;
+}
+interface IGraphCompiler {
+    getConfiguredGraph<T extends string>(type: T, thread?: any): Promise<CompiledGraphFor<T>>;
+}
+type BaseGraphState = {};
+interface IGraphMetadata {
+    workflowType: string;
+    version: string;
+}
+interface IGraphConfigurable<TGraphSettings = any> {
+    thread_id?: string;
+    metadata?: IGraphMetadata;
+    graphSettings: TGraphSettings;
+    userId?: string;
+    agentId?: string;
+}
+type IGraphRunnableConfig<TGraphSettings = any> = LangGraphRunnableConfig<IGraphConfigurable<TGraphSettings>> & {
+    configurable: IGraphConfigurable<TGraphSettings>;
+};
+type StrictGraphRunnableConfig<TGraphSettings = any> = LangGraphRunnableConfig<TGraphSettings> & {
+    configurable: IGraphConfigurable<TGraphSettings>;
+};
+interface LLMConfig {
+    modelId: string;
+    temperature?: number;
+    maxTokens?: number;
+    prompt?: string;
+}
+interface IGraphTypeMetadata {
+    type: string;
+    metadata: {
+        title: string;
+        description: string;
+        detailedDescription: string;
+        icon?: string;
+        recommendations?: string[];
+        tags?: string[];
+        category?: string;
+    };
+    schema: {
+        properties: Record<string, any>;
+        required: string[];
+    };
+    defaultSettings: any;
+    formFields?: any[];
+}
+type IGraphMetadataRegistry = Record<string, IGraphTypeMetadata>;
+
 interface BaseGraphContext {
     messageId?: string;
     threadId: string;
@@ -1013,13 +1022,18 @@ interface IGraphManifest {
         configSchemaPath?: string;
     }>;
 }
+interface IGraphLogger {
+    log: (message: any, ...optionalParams: any[]) => void;
+    error: (message: any, ...optionalParams: any[]) => void;
+    warn: (message: any, ...optionalParams: any[]) => void;
+    debug: (message: any, ...optionalParams: any[]) => void;
+    verbose?: (message: any, ...optionalParams: any[]) => void;
+}
 declare abstract class AbstractGraphBuilder<V extends string = string> {
     abstract readonly version: V;
-    protected logger: Logger;
-    protected callbackRegistry: CallbackRegistry;
-    protected endpointRegistry: EndpointRegistry;
+    protected logger: IGraphLogger;
     get graphType(): string;
-    protected manifestPath: string;
+    protected manifestPath: string | null;
     protected manifest?: IGraphManifest;
     constructor();
     abstract buildGraph(config: any): Promise<any>;
@@ -1059,9 +1073,6 @@ declare abstract class AbstractGraphBuilder<V extends string = string> {
     }>;
     getFullGraphType(baseGraphType: string): string;
     validateVersion(): boolean;
-    protected registerCallbacks(): Promise<void>;
-    protected registerEndpoints(): Promise<void>;
-    protected registerEndpointsManually(endpoints: EndpointDescriptor[]): void;
 }
 interface IGraphEngine {
     invokeGraph(graph: any, config: any, signal?: AbortSignal): Promise<any>;
@@ -1608,4 +1619,4 @@ declare class StaticDiscovery implements ServiceDiscoveryProvider {
     }>>;
 }
 
-export { type ACLValidationResult, AbstractGraphBuilder, type ApiCallTracerOptions, AttachmentType, type AuditEntry, type BaseGraphConfig, type BaseGraphContext, GraphController as BaseGraphServiceController, UniversalGraphModule as BaseGraphServiceModule, type BaseGraphState, BuilderRegistryService, Callback, CallbackACL, CallbackAuditAction, CallbackAuditor, type CallbackContext, CallbackController, type CallbackEntry, type CallbackHandler, type CallbackMetadata, CallbackMetrics, type CallbackPatch, type CallbackPatchHandler, CallbackPatchService, CallbackRateLimiter, type CallbackRecord, CallbackRegistry, type CallbackRequest, type CallbackResult, CallbackStore, CallbackTokenGuard, type CallbackUser, type ChannelState, type ChartType, ChatFeature, type ChatModelCreator, type ChatModelOrRunnable, type ChatModelWithTools, type CitationValue, type CompiledGraphFor, type ConcreteModels, type CustomDocument, DEFAULT_TRACER_OPTIONS, type DataEnvelope, ENDPOINT_METADATA_KEY, type EmbeddingModelCreator, Endpoint, type EndpointDescriptor, type EndpointHandler, type EndpointMetadata, type EndpointOptions, EndpointRegistry, EventProcessor, type ExtendedCallbackContext, type ExtendedCallbackHandler, FileBasedDiscovery, GraphController, GraphEngineFactory, GraphEngineType, GraphManifestSchema, GraphManifestValidator, GraphServiceTokens, GraphTypeUtils, type IAgentToolConfig, type IAgentToolConfiguration, type IAttachment, type IBaseEntity, type IChartDataPoint, type IChartDataset, type IChartValue, type IContentBlock, type IContentChain, type IDeletionInfo, type IGenericGraphType, type IGraphAttachment, type IGraphBuilder, type IGraphCompiler, type IGraphConfigurable, type IGraphEngine, type IGraphManifest, type IGraphMetadata, type IGraphMetadataRegistry, type IGraphRequestPayload, type IGraphResponsePayload, type IGraphRunnableConfig, type IGraphService, type IGraphServiceRegistry, type IGraphSettingsRepository, type IGraphTraceEvent, type IGraphTracer, type IGraphTypeMetadata, type IGraphTypeRegistry, type IModelInitializer, type IReasoningChain, type IReasoningStep, type IStoredMessageContent, type ISystemToolCredentials, type IToolCall, type IToolCatalog, type IToolConfigOption, type IToolExecutionContext, type ITracingEvent, type IUsageMetrics, type IUsageRecorder, type IdempotencyConfig, type IdempotencyEntry, IdempotencyManager, IdempotencyStatus, type KnowledgeBaseInfo, type LLMCallRecord, type LLMConfig, type LLModel, LangGraphEngine, type MappedChannels, McpConverter, type McpRuntimeClient, McpRuntimeHttpClient, type McpTool, McpToolFilter, type Model, type ModelByIdConfig, type ModelByIdWithTypeConfig, type ModelConfig, type ModelConfigFetcher, type ModelConfigWithToken, type ModelConfigWithTokenAndType, type ModelCreator, type ModelCreators, ModelInitializer, ModelProvider, ModelType, type MongoDBConfig, type RateLimitConfig, type RateLimitResult, type RequestContext, type RerankModelCreator, type RetrieveQueryOptions, type RetrieverConfig, RetrieverSearchType, RetrieverService, type RouterConfig, type ServiceDiscoveryProvider, SmartCallbackRouter, StaticDiscovery, type StreamAccumulator, StreamChannel, type StrictGraphRunnableConfig, TelegramPatchHandler, type ToolExecutionResult, type TraceApiCallResult, type TracingLevel, UIDispatchController, type UIDispatchDto, UIEndpoint, type UIEndpointClassMetadata, type UIEndpointMethodMetadata, UIEndpointsDiscoveryService, UniversalCallbackService, UniversalGraphModule, type UniversalGraphModuleOptions, UniversalGraphService, type VersionResolution, type VersionResolutionOptions, type VersionRoute, VersionedGraphService, type VersioningConfig, VoyageAIRerank, type VoyageAIRerankConfig, WebPatchHandler, WithCallbacks, WithEndpoints, WithUIEndpoints, bootstrap, createEndpointDescriptors, createGraphAttachment, createMongoClientAdapter, createStaticMessage, findCallbackMethod, findEndpointMethod, generateAttachmentSummary, getCallbackMetadata, getEndpointMetadata, getUIEndpointClassMetadata, getUIEndpointMethodsMetadata, hasCallbacks, hasUIEndpoints, registerFinanceExampleCallback, registerUIEndpointsFromClass, sanitizeTraceData, traceApiCall };
+export { type ACLValidationResult, AbstractGraphBuilder, type ApiCallTracerOptions, AttachmentType, type AuditEntry, type BaseGraphConfig, type BaseGraphContext, GraphController as BaseGraphServiceController, UniversalGraphModule as BaseGraphServiceModule, type BaseGraphState, BuilderRegistryService, Callback, CallbackACL, CallbackAuditAction, CallbackAuditor, type CallbackContext, CallbackController, type CallbackEntry, type CallbackHandler, type CallbackMetadata, CallbackMetrics, type CallbackPatch, type CallbackPatchHandler, CallbackPatchService, CallbackRateLimiter, type CallbackRecord, CallbackRegistry, type CallbackRequest, type CallbackResult, CallbackStore, CallbackTokenGuard, type CallbackUser, type ChannelState, type ChartType, ChatFeature, type ChatModelCreator, type ChatModelOrRunnable, type ChatModelWithTools, type CitationValue, type CompiledGraphFor, type ConcreteModels, type CustomDocument, DEFAULT_TRACER_OPTIONS, type DataEnvelope, ENDPOINT_METADATA_KEY, type EmbeddingModelCreator, Endpoint, type EndpointDescriptor, type EndpointHandler, type EndpointMetadata, type EndpointOptions, EndpointRegistry, EventProcessor, type ExtendedCallbackContext, type ExtendedCallbackHandler, ExternalGraphBuilder, FileBasedDiscovery, GraphController, GraphEngineFactory, GraphEngineType, GraphManifestSchema, GraphManifestValidator, GraphServiceTokens, GraphTypeUtils, type IAgentToolConfig, type IAgentToolConfiguration, type IAttachment, type IBaseEntity, type IChartDataPoint, type IChartDataset, type IChartValue, type IContentBlock, type IContentChain, type IDeletionInfo, type IGenericGraphType, type IGraphAttachment, type IGraphBuilder, type IGraphCompiler, type IGraphConfigurable, type IGraphEngine, type IGraphLogger, type IGraphManifest, type IGraphMetadata, type IGraphMetadataRegistry, type IGraphRequestPayload, type IGraphResponsePayload, type IGraphRunnableConfig, type IGraphService, type IGraphServiceRegistry, type IGraphSettingsRepository, type IGraphTraceEvent, type IGraphTracer, type IGraphTypeMetadata, type IGraphTypeRegistry, type IModelInitializer, type IReasoningChain, type IReasoningStep, type IStoredMessageContent, type ISystemToolCredentials, type IToolCall, type IToolCatalog, type IToolConfigOption, type IToolExecutionContext, type ITracingEvent, type IUsageMetrics, type IUsageRecorder, type IdempotencyConfig, type IdempotencyEntry, IdempotencyManager, IdempotencyStatus, type KnowledgeBaseInfo, type LLMCallRecord, type LLMConfig, type LLModel, LangGraphEngine, type MappedChannels, McpConverter, type McpRuntimeClient, McpRuntimeHttpClient, type McpTool, McpToolFilter, type Model, type ModelByIdConfig, type ModelByIdWithTypeConfig, type ModelConfig, type ModelConfigFetcher, type ModelConfigWithToken, type ModelConfigWithTokenAndType, type ModelCreator, type ModelCreators, ModelInitializer, ModelProvider, ModelType, type MongoDBConfig, type RateLimitConfig, type RateLimitResult, type RequestContext, type RerankModelCreator, type RetrieveQueryOptions, type RetrieverConfig, RetrieverSearchType, RetrieverService, type RouterConfig, type ServiceDiscoveryProvider, SmartCallbackRouter, StaticDiscovery, type StreamAccumulator, StreamChannel, type StrictGraphRunnableConfig, TelegramPatchHandler, type ToolExecutionResult, type TraceApiCallResult, type TracingLevel, UIDispatchController, type UIDispatchDto, UIEndpoint, type UIEndpointClassMetadata, type UIEndpointMethodMetadata, UIEndpointsDiscoveryService, UniversalCallbackService, UniversalGraphModule, type UniversalGraphModuleOptions, UniversalGraphService, type VersionResolution, type VersionResolutionOptions, type VersionRoute, VersionedGraphService, type VersioningConfig, VoyageAIRerank, type VoyageAIRerankConfig, WebPatchHandler, WithCallbacks, WithEndpoints, WithUIEndpoints, bootstrap, createEndpointDescriptors, createGraphAttachment, createMongoClientAdapter, createStaticMessage, findCallbackMethod, findEndpointMethod, generateAttachmentSummary, getCallbackMetadata, getEndpointMetadata, getUIEndpointClassMetadata, getUIEndpointMethodsMetadata, hasCallbacks, hasUIEndpoints, registerFinanceExampleCallback, registerUIEndpointsFromClass, sanitizeTraceData, traceApiCall };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { JSONSchema7 } from 'json-schema';
 import * as _nestjs_common from '@nestjs/common';
-import { OnModuleInit, Logger, Type, CanActivate, ExecutionContext, DynamicModule } from '@nestjs/common';
+import { OnModuleInit, Logger, CanActivate, ExecutionContext, Type, DynamicModule } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
 import { HumanMessage, AIMessage, AIMessageChunk } from '@langchain/core/messages';
 import { BaseChannel, CompiledStateGraph, LangGraphRunnableConfig } from '@langchain/langgraph';
@@ -506,132 +506,6 @@ declare class GraphManifestValidator {
     static validateOrThrow(manifest: any): void;
 }
 
-interface IGraphTraceEvent {
-    type: string;
-    name?: string;
-    channel?: string;
-    nodeName?: string;
-    timestamp: number;
-    metadata?: Record<string, unknown>;
-    data?: Record<string, unknown>;
-}
-
-interface VersionRoute {
-    version: string;
-    builderClass: Type<AbstractGraphBuilder<any>>;
-    isDefault?: boolean;
-}
-interface VersioningConfig {
-    baseGraphType: string;
-    versions: VersionRoute[];
-    defaultVersionStrategy?: "latest" | "explicit";
-}
-interface VersionResolution {
-    version: string;
-    builderClass: Type<AbstractGraphBuilder<any>>;
-    fullGraphType: string;
-}
-interface VersionResolutionOptions {
-    requestedVersion?: string;
-    strict?: boolean;
-}
-
-declare class VersionedGraphService {
-    private readonly logger;
-    private readonly versionConfigs;
-    constructor();
-    registerVersioning(config: VersioningConfig): void;
-    resolveVersion(graphType: string, options?: VersionResolutionOptions): Promise<VersionResolution>;
-    createVersionedBuilder(graphType: string, moduleRef?: ModuleRef, options?: VersionResolutionOptions): Promise<AbstractGraphBuilder<any>>;
-    getAvailableVersions(baseGraphType: string): string[];
-    isVersionSupported(graphType: string, options?: VersionResolutionOptions): boolean;
-    private findBestVersionRoute;
-    private isVersionCompatible;
-    getVersioningInfo(baseGraphType: string): VersioningConfig | null;
-}
-
-interface IGraphTracer {
-    log(data: any): void;
-    error(data: any): void;
-}
-interface IUsageRecorder {
-    recordModelExecution(record: any): void;
-}
-
-type MappedChannels<T> = {
-    [K in keyof T]: BaseChannel<T[K], T[K]>;
-};
-declare global {
-    namespace GraphTypes {
-        interface Registry {
-        }
-    }
-}
-type IGraphTypeRegistry = GraphTypes.Registry;
-interface IGenericGraphType {
-    Params: any;
-    State: any;
-    Config: any;
-    Input: any;
-    Definition: any;
-    ConfigDefinition: any;
-    InputDefinition: any;
-    StateValues: any;
-    ConfigValues: any;
-    InputValues: any;
-    OutputValues: any;
-}
-type CompiledGraphFor<T extends string> = T extends keyof IGraphTypeRegistry ? CompiledStateGraph<IGraphTypeRegistry[T]["State"], IGraphTypeRegistry[T]["State"], string, IGraphTypeRegistry[T]["Input"], IGraphTypeRegistry[T]["State"], IGraphTypeRegistry[T]["Config"]> : CompiledStateGraph<any, any, string, any, any, any>;
-interface IGraphBuilder<T extends string> {
-    buildGraph(config?: any): Promise<CompiledGraphFor<T>>;
-}
-interface IGraphCompiler {
-    getConfiguredGraph<T extends string>(type: T, thread?: any): Promise<CompiledGraphFor<T>>;
-}
-type BaseGraphState = {};
-interface IGraphMetadata {
-    workflowType: string;
-    version: string;
-}
-interface IGraphConfigurable<TGraphSettings = any> {
-    thread_id?: string;
-    metadata?: IGraphMetadata;
-    graphSettings: TGraphSettings;
-    userId?: string;
-    agentId?: string;
-}
-type IGraphRunnableConfig<TGraphSettings = any> = LangGraphRunnableConfig<IGraphConfigurable<TGraphSettings>> & {
-    configurable: IGraphConfigurable<TGraphSettings>;
-};
-type StrictGraphRunnableConfig<TGraphSettings = any> = LangGraphRunnableConfig<TGraphSettings> & {
-    configurable: IGraphConfigurable<TGraphSettings>;
-};
-interface LLMConfig {
-    modelId: string;
-    temperature?: number;
-    maxTokens?: number;
-    prompt?: string;
-}
-interface IGraphTypeMetadata {
-    type: string;
-    metadata: {
-        title: string;
-        description: string;
-        detailedDescription: string;
-        icon?: string;
-        recommendations?: string[];
-        tags?: string[];
-        category?: string;
-    };
-    schema: {
-        properties: Record<string, any>;
-        required: string[];
-    };
-    defaultSettings: any;
-    formFields?: any[];
-}
-type IGraphMetadataRegistry = Record<string, IGraphTypeMetadata>;
-
 declare class CallbackStore {
     private readonly redis;
     private readonly isProduction;
@@ -957,6 +831,141 @@ declare class CallbackController {
     handleCallback(req: CallbackRequest): Promise<CallbackResult>;
 }
 
+declare abstract class ExternalGraphBuilder<V extends string = string> extends AbstractGraphBuilder<V> {
+    protected callbackRegistry: CallbackRegistry;
+    protected endpointRegistry: EndpointRegistry;
+    constructor();
+    protected registerCallbacks(): Promise<void>;
+    protected registerEndpoints(): Promise<void>;
+    protected registerEndpointsManually(endpoints: EndpointDescriptor[]): void;
+}
+
+interface IGraphTraceEvent {
+    type: string;
+    name?: string;
+    channel?: string;
+    nodeName?: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+    data?: Record<string, unknown>;
+}
+
+interface VersionRoute {
+    version: string;
+    builderClass: Type<AbstractGraphBuilder<any>>;
+    isDefault?: boolean;
+}
+interface VersioningConfig {
+    baseGraphType: string;
+    versions: VersionRoute[];
+    defaultVersionStrategy?: "latest" | "explicit";
+}
+interface VersionResolution {
+    version: string;
+    builderClass: Type<AbstractGraphBuilder<any>>;
+    fullGraphType: string;
+}
+interface VersionResolutionOptions {
+    requestedVersion?: string;
+    strict?: boolean;
+}
+
+declare class VersionedGraphService {
+    private readonly logger;
+    private readonly versionConfigs;
+    constructor();
+    registerVersioning(config: VersioningConfig): void;
+    resolveVersion(graphType: string, options?: VersionResolutionOptions): Promise<VersionResolution>;
+    createVersionedBuilder(graphType: string, moduleRef?: ModuleRef, options?: VersionResolutionOptions): Promise<AbstractGraphBuilder<any>>;
+    getAvailableVersions(baseGraphType: string): string[];
+    isVersionSupported(graphType: string, options?: VersionResolutionOptions): boolean;
+    private findBestVersionRoute;
+    private isVersionCompatible;
+    getVersioningInfo(baseGraphType: string): VersioningConfig | null;
+}
+
+interface IGraphTracer {
+    log(data: any): void;
+    error(data: any): void;
+}
+interface IUsageRecorder {
+    recordModelExecution(record: any): void;
+}
+
+type MappedChannels<T> = {
+    [K in keyof T]: BaseChannel<T[K], T[K]>;
+};
+declare global {
+    namespace GraphTypes {
+        interface Registry {
+        }
+    }
+}
+type IGraphTypeRegistry = GraphTypes.Registry;
+interface IGenericGraphType {
+    Params: any;
+    State: any;
+    Config: any;
+    Input: any;
+    Definition: any;
+    ConfigDefinition: any;
+    InputDefinition: any;
+    StateValues: any;
+    ConfigValues: any;
+    InputValues: any;
+    OutputValues: any;
+}
+type CompiledGraphFor<T extends string> = T extends keyof IGraphTypeRegistry ? CompiledStateGraph<IGraphTypeRegistry[T]["State"], IGraphTypeRegistry[T]["State"], string, IGraphTypeRegistry[T]["Input"], IGraphTypeRegistry[T]["State"], IGraphTypeRegistry[T]["Config"]> : CompiledStateGraph<any, any, string, any, any, any>;
+interface IGraphBuilder<T extends string> {
+    buildGraph(config?: any): Promise<CompiledGraphFor<T>>;
+}
+interface IGraphCompiler {
+    getConfiguredGraph<T extends string>(type: T, thread?: any): Promise<CompiledGraphFor<T>>;
+}
+type BaseGraphState = {};
+interface IGraphMetadata {
+    workflowType: string;
+    version: string;
+}
+interface IGraphConfigurable<TGraphSettings = any> {
+    thread_id?: string;
+    metadata?: IGraphMetadata;
+    graphSettings: TGraphSettings;
+    userId?: string;
+    agentId?: string;
+}
+type IGraphRunnableConfig<TGraphSettings = any> = LangGraphRunnableConfig<IGraphConfigurable<TGraphSettings>> & {
+    configurable: IGraphConfigurable<TGraphSettings>;
+};
+type StrictGraphRunnableConfig<TGraphSettings = any> = LangGraphRunnableConfig<TGraphSettings> & {
+    configurable: IGraphConfigurable<TGraphSettings>;
+};
+interface LLMConfig {
+    modelId: string;
+    temperature?: number;
+    maxTokens?: number;
+    prompt?: string;
+}
+interface IGraphTypeMetadata {
+    type: string;
+    metadata: {
+        title: string;
+        description: string;
+        detailedDescription: string;
+        icon?: string;
+        recommendations?: string[];
+        tags?: string[];
+        category?: string;
+    };
+    schema: {
+        properties: Record<string, any>;
+        required: string[];
+    };
+    defaultSettings: any;
+    formFields?: any[];
+}
+type IGraphMetadataRegistry = Record<string, IGraphTypeMetadata>;
+
 interface BaseGraphContext {
     messageId?: string;
     threadId: string;
@@ -1013,13 +1022,18 @@ interface IGraphManifest {
         configSchemaPath?: string;
     }>;
 }
+interface IGraphLogger {
+    log: (message: any, ...optionalParams: any[]) => void;
+    error: (message: any, ...optionalParams: any[]) => void;
+    warn: (message: any, ...optionalParams: any[]) => void;
+    debug: (message: any, ...optionalParams: any[]) => void;
+    verbose?: (message: any, ...optionalParams: any[]) => void;
+}
 declare abstract class AbstractGraphBuilder<V extends string = string> {
     abstract readonly version: V;
-    protected logger: Logger;
-    protected callbackRegistry: CallbackRegistry;
-    protected endpointRegistry: EndpointRegistry;
+    protected logger: IGraphLogger;
     get graphType(): string;
-    protected manifestPath: string;
+    protected manifestPath: string | null;
     protected manifest?: IGraphManifest;
     constructor();
     abstract buildGraph(config: any): Promise<any>;
@@ -1059,9 +1073,6 @@ declare abstract class AbstractGraphBuilder<V extends string = string> {
     }>;
     getFullGraphType(baseGraphType: string): string;
     validateVersion(): boolean;
-    protected registerCallbacks(): Promise<void>;
-    protected registerEndpoints(): Promise<void>;
-    protected registerEndpointsManually(endpoints: EndpointDescriptor[]): void;
 }
 interface IGraphEngine {
     invokeGraph(graph: any, config: any, signal?: AbortSignal): Promise<any>;
@@ -1608,4 +1619,4 @@ declare class StaticDiscovery implements ServiceDiscoveryProvider {
     }>>;
 }
 
-export { type ACLValidationResult, AbstractGraphBuilder, type ApiCallTracerOptions, AttachmentType, type AuditEntry, type BaseGraphConfig, type BaseGraphContext, GraphController as BaseGraphServiceController, UniversalGraphModule as BaseGraphServiceModule, type BaseGraphState, BuilderRegistryService, Callback, CallbackACL, CallbackAuditAction, CallbackAuditor, type CallbackContext, CallbackController, type CallbackEntry, type CallbackHandler, type CallbackMetadata, CallbackMetrics, type CallbackPatch, type CallbackPatchHandler, CallbackPatchService, CallbackRateLimiter, type CallbackRecord, CallbackRegistry, type CallbackRequest, type CallbackResult, CallbackStore, CallbackTokenGuard, type CallbackUser, type ChannelState, type ChartType, ChatFeature, type ChatModelCreator, type ChatModelOrRunnable, type ChatModelWithTools, type CitationValue, type CompiledGraphFor, type ConcreteModels, type CustomDocument, DEFAULT_TRACER_OPTIONS, type DataEnvelope, ENDPOINT_METADATA_KEY, type EmbeddingModelCreator, Endpoint, type EndpointDescriptor, type EndpointHandler, type EndpointMetadata, type EndpointOptions, EndpointRegistry, EventProcessor, type ExtendedCallbackContext, type ExtendedCallbackHandler, FileBasedDiscovery, GraphController, GraphEngineFactory, GraphEngineType, GraphManifestSchema, GraphManifestValidator, GraphServiceTokens, GraphTypeUtils, type IAgentToolConfig, type IAgentToolConfiguration, type IAttachment, type IBaseEntity, type IChartDataPoint, type IChartDataset, type IChartValue, type IContentBlock, type IContentChain, type IDeletionInfo, type IGenericGraphType, type IGraphAttachment, type IGraphBuilder, type IGraphCompiler, type IGraphConfigurable, type IGraphEngine, type IGraphManifest, type IGraphMetadata, type IGraphMetadataRegistry, type IGraphRequestPayload, type IGraphResponsePayload, type IGraphRunnableConfig, type IGraphService, type IGraphServiceRegistry, type IGraphSettingsRepository, type IGraphTraceEvent, type IGraphTracer, type IGraphTypeMetadata, type IGraphTypeRegistry, type IModelInitializer, type IReasoningChain, type IReasoningStep, type IStoredMessageContent, type ISystemToolCredentials, type IToolCall, type IToolCatalog, type IToolConfigOption, type IToolExecutionContext, type ITracingEvent, type IUsageMetrics, type IUsageRecorder, type IdempotencyConfig, type IdempotencyEntry, IdempotencyManager, IdempotencyStatus, type KnowledgeBaseInfo, type LLMCallRecord, type LLMConfig, type LLModel, LangGraphEngine, type MappedChannels, McpConverter, type McpRuntimeClient, McpRuntimeHttpClient, type McpTool, McpToolFilter, type Model, type ModelByIdConfig, type ModelByIdWithTypeConfig, type ModelConfig, type ModelConfigFetcher, type ModelConfigWithToken, type ModelConfigWithTokenAndType, type ModelCreator, type ModelCreators, ModelInitializer, ModelProvider, ModelType, type MongoDBConfig, type RateLimitConfig, type RateLimitResult, type RequestContext, type RerankModelCreator, type RetrieveQueryOptions, type RetrieverConfig, RetrieverSearchType, RetrieverService, type RouterConfig, type ServiceDiscoveryProvider, SmartCallbackRouter, StaticDiscovery, type StreamAccumulator, StreamChannel, type StrictGraphRunnableConfig, TelegramPatchHandler, type ToolExecutionResult, type TraceApiCallResult, type TracingLevel, UIDispatchController, type UIDispatchDto, UIEndpoint, type UIEndpointClassMetadata, type UIEndpointMethodMetadata, UIEndpointsDiscoveryService, UniversalCallbackService, UniversalGraphModule, type UniversalGraphModuleOptions, UniversalGraphService, type VersionResolution, type VersionResolutionOptions, type VersionRoute, VersionedGraphService, type VersioningConfig, VoyageAIRerank, type VoyageAIRerankConfig, WebPatchHandler, WithCallbacks, WithEndpoints, WithUIEndpoints, bootstrap, createEndpointDescriptors, createGraphAttachment, createMongoClientAdapter, createStaticMessage, findCallbackMethod, findEndpointMethod, generateAttachmentSummary, getCallbackMetadata, getEndpointMetadata, getUIEndpointClassMetadata, getUIEndpointMethodsMetadata, hasCallbacks, hasUIEndpoints, registerFinanceExampleCallback, registerUIEndpointsFromClass, sanitizeTraceData, traceApiCall };
+export { type ACLValidationResult, AbstractGraphBuilder, type ApiCallTracerOptions, AttachmentType, type AuditEntry, type BaseGraphConfig, type BaseGraphContext, GraphController as BaseGraphServiceController, UniversalGraphModule as BaseGraphServiceModule, type BaseGraphState, BuilderRegistryService, Callback, CallbackACL, CallbackAuditAction, CallbackAuditor, type CallbackContext, CallbackController, type CallbackEntry, type CallbackHandler, type CallbackMetadata, CallbackMetrics, type CallbackPatch, type CallbackPatchHandler, CallbackPatchService, CallbackRateLimiter, type CallbackRecord, CallbackRegistry, type CallbackRequest, type CallbackResult, CallbackStore, CallbackTokenGuard, type CallbackUser, type ChannelState, type ChartType, ChatFeature, type ChatModelCreator, type ChatModelOrRunnable, type ChatModelWithTools, type CitationValue, type CompiledGraphFor, type ConcreteModels, type CustomDocument, DEFAULT_TRACER_OPTIONS, type DataEnvelope, ENDPOINT_METADATA_KEY, type EmbeddingModelCreator, Endpoint, type EndpointDescriptor, type EndpointHandler, type EndpointMetadata, type EndpointOptions, EndpointRegistry, EventProcessor, type ExtendedCallbackContext, type ExtendedCallbackHandler, ExternalGraphBuilder, FileBasedDiscovery, GraphController, GraphEngineFactory, GraphEngineType, GraphManifestSchema, GraphManifestValidator, GraphServiceTokens, GraphTypeUtils, type IAgentToolConfig, type IAgentToolConfiguration, type IAttachment, type IBaseEntity, type IChartDataPoint, type IChartDataset, type IChartValue, type IContentBlock, type IContentChain, type IDeletionInfo, type IGenericGraphType, type IGraphAttachment, type IGraphBuilder, type IGraphCompiler, type IGraphConfigurable, type IGraphEngine, type IGraphLogger, type IGraphManifest, type IGraphMetadata, type IGraphMetadataRegistry, type IGraphRequestPayload, type IGraphResponsePayload, type IGraphRunnableConfig, type IGraphService, type IGraphServiceRegistry, type IGraphSettingsRepository, type IGraphTraceEvent, type IGraphTracer, type IGraphTypeMetadata, type IGraphTypeRegistry, type IModelInitializer, type IReasoningChain, type IReasoningStep, type IStoredMessageContent, type ISystemToolCredentials, type IToolCall, type IToolCatalog, type IToolConfigOption, type IToolExecutionContext, type ITracingEvent, type IUsageMetrics, type IUsageRecorder, type IdempotencyConfig, type IdempotencyEntry, IdempotencyManager, IdempotencyStatus, type KnowledgeBaseInfo, type LLMCallRecord, type LLMConfig, type LLModel, LangGraphEngine, type MappedChannels, McpConverter, type McpRuntimeClient, McpRuntimeHttpClient, type McpTool, McpToolFilter, type Model, type ModelByIdConfig, type ModelByIdWithTypeConfig, type ModelConfig, type ModelConfigFetcher, type ModelConfigWithToken, type ModelConfigWithTokenAndType, type ModelCreator, type ModelCreators, ModelInitializer, ModelProvider, ModelType, type MongoDBConfig, type RateLimitConfig, type RateLimitResult, type RequestContext, type RerankModelCreator, type RetrieveQueryOptions, type RetrieverConfig, RetrieverSearchType, RetrieverService, type RouterConfig, type ServiceDiscoveryProvider, SmartCallbackRouter, StaticDiscovery, type StreamAccumulator, StreamChannel, type StrictGraphRunnableConfig, TelegramPatchHandler, type ToolExecutionResult, type TraceApiCallResult, type TracingLevel, UIDispatchController, type UIDispatchDto, UIEndpoint, type UIEndpointClassMetadata, type UIEndpointMethodMetadata, UIEndpointsDiscoveryService, UniversalCallbackService, UniversalGraphModule, type UniversalGraphModuleOptions, UniversalGraphService, type VersionResolution, type VersionResolutionOptions, type VersionRoute, VersionedGraphService, type VersioningConfig, VoyageAIRerank, type VoyageAIRerankConfig, WebPatchHandler, WithCallbacks, WithEndpoints, WithUIEndpoints, bootstrap, createEndpointDescriptors, createGraphAttachment, createMongoClientAdapter, createStaticMessage, findCallbackMethod, findEndpointMethod, generateAttachmentSummary, getCallbackMetadata, getEndpointMetadata, getUIEndpointClassMetadata, getUIEndpointMethodsMetadata, hasCallbacks, hasUIEndpoints, registerFinanceExampleCallback, registerUIEndpointsFromClass, sanitizeTraceData, traceApiCall };