erdo 0.1.31__py3-none-any.whl

erdo-0.1.31.dist-info/METADATA

@@ -0,0 +1,471 @@
+Metadata-Version: 2.4
+Name: erdo
+Version: 0.1.31
+Summary: Python SDK for building workflow automation agents with Erdo
+Project-URL: Homepage, https://erdo.ai
+Project-URL: Documentation, https://docs.erdo.ai
+Project-URL: Repository, https://github.com/erdoai/erdo-python-sdk
+Project-URL: Issues, https://github.com/erdoai/erdo-python-sdk/issues
+Author-email: Erdo AI <hello@erdo.ai>
+License: Proprietary
+License-File: LICENSE
+Keywords: agents,ai,automation,data,workflow
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: flake8>=6.0.0; extra == 'dev'
+Requires-Dist: isort>=5.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
+Requires-Dist: types-requests>=2.31.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Erdo Agent SDK
+
+Build AI agents and workflows with Python. The Erdo Agent SDK provides a declarative way to create agents that can be executed by the [Erdo platform](https://erdo.ai).
+
+## Installation
+
+```bash
+pip install erdo
+```
+
+## Quick Start
+
+### Creating Agents
+
+Create agents using the `Agent` class and define steps with actions:
+
+```python
+from erdo import Agent, state
+from erdo.actions import memory, llm
+from erdo.conditions import IsSuccess, GreaterThan
+
+# Create an agent
+data_analyzer = Agent(
+    name="data analyzer",
+    description="Analyzes data files and provides insights",
+    running_status="Analyzing data...",
+    finished_status="Analysis complete",
+)
+
+# Step 1: Search for relevant context
+search_step = data_analyzer.step(
+    memory.search(
+        query=state.query,
+        organization_scope="specific",
+        limit=5,
+        max_distance=0.8
+    )
+)
+
+# Step 2: Analyze the data with AI
+analyze_step = data_analyzer.step(
+    llm.message(
+        model="claude-sonnet-4-20250514",
+        system_prompt="You are a data analyst. Analyze the data and provide insights.",
+        query=state.query,
+        context=search_step.output.memories,
+        response_format={
+            "Type": "json_schema",
+            "Schema": {
+                "type": "object",
+                "required": ["insights", "confidence", "recommendations"],
+                "properties": {
+                    "insights": {"type": "string", "description": "Key insights found"},
+                    "confidence": {"type": "number", "description": "Confidence 0-1"},
+                    "recommendations": {"type": "array", "items": {"type": "string"}},
+                },
+            },
+        },
+    ),
+    depends_on=search_step,
+)
+```
+
+### Code Execution with External Files
+
+Use the `@agent.exec` decorator to execute code with external Python files:
+
+```python
+from erdo.types import PythonFile
+
+@data_analyzer.exec(
+    code_files=[
+        PythonFile(filename="analysis_files/analyze.py"),
+        PythonFile(filename="analysis_files/utils.py"),
+    ]
+)
+def execute_analysis():
+    """Execute detailed analysis using external code files."""
+    from analysis_files.analyze import analyze_data
+    from analysis_files.utils import prepare_data
+
+    # Prepare and analyze data
+    prepared_data = prepare_data(context.parameters.get("dataset", {}))
+    results = analyze_data(context)
+
+    return results
+```
+
+### Conditional Step Execution
+
+Handle step results with conditions:
+
+```python
+from erdo.conditions import IsSuccess, GreaterThan
+
+# Store high-confidence results
+analyze_step.on(
+    IsSuccess() & GreaterThan("confidence", "0.8"),
+    memory.store(
+        memory={
+            "content": analyze_step.output.insights,
+            "description": "High-confidence data analysis results",
+            "type": "analysis",
+            "tags": ["analysis", "high-confidence"],
+        }
+    ),
+)
+
+# Execute detailed analysis for high-confidence results
+analyze_step.on(
+    IsSuccess() & GreaterThan("confidence", "0.8"),
+    execute_analysis
+)
+```
+
+### Complex Execution Modes
+
+Use execution modes for advanced workflows:
+
+```python
+from erdo import ExecutionMode, ExecutionModeType
+from erdo.actions import bot
+from erdo.conditions import And, IsAny
+from erdo.template import TemplateString
+
+# Iterate over resources
+analyze_files = agent.step(
+    action=bot.invoke(
+        bot_name="file analyzer",
+        parameters={"resource": TemplateString("{{resources}}")},
+    ),
+    key="analyze_files",
+    execution_mode=ExecutionMode(
+        mode=ExecutionModeType.ITERATE_OVER,
+        data="parameters.resource",
+        if_condition=And(
+            IsAny(key="dataset.analysis_summary", value=["", None]),
+            IsAny(key="dataset.type", value=["FILE"]),
+        ),
+    )
+)
+```
+
+### Loading Prompts
+
+Use the `Prompt` class to load prompts from files:
+
+```python
+from erdo import Prompt
+
+# Load prompts from a directory
+prompts = Prompt.load_from_directory("prompts")
+
+# Use in your agent steps
+step = agent.step(
+    llm.message(
+        system_prompt=prompts.system_prompt,
+        query=state.query,
+    )
+)
+```
+
+### State and Templating
+
+Access dynamic data using the `state` object and template strings:
+
+```python
+from erdo import state
+from erdo.template import TemplateString
+
+# Access input parameters
+query = state.query
+dataset = state.dataset
+
+# Use in template strings
+template = TemplateString("Analyzing: {{query}} for dataset {{dataset.id}}")
+```
+
+## Core Concepts
+
+### Actions
+
+Actions are the building blocks of your agents. Available action modules:
+
+- `erdo.actions.memory` - Memory storage and search
+- `erdo.actions.llm` - Large language model interactions
+- `erdo.actions.bot` - Bot invocation and orchestration
+- `erdo.actions.codeexec` - Code execution
+- `erdo.actions.utils` - Utility functions
+- `erdo.actions.resource_definitions` - Resource management
+
+### Conditions
+
+Conditions control when steps execute:
+
+- `IsSuccess()`, `IsError()` - Check step status
+- `GreaterThan()`, `LessThan()` - Numeric comparisons
+- `TextEquals()`, `TextContains()` - Text matching
+- `And()`, `Or()`, `Not()` - Logical operators
+
+### Types
+
+Key types for agent development:
+
+- `Agent` - Main agent class
+- `ExecutionMode` - Control step execution behavior
+- `PythonFile` - Reference external Python files
+- `TemplateString` - Dynamic string templates
+- `Prompt` - Prompt management
+
+## Advanced Features
+
+### Multi-Step Dependencies
+
+Create complex workflows with step dependencies:
+
+```python
+step1 = agent.step(memory.search(...))
+step2 = agent.step(llm.message(...), depends_on=step1)
+step3 = agent.step(utils.send_status(...), depends_on=[step1, step2])
+```
+
+### Dynamic Data Access
+
+Use the state object to access runtime data:
+
+```python
+# Access nested data
+user_id = state.user.id
+dataset_config = state.dataset.config.type
+
+# Use in actions
+step = agent.step(
+    memory.search(query=f"data for user {state.user.id}")
+)
+```
+
+### Error Handling
+
+Handle errors with conditions and fallback steps:
+
+```python
+from erdo.conditions import IsError
+
+main_step = agent.step(llm.message(...))
+
+# Handle errors
+main_step.on(
+    IsError(),
+    utils.send_status(
+        message="Analysis failed, please try again",
+        status="error"
+    )
+)
+```
+
+## Invoking Agents
+
+Use the `invoke()` function to execute agents programmatically:
+
+```python
+from erdo import invoke
+
+# Invoke an agent
+response = invoke(
+    "data-question-answerer",
+    messages=[{"role": "user", "content": "What were Q4 sales?"}],
+    datasets=["sales-2024"],
+    parameters={"time_period": "Q4"},
+)
+
+if response.success:
+    print(response.result)
+else:
+    print(f"Error: {response.error}")
+```
+
+### Invocation Modes
+
+Control how bot actions are executed for testing and development:
+
+| Mode | Description | Cost |
+|------|-------------|------|
+| **live** | Execute with real API calls | $$$ per run |
+| **replay** | Cache responses, replay on subsequent runs | $$$ first run, FREE after |
+| **manual** | Use developer-provided mock responses | FREE always |
+
+```python
+# Live mode (default) - real API calls
+response = invoke("my-agent", messages=[...], mode="live")
+
+# Replay mode - cache after first run (recommended for testing!)
+response = invoke("my-agent", messages=[...], mode="replay")
+
+# Replay with refresh - bypass cache, get fresh response
+response = invoke("my-agent", messages=[...], mode={"mode": "replay", "refresh": True})
+
+# Manual mode - use mock responses
+response = invoke(
+    "my-agent",
+    messages=[...],
+    mode="manual",
+    manual_mocks={
+        "llm.message": {
+            "status": "success",
+            "output": {"content": "Mocked response"}
+        }
+    }
+)
+```
+
+**Replay Mode Refresh:**
+The `refresh` parameter forces a fresh API call while staying in replay mode:
+- First run: Executes and caches the response
+- Subsequent runs: Uses cached response (free!)
+- With refresh: Bypasses cache, gets fresh response, updates cache
+
+Perfect for updating cached responses after bot changes without switching modes.
+
+## Testing Agents
+
+Write fast, parallel agent tests using `agent_test_*` functions:
+
+```python
+from erdo import invoke
+from erdo.test import text_contains
+
+def agent_test_csv_sales():
+    """Test CSV sales analysis."""
+    response = invoke(
+        "data-question-answerer",
+        messages=[{"role": "user", "content": "What were Q4 sales?"}],
+        datasets=["sales-q4-2024"],
+        mode="replay",  # Free after first run!
+    )
+
+    assert response.success
+    result_text = str(response.result)
+    assert text_contains(result_text, "sales", case_sensitive=False)
+```
+
+Run tests in parallel with the CLI:
+
+```bash
+# Run all tests
+erdo agent-test tests/test_my_agent.py
+
+# Verbose output
+erdo agent-test tests/test_my_agent.py --verbose
+
+# Refresh cached responses (bypass cache for all replay mode tests)
+erdo agent-test tests/test_my_agent.py --refresh
+```
+
+**Refresh Flag:**
+The `--refresh` flag forces all tests using `mode="replay"` to bypass cache and get fresh responses. Perfect for:
+- Updating cached responses after bot changes
+- Verifying tests with current LLM behavior
+- No code changes needed - just add the flag!
+
+### Test Helpers
+
+The `erdo.test` module provides assertion helpers:
+
+```python
+from erdo.test import (
+    text_contains,      # Check if text contains substring
+    text_equals,        # Check exact match
+    text_matches,       # Check regex pattern
+    json_path_equals,   # Check JSON path value
+    json_path_exists,   # Check if JSON path exists
+    has_dataset,        # Check if dataset is present
+)
+```
+
+## CLI Integration
+
+Deploy and manage your agents using the Erdo CLI:
+
+```bash
+# Login to your account
+erdo login
+
+# Sync your agents to the platform
+erdo sync-agent my_agent.py
+
+# Invoke an agent
+erdo invoke my-agent --message "Hello!"
+
+# Run agent tests
+erdo agent-test tests/test_my_agent.py
+```
+
+## Examples
+
+See the `examples/` directory for complete examples:
+
+- `agent_centric_example.py` - Comprehensive agent with multiple steps
+- `state_example.py` - State management and templating
+- `invoke_example.py` - Agent invocation patterns
+- `agent_test_example.py` - Agent testing examples
+
+## API Reference
+
+### Core Classes
+
+- **Agent**: Main agent class for creating workflows
+- **ExecutionMode**: Control step execution (iterate, conditional, etc.)
+- **Prompt**: Load and manage prompt templates
+
+### Actions
+
+- **memory**: Store and search memories
+- **llm**: Interact with language models
+- **bot**: Invoke other bots and agents
+- **codeexec**: Execute Python code
+- **utils**: Utility functions (status, notifications, etc.)
+
+### Conditions
+
+- **Comparison**: `GreaterThan`, `LessThan`, `TextEquals`, etc.
+- **Status**: `IsSuccess`, `IsError`, `IsNull`, etc.
+- **Logical**: `And`, `Or`, `Not`
+
+### State & Templating
+
+- **state**: Access runtime parameters and data
+- **TemplateString**: Dynamic string templates with `{{variable}}` syntax
+
+## License
+
+Commercial License - see LICENSE file for details.

erdo-0.1.31.dist-info/RECORD

@@ -0,0 +1,48 @@
+erdo/__init__.py,sha256=qHL0RC-93sT0NGIPy_jbl_Or0xUb3KfaA0dZ7nGvf8A,1151
+erdo/bot_permissions.py,sha256=NZSjjGURORpq3hRqv0tA0YvkxcTZ9MQqtmzrlmof29c,8261
+erdo/cli_entry.py,sha256=jz18bWz-D09rmkEvwLTAbcK1shHUqFCpiU7U7czEltY,2057
+erdo/formatting.py,sha256=jIfQlqk1oKratM8Fkrlq1rRsnergthbSQFCfeEd6rqY,8346
+erdo/install_cli.py,sha256=jgRoSm-MIbLHW0Sr5m78q3htRwIh7JXo_wNmpVsiAcM,4454
+erdo/integrations.py,sha256=-xYBpjYmjhJtv_UnaIfBb46cJC4icLOx9P1kOf5lM-g,4219
+erdo/state.py,sha256=o89-SThDWYNjfwMZuDfier1Lx96_tLi5wYSth7dPI6I,14270
+erdo/template.py,sha256=gvlSpEN3whD4LEqY6ppeYYZuFeM9ndU68qzKP-ETRJ8,4641
+erdo/types.py,sha256=_JX8E75eVNu2NYwQu_SDRzkQ8_ZcQo-eoGVjwnuWUOE,57030
+erdo/_generated/__init__.py,sha256=jFLoVFeswecK5mGp4-MPWwnygol2dYIsEpnmm9gubHY,506
+erdo/_generated/internal.py,sha256=ghd1g_9WF0kXO2MkFIBxcuHuRF00SlOeT-mjJcfQNyM,1569
+erdo/_generated/internal_actions.py,sha256=dbZgHNF5RQhjyB8VAJ-4eaV2XUlqHKv99m-DtNNx7rI,2661
+erdo/_generated/parameters.py,sha256=QC-_75fQg_iFu-dvI9ce4yHP9UnFItDWe6sBfzfXaig,472
+erdo/_generated/secrets.py,sha256=F2xBkFsiYXOJnZ5Tcrc9uiaakyirHlKFkYCFxZKANtw,454
+erdo/_generated/template_functions.py,sha256=mgFqsXxL36dMNptzDaGvNEjoA76nFf4k9ZRz-J4Ozdc,1174
+erdo/_generated/types.py,sha256=OuDYBt5SkAs2fKlqrZ8-X5KIEKQBeVChK5sph5RaDZ0,131696
+erdo/_generated/actions/__init__.py,sha256=L5YKDEe1RikpvtkWxmTAThVLa-HxGfur3kcO-S7RB_w,1223
+erdo/_generated/actions/analysis.py,sha256=-LMXVQmhQ5G5fadMsLJxIa2YlhlYzDGoF6G4fpgpv2A,5497
+erdo/_generated/actions/bot.py,sha256=VhDIgtHCcUDovDyXT14ow8qntKxe73KhOvN6FO3c454,6456
+erdo/_generated/actions/codeexec.py,sha256=31cZWnFHSAsYeu_y_gLlhcoKVpSl-C701OvilKb_qo4,6698
+erdo/_generated/actions/llm.py,sha256=CnAdNU-Ei3P_N6LSuvyuPzFvN8Zl-C6B6L7rgefPiAo,5282
+erdo/_generated/actions/memory.py,sha256=3SF84ecUGq12amOL3ly20O3CnoEj7T63NQvJSv4gUuc,17014
+erdo/_generated/actions/pdfextractor.py,sha256=UQ10OQ3K3FNKkqx18aG67Xbqd3GjB0nNh7DA6mpNs2g,3535
+erdo/_generated/actions/resource_definitions.py,sha256=0vzElFygA__fUYhgUOlcmyhkGwqLCNnxiPYcW6c3sDk,10787
+erdo/_generated/actions/sqlexec.py,sha256=riUkVHyoQLIPVSOmTiVG0lIiKeLmrlgBZL3HP6Uqhqo,2862
+erdo/_generated/actions/utils.py,sha256=jhCh2jJbeM_h1kgfVepIh6S-hBzoHidICDkhVn16MNk,14617
+erdo/_generated/actions/webparser.py,sha256=TonVmfVvnUPthvAT2rC_l8hvO25rCPhtYVR36pNPNQI,4184
+erdo/_generated/actions/websearch.py,sha256=KGKeJwZDBUXg-fPkq8oe7vw1zsspSNJ_Ei-BhSLi3zg,2715
+erdo/_generated/condition/__init__.py,sha256=BgAXUvg996k85DAhXUB2hwpqIazKoYo5WxRXqnoFEL0,15908
+erdo/actions/__init__.py,sha256=kb9vGSmhSGwxKNGacUCquu6z3d8u972uIw9x13aCrp0,1311
+erdo/conditions/__init__.py,sha256=xN7MS1aj4lh65CrE-94yFQXnQV8v8VjdEXMzPLTK0CU,394
+erdo/config/__init__.py,sha256=lROKyMtaH5cMiF1RcIRA2NLR1Sp8AKWx4brcPT1Vwy8,147
+erdo/config/config.py,sha256=BSerQVQdbbp1KuARpIuKp6bM1M4Cqr-Bsf0nQJJTND8,4279
+erdo/invoke/__init__.py,sha256=QhMBmUR8OXuyFS8fbNntjpRd7LNeKlV8Y8x6qSjgQ0I,249
+erdo/invoke/client.py,sha256=NNuZRQGvLFDENMCub4xLzEpihFYdc6PauKyA99pncsk,8523
+erdo/invoke/invoke.py,sha256=wSI_bj_EvRmCVXxnRNvtij8kEQhu1UVJ_dH3ILOUQfs,22849
+erdo/sync/__init__.py,sha256=f-7-9cYngOiLrTDAng3JxMC86JIE6jFk6-Vjz_dMybs,311
+erdo/sync/client.py,sha256=LrcyrsapuyrqmuPh-UwbocL7WUhHZ9zkDItXzon_AUs,3022
+erdo/sync/extractor.py,sha256=nLCtg_I0XeHN-c9zFIJaLfPWKOMNJlZEBBsxCgEjU6I,17593
+erdo/sync/sync.py,sha256=KzuChW5ramY8rX6QM3emRda928A09CQzFLmLJ5PLztg,10421
+erdo/test/__init__.py,sha256=_OevGagFDTykFcYzA__FARXiS5kgT9tK90r_0TmyGQQ,1114
+erdo/test/evaluate.py,sha256=-6vX6ynW8ICYaoXZLl-xdzAALvx1aSl1CurIRkgSJ0s,7730
+erdo/test/runner.py,sha256=vZR9PLKT2nDMzHyPm_jniGSA9eddGk4p1dQq0h1dRms,7299
+erdo-0.1.31.dist-info/METADATA,sha256=G4HhgVG3jnZ1iR4oUxq9JNqn0tzOCFpPjZH-7w_DTlg,12710
+erdo-0.1.31.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+erdo-0.1.31.dist-info/entry_points.txt,sha256=KFGSp8-6IE3-8dSr-3Djqye3IdEY65Y4E8fABoFUCHg,45
+erdo-0.1.31.dist-info/licenses/LICENSE,sha256=9pdgUAuBAumY5tewMdJnx2Ozj8dS6gGKsSiY-SVInu4,1034
+erdo-0.1.31.dist-info/RECORD,,

erdo-0.1.31.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

erdo-0.1.31.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+erdo = erdo.cli_entry:main

erdo-0.1.31.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+Erdo Agents SDK License
+
+Copyright (c) 2024 Erdo AI LLC
+
+All rights reserved.
+
+This software is proprietary to Erdo AI LLC and is protected by copyright law.
+No part of this software may be reproduced, distributed, or transmitted in
+any form or by any means, including photocopying, recording, or other
+electronic or mechanical methods, without the prior written permission of
+Erdo AI LLC, except in the case of brief quotations embodied in critical reviews
+and certain other noncommercial uses permitted by copyright law.
+
+For permission requests, contact: legal@erdo.ai
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.