dhenara-agent 0.1.0__tar.gz

dhenara_agent-0.1.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+
+recursive-include src/dhenara/cli/templates *.py
+
+global-exclude __pycache__/*
+global-exclude *.pyc
+global-exclude *.py[cod]

dhenara_agent-0.1.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: dhenara-agent
+Version: 0.1.0
+Summary: Dhenara Agent DSL (DAD) Framework SDK
+Home-page: https://github.com/dhenara/dhenara-agent
+Author: Dhenara
+Author-email: support@dhenara.com
+License: MIT
+Project-URL: Homepage, https://dhenara.com
+Project-URL: Documentation, https://docs.dhenara.com/
+Project-URL: Bug Reports, https://github.com/dhenara/dhenara-agent/issues
+Project-URL: Source Code, https://github.com/dhenara/dhenara-agent
+Keywords: ai,llm,machine learning,language models,ai agents,agent frameworks
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: dhenara-ai>=1.0.1
+Requires-Dist: click>=8.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: requests>=2.25.1
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: opentelemetry-api>=1.20.0
+Requires-Dist: opentelemetry-sdk>=1.20.0
+Requires-Dist: opentelemetry-instrumentation>=0.40b0
+Requires-Dist: opentelemetry-exporter-otlp>=1.20.0
+Requires-Dist: opentelemetry-exporter-zipkin
+Provides-Extra: observability
+Requires-Dist: opentelemetry-exporter-jaeger>=1.20.0; extra == "observability"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.18.0; extra == "dev"
+Requires-Dist: pytest-cov>=3.0.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Dhenara Agent DSL (DAD)
+
+## Overview
+
+Dhenara Agent DSL (DAD) is an open-source framework built on top of the `dhenara-ai` Python package. It provides a
+powerful, expressive, and type-safe domain-specific language (DSL) for defining and executing AI agent workflows. DAD
+makes it easier to create, compose, and orchestrate AI agents with sophisticated behaviors, while maintaining robust
+observability and reproducibility.
+
+For full documentation, visit [docs.dhenara.com](https://docs.dhenara.com/).
+
+
+## What is Dhenara Agent DSL?
+
+Dhenara Agent DSL or DAD (available as a Python package named `dhenara-agent`) is an AI agent framework with a strong
+focus on:
+
+1. **Expressive Agent Definition**: Create complex agent workflows using a straightforward, programming language-like
+   approach
+2. **Component-Based Architecture**: Compose reusable components to build sophisticated agent systems
+3. **Out-of-the-box Support for Multiple LLMs**: Switch between different LLM models on the fly
+4. **Comprehensive Observability**: Built-in logging, tracing, and metrics collection for all agent activities using
+   OpenTelemetry and open-source exporters like Zipkin and Jaeger
+5. **Reproducible Execution**: Track and replay agent execution through a run context system, reducing costs by
+   rerunning failed flows without additional AI Model API calls
+6. **Extensible Node System**: Easily create custom node types to extend functionality
+7. **Resource Management**: Flexible management of AI model resources and credentials
+
+## Installation
+
+You can install the Dhenara Agent DSL framework using pip:
+
+```bash
+pip install dhenara-agent
+```
+
+## Core Concepts
+
+### Basic Elements
+
+DAD uses a hierarchical component model that allows for composition and reuse. It is built around three primary types of
+components:
+
+- **Execution Nodes**: Atomic execution units that perform specific functions (e.g., making an LLM API call, analyzing a
+  folder, performing file operations like creating/updating files)
+- **Execution Flows**: Collections of nodes or sub-flows with execution logic, supporting sequential execution,
+  conditionals, and loops
+- **Agents**: Higher-level abstractions that can contain flows and other agents, representing complete functional units
+
+### Event-Driven Architecture
+
+An event system enables loose coupling between components, allowing agents to react to events, request inputs, and
+communicate with each other without tight coupling.
+
+### Powerful Template Engine
+
+A powerful template engine supports variable substitution, expressions, and hierarchical references, making it easy to
+build dynamic prompts and process responses.
+
+### Execution Model
+
+The execution follows a hierarchical structure:
+
+1. Components (Agents or Flows) define the overall structure
+2. Nodes within components perform specific tasks
+3. A RunContext manages the execution environment
+4. Tracing, logging, and metrics provide visibility into execution
+
+### Resource Management
+
+DAD provides a flexible system for managing AI model resources and API credentials, making it easier to work with
+different LLM providers and models.
+
+## Usage Examples
+
+### Basic Example
+
+Here's a simple example of defining a flow using DAD:
+
+```python
+from dhenara.agent.dsl import (
+    AIModelNode,
+    AIModelNodeSettings,
+    FlowDefinition,
+    ResourceConfigItem,
+)
+from dhenara.ai.types import Prompt
+
+# Define a flow
+my_flow = FlowDefinition()
+
+# Add an AI model node to the flow
+my_flow.node(
+    "question_answerer",
+    AIModelNode(
+        resources=ResourceConfigItem.with_model("claude-3-5-haiku"),
+        settings=AIModelNodeSettings(
+            system_instructions=["You are a helpful assistant."],
+            prompt=Prompt.with_dad_text("Answer the following question: $var{question}"),
+        ),
+    ),
+)
+```
+
+
+
+## Documentation
+
+For comprehensive documentation including tutorials, API reference, and advanced usage examples, visit [docs.dhenara.com](https://docs.dhenara.com/).

dhenara_agent-0.1.0/README.md

@@ -0,0 +1,109 @@
+# Dhenara Agent DSL (DAD)
+
+## Overview
+
+Dhenara Agent DSL (DAD) is an open-source framework built on top of the `dhenara-ai` Python package. It provides a
+powerful, expressive, and type-safe domain-specific language (DSL) for defining and executing AI agent workflows. DAD
+makes it easier to create, compose, and orchestrate AI agents with sophisticated behaviors, while maintaining robust
+observability and reproducibility.
+
+For full documentation, visit [docs.dhenara.com](https://docs.dhenara.com/).
+
+
+## What is Dhenara Agent DSL?
+
+Dhenara Agent DSL or DAD (available as a Python package named `dhenara-agent`) is an AI agent framework with a strong
+focus on:
+
+1. **Expressive Agent Definition**: Create complex agent workflows using a straightforward, programming language-like
+   approach
+2. **Component-Based Architecture**: Compose reusable components to build sophisticated agent systems
+3. **Out-of-the-box Support for Multiple LLMs**: Switch between different LLM models on the fly
+4. **Comprehensive Observability**: Built-in logging, tracing, and metrics collection for all agent activities using
+   OpenTelemetry and open-source exporters like Zipkin and Jaeger
+5. **Reproducible Execution**: Track and replay agent execution through a run context system, reducing costs by
+   rerunning failed flows without additional AI Model API calls
+6. **Extensible Node System**: Easily create custom node types to extend functionality
+7. **Resource Management**: Flexible management of AI model resources and credentials
+
+## Installation
+
+You can install the Dhenara Agent DSL framework using pip:
+
+```bash
+pip install dhenara-agent
+```
+
+## Core Concepts
+
+### Basic Elements
+
+DAD uses a hierarchical component model that allows for composition and reuse. It is built around three primary types of
+components:
+
+- **Execution Nodes**: Atomic execution units that perform specific functions (e.g., making an LLM API call, analyzing a
+  folder, performing file operations like creating/updating files)
+- **Execution Flows**: Collections of nodes or sub-flows with execution logic, supporting sequential execution,
+  conditionals, and loops
+- **Agents**: Higher-level abstractions that can contain flows and other agents, representing complete functional units
+
+### Event-Driven Architecture
+
+An event system enables loose coupling between components, allowing agents to react to events, request inputs, and
+communicate with each other without tight coupling.
+
+### Powerful Template Engine
+
+A powerful template engine supports variable substitution, expressions, and hierarchical references, making it easy to
+build dynamic prompts and process responses.
+
+### Execution Model
+
+The execution follows a hierarchical structure:
+
+1. Components (Agents or Flows) define the overall structure
+2. Nodes within components perform specific tasks
+3. A RunContext manages the execution environment
+4. Tracing, logging, and metrics provide visibility into execution
+
+### Resource Management
+
+DAD provides a flexible system for managing AI model resources and API credentials, making it easier to work with
+different LLM providers and models.
+
+## Usage Examples
+
+### Basic Example
+
+Here's a simple example of defining a flow using DAD:
+
+```python
+from dhenara.agent.dsl import (
+    AIModelNode,
+    AIModelNodeSettings,
+    FlowDefinition,
+    ResourceConfigItem,
+)
+from dhenara.ai.types import Prompt
+
+# Define a flow
+my_flow = FlowDefinition()
+
+# Add an AI model node to the flow
+my_flow.node(
+    "question_answerer",
+    AIModelNode(
+        resources=ResourceConfigItem.with_model("claude-3-5-haiku"),
+        settings=AIModelNodeSettings(
+            system_instructions=["You are a helpful assistant."],
+            prompt=Prompt.with_dad_text("Answer the following question: $var{question}"),
+        ),
+    ),
+)
+```
+
+
+
+## Documentation
+
+For comprehensive documentation including tutorials, API reference, and advanced usage examples, visit [docs.dhenara.com](https://docs.dhenara.com/).

dhenara_agent-0.1.0/pyproject.toml

@@ -0,0 +1,60 @@
+[tool.ruff]
+target-version = "py310"
+line-length = 120
+src = ["src"]
+force-exclude = true
+exclude = []
+
+[tool.ruff.lint]
+select = [
+    "I",  # automatically sort imports
+    "E",  # find errors
+    "B",  # Bugbear
+    "F",  # linting
+    "W",  # find warnings
+    "N",  # naming errors
+    "UP",  # PyUpgrade; update for newer syntax of the language.  Eg: Use list in favor of List from 3.10
+    "YTT",  # checks for misuse of sys.version or sys.version_info
+    "ASYNC",  # checks for bad async / asyncio practices
+    "FLY",  # Avoid unneccessary join: Use f"{a}_{b}_{c}" instead of "_".join([a, b, c])
+    "RUF",  # ruff-specific rules
+    "PERF",  # A Linter for performance anti-patterns
+    "S101",  # checks for use of asserts instead of if cond: raise AssertionError
+    "FBT",  # Disallow boolean traps
+    "A",  # check if shadow built-ins
+    "COM",  # Check if commas are missing
+    "CPY",  # Check if copyright header is missing
+    "C4",  # Comprehension linter
+]
+ignore = [
+    "RUF012",  # mutable-class-default: Will fail with all Modelclass Meta def
+    "E722",    # TODO_FUTURE: Ignoring the exception rule for the time being
+    "B904",    # Chained exceptions
+    "COM812",  # This rules may cause conflicts when used with the formatter.
+    "FBT001",  # Prevents boolean-default-value-positional-argument
+    "FBT002",  # Prevents boolean-default-value-positional-argument
+    "A005",    # Module name shadows a Python standard-library module
+    "UP038",   # Use `X | Y` in isinstance
+]
+
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = [
+    "I",     # Innore sorting order in init files else will compail fail
+    "F403",  # Enable "import *" in init files
+]
+"tests/test_*.py" = ["S101"]
+"*/tests/test_*.py" = ["S101"]
+"*/templates/runner/runner.py" = ["I001"]
+
+
+[tool.ruff.lint.pycodestyle]
+max-doc-length = 120
+
+[tool.ruff.lint.isort]
+split-on-trailing-comma = true
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+docstring-code-format = true

