File size: 11,161 Bytes
1a70cc9 7ba97b7 1a70cc9 3753865 22f2abd afa8138 3753865 1a70cc9 7ba97b7 55e43b7 7ba97b7 1a70cc9 3753865 1a70cc9 589695d a03fcd1 589695d 174f05a 589695d 1a70cc9 461eb1f 1a70cc9 afa8138 1a70cc9 7ba97b7 22f2abd 7ba97b7 22f2abd 7ba97b7 4945749 7ba97b7 22f2abd 7ba97b7 55e43b7 053707d 55e43b7 22f2abd 55e43b7 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 | """Every registered quant agent has one concrete structured I/O binding."""
from typing import get_args
import pytest
from pydantic import BaseModel
from polyhedra.agents.quant.analysis_contracts import TrendPayload
from polyhedra.agents.quant.asset_contracts import (
BTCAssetAnalysis, GLDAssetAnalysis, QQQAssetAnalysis, SPYAssetAnalysis,
)
from polyhedra.agents.quant.decision_contracts import QuantStrategistLLMPayload
from polyhedra.agents.quant.io_registry import (
QUANT_IO_REGISTRY, _project_asset_input, _project_options_summary,
_project_quantstrategist_input,
_project_trend_input, quant_artifact_schema, quant_io_binding,
)
from polyhedra.agents.quant.market_data_contracts import DataFetcherInput
from polyhedra.agents.quant.product_contracts import PublisherPayload
from polyhedra.core.quant_contracts import AgentName
AT = "2026-09-10T12:00:00Z"
class ProjectionInput(BaseModel):
dependencies: dict
optional_context: dict | None = None
def test_registry_covers_each_agent_exactly_once():
assert set(QUANT_IO_REGISTRY) == set(get_args(AgentName))
assert len(QUANT_IO_REGISTRY) == 19
for name, binding in QUANT_IO_REGISTRY.items():
assert binding.agent == name
assert binding.input_schema.model_json_schema()["type"] == "object"
assert binding.output_schema.model_json_schema()["type"] == "object"
artifact = quant_artifact_schema(name)
assert artifact.model_json_schema()["type"] == "object"
assert "run_id" in artifact.model_fields
def test_prompts_are_agent_specific_and_accept_only_typed_input():
prompts = [binding.prompt_template for binding in QUANT_IO_REGISTRY.values()]
assert len(set(prompts)) == 19
for name, binding in QUANT_IO_REGISTRY.items():
assert name in binding.prompt_template
assert binding.prompt_template.count("{input_json}") == 1
assert "do not add routing fields" in binding.prompt_template
assert "for BASELINE, every delta_state must be NOT_COMPARED" in binding.prompt_template
assert "include either a JSON Pointer field_path" in binding.prompt_template
assert "do not copy a nested reference unless" in binding.prompt_template
assert "containing record in the direct dependency artifact" in binding.prompt_template
assert "use a visible zero-based JSON Pointer" in binding.prompt_template
event_prompt = quant_io_binding("MarketEventWatcher").prompt_template
assert "DataFetcher NEWS provider as the approved event feed" in event_prompt
assert "code EXTERNAL_EVENT_FEED_NOT_CONFIGURED" in event_prompt
assert "into the context's source_refs list" in event_prompt
macro_prompt = quant_io_binding("MacroContextWatcher").prompt_template
assert "direct current MarketEventWatcher or OptionsFlowWatcher artifact" in macro_prompt
trend_prompt = quant_io_binding("TrendAnalyst").prompt_template
assert "exact per-ticker MarketDataArtifact identity" in trend_prompt
assert "Do not reconstruct an artifact identity" in trend_prompt
unusual_prompt = quant_io_binding("UnusualEventDetector").prompt_template
assert "exact direct artifact identity of MarketEventWatcher" in unusual_prompt
assert "never copy a nested DataFetcher" in unusual_prompt
fetch_input = DataFetcherInput(
run_id="run1", session_id="session1", run_mode="BASELINE",
as_of=AT, ticker_scope=["SPY"], baseline_refs={},
)
prompt = quant_io_binding("DataFetcher").build_prompt(fetch_input)
assert '"ticker_scope": [' in prompt
with pytest.raises(TypeError):
quant_io_binding("TrendAnalyst").build_prompt(fetch_input)
def test_specialized_payload_schemas_keep_distinct_ticker_types():
expected = {
"BTCAnalyst": BTCAssetAnalysis,
"SPYAnalyst": SPYAssetAnalysis,
"QQQAnalyst": QQQAssetAnalysis,
"GLDAnalyst": GLDAssetAnalysis,
}
for agent, analysis_type in expected.items():
annotation = QUANT_IO_REGISTRY[agent].output_schema.model_fields["analysis"].annotation
assert annotation is analysis_type
def test_strategy_binding_excludes_runtime_owned_performance_fields():
schema = quant_io_binding("QuantStrategist").output_schema
assert schema is QuantStrategistLLMPayload
assert "committee_weights" not in schema.model_fields
assert "committee_aggregation" not in schema.model_fields
assert "weight_updates" not in schema.model_fields
def test_strategy_prompt_names_complete_contract_and_distinguishes_votes():
prompt = quant_io_binding("QuantStrategist").prompt_template
for field in (
"outcome", "proposals", "no_trade_or_watch_rationale", "exclusions",
"committee_votes", "proposal_updates", "evidence_refs", "data_gaps",
):
assert field in prompt
assert "committee members are not proposals" in prompt
assert "Include every field" in prompt
def test_strategy_projection_keeps_decisions_without_provenance_envelopes():
source = ProjectionInput(
dependencies={"risk": {
"schema_version": "8.0",
"artifact_id": "risk-1",
"input_refs": [{"path": "backtest_results.json"}],
"data_gaps": [{
"component": "BACKTEST",
"code": "NOT_TESTABLE",
"message": "No historical engine.",
"record_refs": [{"field_path": "/payload/results/0"}],
}],
"payload": {"signal_assessments": [{
"signal_id": "spy-signal",
"verdict": "REJECT",
"rationale": "Not testable.",
"evidence_refs": [{"field_path": "/payload/results/0"}],
}]},
}},
optional_context={"committee_performance": {
"weights": {"risk_skeptic": 1.0},
"recorded_at": AT,
}},
)
projected = _project_quantstrategist_input(source)
risk = projected["dependencies"]["risk"]
assert "schema_version" not in risk
assert "artifact_id" not in risk
assert "input_refs" not in risk
assert risk["payload"]["signal_assessments"] == [{
"signal_id": "spy-signal",
"verdict": "REJECT",
"rationale": "Not testable.",
}]
assert risk["data_gaps"][0]["message"] == "No historical engine."
assert "record_refs" not in risk["data_gaps"][0]
assert projected["optional_context"]["committee_performance"]["weights"] == {
"risk_skeptic": 1.0,
}
def test_fixed_markdown_renderer_is_deterministic():
trend = TrendPayload(ticker_analyses=[])
rendered = quant_io_binding("TrendAnalyst").render_markdown(trend)
assert rendered == "# Trend Analyst\n\n## Ticker Analyses\n\nNone recorded.\n"
def test_publisher_renderer_returns_validated_slack_body():
payload = PublisherPayload(
headline="SPY has no validated setup", market_summary="Evidence remains mixed.",
what_to_watch=[], displayed_proposal_ids=[], no_proposal_reason="TRUE_NO_TRADE",
disclaimer="Paper trading simulation only. Not financial advice.",
approximate_word_count=12,
slack_rendering="*SPY has no validated setup*\nEvidence remains mixed.\n",
delta_state="NOT_COMPARED", evidence_refs=[], data_gaps=[],
)
assert quant_io_binding("Publisher").render_markdown(payload) == payload.slack_rendering
def test_registry_is_read_only_and_rejects_unknown_name():
with pytest.raises(TypeError):
QUANT_IO_REGISTRY["Unknown"] = QUANT_IO_REGISTRY["DataFetcher"]
with pytest.raises(KeyError):
quant_io_binding("Unknown")
def test_downstream_options_projection_omits_only_raw_contract_rows():
for agent in ("MacroContextWatcher", "UnusualEventDetector", "EventRouter"):
assert quant_io_binding(agent).prompt_projector is _project_options_summary
for agent in ("SPYAnalyst", "QQQAnalyst", "GLDAnalyst"):
assert quant_io_binding(agent).prompt_projector is _project_asset_input
assert quant_io_binding("OptionsFlowWatcher").prompt_projector is None
source = ProjectionInput(dependencies={"options_flow": {
"artifact_id": "options-1",
"payload": {"ticker_results": [{
"ticker": "SPY",
"contracts": [{"contract_symbol": "SPY-CALL"}],
"market_context": {"contracts_sampled": 1},
"flow_candidates": [{
"candidate_id": "candidate-1",
"evidence_refs": [{"field_path": "/contracts/0"}],
}],
"unusual_flows": [],
"capabilities": {"trade_side": False},
"data_gaps": [],
}]},
}})
projected = _project_options_summary(source)
result = projected["dependencies"]["options_flow"]["payload"]["ticker_results"][0]
assert "contracts" not in result
assert "raw_contracts" not in result
assert projected["prompt_only"] == {
"non_citable_options_contract_counts": {"SPY": 1},
}
assert result["market_context"] == {"contracts_sampled": 1}
assert result["flow_candidates"] == [{"candidate_id": "candidate-1"}]
assert source.dependencies["options_flow"]["payload"]["ticker_results"][0]["contracts"]
def test_trend_projection_omits_nontechnical_records_only():
source = ProjectionInput(dependencies={"market_data": [{
"ticker": "SPY",
"ohlcv": [{"close": 650.0}],
"indicators": {"points": [{"rsi_14": 58.0}]},
"news": [{"headline": "Not used for technical analysis"}],
"earnings": [{"fiscal_period": "Q3"}],
"provenance": [{"component": "OHLCV"}],
"quality_issues": [],
}]})
projected = _project_trend_input(source)
market = projected["dependencies"]["market_data"][0]
assert "news" not in market
assert "earnings" not in market
assert market["omitted_nontechnical_records"] == {"news": 1, "earnings": 1}
assert market["ohlcv"] == [{"close": 650.0}]
assert market["indicators"] == {"points": [{"rsi_14": 58.0}]}
assert source.dependencies["market_data"][0]["news"]
def test_specialized_options_projection_reads_optional_context():
source = ProjectionInput(dependencies={}, optional_context={"options_flow": {
"artifact_id": "options-1",
"payload": {"ticker_results": [{
"ticker": "SPY",
"contracts": [
{"contract_symbol": f"SPY-CALL-{index}"} for index in range(100)
],
"market_context": {"contracts_sampled": 100},
"flow_candidates": [],
"unusual_flows": [],
"capabilities": {"trade_side": False},
"data_gaps": [],
}]},
}})
projected = _project_options_summary(source)
result = projected["optional_context"]["options_flow"]["payload"]["ticker_results"][0]
assert "contracts" not in result
assert "raw_contracts" not in result
assert projected["prompt_only"]["non_citable_options_contract_counts"]["SPY"] == 100
assert result["market_context"] == {"contracts_sampled": 100}
assert source.optional_context["options_flow"]["payload"]["ticker_results"][0]["contracts"]
|