@effect-uai/exa 0.11.0 → 0.12.1

package/dist/ExaContents.d.mts

@@ -3,8 +3,6 @@ import { Context, Effect, Layer, Redacted } from "effect";
 import { HttpClient } from "effect/unstable/http";
 import * as AiError from "@effect-uai/core/AiError";
 import { CommonReadRequest, ReadResponse, WebRead } from "@effect-uai/core/WebRead";
-
-//#region src/ExaContents.d.ts
 declare namespace ExaContents_d_exports {
   export { Config, ExaContents, ExaContentsRequest, ExaContentsService, layer, make };
 }
@@ -14,7 +12,9 @@ declare namespace ExaContents_d_exports {
  * codec below).
  */
 type ExaContentsRequest = CommonReadRequest & {
-  /** Freshness / cache policy - see {@link ExaLivecrawl}. */readonly livecrawl?: ExaLivecrawl; /** Cap on the returned content length (Exa `text.maxCharacters`). */
+  /** Freshness / cache policy - see {@link ExaLivecrawl}. */
+  readonly livecrawl?: ExaLivecrawl;
+  /** Cap on the returned content length (Exa `text.maxCharacters`). */
   readonly maxCharacters?: number;
 };
 type ExaContentsService = {

package/dist/ExaContents.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ExaContents.d.mts","names":[],"sources":["../src/ExaContents.ts"],"mappings":";;;;;;;;;;;;;;;KAoBY,kBAAA,GAAqB,iBAAA;sEAEtB,SAAA,GAAY,YAAA;WAEZ,aAAA;AAAA;AAAA,KAGC,kBAAA;EAAA,SACD,IAAA,GAAO,OAAA,EAAS,kBAAA,KAAuB,MAAA,CAAO,MAAA,CAAO,YAAA,EAAc,OAAA,CAAQ,OAAA;AAAA;AAAA,cACrF,gBAAA;;;;;;cAOY,WAAA,SAAoB,gBAAA;AAAA,KAIrB,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;AAAA;;;;;cAsIE,IAAA,GACX,GAAA,EAAK,MAAA,KACJ,MAAA,CAAO,MAAA,CAAO,kBAAA,SAA2B,UAAA,CAAW,UAAA;;;;;;;cAY1C,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,WAAA,GAAc,OAAA,SAAgB,UAAA,CAAW,UAAA"}
+{"version":3,"file":"ExaContents.d.mts","names":[],"sources":["../src/ExaContents.ts"],"mappings":";;;;;;;;;;;;;KAoBY,qBAAqB;;WAEtB,YAAY;;WAEZ;;KAGC;WACD,OAAO,SAAS,uBAAuB,OAAO,OAAO,cAAc,QAAQ;;;;;;;;cAQzE,oBAAoB;KAIrB;WACD,QAAQ,SAAS;WACjB;;;;;;cAsIE,OAAI,KACV,WACJ,OAAO,OAAO,2BAA2B,WAAW;;;;;;;cAY1C,QAAK,KACX,WACJ,MAAM,MAAM,cAAc,gBAAgB,WAAW"}

package/dist/ExaContents.mjs

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { Context, Effect, Layer, Redacted, Schema } from "effect";
 import { HttpClient, HttpClientRequest } from "effect/unstable/http";
 import * as AiError from "@effect-uai/core/AiError";

package/dist/ExaContents.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ExaContents.mjs","names":[],"sources":["../src/ExaContents.ts"],"sourcesContent":["import { Context, Effect, Layer, Redacted, Schema } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport {\n  type CommonReadRequest,\n  type ReadResponse,\n  WebRead,\n  type WebReadService,\n} from \"@effect-uai/core/WebRead\"\nimport type { ExaLivecrawl } from \"./models.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Exa-typed read request. Widens {@link CommonReadRequest} with Exa\n * `/contents` knobs; the common fields map onto Exa's wire body (see the\n * codec below).\n */\nexport type ExaContentsRequest = CommonReadRequest & {\n  /** Freshness / cache policy - see {@link ExaLivecrawl}. */\n  readonly livecrawl?: ExaLivecrawl\n  /** Cap on the returned content length (Exa `text.maxCharacters`). */\n  readonly maxCharacters?: number\n}\n\nexport type ExaContentsService = {\n  readonly read: (request: ExaContentsRequest) => Effect.Effect<ReadResponse, AiError.AiError>\n}\n\n/**\n * Provider-typed service tag. Yield this for Exa-typed reads (its own\n * `/contents` knobs); yield the generic `WebRead` tag for provider-portable\n * code. Both are registered by {@link layer}.\n */\nexport class ExaContents extends Context.Service<ExaContents, ExaContentsService>()(\n  \"@betalyra/effect-uai/providers/exa/ExaContents\",\n) {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n}\n\n// ---------------------------------------------------------------------------\n// Codec - request body\n// ---------------------------------------------------------------------------\n\ntype WireText = {\n  readonly maxCharacters?: number\n  readonly includeHtmlTags?: boolean\n}\n\ntype WireBody = {\n  readonly urls: ReadonlyArray<string>\n  readonly text: WireText\n  readonly livecrawl?: string\n}\n\n// Exa returns markdown by default; `includeHtmlTags: true` returns HTML tags\n// instead. Both land on the single `text` field of the result.\nconst buildBody = (request: ExaContentsRequest): WireBody => {\n  const text: WireText = {\n    ...(request.maxCharacters !== undefined && { maxCharacters: request.maxCharacters }),\n    ...(request.format === \"html\" && { includeHtmlTags: true }),\n  }\n  return {\n    urls: [request.url],\n    text,\n    ...(request.livecrawl !== undefined && { livecrawl: request.livecrawl }),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Codec - response\n// ---------------------------------------------------------------------------\n\nconst WireResult = Schema.Struct({\n  id: Schema.optional(Schema.String),\n  url: Schema.String,\n  title: Schema.optional(Schema.NullOr(Schema.String)),\n  text: Schema.optional(Schema.NullOr(Schema.String)),\n})\ntype WireResult = typeof WireResult.Type\n\nconst WireStatus = Schema.Struct({\n  id: Schema.optional(Schema.String),\n  status: Schema.optional(Schema.String),\n  source: Schema.optional(Schema.String),\n})\n\nconst WireResponse = Schema.Struct({\n  requestId: Schema.optional(Schema.String),\n  results: Schema.Array(WireResult),\n  statuses: Schema.optional(Schema.Array(WireStatus)),\n})\ntype WireResponse = typeof WireResponse.Type\n\nconst toResponse = (wire: WireResponse, result: WireResult): ReadResponse => {\n  const title = result.title ?? undefined\n  return {\n    url: result.url,\n    content: result.text ?? \"\",\n    ...(title !== undefined && { title }),\n    raw: wire,\n  }\n}\n\n// ---------------------------------------------------------------------------\n// HTTP\n// ---------------------------------------------------------------------------\n\nconst transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"exa\", raw: cause })\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"exa\"\n  const raw = body\n  if (status === 429) return new AiError.RateLimited({ provider, raw })\n  if (status === 408 || status === 504) return new AiError.Timeout({ provider, raw })\n  if (status === 401) return new AiError.AuthFailed({ provider, subtype: \"auth\", raw })\n  if (status === 403) return new AiError.AuthFailed({ provider, subtype: \"permission\", raw })\n  if (status === 402) return new AiError.AuthFailed({ provider, subtype: \"billing\", raw })\n  if (status >= 500) return new AiError.Unavailable({ provider, status, raw })\n  return new AiError.InvalidRequest({ provider, raw })\n}\n\nconst baseUrl = (cfg: Config): string => cfg.baseUrl ?? \"https://api.exa.ai\"\n\nconst postContents = (\n  cfg: Config,\n  body: WireBody,\n): Effect.Effect<WireResponse, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/contents`).pipe(\n      HttpClientRequest.setHeader(\"x-api-key\", Redacted.value(cfg.apiKey)),\n      HttpClientRequest.bodyJsonUnsafe(body),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* httpStatusError(response.status, text)\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    return yield* Schema.decodeUnknownEffect(WireResponse)(json).pipe(\n      Effect.mapError(transportFailure),\n    )\n  })\n\nconst readImpl =\n  (cfg: Config) =>\n  (\n    request: ExaContentsRequest,\n  ): Effect.Effect<ReadResponse, AiError.AiError, HttpClient.HttpClient> =>\n    Effect.gen(function* () {\n      const wire = yield* postContents(cfg, buildBody(request))\n      // Exa reports per-URL crawl failures in `results` / `statuses` rather\n      // than an HTTP error; a missing first result means the single URL could\n      // not be read.\n      const result = wire.results[0]\n      if (result === undefined) {\n        return yield* new AiError.Unavailable({ provider: \"exa\", raw: wire })\n      }\n      return toResponse(wire, result)\n    })\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/**\n * Build an `ExaContentsService` value. For Layer-based setup, prefer\n * {@link layer}.\n */\nexport const make = (\n  cfg: Config,\n): Effect.Effect<ExaContentsService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) => ({\n    read: (request) =>\n      readImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n  }))\n\n/**\n * Layer registering both the provider-typed `ExaContents` tag and the generic\n * `WebRead` tag over one implementation. A `CommonReadRequest` is structurally\n * an `ExaContentsRequest` with the extra knobs unset, so the generic\n * registration forwards directly.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<ExaContents | WebRead, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(ExaContents, make(cfg))\n  const generic = Layer.effect(\n    WebRead,\n    Effect.map(make(cfg), (s): WebReadService => ({ read: (request) => s.read(request) })),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}
+{"version":3,"file":"ExaContents.mjs","names":[],"sources":["../src/ExaContents.ts"],"sourcesContent":["import { Context, Effect, Layer, Redacted, Schema } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport {\n  type CommonReadRequest,\n  type ReadResponse,\n  WebRead,\n  type WebReadService,\n} from \"@effect-uai/core/WebRead\"\nimport type { ExaLivecrawl } from \"./models.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Exa-typed read request. Widens {@link CommonReadRequest} with Exa\n * `/contents` knobs; the common fields map onto Exa's wire body (see the\n * codec below).\n */\nexport type ExaContentsRequest = CommonReadRequest & {\n  /** Freshness / cache policy - see {@link ExaLivecrawl}. */\n  readonly livecrawl?: ExaLivecrawl\n  /** Cap on the returned content length (Exa `text.maxCharacters`). */\n  readonly maxCharacters?: number\n}\n\nexport type ExaContentsService = {\n  readonly read: (request: ExaContentsRequest) => Effect.Effect<ReadResponse, AiError.AiError>\n}\n\n/**\n * Provider-typed service tag. Yield this for Exa-typed reads (its own\n * `/contents` knobs); yield the generic `WebRead` tag for provider-portable\n * code. Both are registered by {@link layer}.\n */\nexport class ExaContents extends Context.Service<ExaContents, ExaContentsService>()(\n  \"@betalyra/effect-uai/providers/exa/ExaContents\",\n) {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n}\n\n// ---------------------------------------------------------------------------\n// Codec - request body\n// ---------------------------------------------------------------------------\n\ntype WireText = {\n  readonly maxCharacters?: number\n  readonly includeHtmlTags?: boolean\n}\n\ntype WireBody = {\n  readonly urls: ReadonlyArray<string>\n  readonly text: WireText\n  readonly livecrawl?: string\n}\n\n// Exa returns markdown by default; `includeHtmlTags: true` returns HTML tags\n// instead. Both land on the single `text` field of the result.\nconst buildBody = (request: ExaContentsRequest): WireBody => {\n  const text: WireText = {\n    ...(request.maxCharacters !== undefined && { maxCharacters: request.maxCharacters }),\n    ...(request.format === \"html\" && { includeHtmlTags: true }),\n  }\n  return {\n    urls: [request.url],\n    text,\n    ...(request.livecrawl !== undefined && { livecrawl: request.livecrawl }),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Codec - response\n// ---------------------------------------------------------------------------\n\nconst WireResult = Schema.Struct({\n  id: Schema.optional(Schema.String),\n  url: Schema.String,\n  title: Schema.optional(Schema.NullOr(Schema.String)),\n  text: Schema.optional(Schema.NullOr(Schema.String)),\n})\ntype WireResult = typeof WireResult.Type\n\nconst WireStatus = Schema.Struct({\n  id: Schema.optional(Schema.String),\n  status: Schema.optional(Schema.String),\n  source: Schema.optional(Schema.String),\n})\n\nconst WireResponse = Schema.Struct({\n  requestId: Schema.optional(Schema.String),\n  results: Schema.Array(WireResult),\n  statuses: Schema.optional(Schema.Array(WireStatus)),\n})\ntype WireResponse = typeof WireResponse.Type\n\nconst toResponse = (wire: WireResponse, result: WireResult): ReadResponse => {\n  const title = result.title ?? undefined\n  return {\n    url: result.url,\n    content: result.text ?? \"\",\n    ...(title !== undefined && { title }),\n    raw: wire,\n  }\n}\n\n// ---------------------------------------------------------------------------\n// HTTP\n// ---------------------------------------------------------------------------\n\nconst transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"exa\", raw: cause })\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"exa\"\n  const raw = body\n  if (status === 429) return new AiError.RateLimited({ provider, raw })\n  if (status === 408 || status === 504) return new AiError.Timeout({ provider, raw })\n  if (status === 401) return new AiError.AuthFailed({ provider, subtype: \"auth\", raw })\n  if (status === 403) return new AiError.AuthFailed({ provider, subtype: \"permission\", raw })\n  if (status === 402) return new AiError.AuthFailed({ provider, subtype: \"billing\", raw })\n  if (status >= 500) return new AiError.Unavailable({ provider, status, raw })\n  return new AiError.InvalidRequest({ provider, raw })\n}\n\nconst baseUrl = (cfg: Config): string => cfg.baseUrl ?? \"https://api.exa.ai\"\n\nconst postContents = (\n  cfg: Config,\n  body: WireBody,\n): Effect.Effect<WireResponse, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/contents`).pipe(\n      HttpClientRequest.setHeader(\"x-api-key\", Redacted.value(cfg.apiKey)),\n      HttpClientRequest.bodyJsonUnsafe(body),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* httpStatusError(response.status, text)\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    return yield* Schema.decodeUnknownEffect(WireResponse)(json).pipe(\n      Effect.mapError(transportFailure),\n    )\n  })\n\nconst readImpl =\n  (cfg: Config) =>\n  (\n    request: ExaContentsRequest,\n  ): Effect.Effect<ReadResponse, AiError.AiError, HttpClient.HttpClient> =>\n    Effect.gen(function* () {\n      const wire = yield* postContents(cfg, buildBody(request))\n      // Exa reports per-URL crawl failures in `results` / `statuses` rather\n      // than an HTTP error; a missing first result means the single URL could\n      // not be read.\n      const result = wire.results[0]\n      if (result === undefined) {\n        return yield* new AiError.Unavailable({ provider: \"exa\", raw: wire })\n      }\n      return toResponse(wire, result)\n    })\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/**\n * Build an `ExaContentsService` value. For Layer-based setup, prefer\n * {@link layer}.\n */\nexport const make = (\n  cfg: Config,\n): Effect.Effect<ExaContentsService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) => ({\n    read: (request) =>\n      readImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n  }))\n\n/**\n * Layer registering both the provider-typed `ExaContents` tag and the generic\n * `WebRead` tag over one implementation. A `CommonReadRequest` is structurally\n * an `ExaContentsRequest` with the extra knobs unset, so the generic\n * registration forwards directly.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<ExaContents | WebRead, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(ExaContents, make(cfg))\n  const generic = Layer.effect(\n    WebRead,\n    Effect.map(make(cfg), (s): WebReadService => ({ read: (request) => s.read(request) })),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}

package/dist/ExaSearch.d.mts

@@ -3,8 +3,6 @@ import { Context, Effect, Layer, Redacted } from "effect";
 import { HttpClient } from "effect/unstable/http";
 import * as AiError from "@effect-uai/core/AiError";
 import { CommonSearchRequest, SearchResponse, WebSearch } from "@effect-uai/core/WebSearch";
-
-//#region src/ExaSearch.d.ts
 declare namespace ExaSearch_d_exports {
   export { Config, ExaSearch, ExaSearchRequest, ExaSearchService, layer, make };
 }
@@ -15,7 +13,9 @@ declare namespace ExaSearch_d_exports {
  * `type` choosing the retrieval strategy.
  */
 type ExaSearchRequest = CommonSearchRequest & {
-  /** Retrieval strategy - see {@link ExaSearchType}. Defaults to `auto`. */readonly type?: ExaSearchType; /** Content-vertical filter - see {@link ExaCategory}. */
+  /** Retrieval strategy - see {@link ExaSearchType}. Defaults to `auto`. */
+  readonly type?: ExaSearchType;
+  /** Content-vertical filter - see {@link ExaCategory}. */
   readonly category?: ExaCategory;
 };
 type ExaSearchService = {

package/dist/ExaSearch.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ExaSearch.d.mts","names":[],"sources":["../src/ExaSearch.ts"],"mappings":";;;;;;;;;;;;;;;;KAwBY,gBAAA,GAAmB,mBAAA;qFAEpB,IAAA,GAAO,aAAA;WAEP,QAAA,GAAW,WAAA;AAAA;AAAA,KAGV,gBAAA;EAAA,SACD,MAAA,GAAS,OAAA,EAAS,gBAAA,KAAqB,MAAA,CAAO,MAAA,CAAO,cAAA,EAAgB,OAAA,CAAQ,OAAA;AAAA;AAAA,cACvF,cAAA;;;;;;cAOY,SAAA,SAAkB,cAAA;AAAA,KAInB,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;AAAA;;;;;cA4KE,IAAA,GAAQ,GAAA,EAAK,MAAA,KAAS,MAAA,CAAO,MAAA,CAAO,gBAAA,SAAyB,UAAA,CAAW,UAAA;;;;;;;cAYxE,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,SAAA,GAAY,SAAA,SAAkB,UAAA,CAAW,UAAA"}
+{"version":3,"file":"ExaSearch.d.mts","names":[],"sources":["../src/ExaSearch.ts"],"mappings":";;;;;;;;;;;;;;KAwBY,mBAAmB;;WAEpB,OAAO;;WAEP,WAAW;;KAGV;WACD,SAAS,SAAS,qBAAqB,OAAO,OAAO,gBAAgB,QAAQ;;;;;;;;cAQ3E,kBAAkB;KAInB;WACD,QAAQ,SAAS;WACjB;;;;;;cA4KE,OAAI,KAAS,WAAS,OAAO,OAAO,yBAAyB,WAAW;;;;;;;cAYxE,QAAK,KACX,WACJ,MAAM,MAAM,YAAY,kBAAkB,WAAW"}

package/dist/ExaSearch.mjs

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { Context, DateTime, Effect, Layer, Option, Redacted, Schema } from "effect";
 import { HttpClient, HttpClientRequest } from "effect/unstable/http";
 import * as AiError from "@effect-uai/core/AiError";
@@ -126,7 +126,9 @@ const searchImpl = (cfg) => (request) => Effect.gen(function* () {
 		field: "language",
 		reason: "Exa /search has no language filter; the hint is ignored."
 	});
-	return toResponse(yield* postSearch(cfg, buildBody(request, yield* DateTime.now)));
+	const now = yield* DateTime.now;
+	const wire = yield* postSearch(cfg, buildBody(request, now));
+	return toResponse(wire);
 });
 /**
 * Build an `ExaSearchService` value. For Layer-based setup, prefer

package/dist/ExaSearch.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ExaSearch.mjs","names":[],"sources":["../src/ExaSearch.ts"],"sourcesContent":["import { Context, DateTime, type Duration, Effect, Layer, Option, Redacted, Schema } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport * as Capabilities from \"@effect-uai/core/Capabilities\"\nimport {\n  type CommonSearchRequest,\n  type SearchRecency,\n  type SearchResponse,\n  type SearchResult,\n  WebSearch,\n  type WebSearchService,\n} from \"@effect-uai/core/WebSearch\"\nimport type { ExaCategory, ExaSearchType } from \"./models.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Exa-typed search request. Widens {@link CommonSearchRequest} with Exa's\n * own knobs; the common fields map onto Exa's wire filters (see the codec\n * below). There is no `model` - `/search` ranks the web directly, with\n * `type` choosing the retrieval strategy.\n */\nexport type ExaSearchRequest = CommonSearchRequest & {\n  /** Retrieval strategy - see {@link ExaSearchType}. Defaults to `auto`. */\n  readonly type?: ExaSearchType\n  /** Content-vertical filter - see {@link ExaCategory}. */\n  readonly category?: ExaCategory\n}\n\nexport type ExaSearchService = {\n  readonly search: (request: ExaSearchRequest) => Effect.Effect<SearchResponse, AiError.AiError>\n}\n\n/**\n * Provider-typed service tag. Yield this for Exa-typed search (`type`,\n * `category`, the per-result `score`); yield the generic `WebSearch` tag\n * for provider-portable code. Both are registered by {@link layer}.\n */\nexport class ExaSearch extends Context.Service<ExaSearch, ExaSearchService>()(\n  \"@betalyra/effect-uai/providers/exa/ExaSearch\",\n) {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n}\n\n// ---------------------------------------------------------------------------\n// Codec - request body\n// ---------------------------------------------------------------------------\n\ntype WireBody = {\n  readonly query: string\n  readonly numResults?: number\n  readonly type?: string\n  readonly category?: string\n  readonly includeDomains?: ReadonlyArray<string>\n  readonly excludeDomains?: ReadonlyArray<string>\n  readonly startPublishedDate?: string\n  readonly endPublishedDate?: string\n  readonly userLocation?: string\n}\n\n// Exa has no recency enum; map the coarse enum onto a published-after date\n// computed from \"now\" (per the capabilities policy: lossless translation).\nconst recencyDuration: Record<SearchRecency, Duration.Input> = {\n  hour: \"1 hour\",\n  day: \"1 day\",\n  week: \"7 days\",\n  month: \"30 days\",\n  year: \"365 days\",\n}\n\nconst buildBody = (request: ExaSearchRequest, now: DateTime.DateTime): WireBody => {\n  // Explicit `startDate` wins over the `recency` sugar; otherwise derive the\n  // published-after bound from the recency window.\n  const startPublishedDate =\n    request.startDate !== undefined\n      ? DateTime.formatIso(request.startDate)\n      : request.recency !== undefined\n        ? DateTime.formatIso(DateTime.subtractDuration(now, recencyDuration[request.recency]))\n        : undefined\n\n  return {\n    query: request.query,\n    ...(request.maxResults !== undefined && { numResults: request.maxResults }),\n    ...(request.type !== undefined && { type: request.type }),\n    ...(request.category !== undefined && { category: request.category }),\n    ...(request.includeDomains !== undefined && { includeDomains: request.includeDomains }),\n    ...(request.excludeDomains !== undefined && { excludeDomains: request.excludeDomains }),\n    ...(startPublishedDate !== undefined && { startPublishedDate }),\n    ...(request.endDate !== undefined && { endPublishedDate: DateTime.formatIso(request.endDate) }),\n    ...(request.country !== undefined && { userLocation: request.country }),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Codec - response\n// ---------------------------------------------------------------------------\n\nconst WireResult = Schema.Struct({\n  id: Schema.optional(Schema.String),\n  url: Schema.String,\n  title: Schema.optional(Schema.NullOr(Schema.String)),\n  score: Schema.optional(Schema.Number),\n  publishedDate: Schema.optional(Schema.NullOr(Schema.String)),\n  author: Schema.optional(Schema.NullOr(Schema.String)),\n})\ntype WireResult = typeof WireResult.Type\n\nconst WireCost = Schema.Struct({\n  total: Schema.optional(Schema.Number),\n})\n\nconst WireResponse = Schema.Struct({\n  requestId: Schema.optional(Schema.String),\n  results: Schema.Array(WireResult),\n  costDollars: Schema.optional(WireCost),\n})\ntype WireResponse = typeof WireResponse.Type\n\n/** Lenient parse of Exa's ISO date strings; unparseable -> omitted. */\nconst parseDate = (s: string | null | undefined): DateTime.DateTime | undefined =>\n  s == null ? undefined : Option.getOrUndefined(DateTime.make(s))\n\n// Exa's pure `/search` returns no text excerpt unless you request `contents`\n// (the out-of-scope extract feature), so `snippet` stays undefined here -\n// the honest result is url + title + score + publishedDate. `author` and\n// the full `raw` object remain on `raw` for typed-tag callers.\nconst toResult = (r: WireResult): SearchResult => {\n  const publishedDate = parseDate(r.publishedDate)\n  return {\n    url: r.url,\n    ...(r.title != null && { title: r.title }),\n    ...(r.score !== undefined && { score: r.score }),\n    ...(publishedDate !== undefined && { publishedDate }),\n    raw: r,\n  }\n}\n\n// `costDollars` is still decoded (so it survives on `raw`) but not promoted\n// to a typed cost field: search cost/usage is deferred to the unified usage\n// design (see plans/usage-tracking.md).\nconst toResponse = (wire: WireResponse): SearchResponse => ({\n  results: wire.results.map(toResult),\n  raw: wire,\n})\n\n// ---------------------------------------------------------------------------\n// HTTP\n// ---------------------------------------------------------------------------\n\nconst transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"exa\", raw: cause })\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"exa\"\n  const raw = body\n  if (status === 429) return new AiError.RateLimited({ provider, raw })\n  if (status === 408 || status === 504) return new AiError.Timeout({ provider, raw })\n  if (status === 401) return new AiError.AuthFailed({ provider, subtype: \"auth\", raw })\n  if (status === 403) return new AiError.AuthFailed({ provider, subtype: \"permission\", raw })\n  if (status === 402) return new AiError.AuthFailed({ provider, subtype: \"billing\", raw })\n  if (status >= 500) return new AiError.Unavailable({ provider, status, raw })\n  return new AiError.InvalidRequest({ provider, raw })\n}\n\nconst baseUrl = (cfg: Config): string => cfg.baseUrl ?? \"https://api.exa.ai\"\n\nconst postSearch = (\n  cfg: Config,\n  body: WireBody,\n): Effect.Effect<WireResponse, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/search`).pipe(\n      HttpClientRequest.setHeader(\"x-api-key\", Redacted.value(cfg.apiKey)),\n      HttpClientRequest.bodyJsonUnsafe(body),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* httpStatusError(response.status, text)\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    return yield* Schema.decodeUnknownEffect(WireResponse)(json).pipe(\n      Effect.mapError(transportFailure),\n    )\n  })\n\nconst searchImpl =\n  (cfg: Config) =>\n  (\n    request: ExaSearchRequest,\n  ): Effect.Effect<SearchResponse, AiError.AiError, HttpClient.HttpClient> =>\n    Effect.gen(function* () {\n      // Exa has no language filter (bucket 2: warn, don't fail).\n      yield* Capabilities.warnDroppedWhen(request.language, {\n        provider: \"exa\",\n        capability: \"language\",\n        field: \"language\",\n        reason: \"Exa /search has no language filter; the hint is ignored.\",\n      })\n      const now = yield* DateTime.now\n      const wire = yield* postSearch(cfg, buildBody(request, now))\n      return toResponse(wire)\n    })\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/**\n * Build an `ExaSearchService` value. For Layer-based setup, prefer\n * {@link layer}.\n */\nexport const make = (cfg: Config): Effect.Effect<ExaSearchService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) => ({\n    search: (request) =>\n      searchImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n  }))\n\n/**\n * Layer registering both the provider-typed `ExaSearch` tag and the\n * generic `WebSearch` tag over one implementation. A `CommonSearchRequest`\n * is structurally an `ExaSearchRequest` with `type` / `category` unset, so\n * the generic registration forwards directly.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<ExaSearch | WebSearch, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(ExaSearch, make(cfg))\n  const generic = Layer.effect(\n    WebSearch,\n    Effect.map(make(cfg), (s): WebSearchService => ({ search: (request) => s.search(request) })),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}
+{"version":3,"file":"ExaSearch.mjs","names":[],"sources":["../src/ExaSearch.ts"],"sourcesContent":["import { Context, DateTime, type Duration, Effect, Layer, Option, Redacted, Schema } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport * as Capabilities from \"@effect-uai/core/Capabilities\"\nimport {\n  type CommonSearchRequest,\n  type SearchRecency,\n  type SearchResponse,\n  type SearchResult,\n  WebSearch,\n  type WebSearchService,\n} from \"@effect-uai/core/WebSearch\"\nimport type { ExaCategory, ExaSearchType } from \"./models.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Exa-typed search request. Widens {@link CommonSearchRequest} with Exa's\n * own knobs; the common fields map onto Exa's wire filters (see the codec\n * below). There is no `model` - `/search` ranks the web directly, with\n * `type` choosing the retrieval strategy.\n */\nexport type ExaSearchRequest = CommonSearchRequest & {\n  /** Retrieval strategy - see {@link ExaSearchType}. Defaults to `auto`. */\n  readonly type?: ExaSearchType\n  /** Content-vertical filter - see {@link ExaCategory}. */\n  readonly category?: ExaCategory\n}\n\nexport type ExaSearchService = {\n  readonly search: (request: ExaSearchRequest) => Effect.Effect<SearchResponse, AiError.AiError>\n}\n\n/**\n * Provider-typed service tag. Yield this for Exa-typed search (`type`,\n * `category`, the per-result `score`); yield the generic `WebSearch` tag\n * for provider-portable code. Both are registered by {@link layer}.\n */\nexport class ExaSearch extends Context.Service<ExaSearch, ExaSearchService>()(\n  \"@betalyra/effect-uai/providers/exa/ExaSearch\",\n) {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n}\n\n// ---------------------------------------------------------------------------\n// Codec - request body\n// ---------------------------------------------------------------------------\n\ntype WireBody = {\n  readonly query: string\n  readonly numResults?: number\n  readonly type?: string\n  readonly category?: string\n  readonly includeDomains?: ReadonlyArray<string>\n  readonly excludeDomains?: ReadonlyArray<string>\n  readonly startPublishedDate?: string\n  readonly endPublishedDate?: string\n  readonly userLocation?: string\n}\n\n// Exa has no recency enum; map the coarse enum onto a published-after date\n// computed from \"now\" (per the capabilities policy: lossless translation).\nconst recencyDuration: Record<SearchRecency, Duration.Input> = {\n  hour: \"1 hour\",\n  day: \"1 day\",\n  week: \"7 days\",\n  month: \"30 days\",\n  year: \"365 days\",\n}\n\nconst buildBody = (request: ExaSearchRequest, now: DateTime.DateTime): WireBody => {\n  // Explicit `startDate` wins over the `recency` sugar; otherwise derive the\n  // published-after bound from the recency window.\n  const startPublishedDate =\n    request.startDate !== undefined\n      ? DateTime.formatIso(request.startDate)\n      : request.recency !== undefined\n        ? DateTime.formatIso(DateTime.subtractDuration(now, recencyDuration[request.recency]))\n        : undefined\n\n  return {\n    query: request.query,\n    ...(request.maxResults !== undefined && { numResults: request.maxResults }),\n    ...(request.type !== undefined && { type: request.type }),\n    ...(request.category !== undefined && { category: request.category }),\n    ...(request.includeDomains !== undefined && { includeDomains: request.includeDomains }),\n    ...(request.excludeDomains !== undefined && { excludeDomains: request.excludeDomains }),\n    ...(startPublishedDate !== undefined && { startPublishedDate }),\n    ...(request.endDate !== undefined && { endPublishedDate: DateTime.formatIso(request.endDate) }),\n    ...(request.country !== undefined && { userLocation: request.country }),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Codec - response\n// ---------------------------------------------------------------------------\n\nconst WireResult = Schema.Struct({\n  id: Schema.optional(Schema.String),\n  url: Schema.String,\n  title: Schema.optional(Schema.NullOr(Schema.String)),\n  score: Schema.optional(Schema.Number),\n  publishedDate: Schema.optional(Schema.NullOr(Schema.String)),\n  author: Schema.optional(Schema.NullOr(Schema.String)),\n})\ntype WireResult = typeof WireResult.Type\n\nconst WireCost = Schema.Struct({\n  total: Schema.optional(Schema.Number),\n})\n\nconst WireResponse = Schema.Struct({\n  requestId: Schema.optional(Schema.String),\n  results: Schema.Array(WireResult),\n  costDollars: Schema.optional(WireCost),\n})\ntype WireResponse = typeof WireResponse.Type\n\n/** Lenient parse of Exa's ISO date strings; unparseable -> omitted. */\nconst parseDate = (s: string | null | undefined): DateTime.DateTime | undefined =>\n  s == null ? undefined : Option.getOrUndefined(DateTime.make(s))\n\n// Exa's pure `/search` returns no text excerpt unless you request `contents`\n// (the out-of-scope extract feature), so `snippet` stays undefined here -\n// the honest result is url + title + score + publishedDate. `author` and\n// the full `raw` object remain on `raw` for typed-tag callers.\nconst toResult = (r: WireResult): SearchResult => {\n  const publishedDate = parseDate(r.publishedDate)\n  return {\n    url: r.url,\n    ...(r.title != null && { title: r.title }),\n    ...(r.score !== undefined && { score: r.score }),\n    ...(publishedDate !== undefined && { publishedDate }),\n    raw: r,\n  }\n}\n\n// `costDollars` is still decoded (so it survives on `raw`) but not promoted\n// to a typed cost field: search cost/usage is deferred to the unified usage\n// design (see plans/usage-tracking.md).\nconst toResponse = (wire: WireResponse): SearchResponse => ({\n  results: wire.results.map(toResult),\n  raw: wire,\n})\n\n// ---------------------------------------------------------------------------\n// HTTP\n// ---------------------------------------------------------------------------\n\nconst transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"exa\", raw: cause })\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"exa\"\n  const raw = body\n  if (status === 429) return new AiError.RateLimited({ provider, raw })\n  if (status === 408 || status === 504) return new AiError.Timeout({ provider, raw })\n  if (status === 401) return new AiError.AuthFailed({ provider, subtype: \"auth\", raw })\n  if (status === 403) return new AiError.AuthFailed({ provider, subtype: \"permission\", raw })\n  if (status === 402) return new AiError.AuthFailed({ provider, subtype: \"billing\", raw })\n  if (status >= 500) return new AiError.Unavailable({ provider, status, raw })\n  return new AiError.InvalidRequest({ provider, raw })\n}\n\nconst baseUrl = (cfg: Config): string => cfg.baseUrl ?? \"https://api.exa.ai\"\n\nconst postSearch = (\n  cfg: Config,\n  body: WireBody,\n): Effect.Effect<WireResponse, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/search`).pipe(\n      HttpClientRequest.setHeader(\"x-api-key\", Redacted.value(cfg.apiKey)),\n      HttpClientRequest.bodyJsonUnsafe(body),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* httpStatusError(response.status, text)\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    return yield* Schema.decodeUnknownEffect(WireResponse)(json).pipe(\n      Effect.mapError(transportFailure),\n    )\n  })\n\nconst searchImpl =\n  (cfg: Config) =>\n  (\n    request: ExaSearchRequest,\n  ): Effect.Effect<SearchResponse, AiError.AiError, HttpClient.HttpClient> =>\n    Effect.gen(function* () {\n      // Exa has no language filter (bucket 2: warn, don't fail).\n      yield* Capabilities.warnDroppedWhen(request.language, {\n        provider: \"exa\",\n        capability: \"language\",\n        field: \"language\",\n        reason: \"Exa /search has no language filter; the hint is ignored.\",\n      })\n      const now = yield* DateTime.now\n      const wire = yield* postSearch(cfg, buildBody(request, now))\n      return toResponse(wire)\n    })\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/**\n * Build an `ExaSearchService` value. For Layer-based setup, prefer\n * {@link layer}.\n */\nexport const make = (cfg: Config): Effect.Effect<ExaSearchService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) => ({\n    search: (request) =>\n      searchImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n  }))\n\n/**\n * Layer registering both the provider-typed `ExaSearch` tag and the\n * generic `WebSearch` tag over one implementation. A `CommonSearchRequest`\n * is structurally an `ExaSearchRequest` with `type` / `category` unset, so\n * the generic registration forwards directly.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<ExaSearch | WebSearch, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(ExaSearch, make(cfg))\n  const generic = Layer.effect(\n    WebSearch,\n    Effect.map(make(cfg), (s): WebSearchService => ({ search: (request) => s.search(request) })),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,5 +1,4 @@
-import { ExaCategory, ExaLivecrawl, ExaResearchModel, ExaSearchType } from "./models.mjs";
+import { ExaCategory, ExaLivecrawl, ExaSearchType } from "./models.mjs";
 import { t as ExaContents_d_exports } from "./ExaContents.mjs";
-import { t as ExaDeepResearch_d_exports } from "./ExaDeepResearch.mjs";
 import { t as ExaSearch_d_exports } from "./ExaSearch.mjs";
-export { ExaCategory, ExaContents_d_exports as ExaContents, ExaDeepResearch_d_exports as ExaDeepResearch, ExaLivecrawl, ExaResearchModel, ExaSearch_d_exports as ExaSearch, ExaSearchType };
+export { ExaCategory, ExaContents_d_exports as ExaContents, ExaLivecrawl, ExaSearch_d_exports as ExaSearch, ExaSearchType };

package/dist/index.mjs

@@ -1,5 +1,4 @@
 import { t as ExaContents_exports } from "./ExaContents.mjs";
-import { t as ExaDeepResearch_exports } from "./ExaDeepResearch.mjs";
 import { t as ExaSearch_exports } from "./ExaSearch.mjs";
 import "./models.mjs";
-export { ExaContents_exports as ExaContents, ExaDeepResearch_exports as ExaDeepResearch, ExaSearch_exports as ExaSearch };
+export { ExaContents_exports as ExaContents, ExaSearch_exports as ExaSearch };

package/dist/models.d.mts

@@ -14,18 +14,6 @@
  * cross-provider `CommonSearchRequest`.
  */
 type ExaSearchType = "auto" | "fast" | "instant" | "deep-lite" | "deep" | "deep-reasoning" | "neural" | "keyword" | (string & {});
-/**
- * Exa research model for the async `/research/v1` task API (create + poll).
- * `exa-research-fast` / `exa-research` / `exa-research-pro` trade latency for
- * depth. The `(string & {})` tail accepts any string without an SDK bump.
- *
- * Note (2026-07): Exa announced `/research/v1` deprecation in favour of
- * `/search` with `type: "deep-reasoning"`. Verify the endpoint and the
- * completed-task response shape against live docs before relying on this.
- *
- * Reference: https://docs.exa.ai/reference/research/create-a-task
- */
-type ExaResearchModel = "exa-research" | "exa-research-pro" | "exa-research-fast" | (string & {});
 /**
  * Exa's result category filter. Narrows the index to a content vertical.
  * Provider-specific, so it lives on `ExaSearchRequest`.
@@ -38,5 +26,5 @@ type ExaCategory = "company" | "research paper" | "news" | "personal site" | "fi
  */
 type ExaLivecrawl = "never" | "fallback" | "preferred" | "always" | (string & {});
 //#endregion
-export { ExaCategory, ExaLivecrawl, ExaResearchModel, ExaSearchType };
+export { ExaCategory, ExaLivecrawl, ExaSearchType };
 //# sourceMappingURL=models.d.mts.map

package/dist/models.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"models.d.mts","names":[],"sources":["../src/models.ts"],"mappings":";;AAcA;;;;;AAuBA;;;;;AAWA;;;KAlCY,aAAA;;AAiDZ;;;;;;;;;;KA1BY,gBAAA;;;;;KAWA,WAAA;;;;;;KAeA,YAAA"}
+{"version":3,"file":"models.d.mts","names":[],"sources":["../src/models.ts"],"mappings":";;;;;;;;;;;;;;;KAcY;;;;;KAgBA;;;;;;KAeA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect-uai/exa",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "Exa provider for @effect-uai/core (web search, web read).",
   "keywords": [
     "ai",
@@ -39,10 +39,6 @@
       "types": "./dist/ExaContents.d.mts",
       "import": "./dist/ExaContents.mjs"
     },
-    "./ExaDeepResearch": {
-      "types": "./dist/ExaDeepResearch.d.mts",
-      "import": "./dist/ExaDeepResearch.mjs"
-    },
     "./ExaSearch": {
       "types": "./dist/ExaSearch.d.mts",
       "import": "./dist/ExaSearch.mjs"
@@ -52,13 +48,13 @@
     "access": "public"
   },
   "devDependencies": {
-    "effect": "4.0.0-beta.94",
-    "typescript": "^6.0.3",
-    "@effect-uai/core": "0.11.0"
+    "effect": "4.0.0-rc.111",
+    "typescript": "^7.0.2",
+    "@effect-uai/core": "0.12.1"
   },
   "peerDependencies": {
     "@effect-uai/core": ">=0.2.0 <1",
-    "effect": ">=4.0.0-beta.94 <5.0.0"
+    "effect": ">=4.0.0-rc.111 <5.0.0"
   },
   "scripts": {
     "build": "tsdown",

package/src/index.ts

@@ -1,4 +1,3 @@
 export * as ExaContents from "./ExaContents.js"
-export * as ExaDeepResearch from "./ExaDeepResearch.js"
 export * as ExaSearch from "./ExaSearch.js"
 export * from "./models.js"

package/src/models.ts

@@ -24,24 +24,6 @@ export type ExaSearchType =
   // eslint-disable-next-line @typescript-eslint/ban-types
   | (string & {})
 
-/**
- * Exa research model for the async `/research/v1` task API (create + poll).
- * `exa-research-fast` / `exa-research` / `exa-research-pro` trade latency for
- * depth. The `(string & {})` tail accepts any string without an SDK bump.
- *
- * Note (2026-07): Exa announced `/research/v1` deprecation in favour of
- * `/search` with `type: "deep-reasoning"`. Verify the endpoint and the
- * completed-task response shape against live docs before relying on this.
- *
- * Reference: https://docs.exa.ai/reference/research/create-a-task
- */
-export type ExaResearchModel =
-  | "exa-research"
-  | "exa-research-pro"
-  | "exa-research-fast"
-  // eslint-disable-next-line @typescript-eslint/ban-types
-  | (string & {})
-
 /**
  * Exa's result category filter. Narrows the index to a content vertical.
  * Provider-specific, so it lives on `ExaSearchRequest`.

package/dist/ExaDeepResearch.d.mts

@@ -1,70 +0,0 @@
-import { ExaResearchModel } from "./models.mjs";
-import { Context, Effect, Layer, Redacted, Schema } from "effect";
-import { HttpClient } from "effect/unstable/http";
-import { DeepResearch, DeepResearchServiceShape } from "@effect-uai/core/DeepResearch";
-import * as Job from "@effect-uai/core/Job";
-import * as StructuredFormat from "@effect-uai/core/StructuredFormat";
-import { ResearchRequest, ResearchState } from "@effect-uai/core/Research";
-
-//#region src/ExaDeepResearch.d.ts
-declare namespace ExaDeepResearch_d_exports {
-  export { Config, ExaDeepResearch, ExaDeepResearchService, ExaResearchRequest, WireResearch, jobStateOf, layer, make };
-}
-/**
- * Exa-typed research request. Narrows `model` and adds `outputSchema`.
- * Provider-portable code uses the generic `DeepResearch` tag instead.
- */
-type ExaResearchRequest = Omit<ResearchRequest, "model"> & {
-  readonly model?: ExaResearchModel;
-  /**
-   * Optional structured output. When set, Exa researches the web and returns
-   * JSON matching the schema (Draft 7) instead of a prose report, with
-   * field-level citations. The completed `Turn`'s text is that JSON, so decode
-   * it with `Turn.decodeStructured(turn, outputSchema)` — the same path as
-   * `LanguageModel` structured output.
-   */
-  readonly outputSchema?: StructuredFormat.StructuredFormat<unknown>;
-};
-type ExaDeepResearchService = DeepResearchServiceShape<ExaResearchRequest>;
-declare const ExaDeepResearch_base: Context.ServiceClass<ExaDeepResearch, "@betalyra/effect-uai/providers/exa/ExaDeepResearch", ExaDeepResearchService>;
-/**
- * Provider-typed tag for Exa deep research over the async task API
- * (`POST /research/v0/tasks` create + `GET /research/v0/tasks/{id}` poll). Yield
- * this for the model / `outputSchema` knobs; yield the generic `DeepResearch`
- * tag for portable code. Poll-based, so `researchStream` / `streamFrom` are the
- * synthesized default {@link fromJob} builds.
- */
-declare class ExaDeepResearch extends ExaDeepResearch_base {}
-type Config = {
-  readonly apiKey: Redacted.Redacted;
-  readonly baseUrl?: string; /** Poll cadence / overall timeout for the derived poll loops. */
-  readonly job?: Job.JobConfig;
-};
-declare const WireResearch: Schema.Struct<{
-  readonly id: Schema.optional<Schema.NullOr<Schema.String>>;
-  readonly status: Schema.optional<Schema.NullOr<Schema.String>>;
-  readonly schema: Schema.optional<Schema.NullOr<Schema.Unknown>>;
-  readonly data: Schema.optional<Schema.NullOr<Schema.$Record<Schema.String, Schema.Unknown>>>;
-  readonly citations: Schema.optional<Schema.NullOr<Schema.$Record<Schema.String, Schema.$Array<Schema.Struct<{
-    readonly id: Schema.optional<Schema.NullOr<Schema.String>>;
-    readonly url: Schema.optional<Schema.NullOr<Schema.String>>;
-    readonly title: Schema.optional<Schema.NullOr<Schema.String>>;
-    readonly snippet: Schema.optional<Schema.NullOr<Schema.String>>;
-  }>>>>>;
-  readonly error: Schema.optional<Schema.NullOr<Schema.Struct<{
-    readonly message: Schema.optional<Schema.NullOr<Schema.String>>;
-  }>>>;
-}>;
-type WireResearch = typeof WireResearch.Type;
-declare const jobStateOf: (wire: WireResearch) => ResearchState;
-/** Build an `ExaDeepResearchService`. For Layer setup, prefer {@link layer}. */
-declare const make: (cfg: Config) => Effect.Effect<ExaDeepResearchService, never, HttpClient.HttpClient>;
-/**
- * Layer registering the provider-typed `ExaDeepResearch` tag and the generic
- * `DeepResearch` tag. No capability markers: the surface (poll, collect,
- * synthesized stream) is universal.
- */
-declare const layer: (cfg: Config) => Layer.Layer<ExaDeepResearch | DeepResearch, never, HttpClient.HttpClient>;
-//#endregion
-export { Config, ExaDeepResearch, ExaDeepResearchService, ExaResearchRequest, WireResearch, jobStateOf, layer, make, ExaDeepResearch_d_exports as t };
-//# sourceMappingURL=ExaDeepResearch.d.mts.map

package/dist/ExaDeepResearch.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ExaDeepResearch.d.mts","names":[],"sources":["../src/ExaDeepResearch.ts"],"mappings":";;;;;;;;;;;;;;;;KAyBY,kBAAA,GAAqB,IAAA,CAAK,eAAA;EAAA,SAC3B,KAAA,GAAQ,gBAAA;;;;;;;;WAQR,YAAA,GAAe,gBAAA,CAAiB,gBAAA;AAAA;AAAA,KAG/B,sBAAA,GAAyB,wBAAA,CAAyB,kBAAA;AAAA,cAAmB,oBAAA;;;;;;;;cASpE,eAAA,SAAwB,oBAAA;AAAA,KAIzB,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA,WAlBgD;EAAA,SAoBhD,GAAA,GAAM,GAAA,CAAI,SAAA;AAAA;AAAA,cAwBR,YAAA,EAAY,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;KAQb,YAAA,UAAsB,YAAA,CAAa,IAAA;AAAA,cAoDlC,UAAA,GAAc,IAAA,EAAM,YAAA,KAAe,aAAA;;cA8HnC,IAAA,GACX,GAAA,EAAK,MAAA,KACJ,MAAA,CAAO,MAAA,CAAO,sBAAA,SAA+B,UAAA,CAAW,UAAA;;;;;AAxN3D;cAgOa,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,eAAA,GAAkB,YAAA,SAAqB,UAAA,CAAW,UAAA"}

package/dist/ExaDeepResearch.mjs

@@ -1,183 +0,0 @@
-import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import { Context, Effect, Layer, Match, Redacted, Schema } from "effect";
-import { HttpClient, HttpClientRequest } from "effect/unstable/http";
-import * as AiError from "@effect-uai/core/AiError";
-import { DeepResearch, fromJob } from "@effect-uai/core/DeepResearch";
-import * as Items from "@effect-uai/core/Items";
-import * as Job from "@effect-uai/core/Job";
-//#region src/ExaDeepResearch.ts
-var ExaDeepResearch_exports = /* @__PURE__ */ __exportAll({
-	ExaDeepResearch: () => ExaDeepResearch,
-	WireResearch: () => WireResearch,
-	jobStateOf: () => jobStateOf,
-	layer: () => layer,
-	make: () => make
-});
-/**
-* Provider-typed tag for Exa deep research over the async task API
-* (`POST /research/v0/tasks` create + `GET /research/v0/tasks/{id}` poll). Yield
-* this for the model / `outputSchema` knobs; yield the generic `DeepResearch`
-* tag for portable code. Poll-based, so `researchStream` / `streamFrom` are the
-* synthesized default {@link fromJob} builds.
-*/
-var ExaDeepResearch = class extends Context.Service()("@betalyra/effect-uai/providers/exa/ExaDeepResearch") {};
-const WireSubmit = Schema.Struct({ id: Schema.String });
-const decodeSubmit = Schema.decodeUnknownEffect(WireSubmit);
-const OptionalText = Schema.optional(Schema.NullOr(Schema.String));
-const WireSource = Schema.Struct({
-	id: OptionalText,
-	url: OptionalText,
-	title: OptionalText,
-	snippet: OptionalText
-});
-const WireResearch = Schema.Struct({
-	id: OptionalText,
-	status: OptionalText,
-	schema: Schema.optional(Schema.NullOr(Schema.Unknown)),
-	data: Schema.optional(Schema.NullOr(Schema.Record(Schema.String, Schema.Unknown))),
-	citations: Schema.optional(Schema.NullOr(Schema.Record(Schema.String, Schema.Array(WireSource)))),
-	error: Schema.optional(Schema.NullOr(Schema.Struct({ message: OptionalText })))
-});
-const decodeResearch = Schema.decodeUnknownEffect(WireResearch);
-const reportText = (wire) => {
-	if (wire.schema != null) return JSON.stringify(wire.data ?? {});
-	const answer = wire.data?.answer;
-	return typeof answer === "string" ? answer : "";
-};
-const citationsToAnnotations = (wire) => Object.values(wire.citations ?? {}).flat().flatMap((c, i) => c.url == null ? [] : [{
-	type: "url_citation",
-	url: c.url,
-	title: c.title ?? c.url,
-	marker: i + 1,
-	...c.snippet != null && { cited_text: c.snippet }
-}]);
-const turnFromResearch = (wire) => {
-	const annotations = citationsToAnnotations(wire);
-	return {
-		items: [{
-			type: "message",
-			role: "assistant",
-			content: [{
-				type: "output_text",
-				text: reportText(wire),
-				...annotations.length > 0 && { annotations }
-			}],
-			providerData: wire
-		}],
-		usage: {},
-		stop_reason: "stop"
-	};
-};
-const jobStateOf = (wire) => Match.value(wire.status ?? "").pipe(Match.whenOr("pending", "queued", () => ({ _tag: "Pending" })), Match.whenOr("running", "in_progress", () => ({ _tag: "Running" })), Match.when("completed", () => ({
-	_tag: "Succeeded",
-	result: turnFromResearch(wire)
-})), Match.whenOr("failed", "canceled", "cancelled", () => ({
-	_tag: "Failed",
-	...wire.error?.message != null && { reason: wire.error.message },
-	raw: wire
-})), Match.orElse(() => ({ _tag: "Running" })));
-const baseUrl = (cfg) => cfg.baseUrl ?? "https://api.exa.ai";
-const authHeader = (cfg) => HttpClientRequest.setHeader("x-api-key", Redacted.value(cfg.apiKey));
-const transportFailure = (cause) => new AiError.Unavailable({
-	provider: "exa",
-	raw: cause
-});
-const httpStatusError = (status, body) => {
-	const provider = "exa";
-	const raw = body;
-	if (status === 429) return new AiError.RateLimited({
-		provider,
-		raw
-	});
-	if (status === 408 || status === 504) return new AiError.Timeout({
-		provider,
-		raw
-	});
-	if (status === 401) return new AiError.AuthFailed({
-		provider,
-		subtype: "auth",
-		raw
-	});
-	if (status === 403) return new AiError.AuthFailed({
-		provider,
-		subtype: "permission",
-		raw
-	});
-	if (status === 402) return new AiError.AuthFailed({
-		provider,
-		subtype: "billing",
-		raw
-	});
-	if (status >= 500) return new AiError.Unavailable({
-		provider,
-		status,
-		raw
-	});
-	return new AiError.InvalidRequest({
-		provider,
-		raw
-	});
-};
-const instructions = (history) => history.filter(Items.isMessage).filter((m) => m.role === "user").flatMap((m) => m.content).filter(Items.isInputText).map((b) => b.text).join("\n");
-const submitBody = (request) => ({
-	instructions: instructions(request.history),
-	model: request.model ?? "exa-research",
-	...request.outputSchema !== void 0 && { output: { schema: request.outputSchema.schema["~standard"].jsonSchema.input({ target: "draft-07" }) } }
-});
-const submitJob = (cfg, request) => Effect.gen(function* () {
-	const client = yield* HttpClient.HttpClient;
-	const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/research/v0/tasks`).pipe(authHeader(cfg), HttpClientRequest.bodyJsonUnsafe(submitBody(request)));
-	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
-	if (response.status >= 400) {
-		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
-		return yield* httpStatusError(response.status, text);
-	}
-	const wire = yield* decodeSubmit(yield* response.json.pipe(Effect.mapError(transportFailure))).pipe(Effect.mapError(transportFailure));
-	return Job.jobRef("exa", wire.id);
-});
-const pollJob = (cfg, ref) => Effect.gen(function* () {
-	const client = yield* HttpClient.HttpClient;
-	const httpRequest = HttpClientRequest.get(`${baseUrl(cfg)}/research/v0/tasks/${ref.id}`).pipe(authHeader(cfg));
-	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
-	if (response.status >= 400) {
-		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
-		return yield* httpStatusError(response.status, text);
-	}
-	return jobStateOf(yield* decodeResearch(yield* response.json.pipe(Effect.mapError(transportFailure))).pipe(Effect.mapError(transportFailure)));
-});
-const unsupported = (capability) => new AiError.Unsupported({
-	provider: "exa",
-	capability,
-	reason: "Exa's research task API exposes no verified cancel endpoint."
-});
-const jobOps = (cfg, client) => {
-	const withClient = (e) => Effect.provideService(e, HttpClient.HttpClient, client);
-	return {
-		submit: (request) => withClient(submitJob(cfg, request)),
-		poll: (ref) => withClient(pollJob(cfg, ref)),
-		cancel: () => Effect.fail(unsupported("cancel"))
-	};
-};
-/** Build an `ExaDeepResearchService`. For Layer setup, prefer {@link layer}. */
-const make = (cfg) => Effect.map(HttpClient.HttpClient, (client) => fromJob(jobOps(cfg, client), cfg.job));
-/**
-* Layer registering the provider-typed `ExaDeepResearch` tag and the generic
-* `DeepResearch` tag. No capability markers: the surface (poll, collect,
-* synthesized stream) is universal.
-*/
-const layer = (cfg) => {
-	const typed = Layer.effect(ExaDeepResearch, make(cfg));
-	const generic = Layer.effect(DeepResearch, Effect.map(HttpClient.HttpClient, (client) => {
-		const ops = jobOps(cfg, client);
-		return fromJob({
-			submit: (request) => ops.submit(request),
-			poll: ops.poll,
-			cancel: ops.cancel
-		}, cfg.job);
-	}));
-	return Layer.merge(typed, generic);
-};
-//#endregion
-export { ExaDeepResearch, WireResearch, jobStateOf, layer, make, ExaDeepResearch_exports as t };
-
-//# sourceMappingURL=ExaDeepResearch.mjs.map

package/dist/ExaDeepResearch.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ExaDeepResearch.mjs","names":[],"sources":["../src/ExaDeepResearch.ts"],"sourcesContent":["import { Context, Effect, Layer, Match, Redacted, Schema } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport {\n  DeepResearch,\n  type DeepResearchService,\n  type DeepResearchServiceShape,\n  fromJob,\n  type ResearchJobOps,\n} from \"@effect-uai/core/DeepResearch\"\nimport * as Items from \"@effect-uai/core/Items\"\nimport * as Job from \"@effect-uai/core/Job\"\nimport * as StructuredFormat from \"@effect-uai/core/StructuredFormat\"\nimport type { ResearchJobRef, ResearchRequest, ResearchState } from \"@effect-uai/core/Research\"\nimport type { Turn } from \"@effect-uai/core/Turn\"\nimport type { ExaResearchModel } from \"./models.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Exa-typed research request. Narrows `model` and adds `outputSchema`.\n * Provider-portable code uses the generic `DeepResearch` tag instead.\n */\nexport type ExaResearchRequest = Omit<ResearchRequest, \"model\"> & {\n  readonly model?: ExaResearchModel\n  /**\n   * Optional structured output. When set, Exa researches the web and returns\n   * JSON matching the schema (Draft 7) instead of a prose report, with\n   * field-level citations. The completed `Turn`'s text is that JSON, so decode\n   * it with `Turn.decodeStructured(turn, outputSchema)` — the same path as\n   * `LanguageModel` structured output.\n   */\n  readonly outputSchema?: StructuredFormat.StructuredFormat<unknown>\n}\n\nexport type ExaDeepResearchService = DeepResearchServiceShape<ExaResearchRequest>\n\n/**\n * Provider-typed tag for Exa deep research over the async task API\n * (`POST /research/v0/tasks` create + `GET /research/v0/tasks/{id}` poll). Yield\n * this for the model / `outputSchema` knobs; yield the generic `DeepResearch`\n * tag for portable code. Poll-based, so `researchStream` / `streamFrom` are the\n * synthesized default {@link fromJob} builds.\n */\nexport class ExaDeepResearch extends Context.Service<ExaDeepResearch, ExaDeepResearchService>()(\n  \"@betalyra/effect-uai/providers/exa/ExaDeepResearch\",\n) {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  /** Poll cadence / overall timeout for the derived poll loops. */\n  readonly job?: Job.JobConfig\n}\n\n// ---------------------------------------------------------------------------\n// Wire codec\n// ---------------------------------------------------------------------------\n\nconst WireSubmit = Schema.Struct({ id: Schema.String })\nconst decodeSubmit = Schema.decodeUnknownEffect(WireSubmit)\n\nconst OptionalText = Schema.optional(Schema.NullOr(Schema.String))\n\n// A source backing one data field. `id` is Exa's dedup key (usually the url).\nconst WireSource = Schema.Struct({\n  id: OptionalText,\n  url: OptionalText,\n  title: OptionalText,\n  snippet: OptionalText,\n})\n\n// `data` holds the results: `{ answer }` for a prose task, or the schema-shaped\n// object when an `outputSchema` was given. `schema` (non-null) is the reliable\n// discriminator. `citations` is keyed by data-field path, each a list of\n// sources. Reference: exa-labs/openapi-spec `/research/v0/tasks`.\nexport const WireResearch = Schema.Struct({\n  id: OptionalText,\n  status: OptionalText,\n  schema: Schema.optional(Schema.NullOr(Schema.Unknown)),\n  data: Schema.optional(Schema.NullOr(Schema.Record(Schema.String, Schema.Unknown))),\n  citations: Schema.optional(Schema.NullOr(Schema.Record(Schema.String, Schema.Array(WireSource)))),\n  error: Schema.optional(Schema.NullOr(Schema.Struct({ message: OptionalText }))),\n})\nexport type WireResearch = typeof WireResearch.Type\nconst decodeResearch = Schema.decodeUnknownEffect(WireResearch)\n\n// Structured → the whole `data` object serialized (decoded outside via\n// `Turn.decodeStructured`). Prose → `data.answer`.\nconst reportText = (wire: WireResearch): string => {\n  if (wire.schema != null) return JSON.stringify(wire.data ?? {})\n  const answer = wire.data?.answer\n  return typeof answer === \"string\" ? answer : \"\"\n}\n\n// Flatten the field-keyed citations into the flat `Annotation` list. The\n// per-field grouping is lost in this view; the raw wire stays on `providerData`.\nconst citationsToAnnotations = (wire: WireResearch): ReadonlyArray<Items.Annotation> =>\n  Object.values(wire.citations ?? {})\n    .flat()\n    .flatMap((c, i) =>\n      c.url == null\n        ? []\n        : [\n            {\n              type: \"url_citation\" as const,\n              url: c.url,\n              title: c.title ?? c.url,\n              marker: i + 1,\n              ...(c.snippet != null && { cited_text: c.snippet }),\n            },\n          ],\n    )\n\nconst turnFromResearch = (wire: WireResearch): Turn => {\n  const annotations = citationsToAnnotations(wire)\n  return {\n    items: [\n      {\n        type: \"message\",\n        role: \"assistant\",\n        content: [\n          {\n            type: \"output_text\",\n            text: reportText(wire),\n            ...(annotations.length > 0 && { annotations }),\n          },\n        ],\n        providerData: wire,\n      },\n    ],\n    usage: {},\n    stop_reason: \"stop\",\n  }\n}\n\nexport const jobStateOf = (wire: WireResearch): ResearchState =>\n  Match.value(wire.status ?? \"\").pipe(\n    Match.whenOr(\"pending\", \"queued\", (): ResearchState => ({ _tag: \"Pending\" })),\n    Match.whenOr(\"running\", \"in_progress\", (): ResearchState => ({ _tag: \"Running\" })),\n    Match.when(\n      \"completed\",\n      (): ResearchState => ({ _tag: \"Succeeded\", result: turnFromResearch(wire) }),\n    ),\n    Match.whenOr(\n      \"failed\",\n      \"canceled\",\n      \"cancelled\",\n      (): ResearchState => ({\n        _tag: \"Failed\",\n        ...(wire.error?.message != null && { reason: wire.error.message }),\n        raw: wire,\n      }),\n    ),\n    Match.orElse((): ResearchState => ({ _tag: \"Running\" })),\n  )\n\n// ---------------------------------------------------------------------------\n// HTTP\n// ---------------------------------------------------------------------------\n\nconst baseUrl = (cfg: Config): string => cfg.baseUrl ?? \"https://api.exa.ai\"\n\nconst authHeader = (cfg: Config) =>\n  HttpClientRequest.setHeader(\"x-api-key\", Redacted.value(cfg.apiKey))\n\nconst transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"exa\", raw: cause })\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"exa\"\n  const raw = body\n  if (status === 429) return new AiError.RateLimited({ provider, raw })\n  if (status === 408 || status === 504) return new AiError.Timeout({ provider, raw })\n  if (status === 401) return new AiError.AuthFailed({ provider, subtype: \"auth\", raw })\n  if (status === 403) return new AiError.AuthFailed({ provider, subtype: \"permission\", raw })\n  if (status === 402) return new AiError.AuthFailed({ provider, subtype: \"billing\", raw })\n  if (status >= 500) return new AiError.Unavailable({ provider, status, raw })\n  return new AiError.InvalidRequest({ provider, raw })\n}\n\n// Deep research takes one instruction. Concatenate the user turns' text.\nconst instructions = (history: ReadonlyArray<Items.HistoryItem>): string =>\n  history\n    .filter(Items.isMessage)\n    .filter((m) => m.role === \"user\")\n    .flatMap((m) => m.content)\n    .filter(Items.isInputText)\n    .map((b) => b.text)\n    .join(\"\\n\")\n\nconst submitBody = (request: ExaResearchRequest): Record<string, unknown> => ({\n  instructions: instructions(request.history),\n  model: request.model ?? \"exa-research\",\n  ...(request.outputSchema !== undefined && {\n    output: {\n      schema: request.outputSchema.schema[\"~standard\"].jsonSchema.input({ target: \"draft-07\" }),\n    },\n  }),\n})\n\nconst submitJob = (\n  cfg: Config,\n  request: ExaResearchRequest,\n): Effect.Effect<ResearchJobRef, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/research/v0/tasks`).pipe(\n      authHeader(cfg),\n      HttpClientRequest.bodyJsonUnsafe(submitBody(request)),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* httpStatusError(response.status, text)\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    const wire = yield* decodeSubmit(json).pipe(Effect.mapError(transportFailure))\n    return Job.jobRef<Turn>(\"exa\", wire.id)\n  })\n\nconst pollJob = (\n  cfg: Config,\n  ref: ResearchJobRef,\n): Effect.Effect<ResearchState, AiError.AiError, HttpClient.HttpClient> =>\n  Effect.gen(function* () {\n    const client = yield* HttpClient.HttpClient\n    const httpRequest = HttpClientRequest.get(`${baseUrl(cfg)}/research/v0/tasks/${ref.id}`).pipe(\n      authHeader(cfg),\n    )\n    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n    if (response.status >= 400) {\n      const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n      return yield* httpStatusError(response.status, text)\n    }\n    const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n    const wire = yield* decodeResearch(json).pipe(Effect.mapError(transportFailure))\n    return jobStateOf(wire)\n  })\n\nconst unsupported = (capability: string): AiError.Unsupported =>\n  new AiError.Unsupported({\n    provider: \"exa\",\n    capability,\n    reason: \"Exa's research task API exposes no verified cancel endpoint.\",\n  })\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\nconst jobOps = (cfg: Config, client: HttpClient.HttpClient): ResearchJobOps<ExaResearchRequest> => {\n  const withClient = <A>(e: Effect.Effect<A, AiError.AiError, HttpClient.HttpClient>) =>\n    Effect.provideService(e, HttpClient.HttpClient, client)\n  return {\n    submit: (request) => withClient(submitJob(cfg, request)),\n    poll: (ref) => withClient(pollJob(cfg, ref)),\n    cancel: () => Effect.fail(unsupported(\"cancel\")),\n  }\n}\n\n/** Build an `ExaDeepResearchService`. For Layer setup, prefer {@link layer}. */\nexport const make = (\n  cfg: Config,\n): Effect.Effect<ExaDeepResearchService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) => fromJob(jobOps(cfg, client), cfg.job))\n\n/**\n * Layer registering the provider-typed `ExaDeepResearch` tag and the generic\n * `DeepResearch` tag. No capability markers: the surface (poll, collect,\n * synthesized stream) is universal.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<ExaDeepResearch | DeepResearch, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(ExaDeepResearch, make(cfg))\n  const generic = Layer.effect(\n    DeepResearch,\n    Effect.map(HttpClient.HttpClient, (client): DeepResearchService => {\n      const ops = jobOps(cfg, client)\n      return fromJob<ResearchRequest>(\n        {\n          submit: (request) => ops.submit(request as ExaResearchRequest),\n          poll: ops.poll,\n          cancel: ops.cancel,\n        },\n        cfg.job,\n      )\n    }),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}

package/src/ExaDeepResearch.ts

@@ -1,294 +0,0 @@
-import { Context, Effect, Layer, Match, Redacted, Schema } from "effect"
-import { HttpClient, HttpClientRequest } from "effect/unstable/http"
-import * as AiError from "@effect-uai/core/AiError"
-import {
-  DeepResearch,
-  type DeepResearchService,
-  type DeepResearchServiceShape,
-  fromJob,
-  type ResearchJobOps,
-} from "@effect-uai/core/DeepResearch"
-import * as Items from "@effect-uai/core/Items"
-import * as Job from "@effect-uai/core/Job"
-import * as StructuredFormat from "@effect-uai/core/StructuredFormat"
-import type { ResearchJobRef, ResearchRequest, ResearchState } from "@effect-uai/core/Research"
-import type { Turn } from "@effect-uai/core/Turn"
-import type { ExaResearchModel } from "./models.js"
-
-// ---------------------------------------------------------------------------
-// Public types
-// ---------------------------------------------------------------------------
-
-/**
- * Exa-typed research request. Narrows `model` and adds `outputSchema`.
- * Provider-portable code uses the generic `DeepResearch` tag instead.
- */
-export type ExaResearchRequest = Omit<ResearchRequest, "model"> & {
-  readonly model?: ExaResearchModel
-  /**
-   * Optional structured output. When set, Exa researches the web and returns
-   * JSON matching the schema (Draft 7) instead of a prose report, with
-   * field-level citations. The completed `Turn`'s text is that JSON, so decode
-   * it with `Turn.decodeStructured(turn, outputSchema)` — the same path as
-   * `LanguageModel` structured output.
-   */
-  readonly outputSchema?: StructuredFormat.StructuredFormat<unknown>
-}
-
-export type ExaDeepResearchService = DeepResearchServiceShape<ExaResearchRequest>
-
-/**
- * Provider-typed tag for Exa deep research over the async task API
- * (`POST /research/v0/tasks` create + `GET /research/v0/tasks/{id}` poll). Yield
- * this for the model / `outputSchema` knobs; yield the generic `DeepResearch`
- * tag for portable code. Poll-based, so `researchStream` / `streamFrom` are the
- * synthesized default {@link fromJob} builds.
- */
-export class ExaDeepResearch extends Context.Service<ExaDeepResearch, ExaDeepResearchService>()(
-  "@betalyra/effect-uai/providers/exa/ExaDeepResearch",
-) {}
-
-export type Config = {
-  readonly apiKey: Redacted.Redacted
-  readonly baseUrl?: string
-  /** Poll cadence / overall timeout for the derived poll loops. */
-  readonly job?: Job.JobConfig
-}
-
-// ---------------------------------------------------------------------------
-// Wire codec
-// ---------------------------------------------------------------------------
-
-const WireSubmit = Schema.Struct({ id: Schema.String })
-const decodeSubmit = Schema.decodeUnknownEffect(WireSubmit)
-
-const OptionalText = Schema.optional(Schema.NullOr(Schema.String))
-
-// A source backing one data field. `id` is Exa's dedup key (usually the url).
-const WireSource = Schema.Struct({
-  id: OptionalText,
-  url: OptionalText,
-  title: OptionalText,
-  snippet: OptionalText,
-})
-
-// `data` holds the results: `{ answer }` for a prose task, or the schema-shaped
-// object when an `outputSchema` was given. `schema` (non-null) is the reliable
-// discriminator. `citations` is keyed by data-field path, each a list of
-// sources. Reference: exa-labs/openapi-spec `/research/v0/tasks`.
-export const WireResearch = Schema.Struct({
-  id: OptionalText,
-  status: OptionalText,
-  schema: Schema.optional(Schema.NullOr(Schema.Unknown)),
-  data: Schema.optional(Schema.NullOr(Schema.Record(Schema.String, Schema.Unknown))),
-  citations: Schema.optional(Schema.NullOr(Schema.Record(Schema.String, Schema.Array(WireSource)))),
-  error: Schema.optional(Schema.NullOr(Schema.Struct({ message: OptionalText }))),
-})
-export type WireResearch = typeof WireResearch.Type
-const decodeResearch = Schema.decodeUnknownEffect(WireResearch)
-
-// Structured → the whole `data` object serialized (decoded outside via
-// `Turn.decodeStructured`). Prose → `data.answer`.
-const reportText = (wire: WireResearch): string => {
-  if (wire.schema != null) return JSON.stringify(wire.data ?? {})
-  const answer = wire.data?.answer
-  return typeof answer === "string" ? answer : ""
-}
-
-// Flatten the field-keyed citations into the flat `Annotation` list. The
-// per-field grouping is lost in this view; the raw wire stays on `providerData`.
-const citationsToAnnotations = (wire: WireResearch): ReadonlyArray<Items.Annotation> =>
-  Object.values(wire.citations ?? {})
-    .flat()
-    .flatMap((c, i) =>
-      c.url == null
-        ? []
-        : [
-            {
-              type: "url_citation" as const,
-              url: c.url,
-              title: c.title ?? c.url,
-              marker: i + 1,
-              ...(c.snippet != null && { cited_text: c.snippet }),
-            },
-          ],
-    )
-
-const turnFromResearch = (wire: WireResearch): Turn => {
-  const annotations = citationsToAnnotations(wire)
-  return {
-    items: [
-      {
-        type: "message",
-        role: "assistant",
-        content: [
-          {
-            type: "output_text",
-            text: reportText(wire),
-            ...(annotations.length > 0 && { annotations }),
-          },
-        ],
-        providerData: wire,
-      },
-    ],
-    usage: {},
-    stop_reason: "stop",
-  }
-}
-
-export const jobStateOf = (wire: WireResearch): ResearchState =>
-  Match.value(wire.status ?? "").pipe(
-    Match.whenOr("pending", "queued", (): ResearchState => ({ _tag: "Pending" })),
-    Match.whenOr("running", "in_progress", (): ResearchState => ({ _tag: "Running" })),
-    Match.when(
-      "completed",
-      (): ResearchState => ({ _tag: "Succeeded", result: turnFromResearch(wire) }),
-    ),
-    Match.whenOr(
-      "failed",
-      "canceled",
-      "cancelled",
-      (): ResearchState => ({
-        _tag: "Failed",
-        ...(wire.error?.message != null && { reason: wire.error.message }),
-        raw: wire,
-      }),
-    ),
-    Match.orElse((): ResearchState => ({ _tag: "Running" })),
-  )
-
-// ---------------------------------------------------------------------------
-// HTTP
-// ---------------------------------------------------------------------------
-
-const baseUrl = (cfg: Config): string => cfg.baseUrl ?? "https://api.exa.ai"
-
-const authHeader = (cfg: Config) =>
-  HttpClientRequest.setHeader("x-api-key", Redacted.value(cfg.apiKey))
-
-const transportFailure = (cause: unknown): AiError.AiError =>
-  new AiError.Unavailable({ provider: "exa", raw: cause })
-
-const httpStatusError = (status: number, body: string): AiError.AiError => {
-  const provider = "exa"
-  const raw = body
-  if (status === 429) return new AiError.RateLimited({ provider, raw })
-  if (status === 408 || status === 504) return new AiError.Timeout({ provider, raw })
-  if (status === 401) return new AiError.AuthFailed({ provider, subtype: "auth", raw })
-  if (status === 403) return new AiError.AuthFailed({ provider, subtype: "permission", raw })
-  if (status === 402) return new AiError.AuthFailed({ provider, subtype: "billing", raw })
-  if (status >= 500) return new AiError.Unavailable({ provider, status, raw })
-  return new AiError.InvalidRequest({ provider, raw })
-}
-
-// Deep research takes one instruction. Concatenate the user turns' text.
-const instructions = (history: ReadonlyArray<Items.HistoryItem>): string =>
-  history
-    .filter(Items.isMessage)
-    .filter((m) => m.role === "user")
-    .flatMap((m) => m.content)
-    .filter(Items.isInputText)
-    .map((b) => b.text)
-    .join("\n")
-
-const submitBody = (request: ExaResearchRequest): Record<string, unknown> => ({
-  instructions: instructions(request.history),
-  model: request.model ?? "exa-research",
-  ...(request.outputSchema !== undefined && {
-    output: {
-      schema: request.outputSchema.schema["~standard"].jsonSchema.input({ target: "draft-07" }),
-    },
-  }),
-})
-
-const submitJob = (
-  cfg: Config,
-  request: ExaResearchRequest,
-): Effect.Effect<ResearchJobRef, AiError.AiError, HttpClient.HttpClient> =>
-  Effect.gen(function* () {
-    const client = yield* HttpClient.HttpClient
-    const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/research/v0/tasks`).pipe(
-      authHeader(cfg),
-      HttpClientRequest.bodyJsonUnsafe(submitBody(request)),
-    )
-    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))
-    if (response.status >= 400) {
-      const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""))
-      return yield* httpStatusError(response.status, text)
-    }
-    const json = yield* response.json.pipe(Effect.mapError(transportFailure))
-    const wire = yield* decodeSubmit(json).pipe(Effect.mapError(transportFailure))
-    return Job.jobRef<Turn>("exa", wire.id)
-  })
-
-const pollJob = (
-  cfg: Config,
-  ref: ResearchJobRef,
-): Effect.Effect<ResearchState, AiError.AiError, HttpClient.HttpClient> =>
-  Effect.gen(function* () {
-    const client = yield* HttpClient.HttpClient
-    const httpRequest = HttpClientRequest.get(`${baseUrl(cfg)}/research/v0/tasks/${ref.id}`).pipe(
-      authHeader(cfg),
-    )
-    const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))
-    if (response.status >= 400) {
-      const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""))
-      return yield* httpStatusError(response.status, text)
-    }
-    const json = yield* response.json.pipe(Effect.mapError(transportFailure))
-    const wire = yield* decodeResearch(json).pipe(Effect.mapError(transportFailure))
-    return jobStateOf(wire)
-  })
-
-const unsupported = (capability: string): AiError.Unsupported =>
-  new AiError.Unsupported({
-    provider: "exa",
-    capability,
-    reason: "Exa's research task API exposes no verified cancel endpoint.",
-  })
-
-// ---------------------------------------------------------------------------
-// Constructors
-// ---------------------------------------------------------------------------
-
-const jobOps = (cfg: Config, client: HttpClient.HttpClient): ResearchJobOps<ExaResearchRequest> => {
-  const withClient = <A>(e: Effect.Effect<A, AiError.AiError, HttpClient.HttpClient>) =>
-    Effect.provideService(e, HttpClient.HttpClient, client)
-  return {
-    submit: (request) => withClient(submitJob(cfg, request)),
-    poll: (ref) => withClient(pollJob(cfg, ref)),
-    cancel: () => Effect.fail(unsupported("cancel")),
-  }
-}
-
-/** Build an `ExaDeepResearchService`. For Layer setup, prefer {@link layer}. */
-export const make = (
-  cfg: Config,
-): Effect.Effect<ExaDeepResearchService, never, HttpClient.HttpClient> =>
-  Effect.map(HttpClient.HttpClient, (client) => fromJob(jobOps(cfg, client), cfg.job))
-
-/**
- * Layer registering the provider-typed `ExaDeepResearch` tag and the generic
- * `DeepResearch` tag. No capability markers: the surface (poll, collect,
- * synthesized stream) is universal.
- */
-export const layer = (
-  cfg: Config,
-): Layer.Layer<ExaDeepResearch | DeepResearch, never, HttpClient.HttpClient> => {
-  const typed = Layer.effect(ExaDeepResearch, make(cfg))
-  const generic = Layer.effect(
-    DeepResearch,
-    Effect.map(HttpClient.HttpClient, (client): DeepResearchService => {
-      const ops = jobOps(cfg, client)
-      return fromJob<ResearchRequest>(
-        {
-          submit: (request) => ops.submit(request as ExaResearchRequest),
-          poll: ops.poll,
-          cancel: ops.cancel,
-        },
-        cfg.job,
-      )
-    }),
-  )
-  return Layer.merge(typed, generic)
-}