v0.2.1: reconcile GitHub main with published PyPI 0.2.0 surface

.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+.env
+.DS_Store

README.md

@@ -16,65 +16,68 @@ pip install langchain-agentoracle
 
 ---
 
-## Quickstart
+## Quickstart — gate your agent on verified claims
 
 ```python
-from langchain_agentoracle import AgentOracleTool
-from langchain.agents import initialize_agent, AgentType
-from langchain_openai import ChatOpenAI
+from langchain_agentoracle import AgentOracleEvaluateTool
 
-llm = ChatOpenAI(model="gpt-4")
+verifier = AgentOracleEvaluateTool()
 
-tools = [AgentOracleTool()]
-
-agent = initialize_agent(
-    tools,
-    llm,
-    agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION,
-    verbose=True
+agent_output = (
+    "OpenAI released GPT-4 in March 2023. "
+    "Bitcoin was invented by Elon Musk in 2009."
 )
 
-agent.run(
-    "Research the latest AI agent frameworks and verify the claims before summarizing"
-)
+report = verifier._run(content=agent_output, min_confidence=0.8)
+print(report)
+
+if "[REFUTED]" in report:
+    print("→ Hold — one or more claims failed verification")
+else:
+    print("→ Proceed")
 ```
 
 That's it. Your agent now verifies before acting.
 
 ---
 
-## What comes back
-
-```json
-{
-  "overall_confidence": 0.87,
-  "recommendation": "act",
-  "claims": [
-    {
-      "claim": "LangGraph leads agent frameworks in 2026",
-      "verdict": "supported",
-      "confidence": 0.94,
-      "evidence": "Confirmed across 4 independent sources"
-    },
-    {
-      "claim": "OpenAI acquired Anthropic in early 2026",
-      "verdict": "refuted",
-      "confidence": 0.04,
-      "correction": "Anthropic remains independent as of April 2026"
-    }
-  ]
-}
+## Tools
+
+| Tool | Endpoint | Cost |
+|------|----------|------|
+| `AgentOracleEvaluateTool` | `/evaluate` | $0.01 USDC per evaluation |
+| `AgentOracleVerifyGateTool` | `/verify-gate` | Free (beta) |
+| `AgentOraclePreviewTool` | `/preview` | Free, 10/hr |
+| `AgentOracleResearchTool` | `/research` | $0.02 USDC |
+| `AgentOracleDeepResearchTool` | `/deep-research` | $0.10 USDC (Sonar Pro) |
+| `AgentOracleBatchResearchTool` | `/research/batch` | $0.02 USDC × N |
+
+Bundle them all into an agent:
+
+```python
+from langchain_agentoracle import get_agentoracle_tools
+
+tools = get_agentoracle_tools()                       # all 6 tools
+tools = get_agentoracle_tools(include_paid=False)     # free tools only
 ```
 
 ---
 
-## Recommendation logic
+## What `/evaluate` returns
+
+```text
+EVALUATION RESULT
+Overall confidence: 0.51
+Recommendation: ACT
+Claims found: 3 | Supported: 2 | Refuted: 1 | Unverifiable: 0
+Sources used: sonar, sonar-pro, adversarial, gemma-4
 
-| Score | Recommendation | What your agent should do |
-|-------|---------------|--------------------------|
-| > 0.8 | `act` | Proceed — claims verified |
-| 0.5–0.8 | `verify` | Pause — needs secondary check |
-| < 0.5 | `reject` | Discard — evidence insufficient |
+CLAIMS:
+  ✓ [SUPPORTED] (1.00) OpenAI released GPT-4 in March 2023
+  ✗ [REFUTED] (0.83) Bitcoin was invented by Elon Musk in 2009
+     Correction: Bitcoin was invented by the pseudonymous Satoshi Nakamoto.
+  ✓ [SUPPORTED] (1.00) The Eiffel Tower is located in Paris, France
+```
 
 ---
 
@@ -83,7 +86,7 @@ That's it. Your agent now verifies before acting.
 Every evaluation runs through 4 independent sources in parallel:
 
 1. **Sonar** — real-time web research
-2. **Sonar Pro** — deep multi-step analysis  
+2. **Sonar Pro** — deep multi-step analysis
 3. **Adversarial** — actively tries to disprove the claim
 4. **Gemma 4** — claim decomposition and confidence calibration
 
@@ -99,22 +102,32 @@ curl -X POST https://agentoracle.co/preview \
   -d '{"query": "OpenAI acquired Anthropic in 2026"}'
 ```
 
-20 free requests per hour. No wallet, no API key, no account.
+10 free previews per hour. No wallet, no API key, no account.
 
 ---
 
 ## Pricing
 
-| Endpoint | Price | What it does |
-|----------|-------|-------------|
-| `/preview` | Free | Truncated results, no payment needed |
-| `/evaluate` | $0.01/claim | Full per-claim verification + verdicts |
-| `/research` | $0.02/query | Real-time research + verification |
+| Endpoint | Price |
+|----------|-------|
+| `/preview` | Free |
+| `/verify-gate` | Free (beta) |
+| `/evaluate` | $0.01 USDC per evaluation |
+| `/research` | $0.02 USDC per query |
+| `/deep-research` | $0.10 USDC per query |
+| `/research/batch` | $0.02 USDC × N queries |
 
 Payments via [x402 protocol](https://x402.org) — USDC on Base, SKALE (gasless), or Stellar. No subscriptions. No minimums. No API keys.
 
 ---
 
+## Backwards compatibility
+
+- `AgentOracleTool` (v0.1 name) is kept as an alias of `AgentOracleEvaluateTool`. Existing `from langchain_agentoracle import AgentOracleTool` code continues to work — calls are now routed through the full 4-source evaluation instead of the old preview wrapper.
+- Error handling hardened in 0.2.1: 402 payment-required responses return structured x402 guidance, 429 returns `retry_after`, 500+ retries with exponential backoff, and `/evaluate` now defaults to a 120s timeout to accommodate multi-source tail latency.
+
+---
+
 ## Related
 
 - [agentoracle.co](https://agentoracle.co) — main site + live demo

langchain_agentoracle/__init__.py

@@ -1,3 +1,24 @@
-from .tool import AgentOracleTool
+"""LangChain integration for AgentOracle — trust verification tools for AI agents."""
+from langchain_agentoracle.tools import (
+    AgentOracleTool,  # legacy alias → AgentOracleEvaluateTool
+    AgentOracleEvaluateTool,
+    AgentOracleVerifyGateTool,
+    AgentOraclePreviewTool,
+    AgentOracleResearchTool,
+    AgentOracleDeepResearchTool,
+    AgentOracleBatchResearchTool,
+    get_agentoracle_tools,
+)
 
-__all__ = ["AgentOracleTool"]
+__all__ = [
+    "AgentOracleTool",
+    "AgentOracleEvaluateTool",
+    "AgentOracleVerifyGateTool",
+    "AgentOraclePreviewTool",
+    "AgentOracleResearchTool",
+    "AgentOracleDeepResearchTool",
+    "AgentOracleBatchResearchTool",
+    "get_agentoracle_tools",
+]
+
+__version__ = "0.2.1"