184 lines
8 KiB
Python
184 lines
8 KiB
Python
"""Tests for automatic live database-contract injection into Leo turns."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import importlib.util
|
|
import json
|
|
import subprocess
|
|
from pathlib import Path
|
|
from types import SimpleNamespace
|
|
|
|
ROOT = Path(__file__).resolve().parents[1]
|
|
PLUGIN = ROOT / "hermes-agent" / "leoclean-plugins" / "vps" / "leo-db-context" / "__init__.py"
|
|
|
|
|
|
def load_plugin():
|
|
spec = importlib.util.spec_from_file_location("leo_db_context_plugin", PLUGIN)
|
|
assert spec and spec.loader
|
|
module = importlib.util.module_from_spec(spec)
|
|
spec.loader.exec_module(module)
|
|
return module
|
|
|
|
|
|
def test_plugin_registers_generation_and_delivery_hooks() -> None:
|
|
module = load_plugin()
|
|
registered = []
|
|
module.register(SimpleNamespace(register_hook=lambda name, callback: registered.append((name, callback))))
|
|
assert [name for name, _callback in registered] == ["pre_llm_call", "post_llm_call"]
|
|
|
|
|
|
def test_plugin_injects_only_operational_contracts_and_writes_redacted_trace(
|
|
tmp_path: Path, monkeypatch
|
|
) -> None:
|
|
module = load_plugin()
|
|
home = tmp_path / "profile"
|
|
kb_tool = home / "bin" / "kb_tool.py"
|
|
kb_tool.parent.mkdir(parents=True)
|
|
kb_tool.write_text("# fixture\n", encoding="utf-8")
|
|
trace = tmp_path / "trace.jsonl"
|
|
monkeypatch.setenv("LEO_DB_CONTEXT_TRACE_PATH", str(trace))
|
|
payload = {
|
|
"query": "must not be injected",
|
|
"claims": [{"text": "must not be injected"}],
|
|
"operational_contracts": [
|
|
{"id": "reply_budget", "hard_max_words": 220},
|
|
{"id": "source_intake", "capability_tier": "build-local compiler only"},
|
|
],
|
|
"compiled_response": "must not be injected either",
|
|
}
|
|
calls = []
|
|
|
|
def fake_runner(command, **kwargs):
|
|
calls.append((command, kwargs))
|
|
return subprocess.CompletedProcess(command, 0, stdout=json.dumps(payload), stderr="")
|
|
|
|
context = module.build_database_context(
|
|
"operator secret-shaped but nonsecret message", hermes_home=home, runner=fake_runner
|
|
)
|
|
|
|
assert "reply_budget" in context
|
|
assert "source_intake" in context
|
|
assert "build-local compiler only" in context
|
|
assert "must not be injected" not in context
|
|
assert "operator secret-shaped" not in trace.read_text(encoding="utf-8")
|
|
record = json.loads(trace.read_text(encoding="utf-8"))
|
|
assert record["status"] == "ok"
|
|
assert record["injected"] is True
|
|
assert record["contract_ids"] == ["reply_budget", "source_intake"]
|
|
command, kwargs = calls[0]
|
|
assert command[2:5] == ["--local", "context", "operator secret-shaped but nonsecret message"]
|
|
assert command[-6:] == ["--limit", "0", "--context-limit", "0", "--format", "json"]
|
|
assert kwargs["timeout"] == module.DEFAULT_TIMEOUT_SECONDS
|
|
|
|
|
|
def test_plugin_replaces_contract_violating_draft_with_compiled_db_response(
|
|
tmp_path: Path, monkeypatch
|
|
) -> None:
|
|
module = load_plugin()
|
|
home = tmp_path / "profile"
|
|
kb_tool = home / "bin" / "kb_tool.py"
|
|
kb_tool.parent.mkdir(parents=True)
|
|
kb_tool.write_text("# fixture\n", encoding="utf-8")
|
|
trace = tmp_path / "trace.jsonl"
|
|
monkeypatch.setenv("HERMES_HOME", str(home))
|
|
monkeypatch.setenv("LEO_DB_CONTEXT_TRACE_PATH", str(trace))
|
|
compiled = (
|
|
"Map claims with sources and evidence; put the framework in reasoning_tools, the rule in "
|
|
"behavioral_rules, an evaluative gate in governance_gates, and stage the belief correction. "
|
|
"Stage one pending_review proposal. approve_claim applies only claims, sources, evidence, edges, and "
|
|
"reasoning_tools; approve_claim supports neither behavioral_rules nor governance_gates. Belief updates "
|
|
"remain staged until a separate reviewed apply capability exists. Receipt: proposal applied_at and "
|
|
"postflight row readback."
|
|
)
|
|
payload = {
|
|
"operational_contracts": [
|
|
{"id": "reply_budget", "hard_max_words": 200},
|
|
{"id": "mixed_packet_composition"},
|
|
],
|
|
"compiled_response": compiled,
|
|
}
|
|
|
|
def fake_runner(command, **_kwargs):
|
|
return subprocess.CompletedProcess(command, 0, stdout=json.dumps(payload), stderr="")
|
|
|
|
snapshot = module._load_database_snapshot("compose this packet", hermes_home=home, runner=fake_runner)
|
|
module._store_snapshot("session-1", snapshot)
|
|
result = module._post_llm_call(
|
|
session_id="session-1",
|
|
user_message="compose this packet",
|
|
assistant_response=(
|
|
"Claims, sources, evidence, reasoning_tools, behavioral_rules, governance_gates, and beliefs. "
|
|
"Stage and review a proposal, then apply only the supported collections (claims, sources, evidence, "
|
|
"edges, reasoning_tools, belief updates). approve_claim does not cover behavioral_rules or "
|
|
"governance_gates; use a separate reviewed apply path. Receipt: applied_at and postflight readback."
|
|
),
|
|
)
|
|
|
|
assert result == {"assistant_response": compiled}
|
|
records = [json.loads(line) for line in trace.read_text(encoding="utf-8").splitlines()]
|
|
assert records[-1]["event"] == "post_llm_call"
|
|
assert records[-1]["transformed"] is True
|
|
assert records[-1]["issues"] == [
|
|
"unsupported_collection_listed_as_supported",
|
|
"unsupported_collection_listed_in_apply",
|
|
]
|
|
assert "compose this packet" not in trace.read_text(encoding="utf-8")
|
|
|
|
|
|
def test_plugin_keeps_contract_valid_draft(tmp_path: Path) -> None:
|
|
module = load_plugin()
|
|
home = tmp_path / "profile"
|
|
kb_tool = home / "bin" / "kb_tool.py"
|
|
kb_tool.parent.mkdir(parents=True)
|
|
kb_tool.write_text("# fixture\n", encoding="utf-8")
|
|
valid = (
|
|
"Map claims with sources and evidence; put the framework in reasoning_tools, the rule in "
|
|
"behavioral_rules, an evaluative gate in governance_gates, and stage the belief correction. "
|
|
"Stage one pending_review proposal. approve_claim applies only claims, sources, evidence, edges, and "
|
|
"reasoning_tools; approve_claim supports neither behavioral_rules nor governance_gates. Belief updates "
|
|
"remain staged until a separate reviewed apply capability exists. Receipt: proposal applied_at and "
|
|
"postflight row readback."
|
|
)
|
|
payload = {
|
|
"operational_contracts": [
|
|
{"id": "reply_budget", "hard_max_words": 200},
|
|
{"id": "mixed_packet_composition"},
|
|
],
|
|
"compiled_response": valid,
|
|
}
|
|
|
|
def fake_runner(command, **_kwargs):
|
|
return subprocess.CompletedProcess(command, 0, stdout=json.dumps(payload), stderr="")
|
|
|
|
snapshot = module._load_database_snapshot("compose this packet", hermes_home=home, runner=fake_runner)
|
|
module._store_snapshot("session-2", snapshot)
|
|
assert module._post_llm_call(
|
|
session_id="session-2", user_message="compose this packet", assistant_response=valid
|
|
) is None
|
|
|
|
|
|
def test_plugin_fails_closed_when_database_contract_lookup_fails(tmp_path: Path) -> None:
|
|
module = load_plugin()
|
|
home = tmp_path / "profile"
|
|
kb_tool = home / "bin" / "kb_tool.py"
|
|
kb_tool.parent.mkdir(parents=True)
|
|
kb_tool.write_text("# fixture\n", encoding="utf-8")
|
|
|
|
def fake_runner(command, **_kwargs):
|
|
return subprocess.CompletedProcess(command, 9, stdout="", stderr="database unavailable")
|
|
|
|
context = module.build_database_context("What is live?", hermes_home=home, runner=fake_runner)
|
|
assert 'status="unavailable"' in context
|
|
assert "Do not infer current schema" in context
|
|
assert "database unavailable" not in context
|
|
|
|
|
|
def test_handler_harness_retains_database_context_proof_fields() -> None:
|
|
source = (ROOT / "scripts" / "run_leo_direct_claim_handler_suite.py").read_text(encoding="utf-8")
|
|
assert "LEO_DB_CONTEXT_TRACE_PATH" in source
|
|
assert '"database_context_trace"' in source
|
|
assert '"database_context_injection_count"' in source
|
|
assert '"database_context_all_ok"' in source
|
|
assert '"database_response_validation_count"' in source
|
|
assert '"database_response_validation_all_ok"' in source
|
|
assert '"database_response_transform_count"' in source
|