memra 0.2.3__tar.gz → 0.2.4__tar.gz

memra-0.2.4/CHANGELOG.md

@@ -0,0 +1,63 @@
+# Changelog
+
+All notable changes to the Memra SDK will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.2] - 2025-05-28
+
+### Fixed
+- **MCP Integration**: Fixed broken MCP tool execution after repository separation
+- **Tool Registry**: Updated MCP tool routing to use correct endpoints
+- **Bridge Server**: Added working MCP bridge server implementation
+- **Real Work Detection**: Improved detection of real vs mock work for MCP tools
+
+### Added
+- Complete MCP bridge server with DataValidator and PostgresInsert tools
+- Health check endpoint for MCP bridge monitoring
+- Better error handling and fallback for MCP tool execution
+
+### Changed
+- MCP tools now perform real database operations instead of mock responses
+- Improved logging and debugging for MCP tool execution flow
+
+## [0.2.1] - 2025-05-27
+
+## [0.2.0] - 2024-01-17
+
+### Added
+- **MCP (Model Context Protocol) Integration**: Execute operations on local infrastructure while leveraging cloud AI processing
+  - New `mcp_bridge_server.py` for local resource bridging
+  - HMAC authentication for secure cloud-to-local communication
+  - Support for `hosted_by: "mcp"` in agent tool configurations
+  - PostgreSQL integration via MCP bridge
+  - Tool-level configuration support in execution engine
+  - New MCP tools: `PostgresInsert`, `DataValidator`
+
+### Enhanced
+- **Execution Engine**: Updated to support tool-level configuration and MCP routing
+- **Tool Registry Client**: Enhanced API client with better error handling and MCP support
+- **Agent Configuration**: Added support for tool-specific configuration alongside agent-level config
+
+### Examples
+- `examples/accounts_payable_mcp.py` - Complete invoice processing with MCP database integration
+- `test_mcp_success.py` - Simple MCP integration test
+
+### Documentation
+- `docs/mcp_integration.md` - Comprehensive MCP integration guide
+- Updated README with MCP overview and quick start
+
+### Dependencies
+- Added `aiohttp>=3.8.0` for MCP bridge server
+- Added `aiohttp-cors>=0.7.0` for CORS support
+- Added `psycopg2-binary>=2.9.0` for PostgreSQL integration
+
+## [0.1.0] - 2024-01-01
+
+### Added
+- Initial release of Memra SDK
+- Core agent and department framework
+- API client for Memra cloud services
+- Basic tool registry and execution engine
+- Examples for accounts payable and propane delivery workflows 

