reactifact 0.15.2__tar.gz → 0.15.3__tar.gz

{reactifact-0.15.2/reactifact.egg-info → reactifact-0.15.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactifact
-Version: 0.15.2
+Version: 0.15.3
 Summary: Reactive, artifact-driven agent runtime: agents transform versioned, typed, provenance-aware artifacts inside an evolving context
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/bzdvdn/reactifact
@@ -323,6 +323,23 @@ by hand. Run it yourself: `uv run python -m examples.ledger.main`.
 - **Viz & CLI** — Mermaid `blueprint`/`context_to_mermaid`/`trace_to_mermaid`;
   `reactifact` with `graph`/`context`/`trace`/`replay`/`branch`.
 
+## Agent Skills
+
+reactifact ships official **Agent Skills** — reusable instructions that teach a
+coding agent (Claude Code, Cursor, Codex, Copilot, …) how to build *with*
+reactifact. They're bundled with the package, so they always match your version:
+
+```bash
+python -m reactifact skills list                    # what is available
+python -m reactifact skills install                 # -> .agents/skills/
+python -m reactifact skills install --target both    # + .claude/skills/
+```
+
+Skills: `reactifact` (mental model), `reactifact-agents`, `reactifact-llm`,
+`reactifact-rag`, `reactifact-testing`, `reactifact-eval`,
+`reactifact-observability`, `reactifact-from-langchain` — see
+[Agent skills](docs/en/skills.md).
+
 ## Run a demo
 
 Offline-capable, no API keys required (deterministic fallbacks):

{reactifact-0.15.2 → reactifact-0.15.3}/README.md

@@ -277,6 +277,23 @@ by hand. Run it yourself: `uv run python -m examples.ledger.main`.
 - **Viz & CLI** — Mermaid `blueprint`/`context_to_mermaid`/`trace_to_mermaid`;
   `reactifact` with `graph`/`context`/`trace`/`replay`/`branch`.
 
+## Agent Skills
+
+reactifact ships official **Agent Skills** — reusable instructions that teach a
+coding agent (Claude Code, Cursor, Codex, Copilot, …) how to build *with*
+reactifact. They're bundled with the package, so they always match your version:
+
+```bash
+python -m reactifact skills list                    # what is available
+python -m reactifact skills install                 # -> .agents/skills/
+python -m reactifact skills install --target both    # + .claude/skills/
+```
+
+Skills: `reactifact` (mental model), `reactifact-agents`, `reactifact-llm`,
+`reactifact-rag`, `reactifact-testing`, `reactifact-eval`,
+`reactifact-observability`, `reactifact-from-langchain` — see
+[Agent skills](docs/en/skills.md).
+
 ## Run a demo
 
 Offline-capable, no API keys required (deterministic fallbacks):

{reactifact-0.15.2 → reactifact-0.15.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "reactifact"
-version = "0.15.2"
+version = "0.15.3"
 description = "Reactive, artifact-driven agent runtime: agents transform versioned, typed, provenance-aware artifacts inside an evolving context"
 readme = "README.md"
 requires-python = ">=3.11"

{reactifact-0.15.2 → reactifact-0.15.3}/reactifact/__init__.py

@@ -51,7 +51,7 @@ from .tools import FunctionTool, Tool, ToolOutput, tool
 from .triggers import Trigger
 from .types import register as register_type
 
-__version__ = "0.15.2"
+__version__ = "0.15.3"
 
 __all__ = [
     "Agent",

{reactifact-0.15.2 → reactifact-0.15.3}/reactifact/audit.py

@@ -47,10 +47,30 @@ DEFAULT_RELATIONS: tuple[str, ...] = (
 )
 
 
+def _transient_fields(model: type[BaseModel]) -> set[str]:
+    """Field names a model declares as transactional *envelope*, not state.
+
+    A model lists them as ``transient_fields: ClassVar[frozenset[str]]``
+    (e.g. `PendingAction.dispatched_at`, `PendingQuestion.resolved_at`).
+    Wall-clock transitions are excluded from the content hash so an otherwise
+    identical state doesn't hash differently run to run — the *fact* of the
+    transition stays hashed (`status`/`resolution`); only its timestamp drops.
+    """
+    names = getattr(model, "transient_fields", ())
+    return set(names) if names else set()
+
+
 def _canonical(value: Any) -> str:
-    """Canonical JSON for hashing (sorted keys; pydantic models dumped)."""
+    """Canonical JSON for hashing (sorted keys; pydantic models dumped).
+
+    A model's `transient_fields` are dropped before hashing — envelope, not
+    state. Everything else is serialized exactly as before, so a state with no
+    transient fields hashes the same as it always did.
+    """
     if isinstance(value, BaseModel):
-        payload: Any = value.model_dump(mode="json")
+        payload: Any = value.model_dump(
+            mode="json", exclude=_transient_fields(type(value)) or None
+        )
     else:
         payload = value
     return json.dumps(payload, sort_keys=True, ensure_ascii=False, default=str)

{reactifact-0.15.2 → reactifact-0.15.3}/reactifact/interrupt.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from datetime import datetime
-from typing import Any, Literal
+from typing import Any, ClassVar, Literal
 
 from pydantic import BaseModel, Field
 
@@ -21,6 +21,11 @@ class PendingQuestion(BaseModel):
     resolution: str | None = None
     resolved_at: datetime | None = None
 
+    #: Wall-clock fields excluded from `context_hash` (transactional envelope,
+    #: not state): a resolved question's *state* is `resolution`, the moment it
+    #: was resolved is not something two equivalent runs must agree on.
+    transient_fields: ClassVar[frozenset[str]] = frozenset({"resolved_at"})
+
 
 class PendingAction(BaseModel):
     """An outbound side effect awaiting dispatch (outbox, §42/§55/§59).
@@ -52,3 +57,9 @@ class PendingAction(BaseModel):
     attempts: int = 0
     dispatched_at: datetime | None = None
     error: str | None = None
+
+    #: Wall-clock field excluded from `context_hash` (transactional envelope,
+    #: not state): the *fact* that the action dispatched (`status`/`error`/
+    #: `attempts`) is hashed, the moment it happened is not — so an outbox run
+    #: stays run-to-run reproducible.
+    transient_fields: ClassVar[frozenset[str]] = frozenset({"dispatched_at"})

{reactifact-0.15.2 → reactifact-0.15.3/reactifact.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reactifact
-Version: 0.15.2
+Version: 0.15.3
 Summary: Reactive, artifact-driven agent runtime: agents transform versioned, typed, provenance-aware artifacts inside an evolving context
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/bzdvdn/reactifact
@@ -323,6 +323,23 @@ by hand. Run it yourself: `uv run python -m examples.ledger.main`.
 - **Viz & CLI** — Mermaid `blueprint`/`context_to_mermaid`/`trace_to_mermaid`;
   `reactifact` with `graph`/`context`/`trace`/`replay`/`branch`.
 
+## Agent Skills
+
+reactifact ships official **Agent Skills** — reusable instructions that teach a
+coding agent (Claude Code, Cursor, Codex, Copilot, …) how to build *with*
+reactifact. They're bundled with the package, so they always match your version:
+
+```bash
+python -m reactifact skills list                    # what is available
+python -m reactifact skills install                 # -> .agents/skills/
+python -m reactifact skills install --target both    # + .claude/skills/
+```
+
+Skills: `reactifact` (mental model), `reactifact-agents`, `reactifact-llm`,
+`reactifact-rag`, `reactifact-testing`, `reactifact-eval`,
+`reactifact-observability`, `reactifact-from-langchain` — see
+[Agent skills](docs/en/skills.md).
+
 ## Run a demo
 
 Offline-capable, no API keys required (deterministic fallbacks):

{reactifact-0.15.2 → reactifact-0.15.3}/tests/test_audit.py

@@ -88,6 +88,39 @@ def test_context_hash_changes_when_state_changes():
     assert context_hash(before) != context_hash(after)
 
 
+def test_transient_wall_clock_fields_are_excluded_from_the_hash():
+    """`dispatched_at`/`resolved_at` are envelope, not state: two records that
+    differ only in those timestamps hash the same; a real state change does not."""
+    from datetime import UTC, datetime, timedelta
+
+    from reactifact import PendingAction
+    from reactifact.interrupt import PendingQuestion
+
+    now = datetime.now(UTC)
+    later = now + timedelta(seconds=5)
+
+    dispatched = PendingAction(
+        kind="notify", idempotency_key="k", status="dispatched", dispatched_at=now
+    )
+    dispatched_later = PendingAction(
+        kind="notify", idempotency_key="k", status="dispatched", dispatched_at=later
+    )
+    assert data_hash(dispatched) == data_hash(dispatched_later)
+
+    failed = PendingAction(
+        kind="notify", idempotency_key="k", status="failed", dispatched_at=now
+    )
+    assert data_hash(dispatched) != data_hash(failed)
+
+    answered = PendingQuestion(
+        question="q", answered=True, resolution="yes", resolved_at=now
+    )
+    answered_later = PendingQuestion(
+        question="q", answered=True, resolution="yes", resolved_at=later
+    )
+    assert data_hash(answered) == data_hash(answered_later)
+
+
 # --- report ----------------------------------------------------------------- #
 
 

{reactifact-0.15.2 → reactifact-0.15.3}/tests/test_outbox.py

@@ -13,6 +13,7 @@ from examples.outbox.main import (
     same_generation,
 )
 from reactifact import PendingAction
+from reactifact.audit import context_hash
 
 
 def test_happy_path_sends_once():
@@ -63,3 +64,12 @@ def test_app_owned_retry_absorbs_transient_failures():
     assert status == "dispatched"
     assert attempts == 0  # the wrapper absorbed the failures, runtime saw one outcome
     assert log.keys() == ["notify:77"]
+
+
+def test_dispatch_is_reproducible_despite_wall_clock():
+    """A dispatched outbox run hashes identically run to run: the transition is
+    hashed, its wall-clock timestamp (`dispatched_at`) is not."""
+    first, _ = asyncio.run(happy_path())
+    second, _ = asyncio.run(happy_path())
+    assert first.get(ACTION).data.status == "dispatched"
+    assert context_hash(first) == context_hash(second)