swarmauri-standard 0.10.1.dev3__tar.gz → 0.11.0.dev2__tar.gz

swarmauri_standard-0.11.0.dev2/PKG-INFO

@@ -0,0 +1,213 @@
+Metadata-Version: 2.4
+Name: swarmauri_standard
+Version: 0.11.0.dev2
+Summary: First-party Swarmauri standard components for agents, tools, parsers, vectors, model adapters, and composable intelligence workflows.
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: swarmauri,standard-components,ai-sdk,agents,tools,toolkits,parsers,vector-stores,llms,embeddings,schema-converters,composable-intelligence,dynamic-json-schema,discriminated-unions,pydantic,schema-first,serialization,yaml,toml,plugin-factory,typed-components
+Author: Jacob Stewart
+Author-email: jacob@swarmauri.com
+Requires-Python: >=3.10,<3.15
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing
+Requires-Dist: aiofiles
+Requires-Dist: h11 (>=0.16.0)
+Requires-Dist: httpx (>=0.27.0)
+Requires-Dist: joblib (>=1.4.0)
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: pillow (>=11.1.0)
+Requires-Dist: pydantic (>=2.9.2)
+Requires-Dist: rich
+Requires-Dist: swarmauri_base
+Requires-Dist: swarmauri_core
+Requires-Dist: toml (>=0.10.2)
+Requires-Dist: typing_extensions
+Description-Content-Type: text/markdown
+
+![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)
+
+<p align="center">
+    <a href="https://pepy.tech/project/swarmauri_standard/">
+        <img src="https://static.pepy.tech/badge/swarmauri_standard/month" alt="PyPI - Downloads"/></a>
+    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/swarmauri_standard/">
+        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/swarmauri_standard.svg"/></a>
+    <a href="https://pypi.org/project/swarmauri_standard/">
+        <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
+    <a href="https://pypi.org/project/swarmauri_standard/">
+        <img src="https://img.shields.io/pypi/l/swarmauri_standard" alt="PyPI - License"/></a>
+    <a href="https://pypi.org/project/swarmauri_standard/">
+        <img src="https://img.shields.io/pypi/v/swarmauri_standard?label=swarmauri_standard&color=green" alt="PyPI - swarmauri_standard"/></a>
+    <a href="https://discord.gg/N4UpBuQv8T">
+        <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
+
+# Swarmauri Standard
+
+`swarmauri_standard` provides first-party, ready-to-use Swarmauri components built on `swarmauri_core` interfaces and `swarmauri_base` component behavior. It is the standard component bundle for agents, chains, chunkers, conversations, documents, tools, toolkits, parsers, prompts, schema converters, metrics, similarities, deprecated distance compatibility shims, vectors, vector stores, tracing utilities, STT/TTS/VLM adapters, signing helpers, and key-provider components.
+
+## Why Swarmauri Standard?
+
+`swarmauri_standard` provides maintained first-party components that users can install and instantiate directly. It also demonstrates the expected Swarmauri component style: typed base classes, direct class imports, dynamic serialization, and namespace-ready registration.
+
+## FAQ
+
+### Q: What kinds of components are included?
+
+A: The package includes agents, chains, chunkers, conversations, documents, tools, toolkits, parsers, prompts, schema converters, metrics, similarities, deprecated distance compatibility shims, vectors, vector stores, tracing utilities, STT/TTS/VLM adapters, signing helpers, and key-provider components.
+
+### Q: Is this package the same as `swarmauri`?
+
+A: No. `swarmauri` provides the namespace importer and plugin discovery layer. `swarmauri_standard` provides concrete first-party implementation classes.
+
+### Q: Should examples instantiate plugins directly?
+
+A: Yes. Direct class imports and direct instantiation are the preferred documented workflow unless a package explicitly requires another integration pattern.
+
+## Features
+
+- Standard agents including question-answering, RAG, simple conversation, and tool-using agent patterns.
+- Tool and toolkit components such as calculator, HTTP request, readability, code extraction, temperature conversion, weather, and accessibility utilities.
+- Parser and document components for CSV, XML, OpenAPI specs, markdown-to-HTML, URLs, regular expressions, Python code, and phone-number extraction.
+- Chunkers, conversations, prompts, prompt templates, chains, pipelines, service registries, state objects, and tracing helpers for application workflows.
+- Deprecated distance compatibility shims, vectors, vector stores, measurements, metrics, norms, similarities, and related numerical components.
+- Model adapter classes for LLM, tool LLM, embedding, image generation, STT, TTS, OCR, and VLM workflows where provider configuration is available.
+- Signing and key-provider components that align with Swarmauri's security-oriented interfaces.
+- Dynamic JSON, YAML, and TOML serialization through `ComponentBase`, `DynamicBase`, and `SubclassUnion`.
+- Python 3.10, 3.11, 3.12, 3.13, and 3.14 support.
+
+## Installation
+
+Install with `uv`:
+
+```bash
+uv add swarmauri_standard
+```
+
+Install with `pip`:
+
+```bash
+pip install swarmauri_standard
+```
+
+## Usage
+
+Use standard components directly from their implementation modules:
+
+```python
+from swarmauri_standard.tools.CalculatorTool import CalculatorTool
+
+calculator = CalculatorTool()
+result = calculator("add", 5, 3)
+
+assert result == {"operation": "add", "calculated_result": "8.0"}
+```
+
+Create documents and serialize them as Swarmauri components:
+
+```python
+from swarmauri_standard.documents.Document import Document
+
+doc = Document(content="Composable intelligence infrastructure")
+payload = doc.model_dump_json()
+restored = Document.model_validate_json(payload)
+
+assert restored.type == "Document"
+assert restored.content == doc.content
+```
+
+Hydrate registered standard components through a base-family union:
+
+```python
+from pydantic import BaseModel
+
+from swarmauri_base.DynamicBase import SubclassUnion
+from swarmauri_base.toolkits.ToolkitBase import ToolkitBase
+from swarmauri_standard.toolkits.Toolkit import Toolkit
+
+
+class ToolkitEnvelope(BaseModel):
+    toolkit: SubclassUnion[ToolkitBase]
+
+
+payload = ToolkitEnvelope(toolkit=Toolkit()).model_dump_json()
+restored = ToolkitEnvelope.model_validate_json(payload)
+
+assert isinstance(restored.toolkit, Toolkit)
+```
+
+## Component Families
+
+The package includes these standard component families:
+
+- Agents: `QAAgent`, `RagAgent`, `SimpleConversationAgent`, and `ToolAgent`.
+- Chains and workflow: callable chains, chain steps, context chains, prompt context chains, pipelines, service registries, swarms, and round-robin task management.
+- Text and document processing: chunkers, documents, conversations, prompts, prompt templates, parsers, messages, and schema converters.
+- Tools and toolkits: calculator, arithmetic, HTTP requests, JSON requests, code extraction, code interpretation, readability scoring, weather, temperature conversion, parameters, accessibility toolkit, and generic toolkit support.
+- Vector and numerical work: vectors, TF-IDF vector store, deprecated distance compatibility shims, measurements, metrics, norms, similarities, pseudometrics, seminorms, matrices, tensors, and inner products.
+- AI model surfaces: LLMs, tool LLMs, embeddings, image generators, OCR, STT, TTS, and VLM classes for supported providers.
+- Runtime support: decorators, tracing, transports, state, logging, and utility classes.
+- Trust and security surfaces: signing and key-provider components that align with Swarmauri's core interfaces.
+
+## Distance Migration
+
+The `swarmauri_standard.distances` module remains available only as a deprecated compatibility surface. Prefer the active metric and similarity families instead:
+
+- `CosineDistance` -> `CosineSimilarity`
+- `EuclideanDistance` -> `EuclideanMetric`
+- `LevenshteinDistance` -> `LevenshteinMetric`
+- `JaccardIndexDistance` -> `JaccardIndexSimilarity`
+- `SorensenDiceDistance` -> `DiceSimilarity`
+- `ChebyshevDistance` -> `SupremumMetric`
+- `ManhattanDistance` -> `LpMetric(p=1)`
+- `MinkowskiDistance` -> `LpMetric(p=<order>)`
+- `SquaredEuclideanDistance` -> `EuclideanMetric` or `GaussianRBFSimilarity`, depending on whether you need metric or similarity semantics
+- `CanberraDistance`, `ChiSquaredDistance`, and `HaversineDistance` do not yet have active drop-in replacements in the workspace
+
+## Related Packages
+
+Foundational packages:
+
+- [swarmauri](https://pypi.org/project/swarmauri/) provides namespace imports and plugin discovery.
+- [swarmauri_core](https://pypi.org/project/swarmauri_core/) provides the interfaces implemented by these standard components.
+- [swarmauri_base](https://pypi.org/project/swarmauri_base/) provides component base classes, mixins, and serialization behavior.
+- [swarmauri_typing](https://pypi.org/project/swarmauri_typing/) provides dynamic typing utilities used by the component model.
+
+Related component packages:
+
+- [swarmauri_embedding_doc2vec](https://pypi.org/project/swarmauri_embedding_doc2vec/) for Doc2Vec embedding support.
+- [swarmauri_embedding_nmf](https://pypi.org/project/swarmauri_embedding_nmf/) for NMF embedding support.
+- [swarmauri_vectorstore_doc2vec](https://pypi.org/project/swarmauri_vectorstore_doc2vec/) for Doc2Vec vector-store workflows.
+- [swarmauri_standard](https://pypi.org/project/swarmauri_standard/) for the active metric, similarity, and vector-store comparator surface.
+- [swarmauri_tool_matplotlib](https://pypi.org/project/swarmauri_tool_matplotlib/) for Matplotlib tool support.
+- [swarmauri_parser_keywordextractor](https://pypi.org/project/swarmauri_parser_keywordextractor/) for keyword extraction parsing.
+- [swarmauri_signing_ed25519](https://pypi.org/project/swarmauri_signing_ed25519/) for Ed25519 signing.
+
+## When To Use This Package
+
+Use `swarmauri_standard` when you want maintained first-party implementations that are ready for examples, prototypes, tests, and production workflows where the included component behavior fits. Use smaller standalone component packages when you want a narrower dependency surface for a specific provider, algorithm, or runtime integration.
+
+## License
+
+Apache-2.0
+
+## Contributing
+
+When adding standard components, inherit from the matching `swarmauri_base` class, satisfy the `swarmauri_core` interface, register the component type, document direct instantiation, and follow the [Swarmauri SDK contribution guide](https://github.com/swarmauri/swarmauri-sdk/blob/master/CONTRIBUTING.md).
+
+
+

swarmauri_standard-0.11.0.dev2/README.md

@@ -0,0 +1,170 @@
+![Swarmauri Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/swarmauri_sdk_brand.png)
+
+<p align="center">
+    <a href="https://pepy.tech/project/swarmauri_standard/">
+        <img src="https://static.pepy.tech/badge/swarmauri_standard/month" alt="PyPI - Downloads"/></a>
+    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/swarmauri_standard/">
+        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/swarmauri_standard.svg"/></a>
+    <a href="https://pypi.org/project/swarmauri_standard/">
+        <img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue" alt="PyPI - Python Version"/></a>
+    <a href="https://pypi.org/project/swarmauri_standard/">
+        <img src="https://img.shields.io/pypi/l/swarmauri_standard" alt="PyPI - License"/></a>
+    <a href="https://pypi.org/project/swarmauri_standard/">
+        <img src="https://img.shields.io/pypi/v/swarmauri_standard?label=swarmauri_standard&color=green" alt="PyPI - swarmauri_standard"/></a>
+    <a href="https://discord.gg/N4UpBuQv8T">
+        <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord"/></a></p>
+
+# Swarmauri Standard
+
+`swarmauri_standard` provides first-party, ready-to-use Swarmauri components built on `swarmauri_core` interfaces and `swarmauri_base` component behavior. It is the standard component bundle for agents, chains, chunkers, conversations, documents, tools, toolkits, parsers, prompts, schema converters, metrics, similarities, deprecated distance compatibility shims, vectors, vector stores, tracing utilities, STT/TTS/VLM adapters, signing helpers, and key-provider components.
+
+## Why Swarmauri Standard?
+
+`swarmauri_standard` provides maintained first-party components that users can install and instantiate directly. It also demonstrates the expected Swarmauri component style: typed base classes, direct class imports, dynamic serialization, and namespace-ready registration.
+
+## FAQ
+
+### Q: What kinds of components are included?
+
+A: The package includes agents, chains, chunkers, conversations, documents, tools, toolkits, parsers, prompts, schema converters, metrics, similarities, deprecated distance compatibility shims, vectors, vector stores, tracing utilities, STT/TTS/VLM adapters, signing helpers, and key-provider components.
+
+### Q: Is this package the same as `swarmauri`?
+
+A: No. `swarmauri` provides the namespace importer and plugin discovery layer. `swarmauri_standard` provides concrete first-party implementation classes.
+
+### Q: Should examples instantiate plugins directly?
+
+A: Yes. Direct class imports and direct instantiation are the preferred documented workflow unless a package explicitly requires another integration pattern.
+
+## Features
+
+- Standard agents including question-answering, RAG, simple conversation, and tool-using agent patterns.
+- Tool and toolkit components such as calculator, HTTP request, readability, code extraction, temperature conversion, weather, and accessibility utilities.
+- Parser and document components for CSV, XML, OpenAPI specs, markdown-to-HTML, URLs, regular expressions, Python code, and phone-number extraction.
+- Chunkers, conversations, prompts, prompt templates, chains, pipelines, service registries, state objects, and tracing helpers for application workflows.
+- Deprecated distance compatibility shims, vectors, vector stores, measurements, metrics, norms, similarities, and related numerical components.
+- Model adapter classes for LLM, tool LLM, embedding, image generation, STT, TTS, OCR, and VLM workflows where provider configuration is available.
+- Signing and key-provider components that align with Swarmauri's security-oriented interfaces.
+- Dynamic JSON, YAML, and TOML serialization through `ComponentBase`, `DynamicBase`, and `SubclassUnion`.
+- Python 3.10, 3.11, 3.12, 3.13, and 3.14 support.
+
+## Installation
+
+Install with `uv`:
+
+```bash
+uv add swarmauri_standard
+```
+
+Install with `pip`:
+
+```bash
+pip install swarmauri_standard
+```
+
+## Usage
+
+Use standard components directly from their implementation modules:
+
+```python
+from swarmauri_standard.tools.CalculatorTool import CalculatorTool
+
+calculator = CalculatorTool()
+result = calculator("add", 5, 3)
+
+assert result == {"operation": "add", "calculated_result": "8.0"}
+```
+
+Create documents and serialize them as Swarmauri components:
+
+```python
+from swarmauri_standard.documents.Document import Document
+
+doc = Document(content="Composable intelligence infrastructure")
+payload = doc.model_dump_json()
+restored = Document.model_validate_json(payload)
+
+assert restored.type == "Document"
+assert restored.content == doc.content
+```
+
+Hydrate registered standard components through a base-family union:
+
+```python
+from pydantic import BaseModel
+
+from swarmauri_base.DynamicBase import SubclassUnion
+from swarmauri_base.toolkits.ToolkitBase import ToolkitBase
+from swarmauri_standard.toolkits.Toolkit import Toolkit
+
+
+class ToolkitEnvelope(BaseModel):
+    toolkit: SubclassUnion[ToolkitBase]
+
+
+payload = ToolkitEnvelope(toolkit=Toolkit()).model_dump_json()
+restored = ToolkitEnvelope.model_validate_json(payload)
+
+assert isinstance(restored.toolkit, Toolkit)
+```
+
+## Component Families
+
+The package includes these standard component families:
+
+- Agents: `QAAgent`, `RagAgent`, `SimpleConversationAgent`, and `ToolAgent`.
+- Chains and workflow: callable chains, chain steps, context chains, prompt context chains, pipelines, service registries, swarms, and round-robin task management.
+- Text and document processing: chunkers, documents, conversations, prompts, prompt templates, parsers, messages, and schema converters.
+- Tools and toolkits: calculator, arithmetic, HTTP requests, JSON requests, code extraction, code interpretation, readability scoring, weather, temperature conversion, parameters, accessibility toolkit, and generic toolkit support.
+- Vector and numerical work: vectors, TF-IDF vector store, deprecated distance compatibility shims, measurements, metrics, norms, similarities, pseudometrics, seminorms, matrices, tensors, and inner products.
+- AI model surfaces: LLMs, tool LLMs, embeddings, image generators, OCR, STT, TTS, and VLM classes for supported providers.
+- Runtime support: decorators, tracing, transports, state, logging, and utility classes.
+- Trust and security surfaces: signing and key-provider components that align with Swarmauri's core interfaces.
+
+## Distance Migration
+
+The `swarmauri_standard.distances` module remains available only as a deprecated compatibility surface. Prefer the active metric and similarity families instead:
+
+- `CosineDistance` -> `CosineSimilarity`
+- `EuclideanDistance` -> `EuclideanMetric`
+- `LevenshteinDistance` -> `LevenshteinMetric`
+- `JaccardIndexDistance` -> `JaccardIndexSimilarity`
+- `SorensenDiceDistance` -> `DiceSimilarity`
+- `ChebyshevDistance` -> `SupremumMetric`
+- `ManhattanDistance` -> `LpMetric(p=1)`
+- `MinkowskiDistance` -> `LpMetric(p=<order>)`
+- `SquaredEuclideanDistance` -> `EuclideanMetric` or `GaussianRBFSimilarity`, depending on whether you need metric or similarity semantics
+- `CanberraDistance`, `ChiSquaredDistance`, and `HaversineDistance` do not yet have active drop-in replacements in the workspace
+
+## Related Packages
+
+Foundational packages:
+
+- [swarmauri](https://pypi.org/project/swarmauri/) provides namespace imports and plugin discovery.
+- [swarmauri_core](https://pypi.org/project/swarmauri_core/) provides the interfaces implemented by these standard components.
+- [swarmauri_base](https://pypi.org/project/swarmauri_base/) provides component base classes, mixins, and serialization behavior.
+- [swarmauri_typing](https://pypi.org/project/swarmauri_typing/) provides dynamic typing utilities used by the component model.
+
+Related component packages:
+
+- [swarmauri_embedding_doc2vec](https://pypi.org/project/swarmauri_embedding_doc2vec/) for Doc2Vec embedding support.
+- [swarmauri_embedding_nmf](https://pypi.org/project/swarmauri_embedding_nmf/) for NMF embedding support.
+- [swarmauri_vectorstore_doc2vec](https://pypi.org/project/swarmauri_vectorstore_doc2vec/) for Doc2Vec vector-store workflows.
+- [swarmauri_standard](https://pypi.org/project/swarmauri_standard/) for the active metric, similarity, and vector-store comparator surface.
+- [swarmauri_tool_matplotlib](https://pypi.org/project/swarmauri_tool_matplotlib/) for Matplotlib tool support.
+- [swarmauri_parser_keywordextractor](https://pypi.org/project/swarmauri_parser_keywordextractor/) for keyword extraction parsing.
+- [swarmauri_signing_ed25519](https://pypi.org/project/swarmauri_signing_ed25519/) for Ed25519 signing.
+
+## When To Use This Package
+
+Use `swarmauri_standard` when you want maintained first-party implementations that are ready for examples, prototypes, tests, and production workflows where the included component behavior fits. Use smaller standalone component packages when you want a narrower dependency surface for a specific provider, algorithm, or runtime integration.
+
+## License
+
+Apache-2.0
+
+## Contributing
+
+When adding standard components, inherit from the matching `swarmauri_base` class, satisfy the `swarmauri_core` interface, register the component type, document direct instantiation, and follow the [Swarmauri SDK contribution guide](https://github.com/swarmauri/swarmauri-sdk/blob/master/CONTRIBUTING.md).
+
+

{swarmauri_standard-0.10.1.dev3 → swarmauri_standard-0.11.0.dev2}/pyproject.toml

@@ -1,10 +1,20 @@
 [project]
 name = "swarmauri_standard"
-version = "0.10.1.dev3"
-description = "This repository includes standard components within the Swarmauri framework."
+version = "0.11.0.dev2"
+description = "First-party Swarmauri standard components for agents, tools, parsers, vectors, model adapters, and composable intelligence workflows."
 keywords = [
     "swarmauri",
     "standard-components",
+    "ai-sdk",
+    "agents",
+    "tools",
+    "toolkits",
+    "parsers",
+    "vector-stores",
+    "llms",
+    "embeddings",
+    "schema-converters",
+    "composable-intelligence",
     "dynamic-json-schema",
     "discriminated-unions",
     "pydantic",
@@ -20,7 +30,10 @@ license = "Apache-2.0"
 readme = { file = "README.md", content-type = "text/markdown" }
 repository = "http://github.com/swarmauri/swarmauri-sdk"
 classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
     "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
@@ -29,6 +42,11 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing",
 ]
 requires-python = ">=3.10,<3.15"
 dependencies = [
@@ -64,7 +82,7 @@ dev = [
 "python-dotenv>=1.0.0",
 "jsonschema>=4.18.5",
 "ipython>=8.28.0",
-"requests>=2.32.3",
+"httpx>=0.27",
 "ruff>=0.9.9",
 "pytest-benchmark>=4.0.0",
 ]

{swarmauri_standard-0.10.1.dev3 → swarmauri_standard-0.11.0.dev2}/swarmauri_standard/README.md

@@ -11,7 +11,6 @@
         <img src="https://img.shields.io/pypi/l/swarmauri-standard" alt="PyPI - License"/></a>
     <a href="https://pypi.org/project/swarmauri-standard/">
         <img src="https://img.shields.io/pypi/v/swarmauri-standard?label=swarmauri-standard&color=green" alt="PyPI - swarmauri-standard"/></a>
-
 </p>
 
 # Standard Library
@@ -51,3 +50,6 @@ Your contributions can help the Standard Library grow! Whether it's adding new t
 ## License
 
 Please see the `LICENSE` file in the repository for details.
+
+
+

swarmauri_standard-0.11.0.dev2/swarmauri_standard/__init__.py

@@ -0,0 +1,66 @@
+__long_desc__ = """
+# Swarmauri Standard SDK
+
+The Swarmauri Standard SDK offers a comprehensive suite of tools designed for
+building distributed, extensible systems using the Swarmauri framework.
+
+## Standard
+- **Base Classes**: Provide a foundation for constructing Swarmauri components,
+  with standardized methods and properties.
+- **Mixins**: Reusable code fragments designed to be integrated into various
+  classes, offering shared functionality across different components.
+- **Concrete Classes**: Ready-to-use, pre-implemented classes that fulfill
+  standard system needs while adhering to Swarmauri principles. **These classes
+  are the first in line for ongoing support and maintenance, ensuring they
+  remain stable, performant, and up to date with future SDK developments.**
+
+# Features
+
+- **Polymorphism**: Allows for dynamic behavior switching between components,
+  enabling flexible, context-aware system behavior.
+- **Discriminated Unions**: Provides a robust method for handling multiple
+  possible object types in a type-safe manner.
+- **Serialization**: Efficiently encode and decode data for transmission across
+  different environments and system components, with support for both standard
+  and custom serialization formats.
+- **Intensional and Extensional Programming**: Leverages both rule-based
+  (intensional) and set-based (extensional) approaches to building and
+  manipulating complex data structures, offering developers a wide range of
+  tools for system design.
+
+## Use Cases
+
+- **Modular Systems**: Develop scalable, pluggable systems that can evolve over
+  time by adding or modifying components without disrupting the entire
+  ecosystem.
+- **Distributed Architectures**: Build systems with distributed nodes that
+  seamlessly communicate using the SDK’s standardized interfaces.
+- **Third-Party Integrations**: Extend the system's capabilities by easily
+  incorporating third-party tools, libraries, and services.
+- **Prototype and Experimentation**: Test cutting-edge ideas using the
+  experimental components in the SDK, while retaining the reliability of core
+  and standard features for production systems.
+
+# Future Development
+
+The Swarmauri SDK is an evolving platform, and the community is encouraged to
+contribute to its growth. Upcoming releases will focus on enhancing the
+framework's modularity, providing more advanced serialization methods, and
+expanding the community-driven component library.
+
+Visit us at: https://swarmauri.com
+Follow us at: https://github.com/swarmauri 
+"""
+
+try:
+    # For Python 3.8 and newer
+    from importlib.metadata import version, PackageNotFoundError
+except ImportError:
+    # For older Python versions, use the backport
+    from importlib_metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("swarmauri_standard")
+except PackageNotFoundError:
+    # If the package is not installed (for example, during development)
+    __version__ = "0.0.0"

{swarmauri_standard-0.10.1.dev3 → swarmauri_standard-0.11.0.dev2}/swarmauri_standard/agents/QAAgent.py

@@ -12,8 +12,8 @@ from swarmauri_base.ComponentBase import SubclassUnion, ComponentBase
 
 @ComponentBase.register_type(AgentBase, "QAAgent")
 class QAAgent(AgentBase):
-    conversation: SubclassUnion[ConversationBase] = MaxSystemContextConversation(
-        max_size=2
+    conversation: SubclassUnion[ConversationBase] = (
+        MaxSystemContextConversation(max_size=2)
     )
     type: Literal["QAAgent"] = "QAAgent"
 

{swarmauri_standard-0.10.1.dev3 → swarmauri_standard-0.11.0.dev2}/swarmauri_standard/agents/RagAgent.py

@@ -14,7 +14,9 @@ from swarmauri_base.agents.AgentBase import AgentBase
 from swarmauri_base.agents.AgentRetrieveMixin import AgentRetrieveMixin
 from swarmauri_base.agents.AgentConversationMixin import AgentConversationMixin
 from swarmauri_base.agents.AgentVectorStoreMixin import AgentVectorStoreMixin
-from swarmauri_base.agents.AgentSystemContextMixin import AgentSystemContextMixin
+from swarmauri_base.agents.AgentSystemContextMixin import (
+    AgentSystemContextMixin,
+)
 from swarmauri_base.vector_stores.VectorStoreBase import VectorStoreBase
 from swarmauri_core.messages import IMessage
 from swarmauri_base.ComponentBase import SubclassUnion, ComponentBase
@@ -30,13 +32,14 @@ class RagAgent(
 ):
     """
     RagAgent (Retriever-And-Generator Agent) extends DocumentAgentBase,
-    specialized in retrieving documents based on input queries and generating responses.
+    specialized in retrieving documents based on input queries and generating
+    responses.
     """
 
     llm: SubclassUnion[LLMBase]
-    conversation: Union[MaxSystemContextConversation, SessionCacheConversation] = (
-        MaxSystemContextConversation(system_context="")
-    )
+    conversation: Union[
+        MaxSystemContextConversation, SessionCacheConversation
+    ] = MaxSystemContextConversation(system_context="")
     vector_store: SubclassUnion[VectorStoreBase]
     system_context: Union[SystemMessage, str] = SystemMessage(content="")
     type: Literal["RagAgent"] = "RagAgent"
@@ -66,7 +69,9 @@ class RagAgent(
         elif isinstance(input_data, IMessage):
             human_message = input_data
         else:
-            raise TypeError("Input data must be a string or an instance of IMessage.")
+            raise TypeError(
+                "Input data must be a string or an instance of IMessage."
+            )
 
         self.conversation.add_message(human_message)
 
@@ -125,7 +130,9 @@ class RagAgent(
         try:
             self._prepare_context(input_data, top_k, preamble, fixed)
             if llm_kwargs:
-                await self.llm.apredict(conversation=self.conversation, **llm_kwargs)
+                await self.llm.apredict(
+                    conversation=self.conversation, **llm_kwargs
+                )
             else:
                 await self.llm.apredict(conversation=self.conversation)
             return self.conversation.get_last().content

{swarmauri_standard-0.10.1.dev3 → swarmauri_standard-0.11.0.dev2}/swarmauri_standard/agents/ToolAgent.py

@@ -35,7 +35,9 @@ class ToolAgent(AgentToolMixin, AgentConversationMixin, AgentBase):
         elif isinstance(input_data, IMessage):
             human_message = input_data
         else:
-            raise TypeError("Input data must be a string or an instance of Message.")
+            raise TypeError(
+                "Input data must be a string or an instance of Message."
+            )
 
         # Add the human message to the conversation
         self.conversation.add_message(human_message)
@@ -64,7 +66,9 @@ class ToolAgent(AgentToolMixin, AgentConversationMixin, AgentBase):
         elif isinstance(input_data, IMessage):
             human_message = input_data
         else:
-            raise TypeError("Input data must be a string or an instance of Message.")
+            raise TypeError(
+                "Input data must be a string or an instance of Message."
+            )
 
         # Add input to conversation
         self.conversation.add_message(human_message)
@@ -79,4 +83,6 @@ class ToolAgent(AgentToolMixin, AgentConversationMixin, AgentBase):
         return self.conversation.get_last().content
 
     def get_tool_message_content(self) -> List[str]:
-        return [m.content for m in self.conversation.history if m.role == "tool"]
+        return [
+            m.content for m in self.conversation.history if m.role == "tool"
+        ]

{swarmauri_standard-0.10.1.dev3 → swarmauri_standard-0.11.0.dev2}/swarmauri_standard/agents/__init__.py

@@ -1,10 +1,12 @@
 # from swarmauri_standard.utils._lazy_import import _lazy_import
 
-# # List of agent names (file names without the ".py" extension) and corresponding class names
+# # List of agent names (file names without the ".py" extension) and
+# corresponding class names
 # agent_files = [
 #     ("swarmauri_standard.agents.QAAgent", "QAAgent"),
 #     ("swarmauri_standard.agents.RagAgent", "RagAgent"),
-#     ("swarmauri_standard.agents.SimpleConversationAgent", "SimpleConversationAgent"),
+# ("swarmauri_standard.agents.SimpleConversationAgent",
+# "SimpleConversationAgent"),
 #     ("swarmauri_standard.agents.ToolAgent", "ToolAgent"),
 # ]
 

{swarmauri_standard-0.10.1.dev3 → swarmauri_standard-0.11.0.dev2}/swarmauri_standard/chains/CallableChain.py

@@ -1,5 +1,8 @@
 from typing import Any, Callable, List, Dict, Optional
-from swarmauri_core.chains.ICallableChain import ICallableChain, CallableDefinition
+from swarmauri_core.chains.ICallableChain import (
+    ICallableChain,
+    CallableDefinition,
+)
 
 
 class CallableChain(ICallableChain):
@@ -10,7 +13,8 @@ class CallableChain(ICallableChain):
         result = None
         for func, args, kwargs in self.callables:
             if result is not None:
-                # If there was a previous result, use it as the first argument for the next function
+                # If there was a previous result, use it as the first argument
+                # for the next function
                 args = [result] + list(args)
             result = func(*args, **kwargs)
         return result