soothe-plugins 0.2.6__py3-none-any.whl

soothe_plugins-0.2.6.dist-info/METADATA

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: soothe-plugins
+Version: 0.2.6
+Summary: Community plugins for Soothe agent orchestration framework
+Project-URL: Homepage, https://github.com/mirasoth/soothe-plugins
+Project-URL: Repository, https://github.com/mirasoth/soothe-plugins
+Project-URL: Issues, https://github.com/mirasoth/soothe-plugins/issues
+License: MIT
+Keywords: agents,ai,llm,plugins,soothe
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: <3.15,>=3.11
+Requires-Dist: arxiv<3.0.0,>=2.0.0
+Requires-Dist: feedparser<7.0.0,>=6.0.0
+Requires-Dist: langgraph<2.0.0,>=1.1.1
+Requires-Dist: numpy<3.0.0,>=1.20.0
+Requires-Dist: pyzotero<2.0.0,>=1.5.0
+Requires-Dist: scikit-learn<2.0.0,>=1.0.0
+Requires-Dist: sentence-transformers<6.0.0,>=2.2.0
+Requires-Dist: soothe-sdk<1.0.0,>=0.5.9
+Requires-Dist: tiktoken<1.0.0,>=0.5.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.12.0; extra == 'dev'
+Requires-Dist: twine>=5.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Soothe Community Plugins
+
+Standalone community plugins package for the Soothe agent orchestration framework.
+
+## Installation
+
+```bash
+pip install soothe-plugins
+```
+
+## Available Plugins
+
+### Sample Echo
+
+Minimal echo subagent for testing soothe-plugins integration. See [CONTRIBUTING.md](CONTRIBUTING.md) for plugin development guide.
+
+### Skillify
+
+Skill warehouse indexing and semantic retrieval agent. Provides background indexing loop and retrieval capabilities for skill discovery.
+
+### Weaver
+
+Generative agent framework with skill harmonization. Composes skills from Skillify, resolves conflicts, and generates task-specific subagents dynamically.
+
+### BrowserUse and Claude Code
+
+Delegated **browser-use** and **Claude agent SDK** subagents (IG-415). Install with `pip install "soothe-plugins[browser_use]"` or `"soothe-plugins[claude]"` and enable `subagents.browser_use` / `subagents.claude` in config. Spec: `docs/RFC-601-community-agents.md`.
+
+## Extensibility
+
+This package is designed for extensibility. You can easily add new community plugins:
+
+### Available Plugin Types
+
+1. **Subagent Plugins**: Complex multi-step agents using langgraph
+2. **Tool Plugins**: Simple functions exposed as tools
+3. **Hybrid Plugins**: Both subagents and tools
+
+### Future Plugins
+
+The package structure supports adding new plugins:
+
+```
+src/soothe_plugins/
+├── sample_echo/        # Minimal test subagent (example plugin)
+├── paperscout/         # ArXiv paper recommendations
+├── [your_plugin]/      # Your future plugin
+└── [another_plugin]/   # Another future plugin
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines on adding new plugins.
+
+### Plugin Template
+
+Use the provided template to create new plugins:
+
+```bash
+cp -r src/soothe_plugins/.plugin_template src/soothe_plugins/your_plugin
+```
+
+## Development
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/mirasoth/soothe-plugins.git
+cd soothe-plugins
+
+# Install in development mode
+pip install -e ".[dev]"
+```
+
+### Testing
+
+```bash
+# Run all tests
+pytest tests/
+
+# Run specific plugin tests
+pytest tests/test_paperscout/
+
+# With coverage
+pytest tests/ --cov=src/soothe_plugins
+```
+
+### Code Quality
+
+```bash
+# Format code
+ruff format src/ tests/
+
+# Lint code
+ruff check --fix src/ tests/
+```
+
+## Documentation
+
+- **README.md**: This file - overview and quick start
+- **CONTRIBUTING.md**: How to add new plugins
+- **docs/RFC-601-community-agents.md**: Architecture RFC for community agents
+- **src/soothe_plugins/.plugin_template/**: Template for new plugins
+
+## Architecture
+
+Each plugin follows the RFC-0018 plugin system:
+
+```
+Plugin Package
+├── __init__.py          # @plugin, @subagent, @tool decorators
+├── events.py            # Custom events (optional)
+├── models.py            # Data models
+├── state.py             # Agent state (if subagent)
+├── implementation.py    # Core logic
+└── README.md            # Plugin documentation
+```
+
+## License
+
+MIT

soothe_plugins-0.2.6.dist-info/RECORD

@@ -0,0 +1,30 @@
+soothe_plugins/README.md,sha256=_Zxkk8M7Cqe5vD60Z0T-4OXvIS4sydSLdZhzpeaRplY,4312
+soothe_plugins/__init__.py,sha256=4_-Sz-iC7PxbNfG3cjgNgC62yhzFn48QxpikgN5sFV8,530
+soothe_plugins/_paths.py,sha256=mO5hoASEcieUlPS5EnNA_2HSo22qU8SVWPl59HBHQFw,431
+soothe_plugins/.plugin_template/PLUGIN_TEMPLATE.md,sha256=c0MK31gFaNpTP_V9WD1gquX5VbVvzMa1O7JM-6RVybM,1177
+soothe_plugins/.plugin_template/README.md.template,sha256=BfnETFlVGZhD3rrOG-iAk4OR1Hpwy-lHfasAHadaZX0,2512
+soothe_plugins/.plugin_template/__init__.py.template,sha256=NU9eL7kOOxj4oT5UthU0QrzKW7-kwSSzMSDso8ex2m0,4637
+soothe_plugins/.plugin_template/events.py.template,sha256=ZYfw01sM-__lO-9JSRs4H0KZyvAKP5lAok9XKRODc3w,819
+soothe_plugins/.plugin_template/implementation.py.template,sha256=fvEEnnDOpoxrfBVkmnT_Os2I2gyVZwUY40W_NpzrHng,2465
+soothe_plugins/.plugin_template/models.py.template,sha256=YJzyxWzJ2kphx3R8YP-swDKs4ccQ_IfX_F1gbOPOYx8,870
+soothe_plugins/.plugin_template/state.py.template,sha256=RK52DrLuqdvHJ-kvh-NyveKthkxnE9zat1RvJ7JGQNY,1286
+soothe_plugins/sample_echo/__init__.py,sha256=B8shMGwfyvVC_BJJud9GRQ5qZUVmhkargx_Uqv3M3Wg,1300
+soothe_plugins/sample_echo/implementation.py,sha256=3QX4AYafW3Dkr-MNty_s7kDvl8rLDAzClAUMkoSsqt4,1461
+soothe_plugins/skillify/__init__.py,sha256=GwW1u-XFiJWU8LydKxLziDfVY6PV3H0jE0YmEBFcew4,10391
+soothe_plugins/skillify/events.py,sha256=cgbQelACusfoLjQpvXVjN53k2xveymAeX2iUeHys1lQ,4798
+soothe_plugins/skillify/indexer.py,sha256=LPfeoQLmKrSsFYGD26ledAaTQ1qTdw2S7jtkJnumK8M,11403
+soothe_plugins/skillify/models.py,sha256=KtXPC0mv_xhH8aVzZvcC31gn34RQpNEILQX46GjEF0s,856
+soothe_plugins/skillify/retriever.py,sha256=bJ2IBH2TQoHGzeJyUgIrE9shZnbcpJ3uw1AKOvtKkN4,5616
+soothe_plugins/skillify/warehouse.py,sha256=7dU5S3TGIE3S86xrKRCP8RoQ2go1QPLeqKSg7nnSwL0,3165
+soothe_plugins/weaver/__init__.py,sha256=OF8947t-F0IcmRcc6PFTdi_BLXRKQlRo_McDAeLBaQI,19386
+soothe_plugins/weaver/analyzer.py,sha256=8-z-uVNXlzfOVe3KgqZFxG5pV2YRRENWVwuOY4CHu3g,2547
+soothe_plugins/weaver/composer.py,sha256=GEpBya4E_D8M-yq2XiVnYQqiUgDaJRE8zkaKAr_C-j0,11215
+soothe_plugins/weaver/events.py,sha256=9BYPVk7prXLie0OgnD5U6tBZ-KfncifE7pbvru-Z7Vs,7362
+soothe_plugins/weaver/generator.py,sha256=XYdrcz5SMMQSxeQan7J9EsRwVCMVG6rg6RvGxq41K2A,6405
+soothe_plugins/weaver/models.py,sha256=dj4sZMzWuRTMf-RX3oHX4K0zAQ_1H1kJSfBwTsg-w70,4606
+soothe_plugins/weaver/registry.py,sha256=i7AgL1Y2PenPZhGFopJDvUfJFQboDR2LCJi5nbnPiuI,7394
+soothe_plugins/weaver/reuse.py,sha256=4OKXA6bEvfiTc1IL32uDSs1S9AXewydwrZVOdQfMjmA,4963
+soothe_plugins-0.2.6.dist-info/METADATA,sha256=12YIHnk8w_pvdwe1zuzsRHshNqusrKRGH3fzGqyeHd0,4538
+soothe_plugins-0.2.6.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+soothe_plugins-0.2.6.dist-info/entry_points.txt,sha256=1iy5q2222SIhGdn718PLfJ8VNxg5hBrgRZ79TMd9Yck,169
+soothe_plugins-0.2.6.dist-info/RECORD,,

soothe_plugins-0.2.6.dist-info/WHEEL

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

soothe_plugins-0.2.6.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[soothe.plugins]
+sample_echo = soothe_plugins.sample_echo:SampleEchoPlugin
+skillify = soothe_plugins.skillify:SkillifyPlugin
+weaver = soothe_plugins.weaver:WeaverPlugin