org.slashlib.py.agent 0.1.0__tar.gz

org_slashlib_py_agent-0.1.0/LICENSE.md

@@ -0,0 +1,23 @@
+[AI](AI.md) [CHANGELOG](CHANGELOG.md) [README](README.md)
+
+MIT License
+
+Copyright (c) 2019 Dirk Brenckmann, db-developer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

org_slashlib_py_agent-0.1.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: org.slashlib.py.agent
+Version: 0.1.0
+Summary: python agent for inference handling
+Author-email: Dirk Brenckmann <db.developer@gmx.de>
+Project-URL: Homepage, https://github.com/org-slashlib/org.slashlib.py.agent
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Dynamic: license-file
+
+[Bottom](#license) [AI](AI.md) [CHANGELOG](CHANGELOG.md) [LICENSE](LICENSE.md)
+# org.slashlib.py.agent
+
+A highly decoupled, asynchronous framework for building AI agents in Python.
+
+[![PyPI version](https://img.shields.io/pypi/v/org.slashlib.py.agent.svg)](https://pypi.org/project/org.slashlib.py.agent/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Core Concept
+
+This package provides a robust infrastructure to connect AI models (Inference Engines) with functional tools. The focus lies on **Provider Agnosticism**: The agent does not need to know whether it is communicating with Ollama, OpenAI, or a local model—it uses standardized adapters to ensure seamless integration.
+
+### Key Features
+- **Asynchronous Core**: Built on `asyncio` for non-blocking task execution.
+- **Provider Agnostic**: Easily swap the AI engine using the Adapter pattern.
+- **Automatic Tool Schemas**: Automatically transforms Python functions into JSON schemas for LLMs via decorators.
+- **Multiton Pattern**: Ensures unique agent instances by identifier, preventing redundant resource allocation.
+- **Robust Exception Hierarchy**: Clearly separates connection, configuration, and tool execution errors.
+
+---
+## Installation
+
+Install the package via pip:
+
+```bash
+pip install org.slashlib.py.agent
+```
+
+---
+## Quick Start
+
+Setting up an agent with a tool and the Ollama adapter is straightforward:
+
+```python
+import asyncio
+from org.slashlib.py.agent import Agent, OllamaInferenceAdapter, tool
+
+# 1. Define a tool
+@tool(description="Adds two numbers.")
+async def add_numbers(a: int, b: int) -> int:
+    return a + b
+
+async def main():
+    # 2. Configure Adapter and Agent
+    adapter = OllamaInferenceAdapter()
+    my_agent = Agent(
+        identifier="MathExpert",
+        tools=[add_numbers],
+        adapter=adapter
+    )
+
+    # 3. Start task (non-blocking)
+    task = my_agent.run(user_prompt="What is 123 + 456?")
+    
+    # 4. Retrieve result
+    response = await task
+    print(f"Response: {response.get_last_content()}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+## Documentation & Obsidian
+
+The project root is pre-configured as an **Obsidian Vault**. If you open this folder directly in Obsidian, all settings and documentation links will be available immediately via the included `.obsidian` directory.
+
+The following community plugins are pre-configured in the vault to enhance the documentation experience:
+
+* **[File Include](https://github.com/tillahoffmann/obsidian-file-include)**: Embed code files directly into your markdown documentation.
+* **[Folder Notes](https://github.com/LostPaul/obsidian-folder-notes)**: Add descriptions at the folder level.
+* **[Front Matter Title](https://github.com/snezhig/obsidian-front-matter-title)**: Use metadata for descriptive file titles.
+* **[Hide Folders](https://github.com/JonasDoesThings/obsidian-hide-folders)**: Keeps the structure clean by hiding internal directories.
+* **[Iconic](https://github.com/gfxholo/iconic)** & **[Icons](https://github.com/visini/obsidian-icons-plugin)**: Improved visual navigation.
+
+[More docs](docs)
+
+---
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE.md) file for details.
+
+---
+© 2026 org.slashlib
+
+[TOP](#org-slashlib-py-agent) [AI](AI.md) [CHANGELOG](CHANGELOG.md) [LICENSE](LICENSE.md)

org_slashlib_py_agent-0.1.0/README.md

@@ -0,0 +1,86 @@
+[Bottom](#license) [AI](AI.md) [CHANGELOG](CHANGELOG.md) [LICENSE](LICENSE.md)
+# org.slashlib.py.agent
+
+A highly decoupled, asynchronous framework for building AI agents in Python.
+
+[![PyPI version](https://img.shields.io/pypi/v/org.slashlib.py.agent.svg)](https://pypi.org/project/org.slashlib.py.agent/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Core Concept
+
+This package provides a robust infrastructure to connect AI models (Inference Engines) with functional tools. The focus lies on **Provider Agnosticism**: The agent does not need to know whether it is communicating with Ollama, OpenAI, or a local model—it uses standardized adapters to ensure seamless integration.
+
+### Key Features
+- **Asynchronous Core**: Built on `asyncio` for non-blocking task execution.
+- **Provider Agnostic**: Easily swap the AI engine using the Adapter pattern.
+- **Automatic Tool Schemas**: Automatically transforms Python functions into JSON schemas for LLMs via decorators.
+- **Multiton Pattern**: Ensures unique agent instances by identifier, preventing redundant resource allocation.
+- **Robust Exception Hierarchy**: Clearly separates connection, configuration, and tool execution errors.
+
+---
+## Installation
+
+Install the package via pip:
+
+```bash
+pip install org.slashlib.py.agent
+```
+
+---
+## Quick Start
+
+Setting up an agent with a tool and the Ollama adapter is straightforward:
+
+```python
+import asyncio
+from org.slashlib.py.agent import Agent, OllamaInferenceAdapter, tool
+
+# 1. Define a tool
+@tool(description="Adds two numbers.")
+async def add_numbers(a: int, b: int) -> int:
+    return a + b
+
+async def main():
+    # 2. Configure Adapter and Agent
+    adapter = OllamaInferenceAdapter()
+    my_agent = Agent(
+        identifier="MathExpert",
+        tools=[add_numbers],
+        adapter=adapter
+    )
+
+    # 3. Start task (non-blocking)
+    task = my_agent.run(user_prompt="What is 123 + 456?")
+    
+    # 4. Retrieve result
+    response = await task
+    print(f"Response: {response.get_last_content()}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+## Documentation & Obsidian
+
+The project root is pre-configured as an **Obsidian Vault**. If you open this folder directly in Obsidian, all settings and documentation links will be available immediately via the included `.obsidian` directory.
+
+The following community plugins are pre-configured in the vault to enhance the documentation experience:
+
+* **[File Include](https://github.com/tillahoffmann/obsidian-file-include)**: Embed code files directly into your markdown documentation.
+* **[Folder Notes](https://github.com/LostPaul/obsidian-folder-notes)**: Add descriptions at the folder level.
+* **[Front Matter Title](https://github.com/snezhig/obsidian-front-matter-title)**: Use metadata for descriptive file titles.
+* **[Hide Folders](https://github.com/JonasDoesThings/obsidian-hide-folders)**: Keeps the structure clean by hiding internal directories.
+* **[Iconic](https://github.com/gfxholo/iconic)** & **[Icons](https://github.com/visini/obsidian-icons-plugin)**: Improved visual navigation.
+
+[More docs](docs)
+
+---
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE.md) file for details.
+
+---
+© 2026 org.slashlib
+
+[TOP](#org-slashlib-py-agent) [AI](AI.md) [CHANGELOG](CHANGELOG.md) [LICENSE](LICENSE.md)

org_slashlib_py_agent-0.1.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "org.slashlib.py.agent"
+version = "0.1.0"
+dependencies = [
+]
+authors = [
+  { name="Dirk Brenckmann", email="db.developer@gmx.de" },
+]
+description = "python agent for inference handling"
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/org-slashlib/org.slashlib.py.agent"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+addopts = """
+    -v  
+    --cov 
+    --cov=src/org/slashlib/py/agent 
+    --cov-report=term-missing 
+    --cov-report=xml:docs/reports/coverage/xml
+    --cov-report=html:docs/reports/coverage/html
+"""
+
+[tool.coverage.run]
+source = ["src/org/slashlib/py/agent"]
+omit = ["src/org/slashlib/py/agent/__main__.py"]
+
+[tool.coverage.report]
+show_missing = true

org_slashlib_py_agent-0.1.0/setup.cfg

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

org_slashlib_py_agent-0.1.0/src/org/slashlib/py/agent/__init__.py

@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+# file src/org/slashlib/py/agent/__init__.py
+# @AI:
+# - INTEGRITY RULES:
+#   - STRICT PRESERVATION: Do not remove, move, or modify ANY existing lines of code or comments 
+#     unless they are the explicit target of the requested change. 
+#   - DEBUG MARKERS: Commented-out code (e.g., debug prints) MUST be kept exactly where they are.
+#   - WHITESPACE & STRUCTURE: Maintain all original empty lines and the existing file structure. 
+#     Structural integrity takes precedence over "clean code" or "elegance".
+#   - LEAD-IN/OUT: The very first and last lines (and all comments in between) are immutable anchors.
+# - MAINTENANCE:
+#   - Only update pydoc strings (args, returns, raises) if the function signature changes.
+#   - Do NOT delete existing examples or descriptions in pydoc.
+# - LANGUAGE: en-US for all comments and documentation.
+
+from src.org.slashlib.py.agent.agent import Agent
+from src.org.slashlib.py.agent.tool import tool
+from src.org.slashlib.py.agent.agent_response import AgentResponse
+from src.org.slashlib.py.agent.inference_bases import (
+    InferenceAdapter,
+    InferenceResult,
+    InferenceError,
+    InferenceConnectionError,
+    InferenceConfigError,
+    InferencePayloadError
+)
+from src.org.slashlib.py.agent.inference_complements_for_ollama import (
+    OllamaInferenceAdapter,
+    OllamaInferenceResult
+)
+
+__all__ = [
+    "Agent",
+    "tool",
+    "AgentResponse",
+    "InferenceAdapter",
+    "InferenceResult",
+    "InferenceError",
+    "InferenceConnectionError",
+    "InferenceConfigError",
+    "InferencePayloadError",
+    "OllamaInferenceAdapter",
+    "OllamaInferenceResult"
+]
+
+# end of file src/org/slashlib/py/agent/__init__.py

org_slashlib_py_agent-0.1.0/src/org/slashlib/py/agent/__main__.py

@@ -0,0 +1,91 @@
+# -*- coding: utf-8 -*-
+# file src/org/slashlib/py/agent/__main__.py
+# @AI:
+# - INTEGRITY RULES:
+#   - STRICT PRESERVATION: Do not remove, move, or modify ANY existing lines of code or comments 
+#     unless they are the explicit target of the requested change. 
+#   - DEBUG MARKERS: Commented-out code (e.g., debug prints) MUST be kept exactly where they are.
+#   - WHITESPACE & STRUCTURE: Maintain all original empty lines and the existing file structure. 
+#     Structural integrity takes precedence over "clean code" or "elegance".
+#   - LEAD-IN/OUT: The very first and last lines (and all comments in between) are immutable anchors.
+# - MAINTENANCE:
+#   - Only update pydoc strings (args, returns, raises) if the function signature changes.
+#   - Do NOT delete existing examples or descriptions in pydoc.
+# - LANGUAGE: en-US for all comments and documentation.
+#
+# pragma: no cover
+#
+"""
+Entry point for the org.slashlib.py.agent package.
+"""
+
+# Import python packages
+import argparse
+import logging
+import pathlib
+import sys
+from importlib import metadata
+
+# Compatibility layer for TOML (Python 3.11+ uses tomllib, older use tomli)
+if sys.version_info >= (3, 11):
+    import tomllib
+else:
+    try:
+        import tomli as tomllib
+    except ImportError:
+        tomllib = None
+
+# Import thirdparty packages
+import org.slashlib.py.configloader
+
+# setup logging
+org.slashlib.py.configloader.setup_logging()
+
+log = logging.getLogger(f"org.slashlib.py.agent.{pathlib.Path(__file__).stem}")
+
+def get_version() -> str:
+    """
+    Retrieve the version of the package from metadata or local pyproject.toml.
+    """
+    # 1. Try metadata (works if installed via pip)
+    try:
+        return metadata.version("org.slashlib.py.agent")
+    except metadata.PackageNotFoundError:
+        pass
+
+    # 2. Fallback: Parse pyproject.toml directly (works during development)
+    if tomllib is not None:
+        try:
+            # Search for pyproject.toml relative to this file's location
+            # Path: src/org/slashlib/py/agent/__main__.py -> root is 4 levels up
+            root_path = pathlib.Path(__file__).parents[5]
+            toml_path = root_path / "pyproject.toml"
+            
+            if toml_path.exists():
+                with open(toml_path, "rb") as f:
+                    data = tomllib.load(f)
+                    return data.get("project", {}).get("version", "unknown (local)")
+        except Exception:
+            pass
+
+    return "unknown"
+
+def start():
+    """
+    Bootstrap function to instantiate and run the bot.
+    """
+    parser = argparse.ArgumentParser(description="org.slashlib.py.agent CLI")
+    parser.add_argument("--version", action="store_true", help="Show the package version and exit")
+    
+    args, unknown = parser.parse_known_args()
+
+    if args.version:
+        print(f"org.slashlib.py.agent version {get_version()}")
+        sys.exit(0)
+    else:
+        parser.print_help()
+ 
+if __name__ == "__main__":
+    start()
+    
+# end of file src/org/slashlib/py/agent/__main__.py