odl-kernel 0.9.0__tar.gz

odl_kernel-0.9.0/LICENSE

@@ -0,0 +1,62 @@
+Business Source License 1.1
+
+Parameters:
+
+Licensor:           Centillion System, Inc.
+Licensed Work:      The ODL Kernel Software and its associated source code, 
+                    as provided in this repository.
+Change Date:        Two years from the date of each version release.
+Change License:     Apache License, Version 2.0
+Additional Use Grant:
+
+You may make use of the Software in a production environment provided that you 
+meet ALL of the following conditions:
+
+(a) No Managed ODL Service: You do not use the Software to provide a "Managed ODL Service" 
+    to third parties. A "Managed ODL Service" is defined as any service, platform, 
+    or product where the primary value proposition derives from the execution, 
+    orchestration, or hosting of ODL code, OR where the capabilities, logic 
+    (including the signature-based ID generation), or outputs of the Software 
+    are exposed via an API or any other interface, functioning as a substitute 
+    for the Software itself.
+
+(b) Revenue Limit and Entity Scope: The total annual gross revenue of your 
+    Organization (as defined below) is less than $10,000,000 USD (Ten Million 
+    United States Dollars). 
+    - "Organization" includes the legal entity using the Software and all of 
+      its affiliates, parents, and subsidiaries. 
+    - Revenue shall be calculated on a "Consolidated Basis" including all 
+      entities under common "Control" (ownership of more than 50% of voting 
+      interests or the power to direct management).
+    - If your Organization exceeds this threshold, you must obtain a 
+      Commercial License from the Licensor.
+
+(c) Academic and Individual Use: Notwithstanding conditions (a) and (b), 
+    if you are an academic institution, non-profit research organization, or 
+    an individual using the Software strictly for non-commercial research, 
+    educational, or personal self-improvement purposes, you may use the 
+    Software without charge.
+
+(d) Audit Rights: Upon reasonable suspicion of non-compliance with the revenue 
+    limit, the Licensor reserves the right to request, and you agree to provide, 
+    official financial documentation (such as audited annual reports) to 
+    verify the consolidated gross revenue of your Organization.
+
+---
+
+License Text:
+
+The Licensor hereby grants you the right to copy, modify, create derivative 
+works, redistribute, and make use of the Licensed Work, provided that such 
+use is not a production use, and further provided that any such production 
+use complies with the Additional Use Grant above.
+
+All copies of the Licensed Work and any derivative works made by you must 
+contain this license document and all copyright notices.
+
+Effective upon the Change Date, or the fifth anniversary of the first public 
+release of the Licensed Work, whichever is earlier, the Licensor hereby 
+grants you rights under the Change License, and the restrictions set forth 
+in this License shall no longer apply.
+
+Copyright (c) 2026 Centillion System, Inc. All rights reserved.

