nvidia-nat 1.1.0a20251020__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 +265 -0
- nat/agent/dual_node.py +72 -0
- nat/agent/prompt_optimizer/__init__.py +0 -0
- nat/agent/prompt_optimizer/prompt.py +68 -0
- nat/agent/prompt_optimizer/register.py +149 -0
- nat/agent/react_agent/__init__.py +0 -0
- nat/agent/react_agent/agent.py +394 -0
- nat/agent/react_agent/output_parser.py +104 -0
- nat/agent/react_agent/prompt.py +44 -0
- nat/agent/react_agent/register.py +168 -0
- nat/agent/reasoning_agent/__init__.py +0 -0
- nat/agent/reasoning_agent/reasoning_agent.py +227 -0
- nat/agent/register.py +23 -0
- nat/agent/rewoo_agent/__init__.py +0 -0
- nat/agent/rewoo_agent/agent.py +593 -0
- nat/agent/rewoo_agent/prompt.py +107 -0
- nat/agent/rewoo_agent/register.py +175 -0
- nat/agent/tool_calling_agent/__init__.py +0 -0
- nat/agent/tool_calling_agent/agent.py +246 -0
- nat/agent/tool_calling_agent/register.py +129 -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/credential_validator/__init__.py +14 -0
- nat/authentication/credential_validator/bearer_token_validator.py +557 -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 +96 -0
- nat/authentication/oauth2/__init__.py +14 -0
- nat/authentication/oauth2/oauth2_auth_code_flow_provider.py +140 -0
- nat/authentication/oauth2/oauth2_auth_code_flow_provider_config.py +39 -0
- nat/authentication/oauth2/oauth2_resource_server_config.py +124 -0
- nat/authentication/oauth2/register.py +25 -0
- nat/authentication/register.py +20 -0
- nat/builder/__init__.py +0 -0
- nat/builder/builder.py +317 -0
- nat/builder/component_utils.py +320 -0
- nat/builder/context.py +321 -0
- nat/builder/embedder.py +24 -0
- nat/builder/eval_builder.py +166 -0
- nat/builder/evaluator.py +29 -0
- nat/builder/framework_enum.py +25 -0
- nat/builder/front_end.py +73 -0
- nat/builder/function.py +714 -0
- nat/builder/function_base.py +380 -0
- nat/builder/function_info.py +625 -0
- nat/builder/intermediate_step_manager.py +206 -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 +160 -0
- nat/builder/workflow_builder.py +1365 -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 +47 -0
- nat/cli/commands/info/list_channels.py +32 -0
- nat/cli/commands/info/list_components.py +128 -0
- nat/cli/commands/mcp/__init__.py +14 -0
- nat/cli/commands/mcp/mcp.py +986 -0
- nat/cli/commands/object_store/__init__.py +14 -0
- nat/cli/commands/object_store/object_store.py +227 -0
- nat/cli/commands/optimize.py +90 -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 +153 -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 +257 -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 +17 -0
- nat/cli/commands/workflow/templates/pyproject.toml.j2 +25 -0
- nat/cli/commands/workflow/templates/register.py.j2 +4 -0
- nat/cli/commands/workflow/templates/workflow.py.j2 +50 -0
- nat/cli/commands/workflow/workflow.py +37 -0
- nat/cli/commands/workflow/workflow_commands.py +403 -0
- nat/cli/entrypoint.py +141 -0
- nat/cli/main.py +60 -0
- nat/cli/register_workflow.py +522 -0
- nat/cli/type_registry.py +1069 -0
- nat/control_flow/__init__.py +0 -0
- nat/control_flow/register.py +20 -0
- nat/control_flow/router_agent/__init__.py +0 -0
- nat/control_flow/router_agent/agent.py +329 -0
- nat/control_flow/router_agent/prompt.py +48 -0
- nat/control_flow/router_agent/register.py +91 -0
- nat/control_flow/sequential_executor.py +166 -0
- nat/data_models/__init__.py +14 -0
- nat/data_models/agent.py +34 -0
- nat/data_models/api_server.py +843 -0
- nat/data_models/authentication.py +245 -0
- nat/data_models/common.py +171 -0
- nat/data_models/component.py +60 -0
- nat/data_models/component_ref.py +179 -0
- nat/data_models/config.py +434 -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 +130 -0
- nat/data_models/evaluator.py +26 -0
- nat/data_models/front_end.py +26 -0
- nat/data_models/function.py +64 -0
- nat/data_models/function_dependencies.py +80 -0
- nat/data_models/gated_field_mixin.py +242 -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/optimizable.py +119 -0
- nat/data_models/optimizer.py +149 -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 +228 -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/temperature_mixin.py +44 -0
- nat/data_models/thinking_mixin.py +86 -0
- nat/data_models/top_p_mixin.py +44 -0
- nat/data_models/ttc_strategy.py +30 -0
- nat/embedder/__init__.py +0 -0
- nat/embedder/azure_openai_embedder.py +46 -0
- nat/embedder/nim_embedder.py +59 -0
- nat/embedder/openai_embedder.py +42 -0
- nat/embedder/register.py +22 -0
- nat/eval/__init__.py +14 -0
- nat/eval/config.py +62 -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 +431 -0
- nat/eval/evaluate.py +565 -0
- nat/eval/evaluator/__init__.py +14 -0
- nat/eval/evaluator/base_evaluator.py +77 -0
- nat/eval/evaluator/evaluator_model.py +58 -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 +26 -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_evaluator/__init__.py +14 -0
- nat/eval/runtime_evaluator/evaluate.py +123 -0
- nat/eval/runtime_evaluator/register.py +100 -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 +242 -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/eval_trace_ctx.py +89 -0
- nat/eval/utils/output_uploader.py +140 -0
- nat/eval/utils/tqdm_position_registry.py +40 -0
- nat/eval/utils/weave_eval.py +193 -0
- nat/experimental/__init__.py +0 -0
- nat/experimental/decorators/__init__.py +0 -0
- nat/experimental/decorators/experimental_warning_decorator.py +154 -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 +228 -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 +67 -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 +35 -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 +157 -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 +285 -0
- nat/front_ends/console/console_front_end_config.py +32 -0
- nat/front_ends/console/console_front_end_plugin.py +108 -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 +142 -0
- nat/front_ends/fastapi/dask_client_mixin.py +65 -0
- nat/front_ends/fastapi/fastapi_front_end_config.py +272 -0
- nat/front_ends/fastapi/fastapi_front_end_controller.py +68 -0
- nat/front_ends/fastapi/fastapi_front_end_plugin.py +247 -0
- nat/front_ends/fastapi/fastapi_front_end_plugin_worker.py +1257 -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 +602 -0
- nat/front_ends/fastapi/main.py +64 -0
- nat/front_ends/fastapi/message_handler.py +344 -0
- nat/front_ends/fastapi/message_validator.py +351 -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/fastapi/utils.py +57 -0
- nat/front_ends/mcp/__init__.py +14 -0
- nat/front_ends/mcp/introspection_token_verifier.py +73 -0
- nat/front_ends/mcp/mcp_front_end_config.py +90 -0
- nat/front_ends/mcp/mcp_front_end_plugin.py +113 -0
- nat/front_ends/mcp/mcp_front_end_plugin_worker.py +268 -0
- nat/front_ends/mcp/memory_profiler.py +320 -0
- nat/front_ends/mcp/register.py +27 -0
- nat/front_ends/mcp/tool_converter.py +290 -0
- nat/front_ends/register.py +21 -0
- nat/front_ends/simple_base/__init__.py +14 -0
- nat/front_ends/simple_base/simple_front_end_plugin_base.py +56 -0
- nat/llm/__init__.py +0 -0
- nat/llm/aws_bedrock_llm.py +69 -0
- nat/llm/azure_openai_llm.py +57 -0
- nat/llm/litellm_llm.py +69 -0
- nat/llm/nim_llm.py +58 -0
- nat/llm/openai_llm.py +54 -0
- nat/llm/register.py +27 -0
- nat/llm/utils/__init__.py +14 -0
- nat/llm/utils/env_config_value.py +93 -0
- nat/llm/utils/error.py +17 -0
- nat/llm/utils/thinking.py +215 -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 +19 -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 +550 -0
- nat/observability/exporter/raw_exporter.py +52 -0
- nat/observability/exporter/span_exporter.py +308 -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/redaction_config_mixin.py +42 -0
- nat/observability/mixin/resource_conflict_mixin.py +134 -0
- nat/observability/mixin/serialize_mixin.py +61 -0
- nat/observability/mixin/tagging_config_mixin.py +62 -0
- nat/observability/mixin/type_introspection_mixin.py +496 -0
- nat/observability/processor/__init__.py +14 -0
- nat/observability/processor/batching_processor.py +308 -0
- nat/observability/processor/callback_processor.py +42 -0
- nat/observability/processor/falsy_batch_filter_processor.py +55 -0
- nat/observability/processor/intermediate_step_serializer.py +28 -0
- nat/observability/processor/processor.py +74 -0
- nat/observability/processor/processor_factory.py +70 -0
- nat/observability/processor/redaction/__init__.py +24 -0
- nat/observability/processor/redaction/contextual_redaction_processor.py +125 -0
- nat/observability/processor/redaction/contextual_span_redaction_processor.py +66 -0
- nat/observability/processor/redaction/redaction_processor.py +177 -0
- nat/observability/processor/redaction/span_header_redaction_processor.py +92 -0
- nat/observability/processor/span_tagging_processor.py +68 -0
- nat/observability/register.py +114 -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 +626 -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 +297 -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 +180 -0
- nat/profiler/decorators/function_tracking.py +411 -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 +42 -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 +404 -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/parameter_optimization/__init__.py +0 -0
- nat/profiler/parameter_optimization/optimizable_utils.py +93 -0
- nat/profiler/parameter_optimization/optimizer_runtime.py +67 -0
- nat/profiler/parameter_optimization/parameter_optimizer.py +153 -0
- nat/profiler/parameter_optimization/parameter_selection.py +107 -0
- nat/profiler/parameter_optimization/pareto_visualizer.py +380 -0
- nat/profiler/parameter_optimization/prompt_optimizer.py +384 -0
- nat/profiler/parameter_optimization/update_helpers.py +66 -0
- nat/profiler/profile_runner.py +478 -0
- nat/profiler/utils.py +186 -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 +570 -0
- nat/registry_handlers/pypi/__init__.py +0 -0
- nat/registry_handlers/pypi/pypi_handler.py +248 -0
- nat/registry_handlers/pypi/register_pypi.py +40 -0
- nat/registry_handlers/register.py +20 -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 +236 -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 +21 -0
- nat/runtime/__init__.py +14 -0
- nat/runtime/loader.py +220 -0
- nat/runtime/runner.py +292 -0
- nat/runtime/session.py +223 -0
- nat/runtime/user_metadata.py +130 -0
- nat/settings/__init__.py +0 -0
- nat/settings/global_settings.py +329 -0
- nat/test/.namespace +1 -0
- nat/tool/__init__.py +0 -0
- nat/tool/chat_completion.py +77 -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 +82 -0
- nat/tool/document_search.py +141 -0
- nat/tool/github_tools.py +450 -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 +66 -0
- nat/tool/memory_tools/get_memory_tool.py +72 -0
- nat/tool/nvidia_rag.py +95 -0
- nat/tool/register.py +31 -0
- nat/tool/retriever.py +95 -0
- nat/tool/server_tools.py +66 -0
- nat/utils/__init__.py +0 -0
- nat/utils/callable_utils.py +70 -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/decorators.py +210 -0
- nat/utils/dump_distro_mapping.py +32 -0
- nat/utils/exception_handlers/__init__.py +0 -0
- nat/utils/exception_handlers/automatic_retries.py +342 -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_levels.py +25 -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 +195 -0
- nat/utils/string_utils.py +38 -0
- nat/utils/type_converter.py +299 -0
- nat/utils/type_utils.py +488 -0
- nat/utils/url_utils.py +27 -0
- nvidia_nat-1.1.0a20251020.dist-info/METADATA +195 -0
- nvidia_nat-1.1.0a20251020.dist-info/RECORD +480 -0
- nvidia_nat-1.1.0a20251020.dist-info/WHEEL +5 -0
- nvidia_nat-1.1.0a20251020.dist-info/entry_points.txt +22 -0
- nvidia_nat-1.1.0a20251020.dist-info/licenses/LICENSE-3rd-party.txt +5478 -0
- nvidia_nat-1.1.0a20251020.dist-info/licenses/LICENSE.md +201 -0
- nvidia_nat-1.1.0a20251020.dist-info/top_level.txt +2 -0
|
@@ -0,0 +1,290 @@
|
|
|
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
|
+
from typing import TYPE_CHECKING
|
|
21
|
+
|
|
22
|
+
from mcp.server.fastmcp import FastMCP
|
|
23
|
+
from pydantic import BaseModel
|
|
24
|
+
|
|
25
|
+
from nat.builder.context import ContextState
|
|
26
|
+
from nat.builder.function import Function
|
|
27
|
+
from nat.builder.function_base import FunctionBase
|
|
28
|
+
|
|
29
|
+
if TYPE_CHECKING:
|
|
30
|
+
from nat.builder.workflow import Workflow
|
|
31
|
+
from nat.front_ends.mcp.memory_profiler import MemoryProfiler
|
|
32
|
+
|
|
33
|
+
logger = logging.getLogger(__name__)
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
def create_function_wrapper(
|
|
37
|
+
function_name: str,
|
|
38
|
+
function: FunctionBase,
|
|
39
|
+
schema: type[BaseModel],
|
|
40
|
+
is_workflow: bool = False,
|
|
41
|
+
workflow: 'Workflow | None' = None,
|
|
42
|
+
memory_profiler: 'MemoryProfiler | None' = None,
|
|
43
|
+
):
|
|
44
|
+
"""Create a wrapper function that exposes the actual parameters of a NAT Function as an MCP tool.
|
|
45
|
+
|
|
46
|
+
Args:
|
|
47
|
+
function_name (str): The name of the function/tool
|
|
48
|
+
function (FunctionBase): The NAT Function object
|
|
49
|
+
schema (type[BaseModel]): The input schema of the function
|
|
50
|
+
is_workflow (bool): Whether the function is a Workflow
|
|
51
|
+
workflow (Workflow | None): The parent workflow for observability context
|
|
52
|
+
memory_profiler: Optional memory profiler to track requests
|
|
53
|
+
|
|
54
|
+
Returns:
|
|
55
|
+
A wrapper function suitable for registration with MCP
|
|
56
|
+
"""
|
|
57
|
+
# Check if we're dealing with ChatRequest - special case
|
|
58
|
+
is_chat_request = False
|
|
59
|
+
|
|
60
|
+
# Check if the schema name is ChatRequest
|
|
61
|
+
if schema.__name__ == "ChatRequest" or (hasattr(schema, "__qualname__") and "ChatRequest" in schema.__qualname__):
|
|
62
|
+
is_chat_request = True
|
|
63
|
+
logger.info("Function %s uses ChatRequest - creating simplified interface", function_name)
|
|
64
|
+
|
|
65
|
+
# For ChatRequest, we'll create a simple wrapper with just a query parameter
|
|
66
|
+
parameters = [Parameter(
|
|
67
|
+
name="query",
|
|
68
|
+
kind=Parameter.KEYWORD_ONLY,
|
|
69
|
+
default=Parameter.empty,
|
|
70
|
+
annotation=str,
|
|
71
|
+
)]
|
|
72
|
+
else:
|
|
73
|
+
# Regular case - extract parameter information from the input schema
|
|
74
|
+
# Extract parameter information from the input schema
|
|
75
|
+
param_fields = schema.model_fields
|
|
76
|
+
|
|
77
|
+
parameters = []
|
|
78
|
+
for name, field in param_fields.items():
|
|
79
|
+
# Get the field type and convert to appropriate Python type
|
|
80
|
+
field_type = field.annotation
|
|
81
|
+
|
|
82
|
+
# Add the parameter to our list
|
|
83
|
+
parameters.append(
|
|
84
|
+
Parameter(
|
|
85
|
+
name=name,
|
|
86
|
+
kind=Parameter.KEYWORD_ONLY,
|
|
87
|
+
default=Parameter.empty if field.is_required else None,
|
|
88
|
+
annotation=field_type,
|
|
89
|
+
))
|
|
90
|
+
|
|
91
|
+
# Create the function signature WITHOUT the ctx parameter
|
|
92
|
+
# We'll handle this in the wrapper function internally
|
|
93
|
+
sig = Signature(parameters=parameters, return_annotation=str)
|
|
94
|
+
|
|
95
|
+
# Define the actual wrapper function that accepts ctx but doesn't expose it
|
|
96
|
+
def create_wrapper():
|
|
97
|
+
|
|
98
|
+
async def wrapper_with_ctx(**kwargs):
|
|
99
|
+
"""Internal wrapper that will be called by MCP."""
|
|
100
|
+
# MCP will add a ctx parameter, extract it
|
|
101
|
+
ctx = kwargs.get("ctx")
|
|
102
|
+
|
|
103
|
+
# Remove ctx if present
|
|
104
|
+
if "ctx" in kwargs:
|
|
105
|
+
del kwargs["ctx"]
|
|
106
|
+
|
|
107
|
+
# Process the function call
|
|
108
|
+
if ctx:
|
|
109
|
+
ctx.info("Calling function %s with args: %s", function_name, json.dumps(kwargs, default=str))
|
|
110
|
+
await ctx.report_progress(0, 100)
|
|
111
|
+
|
|
112
|
+
try:
|
|
113
|
+
# Helper function to wrap function calls with observability
|
|
114
|
+
async def call_with_observability(func_call):
|
|
115
|
+
# Use workflow's observability context (workflow should always be available)
|
|
116
|
+
if not workflow:
|
|
117
|
+
logger.error("Missing workflow context for function %s - observability will not be available",
|
|
118
|
+
function_name)
|
|
119
|
+
raise RuntimeError("Workflow context is required for observability")
|
|
120
|
+
|
|
121
|
+
logger.debug("Starting observability context for function %s", function_name)
|
|
122
|
+
context_state = ContextState.get()
|
|
123
|
+
async with workflow.exporter_manager.start(context_state=context_state):
|
|
124
|
+
return await func_call()
|
|
125
|
+
|
|
126
|
+
# Special handling for ChatRequest
|
|
127
|
+
if is_chat_request:
|
|
128
|
+
from nat.data_models.api_server import ChatRequest
|
|
129
|
+
|
|
130
|
+
# Create a chat request from the query string
|
|
131
|
+
query = kwargs.get("query", "")
|
|
132
|
+
chat_request = ChatRequest.from_string(query)
|
|
133
|
+
|
|
134
|
+
# Special handling for Workflow objects
|
|
135
|
+
if is_workflow:
|
|
136
|
+
# Workflows have a run method that is an async context manager
|
|
137
|
+
# that returns a Runner
|
|
138
|
+
async with function.run(chat_request) as runner:
|
|
139
|
+
# Get the result from the runner
|
|
140
|
+
result = await runner.result(to_type=str)
|
|
141
|
+
else:
|
|
142
|
+
# Regular functions use ainvoke
|
|
143
|
+
result = await call_with_observability(lambda: function.ainvoke(chat_request, to_type=str))
|
|
144
|
+
else:
|
|
145
|
+
# Regular handling
|
|
146
|
+
# Handle complex input schema - if we extracted fields from a nested schema,
|
|
147
|
+
# we need to reconstruct the input
|
|
148
|
+
if len(schema.model_fields) == 1 and len(parameters) > 1:
|
|
149
|
+
# Get the field name from the original schema
|
|
150
|
+
field_name = next(iter(schema.model_fields.keys()))
|
|
151
|
+
field_type = schema.model_fields[field_name].annotation
|
|
152
|
+
|
|
153
|
+
# If it's a pydantic model, we need to create an instance
|
|
154
|
+
if field_type and hasattr(field_type, "model_validate"):
|
|
155
|
+
# Create the nested object
|
|
156
|
+
nested_obj = field_type.model_validate(kwargs)
|
|
157
|
+
# Call with the nested object
|
|
158
|
+
kwargs = {field_name: nested_obj}
|
|
159
|
+
|
|
160
|
+
# Call the NAT function with the parameters - special handling for Workflow
|
|
161
|
+
if is_workflow:
|
|
162
|
+
# For workflow with regular input, we'll assume the first parameter is the input
|
|
163
|
+
input_value = list(kwargs.values())[0] if kwargs else ""
|
|
164
|
+
|
|
165
|
+
# Workflows have a run method that is an async context manager
|
|
166
|
+
# that returns a Runner
|
|
167
|
+
async with function.run(input_value) as runner:
|
|
168
|
+
# Get the result from the runner
|
|
169
|
+
result = await runner.result(to_type=str)
|
|
170
|
+
else:
|
|
171
|
+
# Regular function call
|
|
172
|
+
result = await call_with_observability(lambda: function.acall_invoke(**kwargs))
|
|
173
|
+
|
|
174
|
+
# Report completion
|
|
175
|
+
if ctx:
|
|
176
|
+
await ctx.report_progress(100, 100)
|
|
177
|
+
|
|
178
|
+
# Track request completion for memory profiling
|
|
179
|
+
if memory_profiler:
|
|
180
|
+
memory_profiler.on_request_complete()
|
|
181
|
+
|
|
182
|
+
# Handle different result types for proper formatting
|
|
183
|
+
if isinstance(result, str):
|
|
184
|
+
return result
|
|
185
|
+
if isinstance(result, dict | list):
|
|
186
|
+
return json.dumps(result, default=str)
|
|
187
|
+
return str(result)
|
|
188
|
+
except Exception as e:
|
|
189
|
+
if ctx:
|
|
190
|
+
ctx.error("Error calling function %s: %s", function_name, str(e))
|
|
191
|
+
|
|
192
|
+
# Track request completion even on error
|
|
193
|
+
if memory_profiler:
|
|
194
|
+
memory_profiler.on_request_complete()
|
|
195
|
+
|
|
196
|
+
raise
|
|
197
|
+
|
|
198
|
+
return wrapper_with_ctx
|
|
199
|
+
|
|
200
|
+
# Create the wrapper function
|
|
201
|
+
wrapper = create_wrapper()
|
|
202
|
+
|
|
203
|
+
# Set the signature on the wrapper function (WITHOUT ctx)
|
|
204
|
+
wrapper.__signature__ = sig # type: ignore
|
|
205
|
+
wrapper.__name__ = function_name
|
|
206
|
+
|
|
207
|
+
# Return the wrapper with proper signature
|
|
208
|
+
return wrapper
|
|
209
|
+
|
|
210
|
+
|
|
211
|
+
def get_function_description(function: FunctionBase) -> str:
|
|
212
|
+
"""
|
|
213
|
+
Retrieve a human-readable description for a NAT function or workflow.
|
|
214
|
+
|
|
215
|
+
The description is determined using the following precedence:
|
|
216
|
+
1. If the function is a Workflow and has a 'description' attribute, use it.
|
|
217
|
+
2. If the Workflow's config has a 'description', use it.
|
|
218
|
+
3. If the Workflow's config has a 'topic', use it.
|
|
219
|
+
4. If the function is a regular Function, use its 'description' attribute.
|
|
220
|
+
|
|
221
|
+
Args:
|
|
222
|
+
function: The NAT FunctionBase instance (Function or Workflow).
|
|
223
|
+
|
|
224
|
+
Returns:
|
|
225
|
+
The best available description string for the function.
|
|
226
|
+
"""
|
|
227
|
+
function_description = ""
|
|
228
|
+
|
|
229
|
+
# Import here to avoid circular imports
|
|
230
|
+
from nat.builder.workflow import Workflow
|
|
231
|
+
|
|
232
|
+
if isinstance(function, Workflow):
|
|
233
|
+
config = function.config
|
|
234
|
+
|
|
235
|
+
# Workflow doesn't have a description, but probably should
|
|
236
|
+
if hasattr(function, "description") and function.description:
|
|
237
|
+
function_description = function.description
|
|
238
|
+
# Try to get description from config
|
|
239
|
+
elif hasattr(config, "description") and config.description:
|
|
240
|
+
function_description = config.description
|
|
241
|
+
# Try to get anything that might be a description
|
|
242
|
+
elif hasattr(config, "topic") and config.topic:
|
|
243
|
+
function_description = config.topic
|
|
244
|
+
# Try to get description from the workflow config
|
|
245
|
+
elif hasattr(config, "workflow") and hasattr(config.workflow, "description") and config.workflow.description:
|
|
246
|
+
function_description = config.workflow.description
|
|
247
|
+
|
|
248
|
+
elif isinstance(function, Function):
|
|
249
|
+
function_description = function.description
|
|
250
|
+
|
|
251
|
+
return function_description
|
|
252
|
+
|
|
253
|
+
|
|
254
|
+
def register_function_with_mcp(mcp: FastMCP,
|
|
255
|
+
function_name: str,
|
|
256
|
+
function: FunctionBase,
|
|
257
|
+
workflow: 'Workflow | None' = None,
|
|
258
|
+
memory_profiler: 'MemoryProfiler | None' = None) -> None:
|
|
259
|
+
"""Register a NAT Function as an MCP tool.
|
|
260
|
+
|
|
261
|
+
Args:
|
|
262
|
+
mcp: The FastMCP instance
|
|
263
|
+
function_name: The name to register the function under
|
|
264
|
+
function: The NAT Function to register
|
|
265
|
+
workflow: The parent workflow for observability context (if available)
|
|
266
|
+
memory_profiler: Optional memory profiler to track requests
|
|
267
|
+
"""
|
|
268
|
+
logger.info("Registering function %s with MCP", function_name)
|
|
269
|
+
|
|
270
|
+
# Get the input schema from the function
|
|
271
|
+
input_schema = function.input_schema
|
|
272
|
+
logger.info("Function %s has input schema: %s", function_name, input_schema)
|
|
273
|
+
|
|
274
|
+
# Check if we're dealing with a Workflow
|
|
275
|
+
from nat.builder.workflow import Workflow
|
|
276
|
+
is_workflow = isinstance(function, Workflow)
|
|
277
|
+
if is_workflow:
|
|
278
|
+
logger.info("Function %s is a Workflow", function_name)
|
|
279
|
+
|
|
280
|
+
# Get function description
|
|
281
|
+
function_description = get_function_description(function)
|
|
282
|
+
|
|
283
|
+
# Create and register the wrapper function with MCP
|
|
284
|
+
wrapper_func = create_function_wrapper(function_name,
|
|
285
|
+
function,
|
|
286
|
+
input_schema,
|
|
287
|
+
is_workflow,
|
|
288
|
+
workflow,
|
|
289
|
+
memory_profiler)
|
|
290
|
+
mcp.tool(name=function_name, description=function_description)(wrapper_func)
|
|
@@ -0,0 +1,21 @@
|
|
|
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
|
+
# flake8: noqa
|
|
17
|
+
# isort:skip_file
|
|
18
|
+
|
|
19
|
+
from .console import register as console_register
|
|
20
|
+
from .fastapi import register as fastapi_register
|
|
21
|
+
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,56 @@
|
|
|
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
|
+
await self.pre_run()
|
|
39
|
+
|
|
40
|
+
# Must yield the workflow function otherwise it cleans up
|
|
41
|
+
async with WorkflowBuilder.from_config(config=self.full_config) as builder:
|
|
42
|
+
|
|
43
|
+
if logger.isEnabledFor(logging.INFO):
|
|
44
|
+
stream = StringIO()
|
|
45
|
+
|
|
46
|
+
self.full_config.print_summary(stream=stream)
|
|
47
|
+
|
|
48
|
+
click.echo(stream.getvalue())
|
|
49
|
+
|
|
50
|
+
workflow = await builder.build()
|
|
51
|
+
session_manager = SessionManager(workflow)
|
|
52
|
+
await self.run_workflow(session_manager)
|
|
53
|
+
|
|
54
|
+
@abstractmethod
|
|
55
|
+
async def run_workflow(self, session_manager: SessionManager):
|
|
56
|
+
pass
|
nat/llm/__init__.py
ADDED
|
File without changes
|
|
@@ -0,0 +1,69 @@
|
|
|
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.optimizable import OptimizableField
|
|
25
|
+
from nat.data_models.optimizable import OptimizableMixin
|
|
26
|
+
from nat.data_models.optimizable import SearchSpace
|
|
27
|
+
from nat.data_models.retry_mixin import RetryMixin
|
|
28
|
+
from nat.data_models.temperature_mixin import TemperatureMixin
|
|
29
|
+
from nat.data_models.thinking_mixin import ThinkingMixin
|
|
30
|
+
from nat.data_models.top_p_mixin import TopPMixin
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
class AWSBedrockModelConfig(LLMBaseConfig,
|
|
34
|
+
RetryMixin,
|
|
35
|
+
OptimizableMixin,
|
|
36
|
+
TemperatureMixin,
|
|
37
|
+
TopPMixin,
|
|
38
|
+
ThinkingMixin,
|
|
39
|
+
name="aws_bedrock"):
|
|
40
|
+
"""An AWS Bedrock llm provider to be used with an LLM client."""
|
|
41
|
+
|
|
42
|
+
model_config = ConfigDict(protected_namespaces=(), extra="allow")
|
|
43
|
+
|
|
44
|
+
# Completion parameters
|
|
45
|
+
model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
|
|
46
|
+
serialization_alias="model",
|
|
47
|
+
description="The model name for the hosted AWS Bedrock.")
|
|
48
|
+
max_tokens: int = OptimizableField(default=300,
|
|
49
|
+
description="Maximum number of tokens to generate.",
|
|
50
|
+
space=SearchSpace(high=2176, low=128, step=512))
|
|
51
|
+
context_size: int | None = Field(
|
|
52
|
+
default=1024,
|
|
53
|
+
gt=0,
|
|
54
|
+
description="The maximum number of tokens available for input. This is only required for LlamaIndex. "
|
|
55
|
+
"This field is ignored for LangChain/LangGraph.",
|
|
56
|
+
)
|
|
57
|
+
|
|
58
|
+
# Client parameters
|
|
59
|
+
region_name: str | None = Field(default="None", description="AWS region to use.")
|
|
60
|
+
base_url: str | None = Field(
|
|
61
|
+
default=None, description="Bedrock endpoint to use. Needed if you don't want to default to us-east-1 endpoint.")
|
|
62
|
+
credentials_profile_name: str | None = Field(
|
|
63
|
+
default=None, description="The name of the profile in the ~/.aws/credentials or ~/.aws/config files.")
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
@register_llm_provider(config_type=AWSBedrockModelConfig)
|
|
67
|
+
async def aws_bedrock_model(llm_config: AWSBedrockModelConfig, _builder: Builder):
|
|
68
|
+
|
|
69
|
+
yield LLMProviderInfo(config=llm_config, description="A AWS Bedrock model for use with an LLM client.")
|
|
@@ -0,0 +1,57 @@
|
|
|
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 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
|
+
from nat.data_models.temperature_mixin import TemperatureMixin
|
|
26
|
+
from nat.data_models.thinking_mixin import ThinkingMixin
|
|
27
|
+
from nat.data_models.top_p_mixin import TopPMixin
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
class AzureOpenAIModelConfig(
|
|
31
|
+
LLMBaseConfig,
|
|
32
|
+
RetryMixin,
|
|
33
|
+
TemperatureMixin,
|
|
34
|
+
TopPMixin,
|
|
35
|
+
ThinkingMixin,
|
|
36
|
+
name="azure_openai",
|
|
37
|
+
):
|
|
38
|
+
"""An Azure OpenAI LLM provider to be used with an LLM client."""
|
|
39
|
+
|
|
40
|
+
model_config = ConfigDict(protected_namespaces=(), extra="allow")
|
|
41
|
+
|
|
42
|
+
api_key: str | None = Field(default=None, description="Azure OpenAI API key to interact with hosted model.")
|
|
43
|
+
api_version: str = Field(default="2025-04-01-preview", description="Azure OpenAI API version.")
|
|
44
|
+
azure_endpoint: str | None = Field(validation_alias=AliasChoices("azure_endpoint", "base_url"),
|
|
45
|
+
serialization_alias="azure_endpoint",
|
|
46
|
+
default=None,
|
|
47
|
+
description="Base URL for the hosted model.")
|
|
48
|
+
azure_deployment: str = Field(validation_alias=AliasChoices("azure_deployment", "model_name", "model"),
|
|
49
|
+
serialization_alias="azure_deployment",
|
|
50
|
+
description="The Azure OpenAI hosted model/deployment name.")
|
|
51
|
+
seed: int | None = Field(default=None, description="Random seed to set for generation.")
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
@register_llm_provider(config_type=AzureOpenAIModelConfig)
|
|
55
|
+
async def azure_openai_llm(config: AzureOpenAIModelConfig, _builder: Builder):
|
|
56
|
+
|
|
57
|
+
yield LLMProviderInfo(config=config, description="An Azure OpenAI model for use with an LLM client.")
|
nat/llm/litellm_llm.py
ADDED
|
@@ -0,0 +1,69 @@
|
|
|
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 pydantic import AliasChoices
|
|
19
|
+
from pydantic import ConfigDict
|
|
20
|
+
from pydantic import Field
|
|
21
|
+
|
|
22
|
+
from nat.builder.builder import Builder
|
|
23
|
+
from nat.builder.llm import LLMProviderInfo
|
|
24
|
+
from nat.cli.register_workflow import register_llm_provider
|
|
25
|
+
from nat.data_models.llm import LLMBaseConfig
|
|
26
|
+
from nat.data_models.retry_mixin import RetryMixin
|
|
27
|
+
from nat.data_models.temperature_mixin import TemperatureMixin
|
|
28
|
+
from nat.data_models.thinking_mixin import ThinkingMixin
|
|
29
|
+
from nat.data_models.top_p_mixin import TopPMixin
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
class LiteLlmModelConfig(
|
|
33
|
+
LLMBaseConfig,
|
|
34
|
+
RetryMixin,
|
|
35
|
+
TemperatureMixin,
|
|
36
|
+
TopPMixin,
|
|
37
|
+
ThinkingMixin,
|
|
38
|
+
name="litellm",
|
|
39
|
+
):
|
|
40
|
+
"""A LiteLlm provider to be used with an LLM client."""
|
|
41
|
+
|
|
42
|
+
model_config = ConfigDict(protected_namespaces=(), extra="allow")
|
|
43
|
+
|
|
44
|
+
api_key: str | None = Field(default=None, description="API key to interact with hosted model.")
|
|
45
|
+
base_url: str | None = Field(default=None,
|
|
46
|
+
description="Base url to the hosted model.",
|
|
47
|
+
validation_alias=AliasChoices("base_url", "api_base"),
|
|
48
|
+
serialization_alias="api_base")
|
|
49
|
+
model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
|
|
50
|
+
serialization_alias="model",
|
|
51
|
+
description="The LiteLlm hosted model name.")
|
|
52
|
+
seed: int | None = Field(default=None, description="Random seed to set for generation.")
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
@register_llm_provider(config_type=LiteLlmModelConfig)
|
|
56
|
+
async def litellm_model(
|
|
57
|
+
config: LiteLlmModelConfig,
|
|
58
|
+
_builder: Builder,
|
|
59
|
+
) -> AsyncIterator[LLMProviderInfo]:
|
|
60
|
+
"""Litellm model provider.
|
|
61
|
+
|
|
62
|
+
Args:
|
|
63
|
+
config (LiteLlmModelConfig): The LiteLlm model configuration.
|
|
64
|
+
_builder (Builder): The NAT builder instance.
|
|
65
|
+
|
|
66
|
+
Returns:
|
|
67
|
+
AsyncIterator[LLMProviderInfo]: An async iterator that yields an LLMProviderInfo object.
|
|
68
|
+
"""
|
|
69
|
+
yield LLMProviderInfo(config=config, description="A LiteLlm model for use with an LLM client.")
|
nat/llm/nim_llm.py
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
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.optimizable import OptimizableField
|
|
26
|
+
from nat.data_models.optimizable import OptimizableMixin
|
|
27
|
+
from nat.data_models.optimizable import SearchSpace
|
|
28
|
+
from nat.data_models.retry_mixin import RetryMixin
|
|
29
|
+
from nat.data_models.temperature_mixin import TemperatureMixin
|
|
30
|
+
from nat.data_models.thinking_mixin import ThinkingMixin
|
|
31
|
+
from nat.data_models.top_p_mixin import TopPMixin
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
class NIMModelConfig(LLMBaseConfig,
|
|
35
|
+
RetryMixin,
|
|
36
|
+
OptimizableMixin,
|
|
37
|
+
TemperatureMixin,
|
|
38
|
+
TopPMixin,
|
|
39
|
+
ThinkingMixin,
|
|
40
|
+
name="nim"):
|
|
41
|
+
"""An NVIDIA Inference Microservice (NIM) llm provider to be used with an LLM client."""
|
|
42
|
+
|
|
43
|
+
model_config = ConfigDict(protected_namespaces=(), extra="allow")
|
|
44
|
+
|
|
45
|
+
api_key: str | None = Field(default=None, description="NVIDIA API key to interact with hosted NIM.")
|
|
46
|
+
base_url: str | None = Field(default=None, description="Base url to the hosted NIM.")
|
|
47
|
+
model_name: str = Field(validation_alias=AliasChoices("model_name", "model"),
|
|
48
|
+
serialization_alias="model",
|
|
49
|
+
description="The model name for the hosted NIM.")
|
|
50
|
+
max_tokens: PositiveInt = OptimizableField(default=300,
|
|
51
|
+
description="Maximum number of tokens to generate.",
|
|
52
|
+
space=SearchSpace(high=2176, low=128, step=512))
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
@register_llm_provider(config_type=NIMModelConfig)
|
|
56
|
+
async def nim_model(llm_config: NIMModelConfig, _builder: Builder):
|
|
57
|
+
|
|
58
|
+
yield LLMProviderInfo(config=llm_config, description="A NIM model for use with an LLM client.")
|