@flutchai/flutch-sdk 0.2.10 → 0.2.14

package/dist/index.d.cts

@@ -1015,6 +1015,7 @@ interface ModelByIdConfig {
     modelId: string;
     temperature?: number;
     maxTokens?: number;
+    baseURL?: string;
     toolsConfig?: IAgentToolConfig[];
     customTools?: DynamicStructuredTool[];
 }
@@ -1029,6 +1030,7 @@ interface ModelConfigWithToken {
     requiresApiKey: boolean;
     useBedrock?: boolean;
     bedrockModelId?: string;
+    baseURL?: string;
 }
 type ApiKeyResolver = (provider: ModelProvider) => string | undefined;
 type LLModel = BaseChatModel;
@@ -1278,6 +1280,10 @@ interface ExecuteToolWithAttachmentsParams {
     injectIntoArg?: string;
     sourceAttachmentId?: string;
     threadId?: string;
+    toolSchema?: {
+        properties?: Record<string, any>;
+        required?: string[];
+    };
 }
 interface ExecuteToolWithAttachmentsResult {
     toolMessage: ToolMessage;
@@ -1287,7 +1293,10 @@ interface ExecuteToolWithAttachmentsResult {
     };
 }
 declare function executeToolWithAttachments(params: ExecuteToolWithAttachmentsParams): Promise<ExecuteToolWithAttachmentsResult>;
