mirror of
https://github.com/trustgraph-ai/trustgraph.git
synced 2026-04-25 16:36:21 +02:00
* Bump setup.py versions for 1.1 * PoC MCP server (#419) * Very initial MCP server PoC for TrustGraph * Put service on port 8000 * Add MCP container and packages to buildout * Update docs for API/CLI changes in 1.0 (#421) * Update some API basics for the 0.23/1.0 API change * Add MCP container push (#425) * Add command args to the MCP server (#426) * Host and port parameters * Added websocket arg * More docs * MCP client support (#427) - MCP client service - Tool request/response schema - API gateway support for mcp-tool - Message translation for tool request & response - Make mcp-tool using configuration service for information about where the MCP services are. * Feature/react call mcp (#428) Key Features - MCP Tool Integration: Added core MCP tool support with ToolClientSpec and ToolClient classes - API Enhancement: New mcp_tool method for flow-specific tool invocation - CLI Tooling: New tg-invoke-mcp-tool command for testing MCP integration - React Agent Enhancement: Fixed and improved multi-tool invocation capabilities - Tool Management: Enhanced CLI for tool configuration and management Changes - Added MCP tool invocation to API with flow-specific integration - Implemented ToolClientSpec and ToolClient for tool call handling - Updated agent-manager-react to invoke MCP tools with configurable types - Enhanced CLI with new commands and improved help text - Added comprehensive documentation for new CLI commands - Improved tool configuration management Testing - Added tg-invoke-mcp-tool CLI command for isolated MCP integration testing - Enhanced agent capability to invoke multiple tools simultaneously * Test suite executed from CI pipeline (#433) * Test strategy & test cases * Unit tests * Integration tests * Extending test coverage (#434) * Contract tests * Testing embeedings * Agent unit tests * Knowledge pipeline tests * Turn on contract tests * Increase storage test coverage (#435) * Fixing storage and adding tests * PR pipeline only runs quick tests * Empty configuration is returned as empty list, previously was not in response (#436) * Update config util to take files as well as command-line text (#437) * Updated CLI invocation and config model for tools and mcp (#438) * Updated CLI invocation and config model for tools and mcp * CLI anomalies * Tweaked the MCP tool implementation for new model * Update agent implementation to match the new model * Fix agent tools, now all tested * Fixed integration tests * Fix MCP delete tool params * Update Python deps to 1.2 * Update to enable knowledge extraction using the agent framework (#439) * Implement KG extraction agent (kg-extract-agent) * Using ReAct framework (agent-manager-react) * ReAct manager had an issue when emitting JSON, which conflicts which ReAct manager's own JSON messages, so refactored ReAct manager to use traditional ReAct messages, non-JSON structure. * Minor refactor to take the prompt template client out of prompt-template so it can be more readily used by other modules. kg-extract-agent uses this framework. * Migrate from setup.py to pyproject.toml (#440) * Converted setup.py to pyproject.toml * Modern package infrastructure as recommended by py docs * Install missing build deps (#441) * Install missing build deps (#442) * Implement logging strategy (#444) * Logging strategy and convert all prints() to logging invocations * Fix/startup failure (#445) * Fix loggin startup problems * Fix logging startup problems (#446) * Fix logging startup problems (#447) * Fixed Mistral OCR to use current API (#448) * Fixed Mistral OCR to use current API * Added PDF decoder tests * Fix Mistral OCR ident to be standard pdf-decoder (#450) * Fix Mistral OCR ident to be standard pdf-decoder * Correct test * Schema structure refactor (#451) * Write schema refactor spec * Implemented schema refactor spec * Structure data mvp (#452) * Structured data tech spec * Architecture principles * New schemas * Updated schemas and specs * Object extractor * Add .coveragerc * New tests * Cassandra object storage * Trying to object extraction working, issues exist * Validate librarian collection (#453) * Fix token chunker, broken API invocation (#454) * Fix token chunker, broken API invocation (#455) * Knowledge load utility CLI (#456) * Knowledge loader * More tests
347 lines
No EOL
12 KiB
Python
347 lines
No EOL
12 KiB
Python
"""
|
|
Unit tests for trustgraph.base.flow_processor
|
|
Starting small with a single test to verify basic functionality
|
|
"""
|
|
|
|
import pytest
|
|
from unittest.mock import AsyncMock, MagicMock, patch
|
|
from unittest import IsolatedAsyncioTestCase
|
|
|
|
# Import the service under test
|
|
from trustgraph.base.flow_processor import FlowProcessor
|
|
|
|
|
|
class TestFlowProcessorSimple(IsolatedAsyncioTestCase):
|
|
"""Test FlowProcessor base class functionality"""
|
|
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
async def test_flow_processor_initialization_basic(self, mock_register_config, mock_async_init):
|
|
"""Test basic FlowProcessor initialization"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
|
|
config = {
|
|
'id': 'test-flow-processor',
|
|
'taskgroup': AsyncMock()
|
|
}
|
|
|
|
# Act
|
|
processor = FlowProcessor(**config)
|
|
|
|
# Assert
|
|
# Verify AsyncProcessor.__init__ was called
|
|
mock_async_init.assert_called_once()
|
|
|
|
# Verify register_config_handler was called with the correct handler
|
|
mock_register_config.assert_called_once_with(processor.on_configure_flows)
|
|
|
|
# Verify FlowProcessor-specific initialization
|
|
assert hasattr(processor, 'flows')
|
|
assert processor.flows == {}
|
|
assert hasattr(processor, 'specifications')
|
|
assert processor.specifications == []
|
|
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
async def test_register_specification(self, mock_register_config, mock_async_init):
|
|
"""Test registering a specification"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
|
|
config = {
|
|
'id': 'test-flow-processor',
|
|
'taskgroup': AsyncMock()
|
|
}
|
|
|
|
processor = FlowProcessor(**config)
|
|
mock_spec = MagicMock()
|
|
mock_spec.name = 'test-spec'
|
|
|
|
# Act
|
|
processor.register_specification(mock_spec)
|
|
|
|
# Assert
|
|
assert len(processor.specifications) == 1
|
|
assert processor.specifications[0] == mock_spec
|
|
|
|
@patch('trustgraph.base.flow_processor.Flow')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
async def test_start_flow(self, mock_register_config, mock_async_init, mock_flow_class):
|
|
"""Test starting a flow"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
|
|
config = {
|
|
'id': 'test-flow-processor',
|
|
'taskgroup': AsyncMock()
|
|
}
|
|
|
|
processor = FlowProcessor(**config)
|
|
processor.id = 'test-processor' # Set id for Flow creation
|
|
|
|
mock_flow = AsyncMock()
|
|
mock_flow_class.return_value = mock_flow
|
|
|
|
flow_name = 'test-flow'
|
|
flow_defn = {'config': 'test-config'}
|
|
|
|
# Act
|
|
await processor.start_flow(flow_name, flow_defn)
|
|
|
|
# Assert
|
|
assert flow_name in processor.flows
|
|
# Verify Flow was created with correct parameters
|
|
mock_flow_class.assert_called_once_with('test-processor', flow_name, processor, flow_defn)
|
|
# Verify the flow's start method was called
|
|
mock_flow.start.assert_called_once()
|
|
|
|
@patch('trustgraph.base.flow_processor.Flow')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
async def test_stop_flow(self, mock_register_config, mock_async_init, mock_flow_class):
|
|
"""Test stopping a flow"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
|
|
config = {
|
|
'id': 'test-flow-processor',
|
|
'taskgroup': AsyncMock()
|
|
}
|
|
|
|
processor = FlowProcessor(**config)
|
|
processor.id = 'test-processor'
|
|
|
|
mock_flow = AsyncMock()
|
|
mock_flow_class.return_value = mock_flow
|
|
|
|
flow_name = 'test-flow'
|
|
flow_defn = {'config': 'test-config'}
|
|
|
|
# Start a flow first
|
|
await processor.start_flow(flow_name, flow_defn)
|
|
|
|
# Act
|
|
await processor.stop_flow(flow_name)
|
|
|
|
# Assert
|
|
assert flow_name not in processor.flows
|
|
mock_flow.stop.assert_called_once()
|
|
|
|
@patch('trustgraph.base.flow_processor.Flow')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
async def test_stop_flow_not_exists(self, mock_register_config, mock_async_init, mock_flow_class):
|
|
"""Test stopping a flow that doesn't exist"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
|
|
config = {
|
|
'id': 'test-flow-processor',
|
|
'taskgroup': AsyncMock()
|
|
}
|
|
|
|
processor = FlowProcessor(**config)
|
|
|
|
# Act - should not raise an exception
|
|
await processor.stop_flow('non-existent-flow')
|
|
|
|
# Assert - flows dict should still be empty
|
|
assert processor.flows == {}
|
|
|
|
@patch('trustgraph.base.flow_processor.Flow')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
async def test_on_configure_flows_basic(self, mock_register_config, mock_async_init, mock_flow_class):
|
|
"""Test basic flow configuration handling"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
|
|
config = {
|
|
'id': 'test-flow-processor',
|
|
'taskgroup': AsyncMock()
|
|
}
|
|
|
|
processor = FlowProcessor(**config)
|
|
processor.id = 'test-processor'
|
|
|
|
mock_flow = AsyncMock()
|
|
mock_flow_class.return_value = mock_flow
|
|
|
|
# Configuration with flows for this processor
|
|
flow_config = {
|
|
'test-flow': {'config': 'test-config'}
|
|
}
|
|
config_data = {
|
|
'flows-active': {
|
|
'test-processor': '{"test-flow": {"config": "test-config"}}'
|
|
}
|
|
}
|
|
|
|
# Act
|
|
await processor.on_configure_flows(config_data, version=1)
|
|
|
|
# Assert
|
|
assert 'test-flow' in processor.flows
|
|
mock_flow_class.assert_called_once_with('test-processor', 'test-flow', processor, {'config': 'test-config'})
|
|
mock_flow.start.assert_called_once()
|
|
|
|
@patch('trustgraph.base.flow_processor.Flow')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
async def test_on_configure_flows_no_config(self, mock_register_config, mock_async_init, mock_flow_class):
|
|
"""Test flow configuration handling when no config exists for this processor"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
|
|
config = {
|
|
'id': 'test-flow-processor',
|
|
'taskgroup': AsyncMock()
|
|
}
|
|
|
|
processor = FlowProcessor(**config)
|
|
processor.id = 'test-processor'
|
|
|
|
# Configuration without flows for this processor
|
|
config_data = {
|
|
'flows-active': {
|
|
'other-processor': '{"other-flow": {"config": "other-config"}}'
|
|
}
|
|
}
|
|
|
|
# Act
|
|
await processor.on_configure_flows(config_data, version=1)
|
|
|
|
# Assert
|
|
assert processor.flows == {}
|
|
mock_flow_class.assert_not_called()
|
|
|
|
@patch('trustgraph.base.flow_processor.Flow')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
async def test_on_configure_flows_invalid_config(self, mock_register_config, mock_async_init, mock_flow_class):
|
|
"""Test flow configuration handling with invalid config format"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
|
|
config = {
|
|
'id': 'test-flow-processor',
|
|
'taskgroup': AsyncMock()
|
|
}
|
|
|
|
processor = FlowProcessor(**config)
|
|
processor.id = 'test-processor'
|
|
|
|
# Configuration without flows-active key
|
|
config_data = {
|
|
'other-data': 'some-value'
|
|
}
|
|
|
|
# Act
|
|
await processor.on_configure_flows(config_data, version=1)
|
|
|
|
# Assert
|
|
assert processor.flows == {}
|
|
mock_flow_class.assert_not_called()
|
|
|
|
@patch('trustgraph.base.flow_processor.Flow')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
async def test_on_configure_flows_start_and_stop(self, mock_register_config, mock_async_init, mock_flow_class):
|
|
"""Test flow configuration handling with starting and stopping flows"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
|
|
config = {
|
|
'id': 'test-flow-processor',
|
|
'taskgroup': AsyncMock()
|
|
}
|
|
|
|
processor = FlowProcessor(**config)
|
|
processor.id = 'test-processor'
|
|
|
|
mock_flow1 = AsyncMock()
|
|
mock_flow2 = AsyncMock()
|
|
mock_flow_class.side_effect = [mock_flow1, mock_flow2]
|
|
|
|
# First configuration - start flow1
|
|
config_data1 = {
|
|
'flows-active': {
|
|
'test-processor': '{"flow1": {"config": "config1"}}'
|
|
}
|
|
}
|
|
|
|
await processor.on_configure_flows(config_data1, version=1)
|
|
|
|
# Second configuration - stop flow1, start flow2
|
|
config_data2 = {
|
|
'flows-active': {
|
|
'test-processor': '{"flow2": {"config": "config2"}}'
|
|
}
|
|
}
|
|
|
|
# Act
|
|
await processor.on_configure_flows(config_data2, version=2)
|
|
|
|
# Assert
|
|
# flow1 should be stopped and removed
|
|
assert 'flow1' not in processor.flows
|
|
mock_flow1.stop.assert_called_once()
|
|
|
|
# flow2 should be started and added
|
|
assert 'flow2' in processor.flows
|
|
mock_flow2.start.assert_called_once()
|
|
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.start')
|
|
async def test_start_calls_parent(self, mock_parent_start, mock_register_config, mock_async_init):
|
|
"""Test that start() calls parent start method"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
mock_parent_start.return_value = None
|
|
|
|
config = {
|
|
'id': 'test-flow-processor',
|
|
'taskgroup': AsyncMock()
|
|
}
|
|
|
|
processor = FlowProcessor(**config)
|
|
|
|
# Act
|
|
await processor.start()
|
|
|
|
# Assert
|
|
mock_parent_start.assert_called_once()
|
|
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.__init__')
|
|
@patch('trustgraph.base.async_processor.AsyncProcessor.register_config_handler')
|
|
async def test_add_args_calls_parent(self, mock_register_config, mock_async_init):
|
|
"""Test that add_args() calls parent add_args method"""
|
|
# Arrange
|
|
mock_async_init.return_value = None
|
|
mock_register_config.return_value = None
|
|
|
|
mock_parser = MagicMock()
|
|
|
|
# Act
|
|
with patch('trustgraph.base.async_processor.AsyncProcessor.add_args') as mock_parent_add_args:
|
|
FlowProcessor.add_args(mock_parser)
|
|
|
|
# Assert
|
|
mock_parent_add_args.assert_called_once_with(mock_parser)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
pytest.main([__file__]) |