{memra-0.2.3 → memra-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memra
-Version: 0.2.3
+Version: 0.2.4
 Summary: Declarative framework for enterprise workflows with MCP integration - Client SDK
 Home-page: https://github.com/memra/memra-sdk
 Author: Memra
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: pydantic>=1.8.0
 Requires-Dist: httpx>=0.24.0
 Requires-Dist: typing-extensions>=4.0.0
@@ -33,6 +34,7 @@ Provides-Extra: mcp
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "mcp"
 Dynamic: author
 Dynamic: home-page
+Dynamic: license-file
 Dynamic: requires-python
 
 # Memra SDK
@@ -96,6 +98,48 @@ See the `examples/` directory for basic usage examples:
 
 For detailed documentation, visit [docs.memra.co](https://docs.memra.co)
 
+Documentation is also available locally in the `examples/` directory.
+
+## Example: Propane Delivery Workflow
+
+See the `examples/propane_delivery.py` file for a complete example of how to use Memra to orchestrate a propane delivery workflow.
+
+## 🔍 Smart File Discovery
+
+Memra includes intelligent file discovery and management capabilities:
+
+### File Discovery Tools
+- **FileDiscovery**: Automatically scan directories for files matching patterns
+- **FileCopy**: Copy files from external locations to standard processing directories
+- **Smart Routing**: Automatically handle file paths and directory management
+
+### Example: Smart Invoice Processing
+```python
+from memra import Agent
+
+# Smart agent that discovers and processes files automatically
+smart_parser = Agent(
+    role="Smart Invoice Parser",
+    job="Discover and process invoice files intelligently",
+    tools=[
+        {"name": "FileDiscovery", "hosted_by": "memra"},
+        {"name": "FileCopy", "hosted_by": "memra"},
+        {"name": "InvoiceExtractionWorkflow", "hosted_by": "memra"}
+    ]
+)
+
+# Three modes of operation:
+# 1. Auto-discovery: Scan invoices/ directory
+# 2. External file: Copy from Downloads to invoices/
+# 3. Specific file: Process exact file path
+```
+
+See `examples/accounts_payable_smart.py` for a complete implementation.
+
+## Contributing
+
+We welcome contributions! Please see our [contributing guide](CONTRIBUTING.md) for details.
+
 ## License
 
 MIT License - see LICENSE file for details. 

memra-0.2.4/README.md

@@ -0,0 +1,106 @@
+# Memra SDK
+
+The core Memra framework for building AI-powered business workflows.
+
+## Installation
+
+```bash
+pip install memra
+```
+
+## Quick Start
+
+```python
+from memra import Agent, Department, LLM, ExecutionEngine
+
+# Define an agent
+agent = Agent(
+    role="Data Analyst",
+    job="Analyze customer data",
+    llm=LLM(model="llama-3.2-11b-vision-preview"),
+    sops=["Load data", "Perform analysis", "Generate report"],
+    output_key="analysis_result"
+)
+
+# Create a department
+department = Department(
+    name="Analytics",
+    mission="Provide data insights",
+    agents=[agent],
+    workflow_order=["Data Analyst"]
+)
+
+# Execute the workflow
+engine = ExecutionEngine()
+result = engine.execute_department(department, {"data": "customer_data.csv"})
+```
+
+## Core Components
+
+### Agent
+An AI worker that performs specific tasks using LLMs and tools.
+
+### Department
+A team of agents working together to accomplish a mission.
+
+### ExecutionEngine
+Orchestrates the execution of departments and their workflows.
+
+### LLM
+Configuration for language models used by agents.
+
+## Examples
+
+See the `examples/` directory for basic usage examples:
+- `simple_text_to_sql.py` - Basic text-to-SQL conversion
+- `ask_questions.py` - Simple question answering
+
+## Documentation
+
+For detailed documentation, visit [docs.memra.co](https://docs.memra.co)
+
+Documentation is also available locally in the `examples/` directory.
+
+## Example: Propane Delivery Workflow
+
+See the `examples/propane_delivery.py` file for a complete example of how to use Memra to orchestrate a propane delivery workflow.
+
+## 🔍 Smart File Discovery
+
+Memra includes intelligent file discovery and management capabilities:
+
+### File Discovery Tools
+- **FileDiscovery**: Automatically scan directories for files matching patterns
+- **FileCopy**: Copy files from external locations to standard processing directories
+- **Smart Routing**: Automatically handle file paths and directory management
+
+### Example: Smart Invoice Processing
+```python
+from memra import Agent
+
+# Smart agent that discovers and processes files automatically
+smart_parser = Agent(
+    role="Smart Invoice Parser",
+    job="Discover and process invoice files intelligently",
+    tools=[
+        {"name": "FileDiscovery", "hosted_by": "memra"},
+        {"name": "FileCopy", "hosted_by": "memra"},
+        {"name": "InvoiceExtractionWorkflow", "hosted_by": "memra"}
+    ]
+)
+
+# Three modes of operation:
+# 1. Auto-discovery: Scan invoices/ directory
+# 2. External file: Copy from Downloads to invoices/
+# 3. Specific file: Process exact file path
+```
+
+See `examples/accounts_payable_smart.py` for a complete implementation.
+
+## Contributing
+
+We welcome contributions! Please see our [contributing guide](CONTRIBUTING.md) for details.
+
+## License
+
+MIT License - see LICENSE file for details.