nvidia-nat 1.2.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- aiq/__init__.py +66 -0
- nat/agent/__init__.py +0 -0
- nat/agent/base.py +256 -0
- nat/agent/dual_node.py +67 -0
- nat/agent/react_agent/__init__.py +0 -0
- nat/agent/react_agent/agent.py +363 -0
- nat/agent/react_agent/output_parser.py +104 -0
- nat/agent/react_agent/prompt.py +44 -0
- nat/agent/react_agent/register.py +149 -0
- nat/agent/reasoning_agent/__init__.py +0 -0
- nat/agent/reasoning_agent/reasoning_agent.py +225 -0
- nat/agent/register.py +23 -0
- nat/agent/rewoo_agent/__init__.py +0 -0
- nat/agent/rewoo_agent/agent.py +415 -0
- nat/agent/rewoo_agent/prompt.py +110 -0
- nat/agent/rewoo_agent/register.py +157 -0
- nat/agent/tool_calling_agent/__init__.py +0 -0
- nat/agent/tool_calling_agent/agent.py +119 -0
- nat/agent/tool_calling_agent/register.py +106 -0
- nat/authentication/__init__.py +14 -0
- nat/authentication/api_key/__init__.py +14 -0
- nat/authentication/api_key/api_key_auth_provider.py +96 -0
- nat/authentication/api_key/api_key_auth_provider_config.py +124 -0
- nat/authentication/api_key/register.py +26 -0
- nat/authentication/exceptions/__init__.py +14 -0
- nat/authentication/exceptions/api_key_exceptions.py +38 -0
- nat/authentication/http_basic_auth/__init__.py +0 -0
- nat/authentication/http_basic_auth/http_basic_auth_provider.py +81 -0
- nat/authentication/http_basic_auth/register.py +30 -0
- nat/authentication/interfaces.py +93 -0
- nat/authentication/oauth2/__init__.py +14 -0
- nat/authentication/oauth2/oauth2_auth_code_flow_provider.py +107 -0
- nat/authentication/oauth2/oauth2_auth_code_flow_provider_config.py +39 -0
- nat/authentication/oauth2/register.py +25 -0
- nat/authentication/register.py +21 -0
- nat/builder/__init__.py +0 -0
- nat/builder/builder.py +285 -0
- nat/builder/component_utils.py +316 -0
- nat/builder/context.py +270 -0
- nat/builder/embedder.py +24 -0
- nat/builder/eval_builder.py +161 -0
- nat/builder/evaluator.py +29 -0
- nat/builder/framework_enum.py +24 -0
- nat/builder/front_end.py +73 -0
- nat/builder/function.py +344 -0
- nat/builder/function_base.py +380 -0
- nat/builder/function_info.py +627 -0
- nat/builder/intermediate_step_manager.py +174 -0
- nat/builder/llm.py +25 -0
- nat/builder/retriever.py +25 -0
- nat/builder/user_interaction_manager.py +78 -0
- nat/builder/workflow.py +148 -0
- nat/builder/workflow_builder.py +1117 -0
- nat/cli/__init__.py +14 -0
- nat/cli/cli_utils/__init__.py +0 -0
- nat/cli/cli_utils/config_override.py +231 -0
- nat/cli/cli_utils/validation.py +37 -0
- nat/cli/commands/__init__.py +0 -0
- nat/cli/commands/configure/__init__.py +0 -0
- nat/cli/commands/configure/channel/__init__.py +0 -0
- nat/cli/commands/configure/channel/add.py +28 -0
- nat/cli/commands/configure/channel/channel.py +34 -0
- nat/cli/commands/configure/channel/remove.py +30 -0
- nat/cli/commands/configure/channel/update.py +30 -0
- nat/cli/commands/configure/configure.py +33 -0
- nat/cli/commands/evaluate.py +139 -0
- nat/cli/commands/info/__init__.py +14 -0
- nat/cli/commands/info/info.py +37 -0
- nat/cli/commands/info/list_channels.py +32 -0
- nat/cli/commands/info/list_components.py +129 -0
- nat/cli/commands/info/list_mcp.py +304 -0
- nat/cli/commands/registry/__init__.py +14 -0
- nat/cli/commands/registry/publish.py +88 -0
- nat/cli/commands/registry/pull.py +118 -0
- nat/cli/commands/registry/registry.py +36 -0
- nat/cli/commands/registry/remove.py +108 -0
- nat/cli/commands/registry/search.py +155 -0
- nat/cli/commands/sizing/__init__.py +14 -0
- nat/cli/commands/sizing/calc.py +297 -0
- nat/cli/commands/sizing/sizing.py +27 -0
- nat/cli/commands/start.py +246 -0
- nat/cli/commands/uninstall.py +81 -0
- nat/cli/commands/validate.py +47 -0
- nat/cli/commands/workflow/__init__.py +14 -0
- nat/cli/commands/workflow/templates/__init__.py.j2 +0 -0
- nat/cli/commands/workflow/templates/config.yml.j2 +16 -0
- nat/cli/commands/workflow/templates/pyproject.toml.j2 +22 -0
- nat/cli/commands/workflow/templates/register.py.j2 +5 -0
- nat/cli/commands/workflow/templates/workflow.py.j2 +36 -0
- nat/cli/commands/workflow/workflow.py +37 -0
- nat/cli/commands/workflow/workflow_commands.py +317 -0
- nat/cli/entrypoint.py +135 -0
- nat/cli/main.py +57 -0
- nat/cli/register_workflow.py +488 -0
- nat/cli/type_registry.py +1000 -0
- nat/data_models/__init__.py +14 -0
- nat/data_models/api_server.py +716 -0
- nat/data_models/authentication.py +231 -0
- nat/data_models/common.py +171 -0
- nat/data_models/component.py +58 -0
- nat/data_models/component_ref.py +168 -0
- nat/data_models/config.py +410 -0
- nat/data_models/dataset_handler.py +169 -0
- nat/data_models/discovery_metadata.py +305 -0
- nat/data_models/embedder.py +27 -0
- nat/data_models/evaluate.py +127 -0
- nat/data_models/evaluator.py +26 -0
- nat/data_models/front_end.py +26 -0
- nat/data_models/function.py +30 -0
- nat/data_models/function_dependencies.py +72 -0
- nat/data_models/interactive.py +246 -0
- nat/data_models/intermediate_step.py +302 -0
- nat/data_models/invocation_node.py +38 -0
- nat/data_models/llm.py +27 -0
- nat/data_models/logging.py +26 -0
- nat/data_models/memory.py +27 -0
- nat/data_models/object_store.py +44 -0
- nat/data_models/profiler.py +54 -0
- nat/data_models/registry_handler.py +26 -0
- nat/data_models/retriever.py +30 -0
- nat/data_models/retry_mixin.py +35 -0
- nat/data_models/span.py +190 -0
- nat/data_models/step_adaptor.py +64 -0
- nat/data_models/streaming.py +33 -0
- nat/data_models/swe_bench_model.py +54 -0
- nat/data_models/telemetry_exporter.py +26 -0
- nat/data_models/ttc_strategy.py +30 -0
- nat/embedder/__init__.py +0 -0
- nat/embedder/nim_embedder.py +59 -0
- nat/embedder/openai_embedder.py +43 -0
- nat/embedder/register.py +22 -0
- nat/eval/__init__.py +14 -0
- nat/eval/config.py +60 -0
- nat/eval/dataset_handler/__init__.py +0 -0
- nat/eval/dataset_handler/dataset_downloader.py +106 -0
- nat/eval/dataset_handler/dataset_filter.py +52 -0
- nat/eval/dataset_handler/dataset_handler.py +367 -0
- nat/eval/evaluate.py +510 -0
- nat/eval/evaluator/__init__.py +14 -0
- nat/eval/evaluator/base_evaluator.py +77 -0
- nat/eval/evaluator/evaluator_model.py +45 -0
- nat/eval/intermediate_step_adapter.py +99 -0
- nat/eval/rag_evaluator/__init__.py +0 -0
- nat/eval/rag_evaluator/evaluate.py +178 -0
- nat/eval/rag_evaluator/register.py +143 -0
- nat/eval/register.py +23 -0
- nat/eval/remote_workflow.py +133 -0
- nat/eval/runners/__init__.py +14 -0
- nat/eval/runners/config.py +39 -0
- nat/eval/runners/multi_eval_runner.py +54 -0
- nat/eval/runtime_event_subscriber.py +52 -0
- nat/eval/swe_bench_evaluator/__init__.py +0 -0
- nat/eval/swe_bench_evaluator/evaluate.py +215 -0
- nat/eval/swe_bench_evaluator/register.py +36 -0
- nat/eval/trajectory_evaluator/__init__.py +0 -0
- nat/eval/trajectory_evaluator/evaluate.py +75 -0
- nat/eval/trajectory_evaluator/register.py +40 -0
- nat/eval/tunable_rag_evaluator/__init__.py +0 -0
- nat/eval/tunable_rag_evaluator/evaluate.py +245 -0
- nat/eval/tunable_rag_evaluator/register.py +52 -0
- nat/eval/usage_stats.py +41 -0
- nat/eval/utils/__init__.py +0 -0
- nat/eval/utils/output_uploader.py +140 -0
- nat/eval/utils/tqdm_position_registry.py +40 -0
- nat/eval/utils/weave_eval.py +184 -0
- nat/experimental/__init__.py +0 -0
- nat/experimental/decorators/__init__.py +0 -0
- nat/experimental/decorators/experimental_warning_decorator.py +134 -0
- nat/experimental/test_time_compute/__init__.py +0 -0
- nat/experimental/test_time_compute/editing/__init__.py +0 -0
- nat/experimental/test_time_compute/editing/iterative_plan_refinement_editor.py +147 -0
- nat/experimental/test_time_compute/editing/llm_as_a_judge_editor.py +204 -0
- nat/experimental/test_time_compute/editing/motivation_aware_summarization.py +107 -0
- nat/experimental/test_time_compute/functions/__init__.py +0 -0
- nat/experimental/test_time_compute/functions/execute_score_select_function.py +105 -0
- nat/experimental/test_time_compute/functions/plan_select_execute_function.py +224 -0
- nat/experimental/test_time_compute/functions/ttc_tool_orchestration_function.py +205 -0
- nat/experimental/test_time_compute/functions/ttc_tool_wrapper_function.py +146 -0
- nat/experimental/test_time_compute/models/__init__.py +0 -0
- nat/experimental/test_time_compute/models/editor_config.py +132 -0
- nat/experimental/test_time_compute/models/scoring_config.py +112 -0
- nat/experimental/test_time_compute/models/search_config.py +120 -0
- nat/experimental/test_time_compute/models/selection_config.py +154 -0
- nat/experimental/test_time_compute/models/stage_enums.py +43 -0
- nat/experimental/test_time_compute/models/strategy_base.py +66 -0
- nat/experimental/test_time_compute/models/tool_use_config.py +41 -0
- nat/experimental/test_time_compute/models/ttc_item.py +48 -0
- nat/experimental/test_time_compute/register.py +36 -0
- nat/experimental/test_time_compute/scoring/__init__.py +0 -0
- nat/experimental/test_time_compute/scoring/llm_based_agent_scorer.py +168 -0
- nat/experimental/test_time_compute/scoring/llm_based_plan_scorer.py +168 -0
- nat/experimental/test_time_compute/scoring/motivation_aware_scorer.py +111 -0
- nat/experimental/test_time_compute/search/__init__.py +0 -0
- nat/experimental/test_time_compute/search/multi_llm_planner.py +128 -0
- nat/experimental/test_time_compute/search/multi_query_retrieval_search.py +122 -0
- nat/experimental/test_time_compute/search/single_shot_multi_plan_planner.py +128 -0
- nat/experimental/test_time_compute/selection/__init__.py +0 -0
- nat/experimental/test_time_compute/selection/best_of_n_selector.py +63 -0
- nat/experimental/test_time_compute/selection/llm_based_agent_output_selector.py +131 -0
- nat/experimental/test_time_compute/selection/llm_based_output_merging_selector.py +159 -0
- nat/experimental/test_time_compute/selection/llm_based_plan_selector.py +128 -0
- nat/experimental/test_time_compute/selection/threshold_selector.py +58 -0
- nat/front_ends/__init__.py +14 -0
- nat/front_ends/console/__init__.py +14 -0
- nat/front_ends/console/authentication_flow_handler.py +233 -0
- nat/front_ends/console/console_front_end_config.py +32 -0
- nat/front_ends/console/console_front_end_plugin.py +96 -0
- nat/front_ends/console/register.py +25 -0
- nat/front_ends/cron/__init__.py +14 -0
- nat/front_ends/fastapi/__init__.py +14 -0
- nat/front_ends/fastapi/auth_flow_handlers/__init__.py +0 -0
- nat/front_ends/fastapi/auth_flow_handlers/http_flow_handler.py +27 -0
- nat/front_ends/fastapi/auth_flow_handlers/websocket_flow_handler.py +107 -0
- nat/front_ends/fastapi/fastapi_front_end_config.py +241 -0
- nat/front_ends/fastapi/fastapi_front_end_controller.py +68 -0
- nat/front_ends/fastapi/fastapi_front_end_plugin.py +116 -0
- nat/front_ends/fastapi/fastapi_front_end_plugin_worker.py +1087 -0
- nat/front_ends/fastapi/html_snippets/__init__.py +14 -0
- nat/front_ends/fastapi/html_snippets/auth_code_grant_success.py +35 -0
- nat/front_ends/fastapi/intermediate_steps_subscriber.py +80 -0
- nat/front_ends/fastapi/job_store.py +183 -0
- nat/front_ends/fastapi/main.py +72 -0
- nat/front_ends/fastapi/message_handler.py +320 -0
- nat/front_ends/fastapi/message_validator.py +352 -0
- nat/front_ends/fastapi/register.py +25 -0
- nat/front_ends/fastapi/response_helpers.py +195 -0
- nat/front_ends/fastapi/step_adaptor.py +319 -0
- nat/front_ends/mcp/__init__.py +14 -0
- nat/front_ends/mcp/mcp_front_end_config.py +36 -0
- nat/front_ends/mcp/mcp_front_end_plugin.py +81 -0
- nat/front_ends/mcp/mcp_front_end_plugin_worker.py +143 -0
- nat/front_ends/mcp/register.py +27 -0
- nat/front_ends/mcp/tool_converter.py +241 -0
- nat/front_ends/register.py +22 -0
- nat/front_ends/simple_base/__init__.py +14 -0
- nat/front_ends/simple_base/simple_front_end_plugin_base.py +54 -0
- nat/llm/__init__.py +0 -0
- nat/llm/aws_bedrock_llm.py +57 -0
- nat/llm/nim_llm.py +46 -0
- nat/llm/openai_llm.py +46 -0
- nat/llm/register.py +23 -0
- nat/llm/utils/__init__.py +14 -0
- nat/llm/utils/env_config_value.py +94 -0
- nat/llm/utils/error.py +17 -0
- nat/memory/__init__.py +20 -0
- nat/memory/interfaces.py +183 -0
- nat/memory/models.py +112 -0
- nat/meta/pypi.md +58 -0
- nat/object_store/__init__.py +20 -0
- nat/object_store/in_memory_object_store.py +76 -0
- nat/object_store/interfaces.py +84 -0
- nat/object_store/models.py +38 -0
- nat/object_store/register.py +20 -0
- nat/observability/__init__.py +14 -0
- nat/observability/exporter/__init__.py +14 -0
- nat/observability/exporter/base_exporter.py +449 -0
- nat/observability/exporter/exporter.py +78 -0
- nat/observability/exporter/file_exporter.py +33 -0
- nat/observability/exporter/processing_exporter.py +322 -0
- nat/observability/exporter/raw_exporter.py +52 -0
- nat/observability/exporter/span_exporter.py +288 -0
- nat/observability/exporter_manager.py +335 -0
- nat/observability/mixin/__init__.py +14 -0
- nat/observability/mixin/batch_config_mixin.py +26 -0
- nat/observability/mixin/collector_config_mixin.py +23 -0
- nat/observability/mixin/file_mixin.py +288 -0
- nat/observability/mixin/file_mode.py +23 -0
- nat/observability/mixin/resource_conflict_mixin.py +134 -0
- nat/observability/mixin/serialize_mixin.py +61 -0
- nat/observability/mixin/type_introspection_mixin.py +183 -0
- nat/observability/processor/__init__.py +14 -0
- nat/observability/processor/batching_processor.py +310 -0
- nat/observability/processor/callback_processor.py +42 -0
- nat/observability/processor/intermediate_step_serializer.py +28 -0
- nat/observability/processor/processor.py +71 -0
- nat/observability/register.py +96 -0
- nat/observability/utils/__init__.py +14 -0
- nat/observability/utils/dict_utils.py +236 -0
- nat/observability/utils/time_utils.py +31 -0
- nat/plugins/.namespace +1 -0
- nat/profiler/__init__.py +0 -0
- nat/profiler/calc/__init__.py +14 -0
- nat/profiler/calc/calc_runner.py +627 -0
- nat/profiler/calc/calculations.py +288 -0
- nat/profiler/calc/data_models.py +188 -0
- nat/profiler/calc/plot.py +345 -0
- nat/profiler/callbacks/__init__.py +0 -0
- nat/profiler/callbacks/agno_callback_handler.py +295 -0
- nat/profiler/callbacks/base_callback_class.py +20 -0
- nat/profiler/callbacks/langchain_callback_handler.py +290 -0
- nat/profiler/callbacks/llama_index_callback_handler.py +205 -0
- nat/profiler/callbacks/semantic_kernel_callback_handler.py +238 -0
- nat/profiler/callbacks/token_usage_base_model.py +27 -0
- nat/profiler/data_frame_row.py +51 -0
- nat/profiler/data_models.py +24 -0
- nat/profiler/decorators/__init__.py +0 -0
- nat/profiler/decorators/framework_wrapper.py +131 -0
- nat/profiler/decorators/function_tracking.py +254 -0
- nat/profiler/forecasting/__init__.py +0 -0
- nat/profiler/forecasting/config.py +18 -0
- nat/profiler/forecasting/model_trainer.py +75 -0
- nat/profiler/forecasting/models/__init__.py +22 -0
- nat/profiler/forecasting/models/forecasting_base_model.py +40 -0
- nat/profiler/forecasting/models/linear_model.py +197 -0
- nat/profiler/forecasting/models/random_forest_regressor.py +269 -0
- nat/profiler/inference_metrics_model.py +28 -0
- nat/profiler/inference_optimization/__init__.py +0 -0
- nat/profiler/inference_optimization/bottleneck_analysis/__init__.py +0 -0
- nat/profiler/inference_optimization/bottleneck_analysis/nested_stack_analysis.py +460 -0
- nat/profiler/inference_optimization/bottleneck_analysis/simple_stack_analysis.py +258 -0
- nat/profiler/inference_optimization/data_models.py +386 -0
- nat/profiler/inference_optimization/experimental/__init__.py +0 -0
- nat/profiler/inference_optimization/experimental/concurrency_spike_analysis.py +468 -0
- nat/profiler/inference_optimization/experimental/prefix_span_analysis.py +405 -0
- nat/profiler/inference_optimization/llm_metrics.py +212 -0
- nat/profiler/inference_optimization/prompt_caching.py +163 -0
- nat/profiler/inference_optimization/token_uniqueness.py +107 -0
- nat/profiler/inference_optimization/workflow_runtimes.py +72 -0
- nat/profiler/intermediate_property_adapter.py +102 -0
- nat/profiler/profile_runner.py +473 -0
- nat/profiler/utils.py +184 -0
- nat/registry_handlers/__init__.py +0 -0
- nat/registry_handlers/local/__init__.py +0 -0
- nat/registry_handlers/local/local_handler.py +176 -0
- nat/registry_handlers/local/register_local.py +37 -0
- nat/registry_handlers/metadata_factory.py +60 -0
- nat/registry_handlers/package_utils.py +571 -0
- nat/registry_handlers/pypi/__init__.py +0 -0
- nat/registry_handlers/pypi/pypi_handler.py +251 -0
- nat/registry_handlers/pypi/register_pypi.py +40 -0
- nat/registry_handlers/register.py +21 -0
- nat/registry_handlers/registry_handler_base.py +157 -0
- nat/registry_handlers/rest/__init__.py +0 -0
- nat/registry_handlers/rest/register_rest.py +56 -0
- nat/registry_handlers/rest/rest_handler.py +237 -0
- nat/registry_handlers/schemas/__init__.py +0 -0
- nat/registry_handlers/schemas/headers.py +42 -0
- nat/registry_handlers/schemas/package.py +68 -0
- nat/registry_handlers/schemas/publish.py +68 -0
- nat/registry_handlers/schemas/pull.py +82 -0
- nat/registry_handlers/schemas/remove.py +36 -0
- nat/registry_handlers/schemas/search.py +91 -0
- nat/registry_handlers/schemas/status.py +47 -0
- nat/retriever/__init__.py +0 -0
- nat/retriever/interface.py +41 -0
- nat/retriever/milvus/__init__.py +14 -0
- nat/retriever/milvus/register.py +81 -0
- nat/retriever/milvus/retriever.py +228 -0
- nat/retriever/models.py +77 -0
- nat/retriever/nemo_retriever/__init__.py +14 -0
- nat/retriever/nemo_retriever/register.py +60 -0
- nat/retriever/nemo_retriever/retriever.py +190 -0
- nat/retriever/register.py +22 -0
- nat/runtime/__init__.py +14 -0
- nat/runtime/loader.py +220 -0
- nat/runtime/runner.py +195 -0
- nat/runtime/session.py +162 -0
- nat/runtime/user_metadata.py +130 -0
- nat/settings/__init__.py +0 -0
- nat/settings/global_settings.py +318 -0
- nat/test/.namespace +1 -0
- nat/tool/__init__.py +0 -0
- nat/tool/chat_completion.py +74 -0
- nat/tool/code_execution/README.md +151 -0
- nat/tool/code_execution/__init__.py +0 -0
- nat/tool/code_execution/code_sandbox.py +267 -0
- nat/tool/code_execution/local_sandbox/.gitignore +1 -0
- nat/tool/code_execution/local_sandbox/Dockerfile.sandbox +60 -0
- nat/tool/code_execution/local_sandbox/__init__.py +13 -0
- nat/tool/code_execution/local_sandbox/local_sandbox_server.py +198 -0
- nat/tool/code_execution/local_sandbox/sandbox.requirements.txt +6 -0
- nat/tool/code_execution/local_sandbox/start_local_sandbox.sh +50 -0
- nat/tool/code_execution/register.py +74 -0
- nat/tool/code_execution/test_code_execution_sandbox.py +414 -0
- nat/tool/code_execution/utils.py +100 -0
- nat/tool/datetime_tools.py +42 -0
- nat/tool/document_search.py +141 -0
- nat/tool/github_tools/__init__.py +0 -0
- nat/tool/github_tools/create_github_commit.py +133 -0
- nat/tool/github_tools/create_github_issue.py +87 -0
- nat/tool/github_tools/create_github_pr.py +106 -0
- nat/tool/github_tools/get_github_file.py +106 -0
- nat/tool/github_tools/get_github_issue.py +166 -0
- nat/tool/github_tools/get_github_pr.py +256 -0
- nat/tool/github_tools/update_github_issue.py +100 -0
- nat/tool/mcp/__init__.py +14 -0
- nat/tool/mcp/exceptions.py +142 -0
- nat/tool/mcp/mcp_client.py +255 -0
- nat/tool/mcp/mcp_tool.py +96 -0
- nat/tool/memory_tools/__init__.py +0 -0
- nat/tool/memory_tools/add_memory_tool.py +79 -0
- nat/tool/memory_tools/delete_memory_tool.py +67 -0
- nat/tool/memory_tools/get_memory_tool.py +72 -0
- nat/tool/nvidia_rag.py +95 -0
- nat/tool/register.py +38 -0
- nat/tool/retriever.py +94 -0
- nat/tool/server_tools.py +66 -0
- nat/utils/__init__.py +0 -0
- nat/utils/data_models/__init__.py +0 -0
- nat/utils/data_models/schema_validator.py +58 -0
- nat/utils/debugging_utils.py +43 -0
- nat/utils/dump_distro_mapping.py +32 -0
- nat/utils/exception_handlers/__init__.py +0 -0
- nat/utils/exception_handlers/automatic_retries.py +289 -0
- nat/utils/exception_handlers/mcp.py +211 -0
- nat/utils/exception_handlers/schemas.py +114 -0
- nat/utils/io/__init__.py +0 -0
- nat/utils/io/model_processing.py +28 -0
- nat/utils/io/yaml_tools.py +119 -0
- nat/utils/log_utils.py +37 -0
- nat/utils/metadata_utils.py +74 -0
- nat/utils/optional_imports.py +142 -0
- nat/utils/producer_consumer_queue.py +178 -0
- nat/utils/reactive/__init__.py +0 -0
- nat/utils/reactive/base/__init__.py +0 -0
- nat/utils/reactive/base/observable_base.py +65 -0
- nat/utils/reactive/base/observer_base.py +55 -0
- nat/utils/reactive/base/subject_base.py +79 -0
- nat/utils/reactive/observable.py +59 -0
- nat/utils/reactive/observer.py +76 -0
- nat/utils/reactive/subject.py +131 -0
- nat/utils/reactive/subscription.py +49 -0
- nat/utils/settings/__init__.py +0 -0
- nat/utils/settings/global_settings.py +197 -0
- nat/utils/string_utils.py +38 -0
- nat/utils/type_converter.py +290 -0
- nat/utils/type_utils.py +484 -0
- nat/utils/url_utils.py +27 -0
- nvidia_nat-1.2.0.dist-info/METADATA +365 -0
- nvidia_nat-1.2.0.dist-info/RECORD +435 -0
- nvidia_nat-1.2.0.dist-info/WHEEL +5 -0
- nvidia_nat-1.2.0.dist-info/entry_points.txt +21 -0
- nvidia_nat-1.2.0.dist-info/licenses/LICENSE-3rd-party.txt +5478 -0
- nvidia_nat-1.2.0.dist-info/licenses/LICENSE.md +201 -0
- nvidia_nat-1.2.0.dist-info/top_level.txt +2 -0
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
|
|
16
|
+
import logging
|
|
17
|
+
from abc import ABC
|
|
18
|
+
from abc import abstractmethod
|
|
19
|
+
|
|
20
|
+
from mcp.server.fastmcp import FastMCP
|
|
21
|
+
from starlette.requests import Request
|
|
22
|
+
|
|
23
|
+
from nat.builder.function import Function
|
|
24
|
+
from nat.builder.workflow import Workflow
|
|
25
|
+
from nat.builder.workflow_builder import WorkflowBuilder
|
|
26
|
+
from nat.data_models.config import Config
|
|
27
|
+
from nat.front_ends.mcp.mcp_front_end_config import MCPFrontEndConfig
|
|
28
|
+
|
|
29
|
+
logger = logging.getLogger(__name__)
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
class MCPFrontEndPluginWorkerBase(ABC):
|
|
33
|
+
"""Base class for MCP front end plugin workers."""
|
|
34
|
+
|
|
35
|
+
def __init__(self, config: Config):
|
|
36
|
+
"""Initialize the MCP worker with configuration.
|
|
37
|
+
|
|
38
|
+
Args:
|
|
39
|
+
config: The full NAT configuration
|
|
40
|
+
"""
|
|
41
|
+
self.full_config = config
|
|
42
|
+
self.front_end_config: MCPFrontEndConfig = config.general.front_end
|
|
43
|
+
|
|
44
|
+
def _setup_health_endpoint(self, mcp: FastMCP):
|
|
45
|
+
"""Set up the HTTP health endpoint that exercises MCP ping handler."""
|
|
46
|
+
|
|
47
|
+
@mcp.custom_route("/health", methods=["GET"])
|
|
48
|
+
async def health_check(_request: Request):
|
|
49
|
+
"""HTTP health check using server's internal ping handler"""
|
|
50
|
+
from starlette.responses import JSONResponse
|
|
51
|
+
|
|
52
|
+
try:
|
|
53
|
+
from mcp.types import PingRequest
|
|
54
|
+
|
|
55
|
+
# Create a ping request
|
|
56
|
+
ping_request = PingRequest(method="ping")
|
|
57
|
+
|
|
58
|
+
# Call the ping handler directly (same one that responds to MCP pings)
|
|
59
|
+
await mcp._mcp_server.request_handlers[PingRequest](ping_request)
|
|
60
|
+
|
|
61
|
+
return JSONResponse({
|
|
62
|
+
"status": "healthy",
|
|
63
|
+
"error": None,
|
|
64
|
+
"server_name": mcp.name,
|
|
65
|
+
})
|
|
66
|
+
|
|
67
|
+
except Exception as e:
|
|
68
|
+
return JSONResponse({
|
|
69
|
+
"status": "unhealthy",
|
|
70
|
+
"error": str(e),
|
|
71
|
+
"server_name": mcp.name,
|
|
72
|
+
},
|
|
73
|
+
status_code=503)
|
|
74
|
+
|
|
75
|
+
@abstractmethod
|
|
76
|
+
async def add_routes(self, mcp: FastMCP, builder: WorkflowBuilder):
|
|
77
|
+
"""Add routes to the MCP server.
|
|
78
|
+
|
|
79
|
+
Args:
|
|
80
|
+
mcp: The FastMCP server instance
|
|
81
|
+
builder (WorkflowBuilder): The workflow builder instance
|
|
82
|
+
"""
|
|
83
|
+
pass
|
|
84
|
+
|
|
85
|
+
def _get_all_functions(self, workflow: Workflow) -> dict[str, Function]:
|
|
86
|
+
"""Get all functions from the workflow.
|
|
87
|
+
|
|
88
|
+
Args:
|
|
89
|
+
workflow: The NAT workflow.
|
|
90
|
+
|
|
91
|
+
Returns:
|
|
92
|
+
Dict mapping function names to Function objects.
|
|
93
|
+
"""
|
|
94
|
+
functions: dict[str, Function] = {}
|
|
95
|
+
|
|
96
|
+
# Extract all functions from the workflow
|
|
97
|
+
for function_name, function in workflow.functions.items():
|
|
98
|
+
functions[function_name] = function
|
|
99
|
+
|
|
100
|
+
functions[workflow.config.workflow.type] = workflow
|
|
101
|
+
|
|
102
|
+
return functions
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
class MCPFrontEndPluginWorker(MCPFrontEndPluginWorkerBase):
|
|
106
|
+
"""Default MCP front end plugin worker implementation."""
|
|
107
|
+
|
|
108
|
+
async def add_routes(self, mcp: FastMCP, builder: WorkflowBuilder):
|
|
109
|
+
"""Add default routes to the MCP server.
|
|
110
|
+
|
|
111
|
+
Args:
|
|
112
|
+
mcp: The FastMCP server instance
|
|
113
|
+
builder (WorkflowBuilder): The workflow builder instance
|
|
114
|
+
"""
|
|
115
|
+
from nat.front_ends.mcp.tool_converter import register_function_with_mcp
|
|
116
|
+
|
|
117
|
+
# Set up the health endpoint
|
|
118
|
+
self._setup_health_endpoint(mcp)
|
|
119
|
+
|
|
120
|
+
# Build the workflow and register all functions with MCP
|
|
121
|
+
workflow = builder.build()
|
|
122
|
+
|
|
123
|
+
# Get all functions from the workflow
|
|
124
|
+
functions = self._get_all_functions(workflow)
|
|
125
|
+
|
|
126
|
+
# Filter functions based on tool_names if provided
|
|
127
|
+
if self.front_end_config.tool_names:
|
|
128
|
+
logger.info("Filtering functions based on tool_names: %s", self.front_end_config.tool_names)
|
|
129
|
+
filtered_functions: dict[str, Function] = {}
|
|
130
|
+
for function_name, function in functions.items():
|
|
131
|
+
if function_name in self.front_end_config.tool_names:
|
|
132
|
+
filtered_functions[function_name] = function
|
|
133
|
+
else:
|
|
134
|
+
logger.debug("Skipping function %s as it's not in tool_names", function_name)
|
|
135
|
+
functions = filtered_functions
|
|
136
|
+
|
|
137
|
+
# Register each function with MCP
|
|
138
|
+
for function_name, function in functions.items():
|
|
139
|
+
register_function_with_mcp(mcp, function_name, function)
|
|
140
|
+
|
|
141
|
+
# Add a simple fallback function if no functions were found
|
|
142
|
+
if not functions:
|
|
143
|
+
raise RuntimeError("No functions found in workflow. Please check your configuration.")
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
|
|
16
|
+
from collections.abc import AsyncIterator
|
|
17
|
+
|
|
18
|
+
from nat.cli.register_workflow import register_front_end
|
|
19
|
+
from nat.data_models.config import Config
|
|
20
|
+
from nat.front_ends.mcp.mcp_front_end_config import MCPFrontEndConfig
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
@register_front_end(config_type=MCPFrontEndConfig)
|
|
24
|
+
async def register_mcp_front_end(config: MCPFrontEndConfig, full_config: Config) -> AsyncIterator:
|
|
25
|
+
from nat.front_ends.mcp.mcp_front_end_plugin import MCPFrontEndPlugin
|
|
26
|
+
|
|
27
|
+
yield MCPFrontEndPlugin(full_config=full_config)
|
|
@@ -0,0 +1,241 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
|
|
16
|
+
import json
|
|
17
|
+
import logging
|
|
18
|
+
from inspect import Parameter
|
|
19
|
+
from inspect import Signature
|
|
20
|
+
|
|
21
|
+
from mcp.server.fastmcp import FastMCP
|
|
22
|
+
from pydantic import BaseModel
|
|
23
|
+
|
|
24
|
+
from nat.builder.function import Function
|
|
25
|
+
from nat.builder.function_base import FunctionBase
|
|
26
|
+
from nat.builder.workflow import Workflow
|
|
27
|
+
|
|
28
|
+
logger = logging.getLogger(__name__)
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
def create_function_wrapper(
|
|
32
|
+
function_name: str,
|
|
33
|
+
function: FunctionBase,
|
|
34
|
+
schema: type[BaseModel],
|
|
35
|
+
is_workflow: bool = False,
|
|
36
|
+
):
|
|
37
|
+
"""Create a wrapper function that exposes the actual parameters of a NAT Function as an MCP tool.
|
|
38
|
+
|
|
39
|
+
Args:
|
|
40
|
+
function_name: The name of the function/tool
|
|
41
|
+
function: The NAT Function object
|
|
42
|
+
schema: The input schema of the function
|
|
43
|
+
is_workflow: Whether the function is a Workflow
|
|
44
|
+
|
|
45
|
+
Returns:
|
|
46
|
+
A wrapper function suitable for registration with MCP
|
|
47
|
+
"""
|
|
48
|
+
# Check if we're dealing with ChatRequest - special case
|
|
49
|
+
is_chat_request = False
|
|
50
|
+
|
|
51
|
+
# Check if the schema name is ChatRequest
|
|
52
|
+
if schema.__name__ == "ChatRequest" or (hasattr(schema, "__qualname__") and "ChatRequest" in schema.__qualname__):
|
|
53
|
+
is_chat_request = True
|
|
54
|
+
logger.info("Function %s uses ChatRequest - creating simplified interface", function_name)
|
|
55
|
+
|
|
56
|
+
# For ChatRequest, we'll create a simple wrapper with just a query parameter
|
|
57
|
+
parameters = [Parameter(
|
|
58
|
+
name="query",
|
|
59
|
+
kind=Parameter.KEYWORD_ONLY,
|
|
60
|
+
default=Parameter.empty,
|
|
61
|
+
annotation=str,
|
|
62
|
+
)]
|
|
63
|
+
else:
|
|
64
|
+
# Regular case - extract parameter information from the input schema
|
|
65
|
+
# Extract parameter information from the input schema
|
|
66
|
+
param_fields = schema.model_fields
|
|
67
|
+
|
|
68
|
+
parameters = []
|
|
69
|
+
for name, field in param_fields.items():
|
|
70
|
+
# Get the field type and convert to appropriate Python type
|
|
71
|
+
field_type = field.annotation
|
|
72
|
+
|
|
73
|
+
# Add the parameter to our list
|
|
74
|
+
parameters.append(
|
|
75
|
+
Parameter(
|
|
76
|
+
name=name,
|
|
77
|
+
kind=Parameter.KEYWORD_ONLY,
|
|
78
|
+
default=Parameter.empty if field.is_required else None,
|
|
79
|
+
annotation=field_type,
|
|
80
|
+
))
|
|
81
|
+
|
|
82
|
+
# Create the function signature WITHOUT the ctx parameter
|
|
83
|
+
# We'll handle this in the wrapper function internally
|
|
84
|
+
sig = Signature(parameters=parameters, return_annotation=str)
|
|
85
|
+
|
|
86
|
+
# Define the actual wrapper function that accepts ctx but doesn't expose it
|
|
87
|
+
def create_wrapper():
|
|
88
|
+
|
|
89
|
+
async def wrapper_with_ctx(**kwargs):
|
|
90
|
+
"""Internal wrapper that will be called by MCP."""
|
|
91
|
+
# MCP will add a ctx parameter, extract it
|
|
92
|
+
ctx = kwargs.get("ctx")
|
|
93
|
+
|
|
94
|
+
# Remove ctx if present
|
|
95
|
+
if "ctx" in kwargs:
|
|
96
|
+
del kwargs["ctx"]
|
|
97
|
+
|
|
98
|
+
# Process the function call
|
|
99
|
+
if ctx:
|
|
100
|
+
ctx.info("Calling function %s with args: %s", function_name, json.dumps(kwargs, default=str))
|
|
101
|
+
await ctx.report_progress(0, 100)
|
|
102
|
+
|
|
103
|
+
try:
|
|
104
|
+
# Special handling for ChatRequest
|
|
105
|
+
if is_chat_request:
|
|
106
|
+
from nat.data_models.api_server import ChatRequest
|
|
107
|
+
|
|
108
|
+
# Create a chat request from the query string
|
|
109
|
+
query = kwargs.get("query", "")
|
|
110
|
+
chat_request = ChatRequest.from_string(query)
|
|
111
|
+
|
|
112
|
+
# Special handling for Workflow objects
|
|
113
|
+
if is_workflow:
|
|
114
|
+
# Workflows have a run method that is an async context manager
|
|
115
|
+
# that returns a Runner
|
|
116
|
+
async with function.run(chat_request) as runner:
|
|
117
|
+
# Get the result from the runner
|
|
118
|
+
result = await runner.result(to_type=str)
|
|
119
|
+
else:
|
|
120
|
+
# Regular functions use ainvoke
|
|
121
|
+
result = await function.ainvoke(chat_request, to_type=str)
|
|
122
|
+
else:
|
|
123
|
+
# Regular handling
|
|
124
|
+
# Handle complex input schema - if we extracted fields from a nested schema,
|
|
125
|
+
# we need to reconstruct the input
|
|
126
|
+
if len(schema.model_fields) == 1 and len(parameters) > 1:
|
|
127
|
+
# Get the field name from the original schema
|
|
128
|
+
field_name = next(iter(schema.model_fields.keys()))
|
|
129
|
+
field_type = schema.model_fields[field_name].annotation
|
|
130
|
+
|
|
131
|
+
# If it's a pydantic model, we need to create an instance
|
|
132
|
+
if hasattr(field_type, "model_validate"):
|
|
133
|
+
# Create the nested object
|
|
134
|
+
nested_obj = field_type.model_validate(kwargs)
|
|
135
|
+
# Call with the nested object
|
|
136
|
+
kwargs = {field_name: nested_obj}
|
|
137
|
+
|
|
138
|
+
# Call the NAT function with the parameters - special handling for Workflow
|
|
139
|
+
if is_workflow:
|
|
140
|
+
# For workflow with regular input, we'll assume the first parameter is the input
|
|
141
|
+
input_value = list(kwargs.values())[0] if kwargs else ""
|
|
142
|
+
|
|
143
|
+
# Workflows have a run method that is an async context manager
|
|
144
|
+
# that returns a Runner
|
|
145
|
+
async with function.run(input_value) as runner:
|
|
146
|
+
# Get the result from the runner
|
|
147
|
+
result = await runner.result(to_type=str)
|
|
148
|
+
else:
|
|
149
|
+
# Regular function call
|
|
150
|
+
result = await function.acall_invoke(**kwargs)
|
|
151
|
+
|
|
152
|
+
# Report completion
|
|
153
|
+
if ctx:
|
|
154
|
+
await ctx.report_progress(100, 100)
|
|
155
|
+
|
|
156
|
+
# Handle different result types for proper formatting
|
|
157
|
+
if isinstance(result, str):
|
|
158
|
+
return result
|
|
159
|
+
if isinstance(result, (dict, list)):
|
|
160
|
+
return json.dumps(result, default=str)
|
|
161
|
+
return str(result)
|
|
162
|
+
except Exception as e:
|
|
163
|
+
if ctx:
|
|
164
|
+
ctx.error("Error calling function %s: %s", function_name, str(e))
|
|
165
|
+
raise
|
|
166
|
+
|
|
167
|
+
return wrapper_with_ctx
|
|
168
|
+
|
|
169
|
+
# Create the wrapper function
|
|
170
|
+
wrapper = create_wrapper()
|
|
171
|
+
|
|
172
|
+
# Set the signature on the wrapper function (WITHOUT ctx)
|
|
173
|
+
wrapper.__signature__ = sig
|
|
174
|
+
wrapper.__name__ = function_name
|
|
175
|
+
|
|
176
|
+
# Return the wrapper with proper signature
|
|
177
|
+
return wrapper
|
|
178
|
+
|
|
179
|
+
|
|
180
|
+
def get_function_description(function: FunctionBase) -> str:
|
|
181
|
+
"""
|
|
182
|
+
Retrieve a human-readable description for a NAT function or workflow.
|
|
183
|
+
|
|
184
|
+
The description is determined using the following precedence:
|
|
185
|
+
1. If the function is a Workflow and has a 'description' attribute, use it.
|
|
186
|
+
2. If the Workflow's config has a 'topic', use it.
|
|
187
|
+
3. If the Workflow's config has a 'description', use it.
|
|
188
|
+
4. If the function is a regular Function, use its 'description' attribute.
|
|
189
|
+
|
|
190
|
+
Args:
|
|
191
|
+
function: The NAT FunctionBase instance (Function or Workflow).
|
|
192
|
+
|
|
193
|
+
Returns:
|
|
194
|
+
The best available description string for the function.
|
|
195
|
+
"""
|
|
196
|
+
function_description = ""
|
|
197
|
+
|
|
198
|
+
if isinstance(function, Workflow):
|
|
199
|
+
config = function.config
|
|
200
|
+
|
|
201
|
+
# Workflow doesn't have a description, but probably should
|
|
202
|
+
if hasattr(function, "description") and function.description:
|
|
203
|
+
function_description = function.description
|
|
204
|
+
# Try to get description from config
|
|
205
|
+
elif hasattr(config, "description") and config.description:
|
|
206
|
+
function_description = config.description
|
|
207
|
+
# Try to get anything that might be a description
|
|
208
|
+
elif hasattr(config, "topic") and config.topic:
|
|
209
|
+
function_description = config.topic
|
|
210
|
+
|
|
211
|
+
elif isinstance(function, Function):
|
|
212
|
+
function_description = function.description
|
|
213
|
+
|
|
214
|
+
return function_description
|
|
215
|
+
|
|
216
|
+
|
|
217
|
+
def register_function_with_mcp(mcp: FastMCP, function_name: str, function: FunctionBase) -> None:
|
|
218
|
+
"""Register a NAT Function as an MCP tool.
|
|
219
|
+
|
|
220
|
+
Args:
|
|
221
|
+
mcp: The FastMCP instance
|
|
222
|
+
function_name: The name to register the function under
|
|
223
|
+
function: The NAT Function to register
|
|
224
|
+
"""
|
|
225
|
+
logger.info("Registering function %s with MCP", function_name)
|
|
226
|
+
|
|
227
|
+
# Get the input schema from the function
|
|
228
|
+
input_schema = function.input_schema
|
|
229
|
+
logger.info("Function %s has input schema: %s", function_name, input_schema)
|
|
230
|
+
|
|
231
|
+
# Check if we're dealing with a Workflow
|
|
232
|
+
is_workflow = isinstance(function, Workflow)
|
|
233
|
+
if is_workflow:
|
|
234
|
+
logger.info("Function %s is a Workflow", function_name)
|
|
235
|
+
|
|
236
|
+
# Get function description
|
|
237
|
+
function_description = get_function_description(function)
|
|
238
|
+
|
|
239
|
+
# Create and register the wrapper function with MCP
|
|
240
|
+
wrapper_func = create_function_wrapper(function_name, function, input_schema, is_workflow)
|
|
241
|
+
mcp.tool(name=function_name, description=function_description)(wrapper_func)
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
|
|
16
|
+
# pylint: disable=unused-import
|
|
17
|
+
# flake8: noqa
|
|
18
|
+
# isort:skip_file
|
|
19
|
+
|
|
20
|
+
from .console import register as console_register
|
|
21
|
+
from .fastapi import register as fastapi_register
|
|
22
|
+
from .mcp import register as mcp_register
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2024-2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
|
|
16
|
+
import logging
|
|
17
|
+
from abc import ABC
|
|
18
|
+
from abc import abstractmethod
|
|
19
|
+
from io import StringIO
|
|
20
|
+
|
|
21
|
+
import click
|
|
22
|
+
|
|
23
|
+
from nat.builder.front_end import FrontEndBase
|
|
24
|
+
from nat.builder.workflow_builder import WorkflowBuilder
|
|
25
|
+
from nat.data_models.front_end import FrontEndConfigT
|
|
26
|
+
from nat.runtime.session import SessionManager
|
|
27
|
+
|
|
28
|
+
logger = logging.getLogger(__name__)
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
class SimpleFrontEndPluginBase(FrontEndBase[FrontEndConfigT], ABC):
|
|
32
|
+
|
|
33
|
+
async def pre_run(self):
|
|
34
|
+
pass
|
|
35
|
+
|
|
36
|
+
async def run(self):
|
|
37
|
+
|
|
38
|
+
# Must yield the workflow function otherwise it cleans up
|
|
39
|
+
async with WorkflowBuilder.from_config(config=self.full_config) as builder:
|
|
40
|
+
|
|
41
|
+
if logger.isEnabledFor(logging.INFO):
|
|
42
|
+
stream = StringIO()
|
|
43
|
+
|
|
44
|
+
self.full_config.print_summary(stream=stream)
|
|
45
|
+
|
|
46
|
+
click.echo(stream.getvalue())
|
|
47
|
+
|
|
48
|
+
workflow = builder.build()
|
|
49
|
+
session_manager = SessionManager(workflow)
|
|
50
|
+
await self.run_workflow(session_manager)
|
|
51
|
+
|
|
52
|
+
@abstractmethod
|
|
53
|
+
async def run_workflow(self, session_manager: SessionManager):
|
|
54
|
+
pass
|
nat/llm/__init__.py
ADDED
|
File without changes
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2024-2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
|
|
16
|
+
from pydantic import AliasChoices
|
|
17
|
+
from pydantic import ConfigDict
|
|
18
|
+
from pydantic import Field
|
|
19
|
+
|
|
20
|
+
from nat.builder.builder import Builder
|
|
21
|
+
from nat.builder.llm import LLMProviderInfo
|
|
22
|
+
from nat.cli.register_workflow import register_llm_provider
|
|
23
|
+
from nat.data_models.llm import LLMBaseConfig
|
|
24
|
+
from nat.data_models.retry_mixin import RetryMixin
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
class AWSBedrockModelConfig(LLMBaseConfig, RetryMixin, name="aws_bedrock"):
|
|
28
|
+
"""An AWS Bedrock llm provider to be used with an LLM client."""
|
|
29
|
+
|
|
30
|
+
model_config = ConfigDict(protected_namespaces=())
|
|
31
|
+
|
|
32
|
+
# Completion parameters
|
|
33
|
+
model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
|
|
34
|
+
serialization_alias="model",
|
|
35
|
+
description="The model name for the hosted AWS Bedrock.")
|
|
36
|
+
temperature: float = Field(default=0.0, ge=0.0, le=1.0, description="Sampling temperature in [0, 1].")
|
|
37
|
+
max_tokens: int | None = Field(default=1024,
|
|
38
|
+
gt=0,
|
|
39
|
+
description="Maximum number of tokens to generate."
|
|
40
|
+
"This field is ONLY required when using AWS Bedrock with Langchain.")
|
|
41
|
+
context_size: int | None = Field(default=1024,
|
|
42
|
+
gt=0,
|
|
43
|
+
description="Maximum number of tokens to generate."
|
|
44
|
+
"This field is ONLY required when using AWS Bedrock with LlamaIndex.")
|
|
45
|
+
|
|
46
|
+
# Client parameters
|
|
47
|
+
region_name: str | None = Field(default="None", description="AWS region to use.")
|
|
48
|
+
base_url: str | None = Field(
|
|
49
|
+
default=None, description="Bedrock endpoint to use. Needed if you don't want to default to us-east-1 endpoint.")
|
|
50
|
+
credentials_profile_name: str | None = Field(
|
|
51
|
+
default=None, description="The name of the profile in the ~/.aws/credentials or ~/.aws/config files.")
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
@register_llm_provider(config_type=AWSBedrockModelConfig)
|
|
55
|
+
async def aws_bedrock_model(llm_config: AWSBedrockModelConfig, builder: Builder):
|
|
56
|
+
|
|
57
|
+
yield LLMProviderInfo(config=llm_config, description="A AWS Bedrock model for use with an LLM client.")
|
nat/llm/nim_llm.py
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2024-2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
|
|
16
|
+
from pydantic import AliasChoices
|
|
17
|
+
from pydantic import ConfigDict
|
|
18
|
+
from pydantic import Field
|
|
19
|
+
from pydantic import PositiveInt
|
|
20
|
+
|
|
21
|
+
from nat.builder.builder import Builder
|
|
22
|
+
from nat.builder.llm import LLMProviderInfo
|
|
23
|
+
from nat.cli.register_workflow import register_llm_provider
|
|
24
|
+
from nat.data_models.llm import LLMBaseConfig
|
|
25
|
+
from nat.data_models.retry_mixin import RetryMixin
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
class NIMModelConfig(LLMBaseConfig, RetryMixin, name="nim"):
|
|
29
|
+
"""An NVIDIA Inference Microservice (NIM) llm provider to be used with an LLM client."""
|
|
30
|
+
|
|
31
|
+
model_config = ConfigDict(protected_namespaces=())
|
|
32
|
+
|
|
33
|
+
api_key: str | None = Field(default=None, description="NVIDIA API key to interact with hosted NIM.")
|
|
34
|
+
base_url: str | None = Field(default=None, description="Base url to the hosted NIM.")
|
|
35
|
+
model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
|
|
36
|
+
serialization_alias="model",
|
|
37
|
+
description="The model name for the hosted NIM.")
|
|
38
|
+
temperature: float = Field(default=0.0, description="Sampling temperature in [0, 1].")
|
|
39
|
+
top_p: float = Field(default=1.0, description="Top-p for distribution sampling.")
|
|
40
|
+
max_tokens: PositiveInt = Field(default=300, description="Maximum number of tokens to generate.")
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
@register_llm_provider(config_type=NIMModelConfig)
|
|
44
|
+
async def nim_model(llm_config: NIMModelConfig, builder: Builder):
|
|
45
|
+
|
|
46
|
+
yield LLMProviderInfo(config=llm_config, description="A NIM model for use with an LLM client.")
|
nat/llm/openai_llm.py
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2024-2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
|
|
16
|
+
from pydantic import AliasChoices
|
|
17
|
+
from pydantic import ConfigDict
|
|
18
|
+
from pydantic import Field
|
|
19
|
+
|
|
20
|
+
from nat.builder.builder import Builder
|
|
21
|
+
from nat.builder.llm import LLMProviderInfo
|
|
22
|
+
from nat.cli.register_workflow import register_llm_provider
|
|
23
|
+
from nat.data_models.llm import LLMBaseConfig
|
|
24
|
+
from nat.data_models.retry_mixin import RetryMixin
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
class OpenAIModelConfig(LLMBaseConfig, RetryMixin, name="openai"):
|
|
28
|
+
"""An OpenAI LLM provider to be used with an LLM client."""
|
|
29
|
+
|
|
30
|
+
model_config = ConfigDict(protected_namespaces=(), extra="allow")
|
|
31
|
+
|
|
32
|
+
api_key: str | None = Field(default=None, description="OpenAI API key to interact with hosted model.")
|
|
33
|
+
base_url: str | None = Field(default=None, description="Base url to the hosted model.")
|
|
34
|
+
model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
|
|
35
|
+
serialization_alias="model",
|
|
36
|
+
description="The OpenAI hosted model name.")
|
|
37
|
+
temperature: float = Field(default=0.0, description="Sampling temperature in [0, 1].")
|
|
38
|
+
top_p: float = Field(default=1.0, description="Top-p for distribution sampling.")
|
|
39
|
+
seed: int | None = Field(default=None, description="Random seed to set for generation.")
|
|
40
|
+
max_retries: int = Field(default=10, description="The max number of retries for the request.")
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
@register_llm_provider(config_type=OpenAIModelConfig)
|
|
44
|
+
async def openai_llm(config: OpenAIModelConfig, builder: Builder):
|
|
45
|
+
|
|
46
|
+
yield LLMProviderInfo(config=config, description="An OpenAI model for use with an LLM client.")
|
nat/llm/register.py
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# SPDX-FileCopyrightText: Copyright (c) 2024-2025, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
|
|
16
|
+
# pylint: disable=unused-import
|
|
17
|
+
# flake8: noqa
|
|
18
|
+
# isort:skip_file
|
|
19
|
+
|
|
20
|
+
# Import any providers which need to be automatically registered here
|
|
21
|
+
from . import aws_bedrock_llm
|
|
22
|
+
from . import nim_llm
|
|
23
|
+
from . import openai_llm
|