dhenara_agent-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dhenara_agent-0.1.0/setup.py

@@ -0,0 +1,82 @@
+import os
+import re
+
+from setuptools import find_namespace_packages, setup
+
+version = None
+# Read version without importing the package
+with open(os.path.join("src/dhenara/agent", "__init__.py")) as f:
+    version_match = re.search(r"^__version__ = ['\"]([^'\"]*)['\"]", f.read(), re.M)
+    if version_match:
+        version = version_match.group(1)
+    else:
+        raise RuntimeError("Unable to find version string")
+
+
+setup(
+    name="dhenara-agent",
+    version=version,
+    package_dir={"": "src"},
+    packages=find_namespace_packages(where="src", include=["dhenara.*"]),
+    install_requires=[
+        "dhenara-ai>=1.0.1",
+        "click>=8.0.0",  # CLI
+        "pyyaml>=6.0",  # CLI
+        "httpx>=0.24.0",
+        "requests>=2.25.1",
+        "pydantic>=2.0.0",
+        # Observability dependencies: # TODO_FUTURE: Add a config
+        "opentelemetry-api>=1.20.0",
+        "opentelemetry-sdk>=1.20.0",
+        "opentelemetry-instrumentation>=0.40b0",
+        "opentelemetry-exporter-otlp>=1.20.0",
+        "opentelemetry-exporter-zipkin",
+    ],
+    extras_require={
+        "observability": [
+            # Additional tracing visualization
+            "opentelemetry-exporter-jaeger>=1.20.0",
+        ],
+        "dev": [
+            # Tests
+            "pytest>=7.0.0",
+            "pytest-asyncio>=0.18.0",
+            "pytest-cov>=3.0.0",
+        ],
+    },
+    python_requires=">=3.10",
+    description="Dhenara Agent DSL (DAD) Framework SDK",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="Dhenara",
+    author_email="support@dhenara.com",
+    url="https://github.com/dhenara/dhenara-agent",
+    license="MIT",
+    keywords="ai, llm, machine learning, language models, ai agents, agent frameworks",
+    project_urls={
+        "Homepage": "https://dhenara.com",
+        "Documentation": "https://docs.dhenara.com/",
+        "Bug Reports": "https://github.com/dhenara/dhenara-agent/issues",
+        "Source Code": "https://github.com/dhenara/dhenara-agent",
+    },
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.10",
+        "Operating System :: OS Independent",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+        "License :: OSI Approved :: MIT License",
+    ],
+    # CLI
+    entry_points={
+        "console_scripts": [
+            "dhenara=dhenara.cli:main",
+        ],
+    },
+    # Include template files in the package
+    package_data={
+        "dhenara.cli": ["templates/**/*.py"],
+    },
+    include_package_data=True,
+)

dhenara_agent-0.1.0/src/dhenara/agent/__init__.py

@@ -0,0 +1,14 @@
+# ruff: noqa: F401
+
+from .observability import *
+
+from .types import *
+from .config import *
+
+from .dsl import *
+
+from .run import *
+
+# from .client import Client : TODO_FUTURE: Fix and enable client
+
+__version__ = "0.1.0"

dhenara_agent-0.1.0/src/dhenara/agent/client/__init__.py

@@ -0,0 +1,4 @@
+# ruff: noqa: F401
+
+from ._urls import *
+from ._client import Client