Skip to content

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

Open
TKCollective wants to merge 1 commit into
mainfrom
feat/v0.2.1-reconcile
Open

v0.2.1: reconcile GitHub main with published PyPI 0.2.0 surface#2
TKCollective wants to merge 1 commit into
mainfrom
feat/v0.2.1-reconcile

Conversation

@TKCollective
Copy link
Copy Markdown
Owner

What this does

Pulls the full published langchain-agentoracle 0.2.0 source from PyPI into main (which was still at v0.1), then applies targeted improvements on top, and bumps to 0.2.1 so the PyPI publish workflow can ship it.

Why

PyPI 0.2.0 (uploaded 2026-04-16) exposes six tools. GitHub main exposed one (AgentOracleTool wrapping /preview). The drift meant:

  • Any source-based contributor reading main had a stale picture of the library.
  • The earlier v0.2.0: full AgentOracle tool surface for LangChain #1 PR proposed a four-tool surface — narrower than what's already shipped — which would have silently broken users importing AgentOracleDeepResearchTool or AgentOracleBatchResearchTool.

Surface (after merge)

Tool Endpoint Cost
AgentOracleEvaluateTool /evaluate $0.01 USDC
AgentOracleVerifyGateTool /verify-gate Free (beta)
AgentOraclePreviewTool /preview Free, 10/hr
AgentOracleResearchTool /research $0.02 USDC
AgentOracleDeepResearchTool /deep-research $0.10 USDC
AgentOracleBatchResearchTool /research/batch $0.02 × N
get_agentoracle_tools() convenience

Plus AgentOracleTool as an alias of AgentOracleEvaluateTool for v0.1 compatibility — matches how 0.2.0 shipped.

Targeted improvements over 0.2.0

  • langchain_core.tools.BaseTool preferred (modern LangChain import), langchain.tools fallback for older installs.
  • DEFAULT_TIMEOUT bumped 60s → 120s. Multi-source /evaluate runs 30-90s in practice; 60s was clipping tail latency during parallel invocation (hit during the tutorial Pattern 2 test).
  • pyproject.toml: license, authors, classifiers, project URLs, deps pinned to langchain-core>=0.2.0 / pydantic>=2.0 / requests>=2.31.
  • .gitignore added; dist/ and .egg-info/ dropped from tracking.
  • README rewritten to document all six tools plus the compat alias.

Verified

  • Installed locally with pip install -e . — all 7 exports import, AgentOracleTool is AgentOracleEvaluateTool is True, get_agentoracle_tools() returns 6 tools by default, include_paid=False returns 2.
  • Ran the upcoming Dev.to tutorial's Pattern 1 payload against live agentoracle.co with the reconciled package — verdicts, adversarial tags, corrections, and the [REFUTED] substring gate all return as documented.

Ship plan

  1. Merge.
  2. Tag v0.2.1.
  3. Existing release.yml workflow fires on v* tags and uploads the wheel.

Dev.to tutorial tie-in

Tutorial install line is pip install langchain-agentoracle crewai-agentoracle. Works today against published 0.2.0, continues to work after 0.2.1 publish. No publish-ordering risk for Thursday.

The 0.2.0 wheel on PyPI exposes six tools, but GitHub main was still at
v0.1 with a single AgentOracleTool. This commit pulls the full published
source into the repo so main is the source of truth again, then applies
a few targeted improvements on top.

Surface (matches PyPI 0.2.0 + future 0.2.1):
- AgentOracleEvaluateTool       /evaluate            $0.01 USDC
- AgentOracleVerifyGateTool     /verify-gate         free (beta)
- AgentOraclePreviewTool        /preview             free, 10/hr
- AgentOracleResearchTool       /research            $0.02 USDC
- AgentOracleDeepResearchTool   /deep-research       $0.10 USDC
- AgentOracleBatchResearchTool  /research/batch      $0.02 USDC × N
- get_agentoracle_tools(include_paid, include_free) convenience bundle

Backwards compatibility:
- AgentOracleTool (v0.1 name) remains exported, aliased to
  AgentOracleEvaluateTool — consistent with how 0.2.0 shipped.

Targeted improvements over 0.2.0:
- Prefer langchain_core.tools.BaseTool (modern LangChain import path),
  falling back to langchain.tools for older installs.
- DEFAULT_TIMEOUT bumped 60s → 120s. Multi-source /evaluate runs 30-90s
  in practice; 60s was clipping tail latency during parallel invocation.
- pyproject.toml: proper metadata (license, authors, classifiers, urls),
  deps pinned to langchain-core>=0.2.0 / pydantic>=2.0 / requests>=2.31.
- .gitignore added; dist/ and egg-info/ dropped from tracking.
- README rewritten to document all six tools and compatibility notes.

Tested: reinstalled locally, all imports succeed, AgentOracleTool is
AgentOracleEvaluateTool alias, get_agentoracle_tools() returns 6 tools
with include_paid=True (default), 2 with include_paid=False.

Live-tested against agentoracle.co with the tutorial's Pattern 1 payload —
verdicts, adversarial tags, and corrections all return as expected.
[REFUTED] substring gate fires correctly on the Bitcoin/Elon Musk claim.

Ship plan after merge: tag v0.2.1, existing PyPI publish workflow fires
on v* tags and uploads the new wheel.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant