rfnry-engine 0.1.0__tar.gz

rfnry_engine-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+.venv/
+__pycache__/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+dist/
+.env*
+node_modules/
+examples/**/uv.lock
+examples/**/.work/
+docs/plans/
+docs/superpowers/
+.superpowers/
+.worktrees

rfnry_engine-0.1.0/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.5
+Name: rfnry-engine
+Version: 0.1.0
+Summary: Agent harness with built-in dataset generation
+Author-email: rfnry <contact@rfnry.dev>
+License-Expression: MIT
+Requires-Python: >=3.12
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: regex>=2026.9.10
+Provides-Extra: dev
+Requires-Dist: asyncpg<1.0,>=0.31.0; extra == 'dev'
+Requires-Dist: httpx>=0.28.1; extra == 'dev'
+Requires-Dist: mypy>=2.3.1; extra == 'dev'
+Requires-Dist: poethepoet>=0.48.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.4.0; extra == 'dev'
+Requires-Dist: pytest>=9.1.1; extra == 'dev'
+Requires-Dist: ruff>=0.16.4; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.12; extra == 'dev'
+Requires-Dist: types-regex>=2026.9.10.20260911; extra == 'dev'
+Provides-Extra: postgres
+Requires-Dist: asyncpg<1.0,>=0.31.0; extra == 'postgres'
+Description-Content-Type: text/markdown
+
+# rfnry-engine
+
+Agent harness with built-in dataset generation.
+
+[`docs/engine.md`](https://github.com/rfnry/engine/blob/main/docs/engine.md).
+[`docs/api.md`](https://github.com/rfnry/engine/blob/main/docs/api.md).

rfnry_engine-0.1.0/README.md

@@ -0,0 +1,6 @@
+# rfnry-engine
+
+Agent harness with built-in dataset generation.
+
+[`docs/engine.md`](https://github.com/rfnry/engine/blob/main/docs/engine.md).
+[`docs/api.md`](https://github.com/rfnry/engine/blob/main/docs/api.md).

rfnry_engine-0.1.0/pyproject.toml

@@ -0,0 +1,72 @@
+[project]
+name = "rfnry-engine"
+version = "0.1.0"
+description = "Agent harness with built-in dataset generation"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+authors = [{name = "rfnry", email = "contact@rfnry.dev"}]
+dependencies = [
+    "pydantic>=2.13.4",
+    "pyyaml>=6.0.3",
+    "regex>=2026.9.10",
+]
+
+[project.optional-dependencies]
+postgres = ["asyncpg>=0.31.0,<1.0"]
+dev = [
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "ruff>=0.16.4",
+    "mypy>=2.3.1",
+    "poethepoet>=0.48.0",
+    "asyncpg>=0.31.0,<1.0",
+    "types-PyYAML>=6.0.12",
+    "types-regex>=2026.9.10.20260911",
+    "httpx>=0.28.1",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/rfnry_engine"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+pythonpath = ["src", "tests"]
+markers = [
+    "live: calls real models (set RFNRY_LIVE_ADAPTERS to a module path)",
+]
+addopts = "-m 'not live'"
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "B", "UP", "SIM"]
+ignore = ["E501"]
+
+[tool.ruff.lint.isort]
+combine-as-imports = true
+
+[tool.poe.tasks]
+format = { cmd = "ruff format src tests" }
+check = { cmd = "ruff check src tests" }
+"check:fix" = { cmd = "ruff check --fix src tests" }
+typecheck = { cmd = "mypy" }
+test = { cmd = "pytest -q" }
+"test:e2e" = { cmd = "pytest -q -m live" }
+
+[tool.mypy]
+strict = true
+files = ["src/rfnry_engine", "tests"]
+
+[[tool.mypy.overrides]]
+module = "asyncpg.*"
+ignore_missing_imports = true

rfnry_engine-0.1.0/src/rfnry_engine/__init__.py

@@ -0,0 +1,152 @@
+from rfnry_engine.engine import AgentInfo, Engine
+from rfnry_engine.errors import (
+    ConfigurationError,
+    DelegationDepthError,
+    DelegationLoopError,
+    EngineException,
+    InputError,
+    ModelError,
+    NotFoundError,
+    RunawayError,
+    StorageError,
+)
+from rfnry_engine.jail import Jail
+from rfnry_engine.models import (
+    Answer,
+    AnswerLike,
+    Audio,
+    Check,
+    CheckAnswer,
+    Choice,
+    ChoiceAnswer,
+    Content,
+    Decided,
+    DecidedLike,
+    DecisionModel,
+    Document,
+    GenerationModel,
+    HistoryLike,
+    Image,
+    Message,
+    Part,
+    Question,
+    QuestionLike,
+    Reply,
+    ReplyLike,
+    Score,
+    ScoreAnswer,
+    State,
+    StreamingGenerationModel,
+    Text,
+    ToolCall,
+    ToolSpec,
+    Usage,
+    confidence,
+)
+from rfnry_engine.records import (
+    Decision,
+    Event,
+    Fingerprint,
+    Generation,
+    Run,
+    Step,
+    TextDelta,
+    ToolCallStarted,
+    ToolResultReady,
+)
+from rfnry_engine.refinery.export import Bucket
+from rfnry_engine.refinery.holdout import is_holdout
+from rfnry_engine.refinery.labels import (
+    Conflict,
+    Exported,
+    Label,
+    Labeled,
+    Outcome,
+    Replay,
+    Review,
+)
+from rfnry_engine.refinery.postgres import PostgresStorage
+from rfnry_engine.refinery.refinery import Refinery
+from rfnry_engine.refinery.storage import LabelRow, RunRow, Storage
+from rfnry_engine.stop import Stop
+from rfnry_engine.tools.engine_tools import EngineTools
+from rfnry_engine.tools.tools import Tool, Tools
+from rfnry_engine.tools.workspace import Backend, Local, Process, Workspace
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "AgentInfo",
+    "Answer",
+    "AnswerLike",
+    "Bucket",
+    "Check",
+    "CheckAnswer",
+    "Choice",
+    "ChoiceAnswer",
+    "ConfigurationError",
+    "Conflict",
+    "Decided",
+    "DecidedLike",
+    "Decision",
+    "DecisionModel",
+    "DelegationDepthError",
+    "DelegationLoopError",
+    "Engine",
+    "EngineException",
+    "EngineTools",
+    "Event",
+    "Exported",
+    "Fingerprint",
+    "Generation",
+    "GenerationModel",
+    "HistoryLike",
+    "InputError",
+    "Jail",
+    "Label",
+    "LabelRow",
+    "Labeled",
+    "Message",
+    "ModelError",
+    "NotFoundError",
+    "Outcome",
+    "PostgresStorage",
+    "Question",
+    "QuestionLike",
+    "Refinery",
+    "Replay",
+    "Reply",
+    "ReplyLike",
+    "Review",
+    "Run",
+    "RunRow",
+    "RunawayError",
+    "Score",
+    "ScoreAnswer",
+    "State",
+    "Step",
+    "Stop",
+    "Storage",
+    "StorageError",
+    "StreamingGenerationModel",
+    "TextDelta",
+    "Tool",
+    "ToolCall",
+    "ToolCallStarted",
+    "ToolResultReady",
+    "ToolSpec",
+    "Tools",
+    "Usage",
+    "Workspace",
+    "Backend",
+    "Local",
+    "Process",
+    "confidence",
+    "is_holdout",
+    "Text",
+    "Image",
+    "Audio",
+    "Document",
+    "Part",
+    "Content",
+]

rfnry_engine-0.1.0/src/rfnry_engine/bundle.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from rfnry_engine.models import ToolSpec
+from rfnry_engine.tree import AgentSpec
+
+
+def _read(path: Path) -> str:
+    return path.read_text(encoding="utf-8").strip() if path.is_file() else ""
+
+
+def build_bundle(
+    spec: AgentSpec,
+    *,
+    task: str | None,
+    tools: list[ToolSpec],
+    agents: list[AgentSpec],
+    context: str | None,
+) -> str:
+    sections = [
+        ("AGENT", spec.body),
+        ("TASK", "" if task is None else _read(spec.root / "tasks" / f"{task}.md")),
+        ("FILES", spec.listing),
+        (
+            "TOOLS",
+            "\n".join(
+                f"- {t.name}: {t.description.splitlines()[0] if t.description else ''}"
+                for t in tools
+            ),
+        ),
+        ("AGENTS", "\n".join(f"- {a.name}: {a.description}" for a in agents)),
+        ("CONTEXT", (context or "").strip()),
+    ]
+    return "\n\n".join(f"<<<{label}>>>\n{body}" for label, body in sections if body)

rfnry_engine-0.1.0/src/rfnry_engine/chain.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+
+import hashlib
+import json
+
+from rfnry_engine.models import Message, Part, ToolSpec
+
+
+def opening(model: str | None, system: str, tools: list[ToolSpec], preload: list[Part]) -> bytes:
+    head = {
+        "model": model,
+        "system": system,
+        "tools": [tool.model_dump(mode="json") for tool in tools],
+        "preload": [part.model_dump(mode="json") for part in preload],
+    }
+    return hashlib.sha256(json.dumps(head, sort_keys=True, ensure_ascii=False).encode()).digest()
+
+
+def extend(digest: bytes, message: Message) -> bytes:
+    said = message.model_dump(mode="json", exclude={"prefix", "usage"}, fallback=repr)
+    return hashlib.sha256(
+        digest + json.dumps(said, sort_keys=True, ensure_ascii=False).encode()
+    ).digest()
+
+
+def mark(digest: bytes) -> str:
+    return digest.hex()[:16]
+
+
+def settle(history: list[Message], digest: bytes) -> tuple[list[Message], bytes]:
+    sent: list[Message] = []
+    for message in history:
+        if message.reasoning is not None and message.prefix != mark(digest):
+            message = message.model_copy(update={"reasoning": None})
+        sent.append(message)
+        digest = extend(digest, message)
+    return sent, digest