agent-framework-lib 0.8.1.post8__tar.gz → 0.8.2__tar.gz
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.
- {agent_framework_lib-0.8.1.post8/agent_framework_lib.egg-info → agent_framework_lib-0.8.2}/PKG-INFO +47 -6
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/README.md +44 -5
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/__init__.py +2 -2
- agent_framework_lib-0.8.2/agent_framework/web/docs/GITNEXUS_USER_GUIDE.md +386 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/README.md +44 -5
- agent_framework_lib-0.8.2/agent_framework/web/gitnexus_client.py +369 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/helper_agent.py +633 -14
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/server.py +94 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/client.py +4 -5
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/router.py +0 -5
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2/agent_framework_lib.egg-info}/PKG-INFO +47 -6
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework_lib.egg-info/SOURCES.txt +3 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework_lib.egg-info/requires.txt +3 -0
- agent_framework_lib-0.8.2/docs/GITNEXUS_USER_GUIDE.md +386 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/pyproject.toml +6 -1
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/ARCHITECTURE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/LICENSE +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/MANIFEST.in +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/base.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/endpoints/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/endpoints/a2a_router.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/endpoints/agent_card_builder.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/endpoints/agent_card_skill_builder.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/endpoints/jsonrpc_dispatcher.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/endpoints/models_jsonrpc.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/endpoints/sse_wrapper.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/endpoints/translation_layer.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/models.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/providers/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/providers/elasticsearch_provider.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/a2a/providers/postgres_provider.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/capabilities/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/capabilities/resolver.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/chart_generation/llm_refinement_loop.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/activity_formatter.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/agent_interface.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/agent_provider.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/base_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/context_budget.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/context_summarizer.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/elasticsearch_config_provider.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/implementation_validator.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/knowledge_state.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/loop_detector.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/model_clients.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/model_config.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/model_router.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/models.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/provider_calibration.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/scratchpad_compressor.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/state_manager.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/step_display_config.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/core/streaming_parts_accumulator.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/implementations/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/implementations/budget_aware_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/implementations/llamaindex_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/implementations/llamaindex_memory_adapter.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/implementations/microsoft_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/memory/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/memory/agent_mixin.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/memory/base.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/memory/config.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/memory/manager.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/memory/personalization.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/memory/providers/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/memory/providers/graphiti_provider.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/memory/providers/memori_provider.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/memory/tools.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/api_timing_tracker.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/elasticsearch_circuit_breaker.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/elasticsearch_logging.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/error_handling.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/error_logging.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/llm_auto_instrumentor.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/llm_metrics.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/llm_metrics_collector.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/llm_metrics_extractor.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/metrics_aggregator.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/metrics_config.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/observability_manager.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/otel_instrumentor.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/otel_logging_handler.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/otel_metrics_recorder.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/otel_setup.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/performance_monitor.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/progress_tracker.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/resource_manager.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/resource_metrics_collector.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/streaming_latency_tracer.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/timing_tracker.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/token_counter.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/monitoring/tracing_context.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/notifications/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/notifications/hub.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/processing/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/processing/ai_content_management.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/processing/markdown_converter.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/processing/multimodal_integration.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/processing/rich_content_validation.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/py.typed +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/session/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/session/elasticsearch_session_storage.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/session/session_storage.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/agent_mixin.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/base.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/scripts/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/scripts/create_and_register.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/scripts/register_to_storage.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/chart/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/chart/chart_to_image.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/code_format/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/code_format/format_python.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/csv/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/csv/create_csv.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/csv/read_csv.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/csv/transform_csv.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/data_format/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/data_format/json_to_yaml.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/data_format/yaml_to_json.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/drawio/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/drawio/create_drawio.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/email_template/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/excel/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/excel/create_excel.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/file/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/file/create_file.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/file/list_files.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/file/read_file.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/file_access/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/file_access/download_to_local.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/file_access/get_file_path.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/form/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/image_display/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/image_gen/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/image_gen/create_image.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/image_gen/generate_image.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/mermaid/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/mermaid/mermaid_to_image.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/multimodal/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/optionsblock/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/powerpoint/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/powerpoint/create_powerpoint.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/skill_creator/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/table/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/table/table_to_image.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/unified_pdf/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/unified_pdf/create_pdf.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/web_news_search/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/web_news_search/web_news_search.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/word/SKILL.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/builtin/skills/word/create_word.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/custom_skill_manager.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/discovery_prompt.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/markdown_loader.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/skills/tools.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/storage/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/storage/file_storages.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/storage/file_system_management.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/storage/storage_optimizer.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/subagents/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/subagents/executor.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/subagents/message_injector.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/subagents/message_queue.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/subagents/retrigger.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/subagents/spawn_tool.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/activity_callback.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/adaptive_pdf_css.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/base.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/html_content_analyzer.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/multimodal_tools.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/pdf_image_scaler.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/shell_tool.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/sizing_config.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/web_fetch_tool.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/tools/web_search_tool.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/utils/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/utils/path_utils.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/utils/post_install.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/utils/session_title_generator.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/utils/source_detector.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/utils/special_blocks.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/admin_auth.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/admin_models.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/admin_router.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/admin_services.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/api_timing_middleware.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/A2A_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/BUILTIN_SKILLS_REFERENCE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/CREATING_AGENTS.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/CUSTOM_SKILLS_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/DOCKER_SETUP.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/Dockerfile +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/GETTING_STARTED.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/MEMORY_INSTALLATION.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/TOOLS_AND_MCP_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/WORKSPACE_INTEGRATION.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/api-reference.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/configuration.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/docker-compose.yml +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/examples/agent_example_multi_skills.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/examples/agent_with_file_storage.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/examples/agent_with_mcp.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/examples/agent_with_memory.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/examples/agent_with_memory_graphiti.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/examples/agent_with_memory_hybrid.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/examples/agent_with_memory_simple.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/examples/custom_framework_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/examples/simple_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/examples/skills_demo_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/installation-guide.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/documentation_generator.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/helper_ui.html +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/modern_ui.html +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/observability/kibana-llm-dashboard-setup.json +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/observability/kibana-resource-metrics-dashboard.json +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/otel_tracing_middleware.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/skills_router.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/test_app.html +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/__init__.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/artefacts.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/config.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/context.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/cursor.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/memory.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/models.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/poller.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/preferences.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/session.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/workspace/subscription.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework_lib.egg-info/dependency_links.txt +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework_lib.egg-info/entry_points.txt +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework_lib.egg-info/top_level.txt +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/A2A_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/ACTIVITY_OUTPUT_PART.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/ARCHITECTURE_DIAGRAM.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/BUILTIN_SKILLS_REFERENCE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/CONCURRENCE_VS_PARALLELISME_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/CREATING_AGENTS.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/CUSTOM_SKILLS_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/DOCKER_SETUP.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/ELASTICSEARCH_DATA_STRUCTURES.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/FILE_DOWNLOAD_LINKS.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/FILE_STORAGE_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/GETTING_STARTED.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/HISTORY_MESSAGE_FORMAT.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/IMPLEMENTATION_GUIDE_NEW_AGENT.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/MEMORY_INSTALLATION.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/MODIFICATIONS_CONCURRENCE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/MULTIMODAL_TOOLS_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/OBSERVABILITY_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/PYPI_PUBLISHING.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/QA_STREAMING_LATENCY.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/SCREENSHOTS_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/SPEC_CROSS_MODEL_HISTORY_CONVERSION.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/SSE_NOTIFICATIONS_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/STREAMING_EVENTS_FRONTEND.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/TOOLS_AND_MCP_GUIDE.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/WORKSPACE_INTEGRATION.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/api-reference.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/configuration.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/framework_audit_remarques.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/index.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/docs/installation-guide.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/README.md +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_context_budget_test.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_example_multi_skills.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_exemple_test.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_training_with_apo.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_with_custom_tools_file_storage.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_with_file_storage.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_with_mcp.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_with_memory_graphiti.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_with_memory_hybrid.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_with_memory_simple.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/agent_with_personalization.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/biagenttest.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/custom_framework_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/dependencies/docker-compose.yaml +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/pyproject.toml +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/simple_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/skills_demo_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/examples/workspace_test_agent.py +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/setup.cfg +0 -0
- {agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/setup.py +0 -0
{agent_framework_lib-0.8.1.post8/agent_framework_lib.egg-info → agent_framework_lib-0.8.2}/PKG-INFO
RENAMED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: agent-framework-lib
|
|
3
|
-
Version: 0.8.
|
|
3
|
+
Version: 0.8.2
|
|
4
4
|
Summary: A comprehensive Python framework for building and serving conversational AI agents with FastAPI
|
|
5
5
|
Author-email: Sebastian Pavel <sebastian@cinco.ai>, Elliott Girard <elliott.girard@icloud.com>
|
|
6
6
|
Maintainer-email: Sebastian Pavel <sebastian@cinco.ai>
|
|
@@ -89,6 +89,8 @@ Provides-Extra: excel
|
|
|
89
89
|
Requires-Dist: openpyxl>=3.1.0; extra == "excel"
|
|
90
90
|
Provides-Extra: drawio
|
|
91
91
|
Requires-Dist: drawpyo>=0.1.0; extra == "drawio"
|
|
92
|
+
Provides-Extra: gitnexus
|
|
93
|
+
Requires-Dist: httpx>=0.27.0; extra == "gitnexus"
|
|
92
94
|
Provides-Extra: dev
|
|
93
95
|
Requires-Dist: pytest>=8.4.0; extra == "dev"
|
|
94
96
|
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
|
|
@@ -186,7 +188,7 @@ uv add agent-framework-lib[llamaindex,mcp]
|
|
|
186
188
|
uv add agent-framework-lib[all]
|
|
187
189
|
```
|
|
188
190
|
|
|
189
|
-
**Available extras:** `llamaindex`, `mcp`, `mongodb`, `elasticsearch`, `postgresql`, `s3`, `minio`, `gcp`, `multimodal`, `memory`, `memori`, `graphiti`, `graphiti-falkordb`, `graphiti-neo4j`, `graphiti-all`, `observability`, `monitoring`, `websearch`, `dev`, `all`
|
|
191
|
+
**Available extras:** `llamaindex`, `mcp`, `gitnexus`, `mongodb`, `elasticsearch`, `postgresql`, `s3`, `minio`, `gcp`, `multimodal`, `memory`, `memori`, `graphiti`, `graphiti-falkordb`, `graphiti-neo4j`, `graphiti-all`, `observability`, `monitoring`, `websearch`, `dev`, `all`
|
|
190
192
|
|
|
191
193
|
**Optional: System Dependencies**
|
|
192
194
|
|
|
@@ -245,35 +247,74 @@ The framework includes a built-in AI assistant that helps you create agents! Acc
|
|
|
245
247
|
|
|
246
248
|
**Features:**
|
|
247
249
|
- 🧠 Deep knowledge of framework documentation, examples, and source code
|
|
248
|
-
- 🔍
|
|
250
|
+
- 🔍 **GitNexus-powered code intelligence** - 12937 symbols, 36668 relationships, 300 execution flows
|
|
249
251
|
- 💡 Code generation assistance
|
|
250
252
|
- 📚 Indexed knowledge base (30+ files)
|
|
251
253
|
- 🗄️ Persistent knowledge graph (FalkorDB) - survives server restarts
|
|
254
|
+
- 🔎 Hybrid search (semantic + structural + text fallback)
|
|
252
255
|
|
|
253
256
|
**Access:** `http://localhost:8000/helper`
|
|
254
257
|
|
|
258
|
+
### GitNexus Setup (Recommended)
|
|
259
|
+
|
|
260
|
+
For the best experience, install and run GitNexus to enable semantic code search:
|
|
261
|
+
|
|
262
|
+
```bash
|
|
263
|
+
# 1. Install and index the codebase
|
|
264
|
+
./scripts/setup_gitnexus.sh
|
|
265
|
+
|
|
266
|
+
# 2. Start the GitNexus server
|
|
267
|
+
./scripts/start_gitnexus_server.sh
|
|
268
|
+
|
|
269
|
+
# 3. Verify it's running
|
|
270
|
+
curl http://localhost:4747/health
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
The helper agent will automatically use GitNexus if available, with graceful fallback to text search if not running.
|
|
274
|
+
|
|
275
|
+
**What GitNexus enables:**
|
|
276
|
+
- Semantic code search across the entire framework
|
|
277
|
+
- Full symbol context (callers, callees, imports, dependencies)
|
|
278
|
+
- Execution flow tracing (300 end-to-end code paths)
|
|
279
|
+
- Impact analysis and relationship queries
|
|
280
|
+
|
|
281
|
+
📖 **[User Guide](docs/GITNEXUS_USER_GUIDE.md)** - Complete guide for using GitNexus features with the Helper Agent
|
|
282
|
+
|
|
283
|
+
**Optional dependencies:**
|
|
284
|
+
```bash
|
|
285
|
+
# Install GitNexus support
|
|
286
|
+
uv add agent-framework-lib[gitnexus]
|
|
287
|
+
```
|
|
288
|
+
|
|
255
289
|
The helper agent indexes:
|
|
256
290
|
- All documentation (`docs/*.md`)
|
|
257
291
|
- All examples (`examples/*.py`)
|
|
292
|
+
- All builtin skills (`agent_framework/skills/builtin/skills/*/SKILL.md`)
|
|
258
293
|
- Core framework source (tools, storage, memory, session management)
|
|
259
294
|
|
|
260
295
|
**Re-indexing:** If you update documentation or examples, trigger a re-index:
|
|
261
296
|
```bash
|
|
297
|
+
# Re-index knowledge base
|
|
262
298
|
curl -X POST http://localhost:8000/helper/reindex
|
|
299
|
+
|
|
300
|
+
# Re-index GitNexus (after code changes)
|
|
301
|
+
npx gitnexus analyze --embeddings
|
|
263
302
|
```
|
|
264
303
|
|
|
265
304
|
**Model Configuration:**
|
|
266
305
|
|
|
267
|
-
By default, the helper agent uses Claude (if `ANTHROPIC_API_KEY` is set) or GPT-5.
|
|
306
|
+
By default, the helper agent uses Claude (if `ANTHROPIC_API_KEY` is set) or GPT-5.4 (if `OPENAI_API_KEY` is set). You can override this with:
|
|
268
307
|
|
|
269
308
|
```env
|
|
270
309
|
# Force a specific model (useful if your Anthropic key has reached its limit)
|
|
271
|
-
HELPER_AGENT_MODEL=gpt-5.
|
|
310
|
+
HELPER_AGENT_MODEL=gpt-5.4
|
|
272
311
|
```
|
|
273
312
|
|
|
274
313
|
**Example questions:**
|
|
275
314
|
- "How do I create an agent with memory?"
|
|
276
|
-
- "Show me
|
|
315
|
+
- "Show me the execution flow for skill loading"
|
|
316
|
+
- "What calls the MemoryProvider class?"
|
|
317
|
+
- "Find all code related to authentication"
|
|
277
318
|
- "What's the difference between Memori and Graphiti?"
|
|
278
319
|
- "How do I configure S3 storage?"
|
|
279
320
|
- "Search the web for LlamaIndex best practices"
|
|
@@ -36,7 +36,7 @@ uv add agent-framework-lib[llamaindex,mcp]
|
|
|
36
36
|
uv add agent-framework-lib[all]
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
-
**Available extras:** `llamaindex`, `mcp`, `mongodb`, `elasticsearch`, `postgresql`, `s3`, `minio`, `gcp`, `multimodal`, `memory`, `memori`, `graphiti`, `graphiti-falkordb`, `graphiti-neo4j`, `graphiti-all`, `observability`, `monitoring`, `websearch`, `dev`, `all`
|
|
39
|
+
**Available extras:** `llamaindex`, `mcp`, `gitnexus`, `mongodb`, `elasticsearch`, `postgresql`, `s3`, `minio`, `gcp`, `multimodal`, `memory`, `memori`, `graphiti`, `graphiti-falkordb`, `graphiti-neo4j`, `graphiti-all`, `observability`, `monitoring`, `websearch`, `dev`, `all`
|
|
40
40
|
|
|
41
41
|
**Optional: System Dependencies**
|
|
42
42
|
|
|
@@ -95,35 +95,74 @@ The framework includes a built-in AI assistant that helps you create agents! Acc
|
|
|
95
95
|
|
|
96
96
|
**Features:**
|
|
97
97
|
- 🧠 Deep knowledge of framework documentation, examples, and source code
|
|
98
|
-
- 🔍
|
|
98
|
+
- 🔍 **GitNexus-powered code intelligence** - 12937 symbols, 36668 relationships, 300 execution flows
|
|
99
99
|
- 💡 Code generation assistance
|
|
100
100
|
- 📚 Indexed knowledge base (30+ files)
|
|
101
101
|
- 🗄️ Persistent knowledge graph (FalkorDB) - survives server restarts
|
|
102
|
+
- 🔎 Hybrid search (semantic + structural + text fallback)
|
|
102
103
|
|
|
103
104
|
**Access:** `http://localhost:8000/helper`
|
|
104
105
|
|
|
106
|
+
### GitNexus Setup (Recommended)
|
|
107
|
+
|
|
108
|
+
For the best experience, install and run GitNexus to enable semantic code search:
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
# 1. Install and index the codebase
|
|
112
|
+
./scripts/setup_gitnexus.sh
|
|
113
|
+
|
|
114
|
+
# 2. Start the GitNexus server
|
|
115
|
+
./scripts/start_gitnexus_server.sh
|
|
116
|
+
|
|
117
|
+
# 3. Verify it's running
|
|
118
|
+
curl http://localhost:4747/health
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
The helper agent will automatically use GitNexus if available, with graceful fallback to text search if not running.
|
|
122
|
+
|
|
123
|
+
**What GitNexus enables:**
|
|
124
|
+
- Semantic code search across the entire framework
|
|
125
|
+
- Full symbol context (callers, callees, imports, dependencies)
|
|
126
|
+
- Execution flow tracing (300 end-to-end code paths)
|
|
127
|
+
- Impact analysis and relationship queries
|
|
128
|
+
|
|
129
|
+
📖 **[User Guide](docs/GITNEXUS_USER_GUIDE.md)** - Complete guide for using GitNexus features with the Helper Agent
|
|
130
|
+
|
|
131
|
+
**Optional dependencies:**
|
|
132
|
+
```bash
|
|
133
|
+
# Install GitNexus support
|
|
134
|
+
uv add agent-framework-lib[gitnexus]
|
|
135
|
+
```
|
|
136
|
+
|
|
105
137
|
The helper agent indexes:
|
|
106
138
|
- All documentation (`docs/*.md`)
|
|
107
139
|
- All examples (`examples/*.py`)
|
|
140
|
+
- All builtin skills (`agent_framework/skills/builtin/skills/*/SKILL.md`)
|
|
108
141
|
- Core framework source (tools, storage, memory, session management)
|
|
109
142
|
|
|
110
143
|
**Re-indexing:** If you update documentation or examples, trigger a re-index:
|
|
111
144
|
```bash
|
|
145
|
+
# Re-index knowledge base
|
|
112
146
|
curl -X POST http://localhost:8000/helper/reindex
|
|
147
|
+
|
|
148
|
+
# Re-index GitNexus (after code changes)
|
|
149
|
+
npx gitnexus analyze --embeddings
|
|
113
150
|
```
|
|
114
151
|
|
|
115
152
|
**Model Configuration:**
|
|
116
153
|
|
|
117
|
-
By default, the helper agent uses Claude (if `ANTHROPIC_API_KEY` is set) or GPT-5.
|
|
154
|
+
By default, the helper agent uses Claude (if `ANTHROPIC_API_KEY` is set) or GPT-5.4 (if `OPENAI_API_KEY` is set). You can override this with:
|
|
118
155
|
|
|
119
156
|
```env
|
|
120
157
|
# Force a specific model (useful if your Anthropic key has reached its limit)
|
|
121
|
-
HELPER_AGENT_MODEL=gpt-5.
|
|
158
|
+
HELPER_AGENT_MODEL=gpt-5.4
|
|
122
159
|
```
|
|
123
160
|
|
|
124
161
|
**Example questions:**
|
|
125
162
|
- "How do I create an agent with memory?"
|
|
126
|
-
- "Show me
|
|
163
|
+
- "Show me the execution flow for skill loading"
|
|
164
|
+
- "What calls the MemoryProvider class?"
|
|
165
|
+
- "Find all code related to authentication"
|
|
127
166
|
- "What's the difference between Memori and Graphiti?"
|
|
128
167
|
- "How do I configure S3 storage?"
|
|
129
168
|
- "Search the web for LlamaIndex best practices"
|
|
@@ -32,7 +32,7 @@ Example Usage:
|
|
|
32
32
|
create_basic_agent_server(MyAgent, port=8000)
|
|
33
33
|
```
|
|
34
34
|
|
|
35
|
-
Version: 0.8.
|
|
35
|
+
Version: 0.8.2
|
|
36
36
|
Author: Cinco AI Team
|
|
37
37
|
License: MIT
|
|
38
38
|
"""
|
|
@@ -88,7 +88,7 @@ def _auto_setup_dependencies() -> None:
|
|
|
88
88
|
# Track if auto-setup has been done
|
|
89
89
|
_AUTO_SETUP_DONE = False
|
|
90
90
|
|
|
91
|
-
__version__ = "0.8.
|
|
91
|
+
__version__ = "0.8.2"
|
|
92
92
|
__author__ = "Cinco AI Team"
|
|
93
93
|
__license__ = "MIT"
|
|
94
94
|
__email__ = "sebastian@cinco.ai"
|
|
@@ -0,0 +1,386 @@
|
|
|
1
|
+
# GitNexus User Guide — Framework Helper Agent
|
|
2
|
+
|
|
3
|
+
Le **Framework Helper Agent** utilise maintenant **GitNexus** pour une compréhension profonde du code. Ce guide explique comment tirer parti de ces nouvelles capacités.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 🎯 Qu'est-ce que GitNexus ?
|
|
8
|
+
|
|
9
|
+
GitNexus est un moteur d'intelligence de code qui indexe votre codebase dans un graphe de connaissances avec :
|
|
10
|
+
|
|
11
|
+
- **13,746 symboles** (classes, fonctions, méthodes)
|
|
12
|
+
- **38,427 relations** (imports, appels, héritage)
|
|
13
|
+
- **300 execution flows** (processus end-to-end)
|
|
14
|
+
- **6,889 embeddings** (recherche sémantique)
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## ✨ Nouvelles Capacités
|
|
19
|
+
|
|
20
|
+
### 1. Recherche Sémantique Intelligente
|
|
21
|
+
|
|
22
|
+
**Avant GitNexus** : Recherche texte simple
|
|
23
|
+
|
|
24
|
+
```
|
|
25
|
+
User: Trouve comment créer un agent avec mémoire
|
|
26
|
+
Helper: [Recherche grep dans les fichiers...]
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
**Avec GitNexus** : Recherche sémantique avec contexte
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
User: Trouve comment créer un agent avec mémoire
|
|
33
|
+
Helper: [GitNexus query: "agent memory creation"]
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**Résultat** :
|
|
37
|
+
- Trouve les **execution flows** pertinents (agent_initialization → MemoryManager)
|
|
38
|
+
- Affiche les **symboles** dans le contexte (LlamaIndexAgent, MemoryConfig)
|
|
39
|
+
- Montre les **définitions** clés (MemoriProvider, GraphitiProvider)
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
### 2. Compréhension des Relations
|
|
44
|
+
|
|
45
|
+
**Question** : Comment LlamaIndexAgent est-il utilisé ?
|
|
46
|
+
|
|
47
|
+
**Réponse GitNexus** :
|
|
48
|
+
|
|
49
|
+
#### Extended By (30 classes)
|
|
50
|
+
- `FrameworkHelperAgent` in `agent_framework/web/helper_agent.py`
|
|
51
|
+
- `SkillsDemoAgent` in `examples/skills_demo_agent.py`
|
|
52
|
+
- `CalculatorAgent` in `examples/simple_agent.py`
|
|
53
|
+
- ...et 27 autres
|
|
54
|
+
|
|
55
|
+
#### Methods (30 méthodes)
|
|
56
|
+
- `__init__` (ligne 164)
|
|
57
|
+
- `get_agent_prompt` (ligne 450)
|
|
58
|
+
- `get_agent_tools` (ligne 520)
|
|
59
|
+
- `run_agent` (ligne 1800)
|
|
60
|
+
- ...
|
|
61
|
+
|
|
62
|
+
#### Imported By (8 fichiers)
|
|
63
|
+
- `agent_framework/__init__.py`
|
|
64
|
+
- `agent_framework/web/helper_agent.py`
|
|
65
|
+
- ...
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
### 3. Traçage des Execution Flows
|
|
70
|
+
|
|
71
|
+
**Question** : Comment fonctionne le streaming de messages ?
|
|
72
|
+
|
|
73
|
+
**Résultat GitNexus** :
|
|
74
|
+
|
|
75
|
+
```
|
|
76
|
+
Execution Flow: "Message_stream → Agent_run"
|
|
77
|
+
Priority: 0.95
|
|
78
|
+
Steps: 12
|
|
79
|
+
|
|
80
|
+
Step 1: stream() in server.py:1566
|
|
81
|
+
Step 2: run_agent() in llamaindex_agent.py:1800
|
|
82
|
+
Step 3: _default_run_agent_stream() in llamaindex_agent.py:1200
|
|
83
|
+
...
|
|
84
|
+
Step 12: yield TextOutputPart in agent_interface.py:250
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 📖 Comment Utiliser GitNexus
|
|
90
|
+
|
|
91
|
+
### Questions à Poser au Helper Agent
|
|
92
|
+
|
|
93
|
+
#### 🔍 Recherche de Code
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
"Comment créer un agent avec skills personnalisées ?"
|
|
97
|
+
"Où est gérée la mémoire des sessions ?"
|
|
98
|
+
"Comment utiliser le file storage ?"
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
→ **GitNexus** trouve les symbols, processes, et definitions pertinents
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
#### 🧩 Relations et Dépendances
|
|
106
|
+
|
|
107
|
+
```
|
|
108
|
+
"Quelles classes étendent BaseAgent ?"
|
|
109
|
+
"Qui appelle la méthode initialize_agent ?"
|
|
110
|
+
"Quels fichiers importent MemoryConfig ?"
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
→ **GitNexus** affiche les relations **incoming** et **outgoing**
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
#### 🔄 Processus et Flows
|
|
118
|
+
|
|
119
|
+
```
|
|
120
|
+
"Trace l'exécution complète d'un message user"
|
|
121
|
+
"Montre le flow de création d'un agent"
|
|
122
|
+
"Comment fonctionne le subagent executor ?"
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
→ **GitNexus** trouve les **execution flows** step-by-step
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## 🎛️ Outils Disponibles dans Helper Agent
|
|
130
|
+
|
|
131
|
+
Le Helper Agent a maintenant accès à ces outils GitNexus :
|
|
132
|
+
|
|
133
|
+
### 1. `search_knowledge(query)`
|
|
134
|
+
|
|
135
|
+
Recherche sémantique dans le code.
|
|
136
|
+
|
|
137
|
+
**Exemple** :
|
|
138
|
+
```python
|
|
139
|
+
search_knowledge("agent memory initialization")
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
**Retourne** :
|
|
143
|
+
- Execution flows pertinents
|
|
144
|
+
- Symboles dans le contexte
|
|
145
|
+
- Définitions clés
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
### 2. `get_code_relationships(class_name)`
|
|
150
|
+
|
|
151
|
+
Obtient le contexte complet d'un symbole (360° view).
|
|
152
|
+
|
|
153
|
+
**Exemple** :
|
|
154
|
+
```python
|
|
155
|
+
get_code_relationships("LlamaIndexAgent")
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
**Retourne** :
|
|
159
|
+
- Extended By (qui hérite de cette classe)
|
|
160
|
+
- Imported By (qui l'importe)
|
|
161
|
+
- Methods (méthodes définies)
|
|
162
|
+
- Calls (quelles fonctions elle appelle)
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## 🚀 Bonnes Pratiques
|
|
167
|
+
|
|
168
|
+
### ✅ Bonnes Questions
|
|
169
|
+
|
|
170
|
+
❌ **Trop vague** : "Comment fonctionne le framework ?"
|
|
171
|
+
✅ **Spécifique** : "Comment créer un agent avec MemoriProvider ?"
|
|
172
|
+
|
|
173
|
+
❌ **Trop large** : "Montre-moi tout sur les skills"
|
|
174
|
+
✅ **Ciblé** : "Comment charger dynamiquement une skill personnalisée ?"
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
### ✅ Utiliser les Noms de Symboles
|
|
179
|
+
|
|
180
|
+
Si vous connaissez le nom d'une classe/fonction :
|
|
181
|
+
|
|
182
|
+
```
|
|
183
|
+
"Montre-moi le contexte de MemoryConfig"
|
|
184
|
+
"Qui utilise la classe SubagentExecutor ?"
|
|
185
|
+
"Trace les appels vers run_agent()"
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
→ GitNexus donnera un **contexte précis** avec toutes les relations
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
### ✅ Demander des Exemples
|
|
193
|
+
|
|
194
|
+
```
|
|
195
|
+
"Montre un exemple d'agent qui utilise Graphiti"
|
|
196
|
+
"Donne-moi un exemple d'utilisation de file storage"
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
→ GitNexus trouvera les **execution flows** et **process symbols** dans les exemples
|
|
200
|
+
|
|
201
|
+
---
|
|
202
|
+
|
|
203
|
+
## 📊 Monitoring (pour les administrateurs)
|
|
204
|
+
|
|
205
|
+
### Endpoint de Health Check
|
|
206
|
+
|
|
207
|
+
```bash
|
|
208
|
+
curl http://localhost:4747/health/gitnexus
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
**Réponse** :
|
|
212
|
+
```json
|
|
213
|
+
{
|
|
214
|
+
"status": "healthy",
|
|
215
|
+
"available": true,
|
|
216
|
+
"index_fresh": true,
|
|
217
|
+
"metrics": {
|
|
218
|
+
"calls": 150,
|
|
219
|
+
"successes": 148,
|
|
220
|
+
"failures": 2,
|
|
221
|
+
"success_rate": 98.67,
|
|
222
|
+
"avg_response_time": 0.245,
|
|
223
|
+
"graphiti_fallbacks": 1,
|
|
224
|
+
"text_fallbacks": 0
|
|
225
|
+
},
|
|
226
|
+
"index": {
|
|
227
|
+
"is_fresh": true,
|
|
228
|
+
"commits_behind": 0,
|
|
229
|
+
"needs_reindex": false
|
|
230
|
+
}
|
|
231
|
+
}
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
---
|
|
235
|
+
|
|
236
|
+
### Logs Périodiques
|
|
237
|
+
|
|
238
|
+
Toutes les 5 minutes (configurable via `GITNEXUS_METRICS_INTERVAL`), le serveur log :
|
|
239
|
+
|
|
240
|
+
```
|
|
241
|
+
[GITNEXUS METRICS] Calls: 150 (✅ 148, ❌ 2),
|
|
242
|
+
Success rate: 98.7%, Avg response: 0.25s,
|
|
243
|
+
Fallbacks: Graphiti=1, Text=0
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
**Variables d'environnement** :
|
|
247
|
+
- `GITNEXUS_METRICS_LOGGING=true` (activer/désactiver)
|
|
248
|
+
- `GITNEXUS_METRICS_INTERVAL=300` (intervalle en secondes)
|
|
249
|
+
|
|
250
|
+
---
|
|
251
|
+
|
|
252
|
+
## 🔧 Maintenance
|
|
253
|
+
|
|
254
|
+
### Index Obsolète ?
|
|
255
|
+
|
|
256
|
+
Si vous voyez :
|
|
257
|
+
|
|
258
|
+
```
|
|
259
|
+
⚠️ Index obsolète (3 commits behind)
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
**Solution** :
|
|
263
|
+
```bash
|
|
264
|
+
gitnexus analyze --embeddings
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
Ou : les **Git hooks** le font automatiquement après chaque commit/merge.
|
|
268
|
+
|
|
269
|
+
---
|
|
270
|
+
|
|
271
|
+
### Embeddings Manquants ?
|
|
272
|
+
|
|
273
|
+
Si `embeddings: 0` dans `.gitnexus/meta.json` :
|
|
274
|
+
|
|
275
|
+
```bash
|
|
276
|
+
gitnexus analyze --embeddings
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
⚠️ **Important** : Toujours utiliser `--embeddings` pour la recherche sémantique.
|
|
280
|
+
|
|
281
|
+
---
|
|
282
|
+
|
|
283
|
+
## 🎓 Exemples d'Utilisation
|
|
284
|
+
|
|
285
|
+
### Exemple 1 : Créer un Agent avec Mémoire
|
|
286
|
+
|
|
287
|
+
**Question** :
|
|
288
|
+
```
|
|
289
|
+
Comment créer un agent qui se souvient des préférences utilisateur ?
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
**GitNexus trouve** :
|
|
293
|
+
1. Execution flow: `Agent_initialization → MemoryManager`
|
|
294
|
+
2. Symboles: `MemoryConfig`, `MemoriProvider`
|
|
295
|
+
3. Exemple: `examples/agent_with_personalization.py`
|
|
296
|
+
|
|
297
|
+
**Helper Agent répond** :
|
|
298
|
+
```python
|
|
299
|
+
# Exemple trouvé par GitNexus
|
|
300
|
+
from agent_framework import LlamaIndexAgent
|
|
301
|
+
from agent_framework.memory.config import MemoryConfig
|
|
302
|
+
|
|
303
|
+
class MyAgent(LlamaIndexAgent):
|
|
304
|
+
def __init__(self):
|
|
305
|
+
super().__init__(
|
|
306
|
+
memory_config=MemoryConfig.memori(
|
|
307
|
+
db_url="sqlite:///agent_memory.db"
|
|
308
|
+
)
|
|
309
|
+
)
|
|
310
|
+
|
|
311
|
+
def get_agent_prompt(self) -> str:
|
|
312
|
+
return "You are an assistant that remembers user preferences..."
|
|
313
|
+
```
|
|
314
|
+
|
|
315
|
+
---
|
|
316
|
+
|
|
317
|
+
### Exemple 2 : Comprendre le File Storage
|
|
318
|
+
|
|
319
|
+
**Question** :
|
|
320
|
+
```
|
|
321
|
+
Montre-moi comment fonctionne le file storage dans le framework
|
|
322
|
+
```
|
|
323
|
+
|
|
324
|
+
**GitNexus trouve** :
|
|
325
|
+
1. Class: `FileStorageManager` in `agent_framework/storage/file_storage.py`
|
|
326
|
+
2. Extended by: 12 agents dans les examples
|
|
327
|
+
3. Methods: `save_file()`, `get_file()`, `list_files()`
|
|
328
|
+
|
|
329
|
+
**Helper Agent répond** :
|
|
330
|
+
```
|
|
331
|
+
Le FileStorageManager gère le stockage des fichiers générés par les agents.
|
|
332
|
+
|
|
333
|
+
Utilisation :
|
|
334
|
+
1. Backends supportés : local, S3, MinIO, GCP
|
|
335
|
+
2. Auto-injecté dans les agents via set_file_storage()
|
|
336
|
+
3. Accessible dans les tools via self.file_storage
|
|
337
|
+
|
|
338
|
+
Exemple : examples/agent_with_file_storage.py
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
---
|
|
342
|
+
|
|
343
|
+
## 🆘 Dépannage
|
|
344
|
+
|
|
345
|
+
### GitNexus non disponible
|
|
346
|
+
|
|
347
|
+
**Symptôme** : `⚠️ GitNexus non disponible - fallback to Graphiti`
|
|
348
|
+
|
|
349
|
+
**Causes** :
|
|
350
|
+
1. GitNexus non installé → `npm install -g gitnexus`
|
|
351
|
+
2. Index non créé → `./scripts/setup_gitnexus.sh`
|
|
352
|
+
3. Serveur non démarré (optionnel pour CLI)
|
|
353
|
+
|
|
354
|
+
---
|
|
355
|
+
|
|
356
|
+
### Requêtes lentes
|
|
357
|
+
|
|
358
|
+
**Symptôme** : `avg_response_time > 2s`
|
|
359
|
+
|
|
360
|
+
**Solutions** :
|
|
361
|
+
1. Vérifier les embeddings : `cat .gitnexus/meta.json | grep embeddings`
|
|
362
|
+
2. Re-indexer : `gitnexus analyze --embeddings`
|
|
363
|
+
3. Réduire la taille du repo avec `.gitignore`
|
|
364
|
+
|
|
365
|
+
---
|
|
366
|
+
|
|
367
|
+
## 📚 Ressources
|
|
368
|
+
|
|
369
|
+
- **Documentation GitNexus** : [https://gitnexus.io](https://gitnexus.io)
|
|
370
|
+
- **CLAUDE.md** : Guide GitNexus pour Claude Code
|
|
371
|
+
- **README.md** : Setup instructions
|
|
372
|
+
- **CHANGELOG.md** : Historique des fonctionnalités
|
|
373
|
+
|
|
374
|
+
---
|
|
375
|
+
|
|
376
|
+
## ✅ Checklist pour les Utilisateurs
|
|
377
|
+
|
|
378
|
+
- [ ] GitNexus installé (`gitnexus --version`)
|
|
379
|
+
- [ ] Index créé avec embeddings (`.gitnexus/lbug` existe)
|
|
380
|
+
- [ ] Git hooks installés (`./scripts/install_git_hooks.sh`)
|
|
381
|
+
- [ ] Testé avec Helper Agent (question simple)
|
|
382
|
+
- [ ] Vérifié les métriques (`curl localhost:4747/health/gitnexus`)
|
|
383
|
+
|
|
384
|
+
---
|
|
385
|
+
|
|
386
|
+
**Happy coding with GitNexus! 🚀**
|
{agent_framework_lib-0.8.1.post8 → agent_framework_lib-0.8.2}/agent_framework/web/docs/README.md
RENAMED
|
@@ -36,7 +36,7 @@ uv add agent-framework-lib[llamaindex,mcp]
|
|
|
36
36
|
uv add agent-framework-lib[all]
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
-
**Available extras:** `llamaindex`, `mcp`, `mongodb`, `elasticsearch`, `postgresql`, `s3`, `minio`, `gcp`, `multimodal`, `memory`, `memori`, `graphiti`, `graphiti-falkordb`, `graphiti-neo4j`, `graphiti-all`, `observability`, `monitoring`, `websearch`, `dev`, `all`
|
|
39
|
+
**Available extras:** `llamaindex`, `mcp`, `gitnexus`, `mongodb`, `elasticsearch`, `postgresql`, `s3`, `minio`, `gcp`, `multimodal`, `memory`, `memori`, `graphiti`, `graphiti-falkordb`, `graphiti-neo4j`, `graphiti-all`, `observability`, `monitoring`, `websearch`, `dev`, `all`
|
|
40
40
|
|
|
41
41
|
**Optional: System Dependencies**
|
|
42
42
|
|
|
@@ -95,35 +95,74 @@ The framework includes a built-in AI assistant that helps you create agents! Acc
|
|
|
95
95
|
|
|
96
96
|
**Features:**
|
|
97
97
|
- 🧠 Deep knowledge of framework documentation, examples, and source code
|
|
98
|
-
- 🔍
|
|
98
|
+
- 🔍 **GitNexus-powered code intelligence** - 12937 symbols, 36668 relationships, 300 execution flows
|
|
99
99
|
- 💡 Code generation assistance
|
|
100
100
|
- 📚 Indexed knowledge base (30+ files)
|
|
101
101
|
- 🗄️ Persistent knowledge graph (FalkorDB) - survives server restarts
|
|
102
|
+
- 🔎 Hybrid search (semantic + structural + text fallback)
|
|
102
103
|
|
|
103
104
|
**Access:** `http://localhost:8000/helper`
|
|
104
105
|
|
|
106
|
+
### GitNexus Setup (Recommended)
|
|
107
|
+
|
|
108
|
+
For the best experience, install and run GitNexus to enable semantic code search:
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
# 1. Install and index the codebase
|
|
112
|
+
./scripts/setup_gitnexus.sh
|
|
113
|
+
|
|
114
|
+
# 2. Start the GitNexus server
|
|
115
|
+
./scripts/start_gitnexus_server.sh
|
|
116
|
+
|
|
117
|
+
# 3. Verify it's running
|
|
118
|
+
curl http://localhost:4747/health
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
The helper agent will automatically use GitNexus if available, with graceful fallback to text search if not running.
|
|
122
|
+
|
|
123
|
+
**What GitNexus enables:**
|
|
124
|
+
- Semantic code search across the entire framework
|
|
125
|
+
- Full symbol context (callers, callees, imports, dependencies)
|
|
126
|
+
- Execution flow tracing (300 end-to-end code paths)
|
|
127
|
+
- Impact analysis and relationship queries
|
|
128
|
+
|
|
129
|
+
📖 **[User Guide](docs/GITNEXUS_USER_GUIDE.md)** - Complete guide for using GitNexus features with the Helper Agent
|
|
130
|
+
|
|
131
|
+
**Optional dependencies:**
|
|
132
|
+
```bash
|
|
133
|
+
# Install GitNexus support
|
|
134
|
+
uv add agent-framework-lib[gitnexus]
|
|
135
|
+
```
|
|
136
|
+
|
|
105
137
|
The helper agent indexes:
|
|
106
138
|
- All documentation (`docs/*.md`)
|
|
107
139
|
- All examples (`examples/*.py`)
|
|
140
|
+
- All builtin skills (`agent_framework/skills/builtin/skills/*/SKILL.md`)
|
|
108
141
|
- Core framework source (tools, storage, memory, session management)
|
|
109
142
|
|
|
110
143
|
**Re-indexing:** If you update documentation or examples, trigger a re-index:
|
|
111
144
|
```bash
|
|
145
|
+
# Re-index knowledge base
|
|
112
146
|
curl -X POST http://localhost:8000/helper/reindex
|
|
147
|
+
|
|
148
|
+
# Re-index GitNexus (after code changes)
|
|
149
|
+
npx gitnexus analyze --embeddings
|
|
113
150
|
```
|
|
114
151
|
|
|
115
152
|
**Model Configuration:**
|
|
116
153
|
|
|
117
|
-
By default, the helper agent uses Claude (if `ANTHROPIC_API_KEY` is set) or GPT-5.
|
|
154
|
+
By default, the helper agent uses Claude (if `ANTHROPIC_API_KEY` is set) or GPT-5.4 (if `OPENAI_API_KEY` is set). You can override this with:
|
|
118
155
|
|
|
119
156
|
```env
|
|
120
157
|
# Force a specific model (useful if your Anthropic key has reached its limit)
|
|
121
|
-
HELPER_AGENT_MODEL=gpt-5.
|
|
158
|
+
HELPER_AGENT_MODEL=gpt-5.4
|
|
122
159
|
```
|
|
123
160
|
|
|
124
161
|
**Example questions:**
|
|
125
162
|
- "How do I create an agent with memory?"
|
|
126
|
-
- "Show me
|
|
163
|
+
- "Show me the execution flow for skill loading"
|
|
164
|
+
- "What calls the MemoryProvider class?"
|
|
165
|
+
- "Find all code related to authentication"
|
|
127
166
|
- "What's the difference between Memori and Graphiti?"
|
|
128
167
|
- "How do I configure S3 storage?"
|
|
129
168
|
- "Search the web for LlamaIndex best practices"
|