Skip to content

v0.8.0

Latest

Choose a tag to compare

@github-actions github-actions released this 09 Jun 17:48

@effect-uai/core

Minor Changes

  • 842d92b: New WebSearch capability (additive):

    • @effect-uai/core/WebSearch: a generic WebSearch service for
      searching the live web, with a free search helper (resolve the tag,
      call .search). CommonSearchRequest is the cross-provider request
      intersection (query, maxResults, recency, startDate / endDate
      as DateTime, includeDomains / excludeDomains, country,
      language); SearchResponse carries normalized SearchResults
      (url, title, snippet, publishedDate, score) plus the raw
      provider payload. SearchRecency is "hour" | "day" | "week" | "month" | "year". A provider layer registers both the generic WebSearch tag
      and its provider-typed tag at once.
    • @effect-uai/core/WebSearchTool: webSearchTool(options?) builds a
      ready-to-use tool for the agent loop. The model only chooses query
      (and optional recency); app policy (maxResults, includeDomains /
      excludeDomains, result rendering) lives in the constructor, not the
      model arguments. The tool annotates a web_search client span.

    See Migrating to 0.8.

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

effect-uai

Minor Changes

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/anthropic

Minor Changes

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/deno

Minor Changes

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/elevenlabs

Minor Changes

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/exa

Minor Changes

  • 842d92b: New package: @effect-uai/exa. A WebSearch provider backed by Exa's
    search API. Registers both the generic WebSearch tag and the
    provider-typed ExaSearch tag. Translates recency into a computed
    startPublishedDate, maps includeDomains / excludeDomains onto Exa's
    domain filters, and exposes the provider-typed ExaSearchType
    (auto / fast / neural / keyword / ...) and ExaCategory.
    language is warnDropped (no wire field); Exa's costDollars is kept
    on the raw payload only (cost reporting is deferred to the upcoming
    usage-tracking pass).

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/google

Minor Changes

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/inworld

Minor Changes

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/jina

Minor Changes

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/microsandbox

Minor Changes

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/openai

Minor Changes

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/perplexity

Minor Changes

  • 842d92b: New package: @effect-uai/perplexity. A WebSearch provider backed by
    Perplexity's /search endpoint. Registers both the generic WebSearch
    tag and the provider-typed PerplexitySearch tag. Maps includeDomains /
    excludeDomains onto search_domain_filter (exclusions via the -
    prefix), passes recency through, formats date ranges as MM/DD/YYYY,
    and maps language onto search_language_filter. Configure the search
    context size via PerplexitySearchContextSize.

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/responses

Minor Changes

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.

@effect-uai/tavily

Minor Changes

  • 842d92b: New package: @effect-uai/tavily. A WebSearch provider backed by
    Tavily's search API. Registers both the generic WebSearch tag and the
    provider-typed TavilySearch tag. Returns content as the result snippet
    plus a relevance score, maps includeDomains / excludeDomains
    directly, and formats date ranges as YYYY-MM-DD. recency maps onto
    time_range (the hour granularity has no equivalent and is
    warnDropped); country and language are warnDropped (Tavily expects
    full names rather than ISO codes). Tune relevance via TavilySearchDepth
    and TavilyTopic.

  • 842d92b: 0.8 adds web search. A new WebSearch capability lands in core: a generic
    service for "search the live web" that providers register against, a free
    search helper, and a webSearchTool you hand to the agent loop so the
    model can ground its answers in current results. Three search providers
    debut behind it (@effect-uai/perplexity, @effect-uai/exa,
    @effect-uai/tavily), and two recipes show the patterns end to end:
    grounded answer
    (search, read, cite) and
    deep research
    (plan, fan out parallel sub-agents, synthesize a cited report).

    Like the request shape on every other capability, CommonSearchRequest
    is the cross-provider intersection (query, maxResults, recency,
    date range, includeDomains / excludeDomains, country, language);
    each provider maps what it supports and warnDroppeds the rest instead
    of silently changing your query. Cost reporting is deliberately left off
    SearchResponse for now, deferred to a unified usage-tracking pass.

    Purely additive. No migration needed. Bump dependencies, run
    typecheck, done. The new surface is in
    Migrating to 0.8.

    Every package outside core and the three new search providers
    (@effect-uai/responses, @effect-uai/anthropic, @effect-uai/google,
    @effect-uai/jina, @effect-uai/openai, @effect-uai/elevenlabs,
    @effect-uai/inworld, @effect-uai/microsandbox, @effect-uai/deno)
    has no functional changes this release; they bump for lockstep versioning
    only.