odl_kernel-0.9.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: odl-kernel
+Version: 0.9.0
+Summary: ODL (Organizational Definition Language) Execution Kernel & Physics
+License: BUSL-1.1
+License-File: LICENSE
+Author: Centillion System, Inc.
+Author-email: odl@centsys.jp
+Requires-Python: >=3.11,<4.0
+Classifier: License :: Other/Proprietary 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: Programming Language :: Python :: 3.14
+Requires-Dist: odl-lang (>=0.9.0,<0.10.0)
+Requires-Dist: pydantic (>=2.0,<3.0)
+Project-URL: Homepage, https://centsys.jp/
+Project-URL: Repository, https://github.com/co-crea/odl-kernel
+Description-Content-Type: text/markdown
+
+# ODL Kernel
+
+<p align="center">
+  <strong>The Physics Engine for AI Agents.</strong><br>
+  Deterministic Foundation for Probabilistic Systems.
+</p>
+
+<p align="center">
+  <a href="#license--commercial-terms"><img src="https://img.shields.io/badge/License-BSL_1.1-orange.svg" alt="License"></a>
+  <img src="https://img.shields.io/badge/Python-3.11+-blue.svg" alt="Python Version">
+  <img src="https://img.shields.io/badge/Coverage-100%25-green.svg" alt="Coverage">
+  <img src="https://img.shields.io/badge/Determinism-UUID_v5-blueviolet.svg" alt="Determinism">
+</p>
+
+---
+
+**The Deterministic Execution Engine for Organizational Definition Language (ODL).**
+
+`odl-kernel` is the reference implementation of the ODL "Physics." It is a stateless, pure-functional execution engine designed to manage the lifecycle of autonomous AI agents and human-AI collaboration.
+
+Unlike traditional workflow engines, the Kernel acts as a rigorous state machine that derives the next organizational state and necessary side effects (Commands) based on a provided `JobSnapshot` and `KernelEvent`.
+
+## ⚛️ Core Principles
+
+* **Functional Core:** The Kernel is side-effect-free. It does not access databases or external APIs directly; it only calculates the transition.
+* **Deterministic Identity:** Every node is assigned a mathematically derived UUID v5 based on its structural path. This ensures that process IDs remain consistent across restarts, replays, and forks.
+* **Deep Analyze:** The engine performs fixed-point iteration to advance states until a stable equilibrium is reached, allowing the host to observe only meaningful state changes.
+
+
+
+## Usage
+
+The integration follows a strict **"Load -> Analyze -> Apply"** pattern.
+
+```python
+import odl_kernel
+from odl_kernel.types import JobSnapshot, KernelEvent
+
+# 1. Prepare Input (Stateless)
+snapshot = JobSnapshot(job=job_data, nodes=node_map)
+event = KernelEvent(type="TICK", occurred_at=datetime.now())
+
+# 2. Analyze (Pure Physics)
+# The Kernel calculates the next state and required commands.
+result = odl_kernel.analyze(snapshot, event)
+
+# 3. Apply Output (Side Effects)
+# The Host runtime persists updated_nodes and executes result.commands.
+my_db.save(result.updated_nodes)
+```
+
+> 📖 **Deep Dive: The Physics of Execution**
+>
+> The code above is just the entry point. The Kernel is a stateless, pure-functional "Physics Engine" designed to run inside your application.
+>
+> To understand the architecture (**Functional Core / Imperative Shell**) and how to implement the **Host Runtime** (Database persistence, LLM API connections, and the Event Loop), please read the full implementation guide:
+>
+> **[USAGE.md: The Host Implementation Guide](./USAGE.md)**
+
+## 🏗 Relationship with `odl-lang`
+
+This repository provides the execution environment. To define the organizational structures and compile them into an executable format, use the **[odl-lang](https://github.com/co-crea/odl-lang)** library.
+
+## 🌹 Dedication
+
+**Dedicated to the memory of Prof. Kazuhisa Seta, and to all researchers who continue to push the boundaries of Knowledge Engineering in his lineage.**
+
+## ⚖️ License & Commercial Terms
+
+Copyright (c) 2026 Centillion System, Inc. All rights reserved.
+
+* **Licensor:** Centillion System, Inc. (https://centsys.jp/)
+* **Contact:** odl@centsys.jp
+
+This software is licensed under the **Business Source License 1.1 (BSL 1.1)**.
+
+### Additional Use Grant
+You are authorized to use this software in a production environment under the following conditions:
+1. **Managed Service Restriction:** You may not use this software to provide a competing "Managed ODL Service" to third parties.
+2. **Revenue Limit:** Use is free for individuals, academic institutions, and organizations with annual gross revenue less than **$10,000,000 USD**.
+3. **Transition to OSS:** This software will convert to **Apache License 2.0** exactly two years after the release date of each version.
+
+Organizations exceeding the revenue limit or wishing to provide managed services must obtain a commercial license from Centillion System, Inc.
+
+---
+*The deterministic ID generation logic in this Kernel uses a proprietary signature for provenance tracking and identity verification.*

odl_kernel-0.9.0/README.md

@@ -0,0 +1,86 @@
+# ODL Kernel
+
+<p align="center">
+  <strong>The Physics Engine for AI Agents.</strong><br>
+  Deterministic Foundation for Probabilistic Systems.
+</p>
+
+<p align="center">
+  <a href="#license--commercial-terms"><img src="https://img.shields.io/badge/License-BSL_1.1-orange.svg" alt="License"></a>
+  <img src="https://img.shields.io/badge/Python-3.11+-blue.svg" alt="Python Version">
+  <img src="https://img.shields.io/badge/Coverage-100%25-green.svg" alt="Coverage">
+  <img src="https://img.shields.io/badge/Determinism-UUID_v5-blueviolet.svg" alt="Determinism">
+</p>
+
+---
+
+**The Deterministic Execution Engine for Organizational Definition Language (ODL).**
+
+`odl-kernel` is the reference implementation of the ODL "Physics." It is a stateless, pure-functional execution engine designed to manage the lifecycle of autonomous AI agents and human-AI collaboration.
+
+Unlike traditional workflow engines, the Kernel acts as a rigorous state machine that derives the next organizational state and necessary side effects (Commands) based on a provided `JobSnapshot` and `KernelEvent`.
+
+## ⚛️ Core Principles
+
+* **Functional Core:** The Kernel is side-effect-free. It does not access databases or external APIs directly; it only calculates the transition.
+* **Deterministic Identity:** Every node is assigned a mathematically derived UUID v5 based on its structural path. This ensures that process IDs remain consistent across restarts, replays, and forks.
+* **Deep Analyze:** The engine performs fixed-point iteration to advance states until a stable equilibrium is reached, allowing the host to observe only meaningful state changes.
+
+
+
+## Usage
+
+The integration follows a strict **"Load -> Analyze -> Apply"** pattern.
+
+```python
+import odl_kernel
+from odl_kernel.types import JobSnapshot, KernelEvent
+
+# 1. Prepare Input (Stateless)
+snapshot = JobSnapshot(job=job_data, nodes=node_map)
+event = KernelEvent(type="TICK", occurred_at=datetime.now())
+
+# 2. Analyze (Pure Physics)
+# The Kernel calculates the next state and required commands.
+result = odl_kernel.analyze(snapshot, event)
+
+# 3. Apply Output (Side Effects)
+# The Host runtime persists updated_nodes and executes result.commands.
+my_db.save(result.updated_nodes)
+```
+
+> 📖 **Deep Dive: The Physics of Execution**
+>
+> The code above is just the entry point. The Kernel is a stateless, pure-functional "Physics Engine" designed to run inside your application.
+>
+> To understand the architecture (**Functional Core / Imperative Shell**) and how to implement the **Host Runtime** (Database persistence, LLM API connections, and the Event Loop), please read the full implementation guide:
+>
+> **[USAGE.md: The Host Implementation Guide](./USAGE.md)**
+
+## 🏗 Relationship with `odl-lang`
+
+This repository provides the execution environment. To define the organizational structures and compile them into an executable format, use the **[odl-lang](https://github.com/co-crea/odl-lang)** library.
+
+## 🌹 Dedication
+
+**Dedicated to the memory of Prof. Kazuhisa Seta, and to all researchers who continue to push the boundaries of Knowledge Engineering in his lineage.**
+
+## ⚖️ License & Commercial Terms
+
+Copyright (c) 2026 Centillion System, Inc. All rights reserved.
+
+* **Licensor:** Centillion System, Inc. (https://centsys.jp/)
+* **Contact:** odl@centsys.jp
+
+This software is licensed under the **Business Source License 1.1 (BSL 1.1)**.
+
+### Additional Use Grant
+You are authorized to use this software in a production environment under the following conditions:
+1. **Managed Service Restriction:** You may not use this software to provide a competing "Managed ODL Service" to third parties.
+2. **Revenue Limit:** Use is free for individuals, academic institutions, and organizations with annual gross revenue less than **$10,000,000 USD**.
+3. **Transition to OSS:** This software will convert to **Apache License 2.0** exactly two years after the release date of each version.
+
+Organizations exceeding the revenue limit or wishing to provide managed services must obtain a commercial license from Centillion System, Inc.
+
+---
+*The deterministic ID generation logic in this Kernel uses a proprietary signature for provenance tracking and identity verification.*

odl_kernel-0.9.0/pyproject.toml

@@ -0,0 +1,30 @@
+[tool.poetry]
+name = "odl-kernel"
+version = "0.9.0"
+license = "BUSL-1.1"
+description = "ODL (Organizational Definition Language) Execution Kernel & Physics"
+authors = ["Centillion System, Inc. <odl@centsys.jp>"]
+readme = "README.md"
+packages = [{include = "odl_kernel", from = "src"}]
+
+[tool.poetry.dependencies]
+python = ">=3.11,<4.0"
+pydantic = "^2.0"
+odl-lang = "^0.9.0"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "*"
+
+[tool.pytest.ini_options]
+pythonpath = [
+    "src",
+    "."
+]
+
+[tool.poetry.urls]
+"Homepage" = "https://centsys.jp/"
+"Repository" = "https://github.com/co-crea/odl-kernel"

odl_kernel-0.9.0/src/odl_kernel/__init__.py

@@ -0,0 +1,46 @@
+# Copyright (c) 2026 Centillion System, Inc. All rights reserved.
+#
+# This software is licensed under the Business Source License 1.1 (BSL 1.1).
+# For full license terms, see the LICENSE file in the root directory.
+#
+# This software is "Source Available" but contains certain restrictions on
+# commercial use and managed service provision. 
+# Usage by organizations with gross revenue exceeding $10M USD requires 
+# a commercial license.
+
+from .types import (
+    JobSnapshot, 
+    KernelEvent, 
+    AnalysisResult
+)
+from .engine.analyzer import OdlAnalyzer
+from .engine.logic.introspection import NodeInspector
+
+# Main Entry Point
+def analyze(snapshot: JobSnapshot, event: KernelEvent) -> AnalysisResult:
+    """
+    ODLカーネルのメインエントリポイント。
+    物理法則に基づき、入力されたSnapshotとEventから次のアクションを導出する純粋関数。
+    
+    Usage:
+        import odl_kernel
+        result = odl_kernel.analyze(snapshot, event)
+    
+    Args:
+        snapshot: 現在のジョブの状態 (DBからロード済み)
+        event: トリガーとなった事象 (Tick, ActionCompleted等)
+        
+    Returns:
+        AnalysisResult: 実行すべきコマンドと、更新されたノード状態
+    """
+    # Analyzerはステートレスなので、都度インスタンス化して実行する
+    # これにより odl.compile(...) と同じような関数的な使い心地を提供する
+    return OdlAnalyzer().analyze(snapshot, event)
+
+__all__ = [
+    "analyze",
+    "JobSnapshot",
+    "KernelEvent", 
+    "AnalysisResult",
+    "NodeInspector"
+]