pactree 0.0.1__py3-none-any.whl

pactree/__init__.py

@@ -0,0 +1,18 @@
+"""Pactree Python shim.
+
+The real Pactree runtime is being extracted from Egregore. This package is a
+small, import-safe placeholder for the future standalone API.
+"""
+
+from __future__ import annotations
+
+from ._version import __version__
+from .context import Context
+from .engine import EngineUnavailableError, engine_available
+
+__all__ = [
+    "Context",
+    "EngineUnavailableError",
+    "__version__",
+    "engine_available",
+]

pactree/_version.py

@@ -0,0 +1,3 @@
+"""Package version."""
+
+__version__ = "0.0.1"

pactree/context.py

@@ -0,0 +1,16 @@
+"""Context facade placeholder."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .engine import EngineUnavailableError
+
+
+class Context:
+    """Placeholder for the Pactree context API."""
+
+    def __init__(self, *_: Any, **__: Any) -> None:
+        raise EngineUnavailableError(
+            "pactree 0.0.1 exposes the package namespace; the Pactree engine is not bundled yet"
+        )

pactree/engine.py

@@ -0,0 +1,13 @@
+"""Pactree engine availability."""
+
+from __future__ import annotations
+
+
+class EngineUnavailableError(RuntimeError):
+    """Raised when an early package release needs the Pactree engine."""
+
+
+def engine_available() -> bool:
+    """Return whether the Pactree engine is bundled with this Python package."""
+
+    return False

pactree/file.py

@@ -0,0 +1,25 @@
+"""File API placeholder for `.pact` storage."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .engine import EngineUnavailableError
+
+
+def _not_wired() -> EngineUnavailableError:
+    return EngineUnavailableError(
+        "pactree 0.0.1 exposes the package namespace; the Pactree engine is not bundled yet"
+    )
+
+
+def info(*_: Any, **__: Any) -> dict[str, Any]:
+    raise _not_wired()
+
+
+def materialize(*_: Any, **__: Any) -> dict[str, Any]:
+    raise _not_wired()
+
+
+def validate(*_: Any, **__: Any) -> dict[str, Any]:
+    raise _not_wired()

pactree/py.typed

@@ -0,0 +1 @@
+

pactree-0.0.1.dist-info/METADATA

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: pactree
+Version: 0.0.1
+Summary: Deterministic context trees for AI agents and applications.
+Project-URL: Homepage, https://github.com/earldennison/egregore-v2
+Project-URL: Repository, https://github.com/earldennison/egregore-v2
+Author: Earl Dennison Tan
+License-Expression: MIT
+Keywords: agent,context,pact,pactree,tree
+Classifier: Development Status :: 2 - Pre-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 :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# Pactree
+
+Pactree is a deterministic context-tree substrate for AI agents and
+applications. It is designed to make context explicit: ordered, queryable,
+branchable, compact on disk, and stable across Python and Rust runtimes.
+
+The project centers on the `.pact` file format and a Rust engine for
+context trees, operations, selectors, projections, traces, and rewind/fork
+workflows. The Python package provides the ergonomic host API that applications
+use to build, inspect, and persist those trees.
+
+Core goals:
+
+- deterministic tree layout for agent context
+- compact content-addressed storage
+- branch, rewind, and what-if workflows
+- provider-facing projections without losing substrate structure
+- a clean Python API backed by a canonical Rust implementation
+
+This is an early `0.0.x` release while the standalone package is being split
+out. The public namespace is available now; the Pactree engine binary and Python
+bindings will land in the next extraction releases.

pactree-0.0.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+pactree/__init__.py,sha256=97XtoI4z3ZMBmfN3qGfN08pMPDofil0rJz701tbHCDk,432
+pactree/_version.py,sha256=XP1F6gZ-vbdP-QabBKGHC0Zs1gYKePp6oqlBkM-HNoY,46
+pactree/context.py,sha256=JuZeUIOOq16HqaafLz3QjF3a2wfFhn_0Bd_8y95Irhk,404
+pactree/engine.py,sha256=eVdLALQTtwCPiUnJkdR2uNRn8OIhUHYIbejXRiGDOu8,323
+pactree/file.py,sha256=OKEpYtPJnKLtajWdRhA2a7i68BcXs4NNSg7IyG-XEys,562
+pactree/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+pactree-0.0.1.dist-info/METADATA,sha256=TXWdFaidESDcpd4hbHnWXsuUurXbD6W0kVAwH4ehiUM,1805
+pactree-0.0.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+pactree-0.0.1.dist-info/RECORD,,

pactree-0.0.1.dist-info/WHEEL

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