-declare function shouldInjectData(args: Record<string, any>, attachments: Record<string, IGraphAttachment>, dataArgName: string): boolean;
+declare function shouldInjectData(args: Record<string, any>, attachments: Record<string, IGraphAttachment>, dataArgName: string, toolSchema?: {
+    properties?: Record<string, any>;
+    required?: string[];
+}): boolean;
 declare const _internals: {
     shouldInjectData: typeof shouldInjectData;
     getLatestAttachment: typeof getLatestAttachment;
@@ -1702,6 +1711,23 @@ declare class OAuthTokenManager {
 declare function encryptTokens(tokens: OAuthTokens, key: string): string;
 declare function decryptTokens(encrypted: string, key: string): OAuthTokens;
 
+interface OAuthProviderDef {
+    name: string;
+    authorizationUrl: string;
+    tokenUrl: string;
+    scopes: string[];
+    clientIdEnvVar: string;
+    clientSecretEnvVar: string;
+}
+declare function loadOAuthProviders(providers: Record<string, OAuthProviderDef>): void;
+declare function getOAuthProvider(provider: string): OAuthProviderDef;
+declare function getOAuthProviderNames(): string[];
+declare function resolveOAuthProviderConfig(provider: string): OAuthProviderConfig;
+declare function buildOAuthAuthorizationUrl(provider: string, params: {
+    redirectUri: string;
+    state: string;
+}): string;
+
 declare class FileTokenStore implements IOAuthTokenStore {
     private readonly filePath;
     constructor(filePath: string);
@@ -1723,4 +1749,4 @@ declare class MongoTokenStore implements IOAuthTokenStore {
     private ensureIndex;
 }
 
-export { type ACLValidationResult, AbstractGraphBuilder, type ApiCallTracerOptions, type ApiKeyResolver, 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 CustomDocument, DEFAULT_ATTACHMENT_THRESHOLD, DEFAULT_TRACER_OPTIONS, type DataEnvelope, ENDPOINT_METADATA_KEY, type EmbeddingModelCreator, Endpoint, type EndpointDescriptor, type EndpointHandler, type EndpointMetadata, type EndpointOptions, EndpointRegistry, EventProcessor, type ExecuteToolWithAttachmentsParams, type ExecuteToolWithAttachmentsResult, type ExtendedCallbackContext, type ExtendedCallbackHandler, ExternalGraphBuilder, FileBasedDiscovery, FileTokenStore, 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 ILangGraphConfig, type IModelInitializer, type IOAuthTokenStore, 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 ModelConfigFetcher, type ModelConfigWithToken, type ModelConfigWithTokenAndType, type ModelCreators, ModelInitializer, ModelProvider, ModelType, type MongoDBConfig, MongoTokenStore, type OAuthProviderConfig, OAuthTokenManager, type OAuthTokenManagerOptions, type OAuthTokens, 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, _internals, bootstrap, clearAttachmentDataStore, createEndpointDescriptors, createGraphAttachment, createMongoClientAdapter, createStaticMessage, decryptTokens, dispatchAttachments, encryptTokens, executeToolWithAttachments, findCallbackMethod, findEndpointMethod, generateAttachmentSummary, getAttachmentData, getCallbackMetadata, getEndpointMetadata, getUIEndpointClassMetadata, getUIEndpointMethodsMetadata, hasCallbacks, hasUIEndpoints, registerFinanceExampleCallback, registerUIEndpointsFromClass, sanitizeTraceData, storeAttachmentData, traceApiCall };
+export { type ACLValidationResult, AbstractGraphBuilder, type ApiCallTracerOptions, type ApiKeyResolver, 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 CustomDocument, DEFAULT_ATTACHMENT_THRESHOLD, DEFAULT_TRACER_OPTIONS, type DataEnvelope, ENDPOINT_METADATA_KEY, type EmbeddingModelCreator, Endpoint, type EndpointDescriptor, type EndpointHandler, type EndpointMetadata, type EndpointOptions, EndpointRegistry, EventProcessor, type ExecuteToolWithAttachmentsParams, type ExecuteToolWithAttachmentsResult, type ExtendedCallbackContext, type ExtendedCallbackHandler, ExternalGraphBuilder, FileBasedDiscovery, FileTokenStore, 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 ILangGraphConfig, type IModelInitializer, type IOAuthTokenStore, 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 ModelConfigFetcher, type ModelConfigWithToken, type ModelConfigWithTokenAndType, type ModelCreators, ModelInitializer, ModelProvider, ModelType, type MongoDBConfig, MongoTokenStore, type OAuthProviderConfig, type OAuthProviderDef, OAuthTokenManager, type OAuthTokenManagerOptions, type OAuthTokens, 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, _internals, bootstrap, buildOAuthAuthorizationUrl, clearAttachmentDataStore, createEndpointDescriptors, createGraphAttachment, createMongoClientAdapter, createStaticMessage, decryptTokens, dispatchAttachments, encryptTokens, executeToolWithAttachments, findCallbackMethod, findEndpointMethod, generateAttachmentSummary, getAttachmentData, getCallbackMetadata, getEndpointMetadata, getOAuthProvider, getOAuthProviderNames, getUIEndpointClassMetadata, getUIEndpointMethodsMetadata, hasCallbacks, hasUIEndpoints, loadOAuthProviders, registerFinanceExampleCallback, registerUIEndpointsFromClass, resolveOAuthProviderConfig, sanitizeTraceData, storeAttachmentData, traceApiCall };

package/dist/index.d.ts

@@ -1015,6 +1015,7 @@ interface ModelByIdConfig {
     modelId: string;
     temperature?: number;
     maxTokens?: number;
+    baseURL?: string;
     toolsConfig?: IAgentToolConfig[];
     customTools?: DynamicStructuredTool[];
 }
@@ -1029,6 +1030,7 @@ interface ModelConfigWithToken {
     requiresApiKey: boolean;
     useBedrock?: boolean;
     bedrockModelId?: string;
+    baseURL?: string;
 }
 type ApiKeyResolver = (provider: ModelProvider) => string | undefined;
 type LLModel = BaseChatModel;
@@ -1278,6 +1280,10 @@ interface ExecuteToolWithAttachmentsParams {
     injectIntoArg?: string;
     sourceAttachmentId?: string;
     threadId?: string;
+    toolSchema?: {
+        properties?: Record<string, any>;
+        required?: string[];
+    };
 }
 interface ExecuteToolWithAttachmentsResult {
     toolMessage: ToolMessage;
@@ -1287,7 +1293,10 @@ interface ExecuteToolWithAttachmentsResult {
     };
 }
 declare function executeToolWithAttachments(params: ExecuteToolWithAttachmentsParams): Promise<ExecuteToolWithAttachmentsResult>;
-declare function shouldInjectData(args: Record<string, any>, attachments: Record<string, IGraphAttachment>, dataArgName: string): boolean;
+declare function shouldInjectData(args: Record<string, any>, attachments: Record<string, IGraphAttachment>, dataArgName: string, toolSchema?: {
+    properties?: Record<string, any>;
+    required?: string[];
+}): boolean;
 declare const _internals: {
     shouldInjectData: typeof shouldInjectData;
     getLatestAttachment: typeof getLatestAttachment;
@@ -1702,6 +1711,23 @@ declare class OAuthTokenManager {
 declare function encryptTokens(tokens: OAuthTokens, key: string): string;
 declare function decryptTokens(encrypted: string, key: string): OAuthTokens;
 
+interface OAuthProviderDef {
+    name: string;
+    authorizationUrl: string;
+    tokenUrl: string;
+    scopes: string[];
+    clientIdEnvVar: string;
+    clientSecretEnvVar: string;
+}
+declare function loadOAuthProviders(providers: Record<string, OAuthProviderDef>): void;
+declare function getOAuthProvider(provider: string): OAuthProviderDef;
+declare function getOAuthProviderNames(): string[];
+declare function resolveOAuthProviderConfig(provider: string): OAuthProviderConfig;
+declare function buildOAuthAuthorizationUrl(provider: string, params: {
+    redirectUri: string;
+    state: string;
+}): string;
+
 declare class FileTokenStore implements IOAuthTokenStore {
     private readonly filePath;
     constructor(filePath: string);
@@ -1723,4 +1749,4 @@ declare class MongoTokenStore implements IOAuthTokenStore {
     private ensureIndex;
 }
 
-export { type ACLValidationResult, AbstractGraphBuilder, type ApiCallTracerOptions, type ApiKeyResolver, 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 CustomDocument, DEFAULT_ATTACHMENT_THRESHOLD, DEFAULT_TRACER_OPTIONS, type DataEnvelope, ENDPOINT_METADATA_KEY, type EmbeddingModelCreator, Endpoint, type EndpointDescriptor, type EndpointHandler, type EndpointMetadata, type EndpointOptions, EndpointRegistry, EventProcessor, type ExecuteToolWithAttachmentsParams, type ExecuteToolWithAttachmentsResult, type ExtendedCallbackContext, type ExtendedCallbackHandler, ExternalGraphBuilder, FileBasedDiscovery, FileTokenStore, 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 ILangGraphConfig, type IModelInitializer, type IOAuthTokenStore, 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 ModelConfigFetcher, type ModelConfigWithToken, type ModelConfigWithTokenAndType, type ModelCreators, ModelInitializer, ModelProvider, ModelType, type MongoDBConfig, MongoTokenStore, type OAuthProviderConfig, OAuthTokenManager, type OAuthTokenManagerOptions, type OAuthTokens, 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, _internals, bootstrap, clearAttachmentDataStore, createEndpointDescriptors, createGraphAttachment, createMongoClientAdapter, createStaticMessage, decryptTokens, dispatchAttachments, encryptTokens, executeToolWithAttachments, findCallbackMethod, findEndpointMethod, generateAttachmentSummary, getAttachmentData, getCallbackMetadata, getEndpointMetadata, getUIEndpointClassMetadata, getUIEndpointMethodsMetadata, hasCallbacks, hasUIEndpoints, registerFinanceExampleCallback, registerUIEndpointsFromClass, sanitizeTraceData, storeAttachmentData, traceApiCall };
+export { type ACLValidationResult, AbstractGraphBuilder, type ApiCallTracerOptions, type ApiKeyResolver, 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 CustomDocument, DEFAULT_ATTACHMENT_THRESHOLD, DEFAULT_TRACER_OPTIONS, type DataEnvelope, ENDPOINT_METADATA_KEY, type EmbeddingModelCreator, Endpoint, type EndpointDescriptor, type EndpointHandler, type EndpointMetadata, type EndpointOptions, EndpointRegistry, EventProcessor, type ExecuteToolWithAttachmentsParams, type ExecuteToolWithAttachmentsResult, type ExtendedCallbackContext, type ExtendedCallbackHandler, ExternalGraphBuilder, FileBasedDiscovery, FileTokenStore, 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 ILangGraphConfig, type IModelInitializer, type IOAuthTokenStore, 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 ModelConfigFetcher, type ModelConfigWithToken, type ModelConfigWithTokenAndType, type ModelCreators, ModelInitializer, ModelProvider, ModelType, type MongoDBConfig, MongoTokenStore, type OAuthProviderConfig, type OAuthProviderDef, OAuthTokenManager, type OAuthTokenManagerOptions, type OAuthTokens, 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, _internals, bootstrap, buildOAuthAuthorizationUrl, clearAttachmentDataStore, createEndpointDescriptors, createGraphAttachment, createMongoClientAdapter, createStaticMessage, decryptTokens, dispatchAttachments, encryptTokens, executeToolWithAttachments, findCallbackMethod, findEndpointMethod, generateAttachmentSummary, getAttachmentData, getCallbackMetadata, getEndpointMetadata, getOAuthProvider, getOAuthProviderNames, getUIEndpointClassMetadata, getUIEndpointMethodsMetadata, hasCallbacks, hasUIEndpoints, loadOAuthProviders, registerFinanceExampleCallback, registerUIEndpointsFromClass, resolveOAuthProviderConfig, sanitizeTraceData, storeAttachmentData, traceApiCall };

package/dist/index.js

@@ -2818,8 +2818,8 @@ IdempotencyManager = __decorateClass([
 
 // src/callbacks/smart-callback.router.ts
 var SmartCallbackRouter = class {
-  constructor(registry, store, acl, auditor, metrics, rateLimiter, idempotencyManager, patchService) {
-    this.registry = registry;
+  constructor(registry2, store, acl, auditor, metrics, rateLimiter, idempotencyManager, patchService) {
+    this.registry = registry2;
     this.store = store;
     this.acl = acl;
     this.auditor = auditor;
@@ -3098,8 +3098,8 @@ var UniversalCallbackService = class {
 };
 
 // src/callbacks/example.callback.ts
-function registerFinanceExampleCallback(registry) {
-  registry.register(
+function registerFinanceExampleCallback(registry2) {
+  registry2.register(
     "example",
     async () => ({
       success: true,
@@ -3624,8 +3624,8 @@ var CallbackMetrics = class {
   activeCallbacks;
   pendingCallbacks;
   queueSize;
-  constructor(registry) {
-    this.registry = registry ?? new Registry();
+  constructor(registry2) {
+    this.registry = registry2 ?? new Registry();
     collectDefaultMetrics({ register: this.registry });
     this.callbacksTotal = new Counter({
       name: "graph_callbacks_total",
@@ -4447,11 +4447,17 @@ async function executeToolWithAttachments(params) {
     threshold = DEFAULT_ATTACHMENT_THRESHOLD,
     injectIntoArg = "data",
     sourceAttachmentId,
-    threadId
+    threadId,
+    toolSchema
   } = params;
   const argsWithInjection = { ...enrichedArgs };
   try {
-    if (shouldInjectData(argsWithInjection, attachments, injectIntoArg)) {
+    if (shouldInjectData(
+      argsWithInjection,
+      attachments,
+      injectIntoArg,
+      toolSchema
+    )) {
       const attachment = sourceAttachmentId ? attachments[sourceAttachmentId] : getLatestAttachment(attachments);
       if (attachment) {
         const attachmentKey = sourceAttachmentId || attachment.toolCallId;
@@ -4513,9 +4519,17 @@ async function executeToolWithAttachments(params) {
   });
   return { toolMessage };
 }
-function shouldInjectData(args, attachments, dataArgName) {
+function shouldInjectData(args, attachments, dataArgName, toolSchema) {
   if (Object.keys(attachments).length === 0) return false;
-  return args[dataArgName] === void 0;
+  if (args[dataArgName] !== void 0) return false;
+  if (toolSchema) {
+    const hasProperty = toolSchema.properties && dataArgName in toolSchema.properties;
+    const isRequired = toolSchema.required?.includes(dataArgName);
+    if (!hasProperty && !isRequired) {
+      return false;
+    }
+  }
+  return true;
 }
 var _internals = {
   shouldInjectData,
@@ -5628,7 +5642,7 @@ var UniversalGraphModule = class {
       },
       {
         provide: CallbackMetrics,
-        useFactory: (registry) => new CallbackMetrics(registry),
+        useFactory: (registry2) => new CallbackMetrics(registry2),
         inject: ["PROMETHEUS_REGISTRY"]
       },
       {
@@ -5656,8 +5670,8 @@ var UniversalGraphModule = class {
       },
       {
         provide: SmartCallbackRouter,
-        useFactory: (registry, store, acl, auditor, metrics, rateLimiter, idempotencyManager, patchService) => new SmartCallbackRouter(
-          registry,
+        useFactory: (registry2, store, acl, auditor, metrics, rateLimiter, idempotencyManager, patchService) => new SmartCallbackRouter(
+          registry2,
           store,
           acl,
           auditor,
@@ -5689,8 +5703,8 @@ var UniversalGraphModule = class {
       },
       {
         provide: "CALLBACK_EXAMPLE_REGISTRATION",
-        useFactory: (registry) => {
-          registerFinanceExampleCallback(registry);
+        useFactory: (registry2) => {
+          registerFinanceExampleCallback(registry2);
         },
         inject: [CallbackRegistry]
       },
@@ -5753,8 +5767,8 @@ var UniversalGraphModule = class {
       },
       {
         provide: "GRAPH_BUILDERS",
-        useFactory: (registry) => {
-          return registry.getBuilders();
+        useFactory: (registry2) => {
+          return registry2.getBuilders();
         },
         inject: [BuilderRegistryService]
       },
@@ -6422,12 +6436,19 @@ function hashToolsConfig(toolsConfig) {
   const sorted = toolsConfig.map((t) => `${t.toolName}:${t.enabled}:${JSON.stringify(t.config || {})}`).sort().join("|");
   return createHash("md5").update(sorted).digest("hex").slice(0, 16);
 }
-function generateModelCacheKey(modelId, temperature, maxTokens, toolsConfig) {
+var DEFAULT_ROUTER_URL = "https://router.flutch.ai";
+function resolveRouterURL(baseURL) {
+  return baseURL ?? process.env.FLUTCH_ROUTER_URL ?? DEFAULT_ROUTER_URL;
+}
+function generateModelCacheKey(modelId, temperature, maxTokens, toolsConfig, baseURL) {
   const parts = [
     modelId,
     temperature ?? "default",
     maxTokens ?? "default"
   ];
+  if (baseURL) {
+    parts.push(baseURL);
+  }
   if (toolsConfig && toolsConfig.length > 0) {
     parts.push(hashToolsConfig(toolsConfig));
   }
@@ -6555,7 +6576,8 @@ var ModelInitializer = class _ModelInitializer {
       config.modelId,
       config.temperature,
       config.maxTokens,
-      config.toolsConfig
+      config.toolsConfig,
+      config.baseURL
     );
   }
   // Chat model creators
@@ -6564,7 +6586,8 @@ var ModelInitializer = class _ModelInitializer {
       modelName,
       defaultTemperature,
       defaultMaxTokens,
-      apiToken
+      apiToken,
+      baseURL
     }) => {
       const config = buildOpenAIModelConfig(
         modelName,
@@ -6572,18 +6595,21 @@ var ModelInitializer = class _ModelInitializer {
         defaultMaxTokens,
         apiToken || this.resolveApiKey("openai" /* OPENAI */) || ""
       );
+      config.configuration = { baseURL: `${resolveRouterURL(baseURL)}/v1` };
       return new ChatOpenAI(config);
     },
     ["anthropic" /* ANTHROPIC */]: ({
       modelName,
       defaultTemperature,
       defaultMaxTokens,
-      apiToken
+      apiToken,
+      baseURL
     }) => new ChatAnthropic({
       modelName,
       temperature: defaultTemperature,
       maxTokens: defaultMaxTokens,
-      anthropicApiKey: apiToken || this.resolveApiKey("anthropic" /* ANTHROPIC */)
+      anthropicApiKey: apiToken || this.resolveApiKey("anthropic" /* ANTHROPIC */),
+      anthropicApiUrl: resolveRouterURL(baseURL)
     }),
     ["cohere" /* COHERE */]: ({
       modelName,
@@ -6665,7 +6691,8 @@ var ModelInitializer = class _ModelInitializer {
       ),
       defaultMaxTokens: Number(
         config.maxTokens ?? modelConfig.defaultMaxTokens
-      )
+      ),
+      baseURL: config.baseURL ?? modelConfig.baseURL
     };
     this.logger.debug(`Creating new chat model instance: ${cacheKey}`);
     let model;
@@ -7300,11 +7327,7 @@ var ALGORITHM = "aes-256-cbc";
 var IV_LENGTH = 16;
 function encryptTokens(tokens, key) {
   const iv = crypto.randomBytes(IV_LENGTH);
-  const cipher = crypto.createCipheriv(
-    ALGORITHM,
-    Buffer.from(key),
-    iv
-  );
+  const cipher = crypto.createCipheriv(ALGORITHM, Buffer.from(key), iv);
   const json = JSON.stringify(tokens);
   let encrypted = cipher.update(json, "utf8", "hex");
   encrypted += cipher.final("hex");
@@ -7318,11 +7341,7 @@ function decryptTokens(encrypted, key) {
   const ivHex = encrypted.substring(0, separatorIndex);
   const encryptedData = encrypted.substring(separatorIndex + 1);
   const iv = Buffer.from(ivHex, "hex");
-  const decipher = crypto.createDecipheriv(
-    ALGORITHM,
-    Buffer.from(key),
-    iv
-  );
+  const decipher = crypto.createDecipheriv(ALGORITHM, Buffer.from(key), iv);
   let decrypted = decipher.update(encryptedData, "hex", "utf8");
   decrypted += decipher.final("utf8");
   return JSON.parse(decrypted);
@@ -7363,7 +7382,10 @@ var OAuthTokenManager = class {
       this.setCache(config.provider, tokens.accessToken, tokens.expiresAt);
       return tokens.accessToken;
     }
-    const refreshed = await this.refreshAccessToken(config, tokens.refreshToken);
+    const refreshed = await this.refreshAccessToken(
+      config,
+      tokens.refreshToken
+    );
     await this.persistTokens(config.provider, refreshed);
     return refreshed.accessToken;
   }
@@ -7427,6 +7449,56 @@ var OAuthTokenManager = class {
     this.cache.set(provider, { token, expiresAt });
   }
 };
+
+// src/oauth/oauth-provider.registry.ts
+var registry = {};
+function loadOAuthProviders(providers) {
+  registry = { ...providers };
+}
+function getOAuthProvider(provider) {
+  const def = registry[provider];
+  if (!def) {
+    throw new Error(`Unknown OAuth provider: ${provider}`);
+  }
+  return def;
+}
+function getOAuthProviderNames() {
+  return Object.keys(registry);
+}
+function resolveOAuthProviderConfig(provider) {
+  const def = getOAuthProvider(provider);
+  const clientId = process.env[def.clientIdEnvVar];
+  const clientSecret = process.env[def.clientSecretEnvVar];
+  if (!clientId) {
+    throw new Error(`Missing env var: ${def.clientIdEnvVar}`);
+  }
+  if (!clientSecret) {
+    throw new Error(`Missing env var: ${def.clientSecretEnvVar}`);
+  }
+  return {
+    provider: def.name,
+    tokenUrl: def.tokenUrl,
+    clientId,
+    clientSecret
+  };
+}
+function buildOAuthAuthorizationUrl(provider, params) {
+  const def = getOAuthProvider(provider);
+  const clientId = process.env[def.clientIdEnvVar];
+  if (!clientId) {
+    throw new Error(`Missing env var: ${def.clientIdEnvVar}`);
+  }
+  const query = new URLSearchParams({
+    client_id: clientId,
+    redirect_uri: params.redirectUri,
+    response_type: "code",
+    state: params.state
+  });
+  if (def.scopes.length > 0) {
+    query.set("scope", def.scopes.join(" "));
+  }
+  return `${def.authorizationUrl}?${query.toString()}`;
+}
 var FileTokenStore = class {
   constructor(filePath) {
     this.filePath = filePath;
@@ -7496,6 +7568,6 @@ var MongoTokenStore = class {
   }
 };
 
-export { AbstractGraphBuilder, AttachmentType, GraphController as BaseGraphServiceController, UniversalGraphModule as BaseGraphServiceModule, BuilderRegistryService, Callback, CallbackACL, CallbackAuditAction, CallbackAuditor, CallbackController, CallbackMetrics, CallbackPatchService, CallbackRateLimiter, CallbackRegistry, CallbackStore, CallbackTokenGuard, ChatFeature, DEFAULT_ATTACHMENT_THRESHOLD, DEFAULT_TRACER_OPTIONS, ENDPOINT_METADATA_KEY, Endpoint, EndpointRegistry, EventProcessor, ExternalGraphBuilder, FileBasedDiscovery, FileTokenStore, GraphController, GraphEngineFactory, GraphEngineType, GraphManifestSchema, GraphManifestValidator, GraphServiceTokens, GraphTypeUtils, IdempotencyManager, IdempotencyStatus, LangGraphEngine, McpConverter, McpRuntimeHttpClient, McpToolFilter, ModelInitializer, ModelProvider, ModelType, MongoTokenStore, OAuthTokenManager, RetrieverSearchType, RetrieverService, SmartCallbackRouter, StaticDiscovery, StreamChannel, TelegramPatchHandler, UIDispatchController, UIEndpoint, UIEndpointsDiscoveryService, UniversalCallbackService, UniversalGraphModule, UniversalGraphService, VersionedGraphService, VoyageAIRerank, WebPatchHandler, WithCallbacks, WithEndpoints, WithUIEndpoints, _internals, bootstrap, clearAttachmentDataStore, createEndpointDescriptors, createGraphAttachment, createMongoClientAdapter, createStaticMessage, decryptTokens, dispatchAttachments, encryptTokens, executeToolWithAttachments, findCallbackMethod, findEndpointMethod, generateAttachmentSummary, getAttachmentData, getCallbackMetadata, getEndpointMetadata, getUIEndpointClassMetadata, getUIEndpointMethodsMetadata, hasCallbacks, hasUIEndpoints, registerFinanceExampleCallback, registerUIEndpointsFromClass, sanitizeTraceData, storeAttachmentData, traceApiCall };
+export { AbstractGraphBuilder, AttachmentType, GraphController as BaseGraphServiceController, UniversalGraphModule as BaseGraphServiceModule, BuilderRegistryService, Callback, CallbackACL, CallbackAuditAction, CallbackAuditor, CallbackController, CallbackMetrics, CallbackPatchService, CallbackRateLimiter, CallbackRegistry, CallbackStore, CallbackTokenGuard, ChatFeature, DEFAULT_ATTACHMENT_THRESHOLD, DEFAULT_TRACER_OPTIONS, ENDPOINT_METADATA_KEY, Endpoint, EndpointRegistry, EventProcessor, ExternalGraphBuilder, FileBasedDiscovery, FileTokenStore, GraphController, GraphEngineFactory, GraphEngineType, GraphManifestSchema, GraphManifestValidator, GraphServiceTokens, GraphTypeUtils, IdempotencyManager, IdempotencyStatus, LangGraphEngine, McpConverter, McpRuntimeHttpClient, McpToolFilter, ModelInitializer, ModelProvider, ModelType, MongoTokenStore, OAuthTokenManager, RetrieverSearchType, RetrieverService, SmartCallbackRouter, StaticDiscovery, StreamChannel, TelegramPatchHandler, UIDispatchController, UIEndpoint, UIEndpointsDiscoveryService, UniversalCallbackService, UniversalGraphModule, UniversalGraphService, VersionedGraphService, VoyageAIRerank, WebPatchHandler, WithCallbacks, WithEndpoints, WithUIEndpoints, _internals, bootstrap, buildOAuthAuthorizationUrl, clearAttachmentDataStore, createEndpointDescriptors, createGraphAttachment, createMongoClientAdapter, createStaticMessage, decryptTokens, dispatchAttachments, encryptTokens, executeToolWithAttachments, findCallbackMethod, findEndpointMethod, generateAttachmentSummary, getAttachmentData, getCallbackMetadata, getEndpointMetadata, getOAuthProvider, getOAuthProviderNames, getUIEndpointClassMetadata, getUIEndpointMethodsMetadata, hasCallbacks, hasUIEndpoints, loadOAuthProviders, registerFinanceExampleCallback, registerUIEndpointsFromClass, resolveOAuthProviderConfig, sanitizeTraceData, storeAttachmentData, traceApiCall };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map