cosmergon-decider-tree 2.0.2__tar.gz

cosmergon_decider_tree-2.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RKO Consult UG (haftungsbeschraenkt)
+
+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.

cosmergon_decider_tree-2.0.2/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: cosmergon-decider-tree
+Version: 2.0.2
+Summary: Rule-based tree decider for Cosmergon api-agents (deterministic, no inference)
+Author-email: "RKO Consult UG (haftungsbeschraenkt)" <contact@cosmergon.de>
+License: MIT
+Keywords: cosmergon,ai-agent,decider,behavior-tree,rule-based
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cosmergon-agent<0.16,>=0.15.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Dynamic: license-file
+
+# cosmergon-decider-tree
+
+Rule-based tree decider for Cosmergon api-agents — deterministic, no
+inference, latency well under 10 ms.
+
+Implements the `Decider` protocol from `cosmergon-agent` 0.13.0+.
+Branch-Logik aus `docs/konzepte/konzept-default-entscheidungsbaum-api-agents.md`
+§3 plus Pet-S165-L1-Conditional-Sequences als Schwellen-Inspiration.
+
+## Architektur
+
+```
+state (GameState)
+   │
+   ├─ persona = state.persona_type or "scientist"
+   ▼
+PERSONA_TREES[persona]   (list of (condition, action_fn) tuples)
+   │
+   ├─ first matching condition wins
+   ▼
+(action, params)           ← optional Compass-Modulation
+```
+
+Sechs Persona-Bäume (scientist / warrior / expansionist / trader /
+diplomat / farmer), gemeinsamer Survival-Header (critical-energy → wait,
+0-fields → create_field, empty-field → place_cells block) und
+gemeinsamer Wachstums-Fallback (fewest-cells, wait).
+
+## Usage
+
+```python
+from cosmergon_decider_tree import TreeDecider
+
+decider = TreeDecider()  # no config — fully deterministic
+
+# In runner-loop:
+async with CosmergonAgent(api_key=..., base_url="https://cosmergon.com") as agent:
+    while True:
+        await agent.refresh_state()
+        action, params = await decider.decide(agent.state)
+        await agent.act(action, **params)
+        await asyncio.sleep(90)
+```
+
+## Vorteile
+
+- **Deterministisch:** identischer State → identische Action.
+- **Schnell:** <10 ms pro `decide()`-Call (lambda-evaluation, kein
+  Modell-Load).
+- **Interpretierbar:** Branch-Liste ist lesbar, Debug-fähig.
+- **Offline-fähig:** kein LLM-Provider, kein Modell-File, läuft auf
+  jedem ARM-Linux mit Python 3.10+.
+
+## Begrenzung
+
+- **Lernt nicht:** Cosmergon-Mechanik-Änderungen (neue Action-Klassen,
+  geänderte Konditions-Schwellen) brechen Tree → klare Versions-Bindung
+  an SDK + Backend-Stand.
+- **Persona-Bäume teils ähnlich:** Konzept §3.2 hat das adressiert,
+  Differenzierung muss strukturiert sichtbar sein.
+
+## Tests
+
+```bash
+cd research/decider-cluster/decider-tree
+pip install -e '.[dev]'
+pytest -q
+```

cosmergon_decider_tree-2.0.2/README.md

@@ -0,0 +1,68 @@
+# cosmergon-decider-tree
+
+Rule-based tree decider for Cosmergon api-agents — deterministic, no
+inference, latency well under 10 ms.
+
+Implements the `Decider` protocol from `cosmergon-agent` 0.13.0+.
+Branch-Logik aus `docs/konzepte/konzept-default-entscheidungsbaum-api-agents.md`
+§3 plus Pet-S165-L1-Conditional-Sequences als Schwellen-Inspiration.
+
+## Architektur
+
+```
+state (GameState)
+   │
+   ├─ persona = state.persona_type or "scientist"
+   ▼
+PERSONA_TREES[persona]   (list of (condition, action_fn) tuples)
+   │
+   ├─ first matching condition wins
+   ▼
+(action, params)           ← optional Compass-Modulation
+```
+
+Sechs Persona-Bäume (scientist / warrior / expansionist / trader /
+diplomat / farmer), gemeinsamer Survival-Header (critical-energy → wait,
+0-fields → create_field, empty-field → place_cells block) und
+gemeinsamer Wachstums-Fallback (fewest-cells, wait).
+
+## Usage
+
+```python
+from cosmergon_decider_tree import TreeDecider
+
+decider = TreeDecider()  # no config — fully deterministic
+
+# In runner-loop:
+async with CosmergonAgent(api_key=..., base_url="https://cosmergon.com") as agent:
+    while True:
+        await agent.refresh_state()
+        action, params = await decider.decide(agent.state)
+        await agent.act(action, **params)
+        await asyncio.sleep(90)
+```
+
+## Vorteile
+
+- **Deterministisch:** identischer State → identische Action.
+- **Schnell:** <10 ms pro `decide()`-Call (lambda-evaluation, kein
+  Modell-Load).
+- **Interpretierbar:** Branch-Liste ist lesbar, Debug-fähig.
+- **Offline-fähig:** kein LLM-Provider, kein Modell-File, läuft auf
+  jedem ARM-Linux mit Python 3.10+.
+
+## Begrenzung
+
+- **Lernt nicht:** Cosmergon-Mechanik-Änderungen (neue Action-Klassen,
+  geänderte Konditions-Schwellen) brechen Tree → klare Versions-Bindung
+  an SDK + Backend-Stand.
+- **Persona-Bäume teils ähnlich:** Konzept §3.2 hat das adressiert,
+  Differenzierung muss strukturiert sichtbar sein.
+
+## Tests
+
+```bash
+cd research/decider-cluster/decider-tree
+pip install -e '.[dev]'
+pytest -q
+```

cosmergon_decider_tree-2.0.2/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cosmergon-decider-tree"
+version = "2.0.2"
+description = "Rule-based tree decider for Cosmergon api-agents (deterministic, no inference)"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "RKO Consult UG (haftungsbeschraenkt)", email = "contact@cosmergon.de" },
+]
+keywords = ["cosmergon", "ai-agent", "decider", "behavior-tree", "rule-based"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "cosmergon-agent>=0.15.0,<0.16",
+]
+
+[project.entry-points."cosmergon.deciders"]
+tree = "cosmergon_decider_tree:TreeDecider"
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "pytest-asyncio>=0.23"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

cosmergon_decider_tree-2.0.2/setup.cfg

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

cosmergon_decider_tree-2.0.2/src/cosmergon_decider_tree/__init__.py

@@ -0,0 +1,15 @@
+"""cosmergon-decider-tree — rule-based decision tree for Cosmergon api-agents.
+
+Implements the SDK 0.13.0 Decider protocol with deterministic rule-based
+logic — no inference, no model. Mirrors the Pet's S165 conditional
+persona-sequences but in pure Python lambdas, suitable for Lab-Cluster
+B.2 baseline (S165) and as a fallback decider when LLM-providers fail.
+"""
+
+from __future__ import annotations
+
+from cosmergon_decider_tree.decider import TreeDecider
+
+__version__ = "1.1.1"
+
+__all__ = ["TreeDecider", "__version__"]