Skip to content

Releases: youdotcom-oss/youdotcom-temporal

Release list

v1.0.0

v1.0.0 Latest
Latest

Choose a tag to compare

View all tags
@tyler5673 tyler5673 released this 07 Aug 21:19
v1.0.0
147fe11

First stable release

Durable You.com search, answer, research, finance research, and contents activities for Temporal. Ships as a SimplePlugin for one-line worker setup, or as standalone activity functions for manual wiring.

pip install youdotcom-temporal

Activities (6)

Activity Input Description
youdotcom_search SearchInput Web and news search results
youdotcom_answer AnswerInput Synthesized answer with inline citations
youdotcom_research ResearchInput Multi-step research with citations
youdotcom_research_background ResearchInput Long-running background research (submits, streams, polls until complete)
youdotcom_finance_research FinanceResearchInput Finance-focused research with citations
youdotcom_contents ContentsInput Webpage content as HTML or markdown

Added

  • New activity youdotcom_answer and AnswerInput for the Answer API
  • New activity youdotcom_finance_research and FinanceResearchInput for the Finance Research API (tiers: deep, exhaustive)
  • New activity youdotcom_research_background using the SDK research_and_wait_async helper; submits and polls long-running tasks until completion. Accepts timeout_s field (defaults to 120s; use 14400 for frontier)
  • New params on SearchInput: offset, include_domains, exclude_domains, boost_domains, crawl_timeout
  • New param on ContentsInput: max_age (cache freshness control)
  • New params on ResearchInput: background, source_control, output_schema, timeout_s
  • Integration tests covering all 6 activities against the real You.com API and a local Temporal server
  • py.typed marker for type checking on the public API
  • httpx.TimeoutException mapped to retryable YouTimeoutError

Changed

  • Retargeted to youdotcom>=3.0.0,<4 (was >=2.3.0,<3)
  • youdotcom_search calls you.search_async() directly (was you.search.unified_async())
  • youdotcom_contents calls you.contents_async() directly (was you.contents.generate_async())
  • ResearchInput.research_effort default changed to "standard" to match the SDK
  • YouConfig.timeout_seconds default increased to 300s (covers deep/exhaustive inline research)
  • Dev tooling consolidated under [dependency-groups]

Fixed

  • Error mappings updated to SDK 3.0.0 class names
  • examples/run_workflow.py generates unique workflow IDs for re-runnability
  • examples/run_worker.py registers both example workflows
  • README plugin example cleaned up
  • CI workflows updated for uv sync --group dev

Full changelog: https://github.com/youdotcom-oss/youdotcom-temporal/blob/main/CHANGELOG.md

Assets 2
Loading