@effect-uai/core
Minor Changes
-
842d92b: New
WebSearchcapability (additive):@effect-uai/core/WebSearch: a genericWebSearchservice for
searching the live web, with a freesearchhelper (resolve the tag,
call.search).CommonSearchRequestis the cross-provider request
intersection (query,maxResults,recency,startDate/endDate
asDateTime,includeDomains/excludeDomains,country,
language);SearchResponsecarries normalizedSearchResults
(url,title,snippet,publishedDate,score) plus the raw
provider payload.SearchRecencyis"hour" | "day" | "week" | "month" | "year". A providerlayerregisters both the genericWebSearchtag
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 choosesquery
(and optionalrecency); app policy (maxResults,includeDomains/
excludeDomains, result rendering) lives in the constructor, not the
model arguments. The tool annotates aweb_searchclient span.
See Migrating to 0.8.
-
842d92b: 0.8 adds web search. A new
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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. AWebSearchprovider backed by Exa's
search API. Registers both the genericWebSearchtag and the
provider-typedExaSearchtag. Translatesrecencyinto a computed
startPublishedDate, mapsincludeDomains/excludeDomainsonto Exa's
domain filters, and exposes the provider-typedExaSearchType
(auto/fast/neural/keyword/ ...) andExaCategory.
languageiswarnDropped(no wire field); Exa'scostDollarsis kept
on the raw payload only (cost reporting is deferred to the upcoming
usage-tracking pass). -
842d92b: 0.8 adds web search. A new
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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. AWebSearchprovider backed by
Perplexity's/searchendpoint. Registers both the genericWebSearch
tag and the provider-typedPerplexitySearchtag. MapsincludeDomains/
excludeDomainsontosearch_domain_filter(exclusions via the-
prefix), passesrecencythrough, formats date ranges asMM/DD/YYYY,
and mapslanguageontosearch_language_filter. Configure the search
context size viaPerplexitySearchContextSize. -
842d92b: 0.8 adds web search. A new
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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. AWebSearchprovider backed by
Tavily's search API. Registers both the genericWebSearchtag and the
provider-typedTavilySearchtag. Returnscontentas the result snippet
plus a relevancescore, mapsincludeDomains/excludeDomains
directly, and formats date ranges asYYYY-MM-DD.recencymaps onto
time_range(thehourgranularity has no equivalent and is
warnDropped);countryandlanguagearewarnDropped(Tavily expects
full names rather than ISO codes). Tune relevance viaTavilySearchDepth
andTavilyTopic. -
842d92b: 0.8 adds web search. A new
WebSearchcapability lands in core: a generic
service for "search the live web" that providers register against, a free
searchhelper, and awebSearchToolyou 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 andwarnDroppeds the rest instead
of silently changing your query. Cost reporting is deliberately left off
SearchResponsefor 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.