@effect-uai/perplexity 0.10.0 → 0.11.0

package/dist/PerplexityDeepResearch.d.mts

@@ -0,0 +1,48 @@
+import { PerplexityReasoningEffort, PerplexityResearchModel } from "./models.mjs";
+import { Context, Effect, Layer, Redacted } 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 { ResearchRequest } from "@effect-uai/core/Research";
+
+//#region src/PerplexityDeepResearch.d.ts
+declare namespace PerplexityDeepResearch_d_exports {
+  export { Config, PerplexityDeepResearch, PerplexityDeepResearchService, PerplexityResearchRequest, layer, make };
+}
+/**
+ * Perplexity-typed research request. Narrows `model` to the sonar research
+ * models and adds `reasoningEffort` (a Perplexity knob that also steers how
+ * many searches `sonar-deep-research` runs). Provider-portable code uses the
+ * generic `DeepResearch` tag instead.
+ */
+type PerplexityResearchRequest = Omit<ResearchRequest, "model"> & {
+  readonly model?: PerplexityResearchModel;
+  readonly reasoningEffort?: PerplexityReasoningEffort;
+};
+type PerplexityDeepResearchService = DeepResearchServiceShape<PerplexityResearchRequest>;
+declare const PerplexityDeepResearch_base: Context.ServiceClass<PerplexityDeepResearch, "@betalyra/effect-uai/providers/perplexity/PerplexityDeepResearch", PerplexityDeepResearchService>;
+/**
+ * Provider-typed tag. Yield this for the Perplexity model / `reasoningEffort`
+ * knobs; yield the generic `DeepResearch` tag for provider-portable code. The
+ * async job is poll-only, so it has no live event stream: `researchStream` /
+ * `streamFrom` return the synthesized progress {@link fromJob} builds (a leading
+ * search event, then the terminal report). `cancel` fails `Unsupported` (no
+ * endpoint). A persisted ref survives a restart (the job is server-backed).
+ */
+declare class PerplexityDeepResearch extends PerplexityDeepResearch_base {}
+type Config = {
+  readonly apiKey: Redacted.Redacted;
+  readonly baseUrl?: string; /** Poll cadence / overall timeout for the derived poll loops. */
+  readonly job?: Job.JobConfig;
+};
+/** Build a `PerplexityDeepResearchService`. For Layer setup, prefer {@link layer}. */
+declare const make: (cfg: Config) => Effect.Effect<PerplexityDeepResearchService, never, HttpClient.HttpClient>;
+/**
+ * Layer registering the provider-typed `PerplexityDeepResearch` tag and the
+ * generic `DeepResearch` tag. No capability markers: the whole surface (poll,
+ * collect, synthesized stream) is universal.
+ */
+declare const layer: (cfg: Config) => Layer.Layer<PerplexityDeepResearch | DeepResearch, never, HttpClient.HttpClient>;
+//#endregion
+export { Config, PerplexityDeepResearch, PerplexityDeepResearchService, PerplexityResearchRequest, layer, make, PerplexityDeepResearch_d_exports as t };
+//# sourceMappingURL=PerplexityDeepResearch.d.mts.map

package/dist/PerplexityDeepResearch.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerplexityDeepResearch.d.mts","names":[],"sources":["../src/PerplexityDeepResearch.ts"],"mappings":";;;;;;;;;;;;;;;;;KA2BY,yBAAA,GAA4B,IAAA,CAAK,eAAA;EAAA,SAClC,KAAA,GAAQ,uBAAA;EAAA,SACR,eAAA,GAAkB,yBAAA;AAAA;AAAA,KAGjB,6BAAA,GAAgC,wBAAA,CAAyB,yBAAA;AAAA,cAA0B,2BAAA;;;;;;;;;cAUlF,sBAAA,SAA+B,2BAAA;AAAA,KAKhC,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA,WApBkB;EAAA,SAsBlB,GAAA,GAAM,GAAA,CAAI,SAAA;AAAA;AAnBrB;AAAA,cAqOa,IAAA,GACX,GAAA,EAAK,MAAA,KACJ,MAAA,CAAO,MAAA,CAAO,6BAAA,SAAsC,UAAA,CAAW,UAAA;;;;AAvO6B;;cA+OlF,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,sBAAA,GAAyB,YAAA,SAAqB,UAAA,CAAW,UAAA"}

package/dist/PerplexityDeepResearch.mjs

@@ -0,0 +1,171 @@
+import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
+import { httpStatusError, transportFailure } from "./http.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 Job from "@effect-uai/core/Job";
+//#region src/PerplexityDeepResearch.ts
+var PerplexityDeepResearch_exports = /* @__PURE__ */ __exportAll({
+	PerplexityDeepResearch: () => PerplexityDeepResearch,
+	layer: () => layer,
+	make: () => make
+});
+/**
+* Provider-typed tag. Yield this for the Perplexity model / `reasoningEffort`
+* knobs; yield the generic `DeepResearch` tag for provider-portable code. The
+* async job is poll-only, so it has no live event stream: `researchStream` /
+* `streamFrom` return the synthesized progress {@link fromJob} builds (a leading
+* search event, then the terminal report). `cancel` fails `Unsupported` (no
+* endpoint). A persisted ref survives a restart (the job is server-backed).
+*/
+var PerplexityDeepResearch = class extends Context.Service()("@betalyra/effect-uai/providers/perplexity/PerplexityDeepResearch") {};
+const WireSearchResult = Schema.Struct({
+	title: Schema.String,
+	url: Schema.String,
+	snippet: Schema.optional(Schema.String)
+});
+const WireChoice = Schema.Struct({ message: Schema.optional(Schema.Struct({ content: Schema.optional(Schema.NullOr(Schema.String)) })) });
+const WireUsage = Schema.Struct({
+	prompt_tokens: Schema.optional(Schema.Number),
+	completion_tokens: Schema.optional(Schema.Number),
+	total_tokens: Schema.optional(Schema.Number)
+});
+const WireCompletion = Schema.Struct({
+	choices: Schema.Array(WireChoice),
+	search_results: Schema.optional(Schema.Array(WireSearchResult)),
+	citations: Schema.optional(Schema.Array(Schema.String)),
+	usage: Schema.optional(WireUsage)
+});
+const WireJob = Schema.Struct({
+	id: Schema.String,
+	status: Schema.Literals([
+		"CREATED",
+		"IN_PROGRESS",
+		"COMPLETED",
+		"FAILED"
+	]),
+	error_message: Schema.optional(Schema.NullOr(Schema.String)),
+	response: Schema.optional(Schema.NullOr(WireCompletion))
+});
+const decodeJob = Schema.decodeUnknownEffect(WireJob);
+const blockText = Match.type().pipe(Match.discriminatorsExhaustive("type")({
+	input_text: (b) => b.text,
+	output_text: (b) => b.text,
+	input_image: () => "",
+	refusal: () => ""
+}));
+const historyToMessages = (history) => history.filter((i) => i.type === "message").map((m) => ({
+	role: m.role,
+	content: m.content.map(blockText).join("")
+}));
+const citationsOf = (wire) => wire.search_results !== void 0 && wire.search_results.length > 0 ? wire.search_results.map((r, i) => ({
+	type: "url_citation",
+	url: r.url,
+	title: r.title,
+	marker: i + 1,
+	...r.snippet !== void 0 && r.snippet !== "" && { cited_text: r.snippet }
+})) : (wire.citations ?? []).map((url, i) => ({
+	type: "url_citation",
+	url,
+	title: url,
+	marker: i + 1
+}));
+const completionToTurn = (wire) => {
+	const text = wire.choices[0]?.message?.content ?? "";
+	const annotations = citationsOf(wire);
+	return {
+		items: [{
+			type: "message",
+			role: "assistant",
+			content: [{
+				type: "output_text",
+				text,
+				...annotations.length > 0 && { annotations }
+			}],
+			providerData: wire
+		}],
+		usage: {
+			...wire.usage?.prompt_tokens !== void 0 && { input_tokens: wire.usage.prompt_tokens },
+			...wire.usage?.completion_tokens !== void 0 && { output_tokens: wire.usage.completion_tokens },
+			...wire.usage?.total_tokens !== void 0 && { total_tokens: wire.usage.total_tokens }
+		},
+		stop_reason: "stop"
+	};
+};
+const jobStateOf = (wire) => Match.value(wire.status).pipe(Match.when("CREATED", () => ({ _tag: "Pending" })), Match.when("IN_PROGRESS", () => ({ _tag: "Running" })), Match.when("COMPLETED", () => wire.response != null ? {
+	_tag: "Succeeded",
+	result: completionToTurn(wire.response)
+} : {
+	_tag: "Failed",
+	reason: "job completed with no response body",
+	raw: wire
+}), Match.when("FAILED", () => ({
+	_tag: "Failed",
+	...wire.error_message != null && { reason: wire.error_message },
+	raw: wire
+})), Match.exhaustive);
+const baseUrl = (cfg) => cfg.baseUrl ?? "https://api.perplexity.ai";
+const authHeader = (cfg) => HttpClientRequest.setHeader("authorization", `Bearer ${Redacted.value(cfg.apiKey)}`);
+const submitBody = (request) => ({ request: {
+	model: request.model ?? "sonar-deep-research",
+	messages: historyToMessages(request.history),
+	...request.reasoningEffort !== void 0 && { reasoning_effort: request.reasoningEffort }
+} });
+const submitJob = (cfg, request) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/v1/async/sonar`).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* decodeJob(yield* response.json.pipe(Effect.mapError(transportFailure))).pipe(Effect.mapError(transportFailure));
+	return Job.jobRef("perplexity", wire.id);
+});
+const pollJob = (cfg, ref) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const httpRequest = HttpClientRequest.get(`${baseUrl(cfg)}/v1/async/sonar/${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* decodeJob(yield* response.json.pipe(Effect.mapError(transportFailure))).pipe(Effect.mapError(transportFailure)));
+});
+const unsupported = (capability) => new AiError.Unsupported({
+	provider: "perplexity",
+	capability,
+	reason: "Perplexity's async research job is poll-only and cannot be cancelled."
+});
+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 a `PerplexityDeepResearchService`. 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 `PerplexityDeepResearch` tag and the
+* generic `DeepResearch` tag. No capability markers: the whole surface (poll,
+* collect, synthesized stream) is universal.
+*/
+const layer = (cfg) => {
+	const typed = Layer.effect(PerplexityDeepResearch, 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 { PerplexityDeepResearch, layer, make, PerplexityDeepResearch_exports as t };
+
+//# sourceMappingURL=PerplexityDeepResearch.mjs.map

package/dist/PerplexityDeepResearch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerplexityDeepResearch.mjs","names":[],"sources":["../src/PerplexityDeepResearch.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 type { Annotation, ContentBlock, HistoryItem, Message } from \"@effect-uai/core/Items\"\nimport * as Job from \"@effect-uai/core/Job\"\nimport type { ResearchJobRef, ResearchRequest, ResearchState } from \"@effect-uai/core/Research\"\nimport type { Turn } from \"@effect-uai/core/Turn\"\nimport { httpStatusError, transportFailure } from \"./http.js\"\nimport type { PerplexityReasoningEffort, PerplexityResearchModel } from \"./models.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Perplexity-typed research request. Narrows `model` to the sonar research\n * models and adds `reasoningEffort` (a Perplexity knob that also steers how\n * many searches `sonar-deep-research` runs). Provider-portable code uses the\n * generic `DeepResearch` tag instead.\n */\nexport type PerplexityResearchRequest = Omit<ResearchRequest, \"model\"> & {\n  readonly model?: PerplexityResearchModel\n  readonly reasoningEffort?: PerplexityReasoningEffort\n}\n\nexport type PerplexityDeepResearchService = DeepResearchServiceShape<PerplexityResearchRequest>\n\n/**\n * Provider-typed tag. Yield this for the Perplexity model / `reasoningEffort`\n * knobs; yield the generic `DeepResearch` tag for provider-portable code. The\n * async job is poll-only, so it has no live event stream: `researchStream` /\n * `streamFrom` return the synthesized progress {@link fromJob} builds (a leading\n * search event, then the terminal report). `cancel` fails `Unsupported` (no\n * endpoint). A persisted ref survives a restart (the job is server-backed).\n */\nexport class PerplexityDeepResearch extends Context.Service<\n  PerplexityDeepResearch,\n  PerplexityDeepResearchService\n>()(\"@betalyra/effect-uai/providers/perplexity/PerplexityDeepResearch\") {}\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 WireSearchResult = Schema.Struct({\n  title: Schema.String,\n  url: Schema.String,\n  snippet: Schema.optional(Schema.String),\n})\n\nconst WireChoice = Schema.Struct({\n  message: Schema.optional(\n    Schema.Struct({ content: Schema.optional(Schema.NullOr(Schema.String)) }),\n  ),\n})\n\nconst WireUsage = Schema.Struct({\n  prompt_tokens: Schema.optional(Schema.Number),\n  completion_tokens: Schema.optional(Schema.Number),\n  total_tokens: Schema.optional(Schema.Number),\n})\n\nconst WireCompletion = Schema.Struct({\n  choices: Schema.Array(WireChoice),\n  search_results: Schema.optional(Schema.Array(WireSearchResult)),\n  citations: Schema.optional(Schema.Array(Schema.String)),\n  usage: Schema.optional(WireUsage),\n})\ntype WireCompletion = typeof WireCompletion.Type\n\nconst WireJob = Schema.Struct({\n  id: Schema.String,\n  status: Schema.Literals([\"CREATED\", \"IN_PROGRESS\", \"COMPLETED\", \"FAILED\"]),\n  error_message: Schema.optional(Schema.NullOr(Schema.String)),\n  response: Schema.optional(Schema.NullOr(WireCompletion)),\n})\ntype WireJob = typeof WireJob.Type\n\nconst decodeJob = Schema.decodeUnknownEffect(WireJob)\n\n// Text of a content block; only the two text-bearing kinds contribute.\nconst blockText = Match.type<ContentBlock>().pipe(\n  Match.discriminatorsExhaustive(\"type\")({\n    input_text: (b) => b.text,\n    output_text: (b) => b.text,\n    input_image: () => \"\",\n    refusal: () => \"\",\n  }),\n)\n\nconst historyToMessages = (\n  history: ReadonlyArray<HistoryItem>,\n): ReadonlyArray<{ readonly role: string; readonly content: string }> =>\n  history\n    .filter((i): i is Message => i.type === \"message\")\n    .map((m) => ({ role: m.role, content: m.content.map(blockText).join(\"\") }))\n\n// Perplexity links answers to sources with positional `[n]` markers, so each\n// citation carries a 1-based `marker` (and `cited_text` from the snippet), the\n// provider-agnostic representation of that style. Prefer the richer\n// `search_results`; fall back to the legacy `citations` URL list.\nconst citationsOf = (wire: WireCompletion): ReadonlyArray<Annotation> =>\n  wire.search_results !== undefined && wire.search_results.length > 0\n    ? wire.search_results.map((r, i) => ({\n        type: \"url_citation\" as const,\n        url: r.url,\n        title: r.title,\n        marker: i + 1,\n        ...(r.snippet !== undefined && r.snippet !== \"\" && { cited_text: r.snippet }),\n      }))\n    : (wire.citations ?? []).map((url, i) => ({\n        type: \"url_citation\" as const,\n        url,\n        title: url,\n        marker: i + 1,\n      }))\n\nconst completionToTurn = (wire: WireCompletion): Turn => {\n  const text = wire.choices[0]?.message?.content ?? \"\"\n  const annotations = citationsOf(wire)\n  return {\n    items: [\n      {\n        type: \"message\",\n        role: \"assistant\",\n        content: [{ type: \"output_text\", text, ...(annotations.length > 0 && { annotations }) }],\n        providerData: wire,\n      },\n    ],\n    usage: {\n      ...(wire.usage?.prompt_tokens !== undefined && { input_tokens: wire.usage.prompt_tokens }),\n      ...(wire.usage?.completion_tokens !== undefined && {\n        output_tokens: wire.usage.completion_tokens,\n      }),\n      ...(wire.usage?.total_tokens !== undefined && { total_tokens: wire.usage.total_tokens }),\n    },\n    stop_reason: \"stop\",\n  }\n}\n\n// Map Perplexity's four job states onto the generic `JobState`, carrying the\n// assembled `Turn` on `Succeeded` and the provider message on `Failed`.\nconst jobStateOf = (wire: WireJob): ResearchState =>\n  Match.value(wire.status).pipe(\n    Match.when(\"CREATED\", (): ResearchState => ({ _tag: \"Pending\" })),\n    Match.when(\"IN_PROGRESS\", (): ResearchState => ({ _tag: \"Running\" })),\n    Match.when(\n      \"COMPLETED\",\n      (): ResearchState =>\n        wire.response != null\n          ? { _tag: \"Succeeded\", result: completionToTurn(wire.response) }\n          : { _tag: \"Failed\", reason: \"job completed with no response body\", raw: wire },\n    ),\n    Match.when(\n      \"FAILED\",\n      (): ResearchState => ({\n        _tag: \"Failed\",\n        ...(wire.error_message != null && { reason: wire.error_message }),\n        raw: wire,\n      }),\n    ),\n    Match.exhaustive,\n  )\n\n// ---------------------------------------------------------------------------\n// HTTP\n// ---------------------------------------------------------------------------\n\nconst baseUrl = (cfg: Config): string => cfg.baseUrl ?? \"https://api.perplexity.ai\"\n\nconst authHeader = (cfg: Config) =>\n  HttpClientRequest.setHeader(\"authorization\", `Bearer ${Redacted.value(cfg.apiKey)}`)\n\nconst submitBody = (request: PerplexityResearchRequest): Record<string, unknown> => ({\n  request: {\n    model: request.model ?? \"sonar-deep-research\",\n    messages: historyToMessages(request.history),\n    ...(request.reasoningEffort !== undefined && { reasoning_effort: request.reasoningEffort }),\n  },\n})\n\nconst submitJob = (\n  cfg: Config,\n  request: PerplexityResearchRequest,\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)}/v1/async/sonar`).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* decodeJob(json).pipe(Effect.mapError(transportFailure))\n    return Job.jobRef<Turn>(\"perplexity\", 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)}/v1/async/sonar/${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* decodeJob(json).pipe(Effect.mapError(transportFailure))\n    return jobStateOf(wire)\n  })\n\n// Perplexity exposes no cancel endpoint and no event stream on the async job.\nconst unsupported = (capability: string): AiError.Unsupported =>\n  new AiError.Unsupported({\n    provider: \"perplexity\",\n    capability,\n    reason: \"Perplexity's async research job is poll-only and cannot be cancelled.\",\n  })\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n// The three job ops. Poll-only, so no `streamFrom`: `fromJob` synthesizes one.\nconst jobOps = (\n  cfg: Config,\n  client: HttpClient.HttpClient,\n): ResearchJobOps<PerplexityResearchRequest> => {\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 a `PerplexityDeepResearchService`. For Layer setup, prefer {@link layer}. */\nexport const make = (\n  cfg: Config,\n): Effect.Effect<PerplexityDeepResearchService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) => fromJob(jobOps(cfg, client), cfg.job))\n\n/**\n * Layer registering the provider-typed `PerplexityDeepResearch` tag and the\n * generic `DeepResearch` tag. No capability markers: the whole surface (poll,\n * collect, synthesized stream) is universal.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<PerplexityDeepResearch | DeepResearch, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(PerplexityDeepResearch, 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 PerplexityResearchRequest),\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/dist/PerplexitySearch.mjs

@@ -128,7 +128,7 @@ const searchImpl = (cfg) => (request) => postSearch(cfg, buildBody(request)).pip
 * Build a `PerplexitySearchService` value. For Layer-based setup, prefer
 * {@link layer}.
 */
-const make = (cfg) => Effect.map(HttpClient.HttpClient.asEffect(), (client) => ({ search: (request) => searchImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)) }));
+const make = (cfg) => Effect.map(HttpClient.HttpClient, (client) => ({ search: (request) => searchImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)) }));
 /**
 * Layer registering both the provider-typed `PerplexitySearch` tag and the
 * generic `WebSearch` tag over one implementation. A `CommonSearchRequest`

package/dist/PerplexitySearch.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"PerplexitySearch.mjs","names":[],"sources":["../src/PerplexitySearch.ts"],"sourcesContent":["import { Context, DateTime, Effect, Layer, Option, type Redacted, Schema } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport {\n  type CommonSearchRequest,\n  type SearchResponse,\n  type SearchResult,\n  WebSearch,\n  type WebSearchService,\n} from \"@effect-uai/core/WebSearch\"\nimport type { PerplexitySearchContextSize } from \"./models.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Perplexity-typed search request. Widens {@link CommonSearchRequest} with\n * the provider's own knobs; the common fields map onto Perplexity's wire\n * filters (see the codec below). There is no `model` - `/search` ranks the\n * web directly.\n */\nexport type PerplexitySearchRequest = CommonSearchRequest & {\n  /** Depth / cost trade-off - see {@link PerplexitySearchContextSize}. */\n  readonly searchContextSize?: PerplexitySearchContextSize\n  /** Cap on tokens extracted per result page (1..1_000_000). */\n  readonly maxTokensPerPage?: number\n}\n\nexport type PerplexitySearchService = {\n  readonly search: (\n    request: PerplexitySearchRequest,\n  ) => Effect.Effect<SearchResponse, AiError.AiError>\n}\n\n/**\n * Provider-typed service tag. Yield this for Perplexity-typed search\n * (`searchContextSize`, `maxTokensPerPage`); yield the generic `WebSearch`\n * tag for provider-portable code. Both are registered by {@link layer}.\n */\nexport class PerplexitySearch extends Context.Service<PerplexitySearch, PerplexitySearchService>()(\n  \"@betalyra/effect-uai/providers/perplexity/PerplexitySearch\",\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 max_results?: number\n  readonly country?: string\n  readonly search_language_filter?: ReadonlyArray<string>\n  readonly search_domain_filter?: ReadonlyArray<string>\n  readonly search_recency_filter?: string\n  readonly search_after_date_filter?: string\n  readonly search_before_date_filter?: string\n  readonly search_context_size?: string\n  readonly max_tokens_per_page?: number\n}\n\n/** Perplexity wants dates as `MM/DD/YYYY`, in UTC. */\nconst formatMmDdYyyy = (dt: DateTime.DateTime): string => {\n  const d = DateTime.toDateUtc(dt)\n  const mm = String(d.getUTCMonth() + 1).padStart(2, \"0\")\n  const dd = String(d.getUTCDate()).padStart(2, \"0\")\n  return `${mm}/${dd}/${d.getUTCFullYear()}`\n}\n\n/**\n * Perplexity has no separate include / exclude fields - it takes one\n * `search_domain_filter` array where an exclusion is a `-` prefix. Lossless\n * shape transform, so done silently (bucket 3).\n */\nconst domainFilter = (\n  include: ReadonlyArray<string> | undefined,\n  exclude: ReadonlyArray<string> | undefined,\n): ReadonlyArray<string> | undefined => {\n  const all = [...(include ?? []), ...(exclude ?? []).map((d) => `-${d}`)]\n  return all.length > 0 ? all : undefined\n}\n\nconst buildBody = (request: PerplexitySearchRequest): WireBody => {\n  const domains = domainFilter(request.includeDomains, request.excludeDomains)\n  return {\n    query: request.query,\n    ...(request.maxResults !== undefined && { max_results: request.maxResults }),\n    ...(request.country !== undefined && { country: request.country }),\n    ...(request.language !== undefined && { search_language_filter: [request.language] }),\n    ...(domains !== undefined && { search_domain_filter: domains }),\n    ...(request.recency !== undefined && { search_recency_filter: request.recency }),\n    ...(request.startDate !== undefined && {\n      search_after_date_filter: formatMmDdYyyy(request.startDate),\n    }),\n    ...(request.endDate !== undefined && {\n      search_before_date_filter: formatMmDdYyyy(request.endDate),\n    }),\n    ...(request.searchContextSize !== undefined && {\n      search_context_size: request.searchContextSize,\n    }),\n    ...(request.maxTokensPerPage !== undefined && {\n      max_tokens_per_page: request.maxTokensPerPage,\n    }),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Codec - response\n// ---------------------------------------------------------------------------\n\nconst WireResult = Schema.Struct({\n  title: Schema.String,\n  url: Schema.String,\n  snippet: Schema.optional(Schema.String),\n  date: Schema.optional(Schema.NullOr(Schema.String)),\n  last_updated: Schema.optional(Schema.NullOr(Schema.String)),\n})\ntype WireResult = typeof WireResult.Type\n\nconst WireResponse = Schema.Struct({\n  results: Schema.Array(WireResult),\n  id: Schema.optional(Schema.String),\n})\ntype WireResponse = typeof WireResponse.Type\n\n/** Lenient parse of Perplexity's date strings; unparseable -> omitted. */\nconst parseDate = (s: string | null | undefined): DateTime.DateTime | undefined =>\n  s == null ? undefined : Option.getOrUndefined(DateTime.make(s))\n\nconst toResult = (r: WireResult): SearchResult => {\n  const publishedDate = parseDate(r.date)\n  return {\n    url: r.url,\n    title: r.title,\n    // Perplexity returns no relevance score, so `score` stays undefined.\n    ...(r.snippet !== undefined && { snippet: r.snippet }),\n    ...(publishedDate !== undefined && { publishedDate }),\n    raw: r,\n  }\n}\n\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: \"perplexity\", raw: cause })\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"perplexity\"\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.perplexity.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.bearerToken(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: PerplexitySearchRequest,\n  ): Effect.Effect<SearchResponse, AiError.AiError, HttpClient.HttpClient> =>\n    postSearch(cfg, buildBody(request)).pipe(Effect.map(toResponse))\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/**\n * Build a `PerplexitySearchService` value. For Layer-based setup, prefer\n * {@link layer}.\n */\nexport const make = (\n  cfg: Config,\n): Effect.Effect<PerplexitySearchService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient.asEffect(), (client) => ({\n    search: (request) =>\n      searchImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n  }))\n\n/**\n * Layer registering both the provider-typed `PerplexitySearch` tag and the\n * generic `WebSearch` tag over one implementation. A `CommonSearchRequest`\n * is structurally a `PerplexitySearchRequest` with the provider extras\n * unset, so the generic registration forwards directly.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<PerplexitySearch | WebSearch, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(PerplexitySearch, 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":"PerplexitySearch.mjs","names":[],"sources":["../src/PerplexitySearch.ts"],"sourcesContent":["import { Context, DateTime, Effect, Layer, Option, type Redacted, Schema } from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport {\n  type CommonSearchRequest,\n  type SearchResponse,\n  type SearchResult,\n  WebSearch,\n  type WebSearchService,\n} from \"@effect-uai/core/WebSearch\"\nimport type { PerplexitySearchContextSize } from \"./models.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Perplexity-typed search request. Widens {@link CommonSearchRequest} with\n * the provider's own knobs; the common fields map onto Perplexity's wire\n * filters (see the codec below). There is no `model` - `/search` ranks the\n * web directly.\n */\nexport type PerplexitySearchRequest = CommonSearchRequest & {\n  /** Depth / cost trade-off - see {@link PerplexitySearchContextSize}. */\n  readonly searchContextSize?: PerplexitySearchContextSize\n  /** Cap on tokens extracted per result page (1..1_000_000). */\n  readonly maxTokensPerPage?: number\n}\n\nexport type PerplexitySearchService = {\n  readonly search: (\n    request: PerplexitySearchRequest,\n  ) => Effect.Effect<SearchResponse, AiError.AiError>\n}\n\n/**\n * Provider-typed service tag. Yield this for Perplexity-typed search\n * (`searchContextSize`, `maxTokensPerPage`); yield the generic `WebSearch`\n * tag for provider-portable code. Both are registered by {@link layer}.\n */\nexport class PerplexitySearch extends Context.Service<PerplexitySearch, PerplexitySearchService>()(\n  \"@betalyra/effect-uai/providers/perplexity/PerplexitySearch\",\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 max_results?: number\n  readonly country?: string\n  readonly search_language_filter?: ReadonlyArray<string>\n  readonly search_domain_filter?: ReadonlyArray<string>\n  readonly search_recency_filter?: string\n  readonly search_after_date_filter?: string\n  readonly search_before_date_filter?: string\n  readonly search_context_size?: string\n  readonly max_tokens_per_page?: number\n}\n\n/** Perplexity wants dates as `MM/DD/YYYY`, in UTC. */\nconst formatMmDdYyyy = (dt: DateTime.DateTime): string => {\n  const d = DateTime.toDateUtc(dt)\n  const mm = String(d.getUTCMonth() + 1).padStart(2, \"0\")\n  const dd = String(d.getUTCDate()).padStart(2, \"0\")\n  return `${mm}/${dd}/${d.getUTCFullYear()}`\n}\n\n/**\n * Perplexity has no separate include / exclude fields - it takes one\n * `search_domain_filter` array where an exclusion is a `-` prefix. Lossless\n * shape transform, so done silently (bucket 3).\n */\nconst domainFilter = (\n  include: ReadonlyArray<string> | undefined,\n  exclude: ReadonlyArray<string> | undefined,\n): ReadonlyArray<string> | undefined => {\n  const all = [...(include ?? []), ...(exclude ?? []).map((d) => `-${d}`)]\n  return all.length > 0 ? all : undefined\n}\n\nconst buildBody = (request: PerplexitySearchRequest): WireBody => {\n  const domains = domainFilter(request.includeDomains, request.excludeDomains)\n  return {\n    query: request.query,\n    ...(request.maxResults !== undefined && { max_results: request.maxResults }),\n    ...(request.country !== undefined && { country: request.country }),\n    ...(request.language !== undefined && { search_language_filter: [request.language] }),\n    ...(domains !== undefined && { search_domain_filter: domains }),\n    ...(request.recency !== undefined && { search_recency_filter: request.recency }),\n    ...(request.startDate !== undefined && {\n      search_after_date_filter: formatMmDdYyyy(request.startDate),\n    }),\n    ...(request.endDate !== undefined && {\n      search_before_date_filter: formatMmDdYyyy(request.endDate),\n    }),\n    ...(request.searchContextSize !== undefined && {\n      search_context_size: request.searchContextSize,\n    }),\n    ...(request.maxTokensPerPage !== undefined && {\n      max_tokens_per_page: request.maxTokensPerPage,\n    }),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Codec - response\n// ---------------------------------------------------------------------------\n\nconst WireResult = Schema.Struct({\n  title: Schema.String,\n  url: Schema.String,\n  snippet: Schema.optional(Schema.String),\n  date: Schema.optional(Schema.NullOr(Schema.String)),\n  last_updated: Schema.optional(Schema.NullOr(Schema.String)),\n})\ntype WireResult = typeof WireResult.Type\n\nconst WireResponse = Schema.Struct({\n  results: Schema.Array(WireResult),\n  id: Schema.optional(Schema.String),\n})\ntype WireResponse = typeof WireResponse.Type\n\n/** Lenient parse of Perplexity's date strings; unparseable -> omitted. */\nconst parseDate = (s: string | null | undefined): DateTime.DateTime | undefined =>\n  s == null ? undefined : Option.getOrUndefined(DateTime.make(s))\n\nconst toResult = (r: WireResult): SearchResult => {\n  const publishedDate = parseDate(r.date)\n  return {\n    url: r.url,\n    title: r.title,\n    // Perplexity returns no relevance score, so `score` stays undefined.\n    ...(r.snippet !== undefined && { snippet: r.snippet }),\n    ...(publishedDate !== undefined && { publishedDate }),\n    raw: r,\n  }\n}\n\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: \"perplexity\", raw: cause })\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"perplexity\"\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.perplexity.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.bearerToken(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: PerplexitySearchRequest,\n  ): Effect.Effect<SearchResponse, AiError.AiError, HttpClient.HttpClient> =>\n    postSearch(cfg, buildBody(request)).pipe(Effect.map(toResponse))\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\n/**\n * Build a `PerplexitySearchService` value. For Layer-based setup, prefer\n * {@link layer}.\n */\nexport const make = (\n  cfg: Config,\n): Effect.Effect<PerplexitySearchService, 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 `PerplexitySearch` tag and the\n * generic `WebSearch` tag over one implementation. A `CommonSearchRequest`\n * is structurally a `PerplexitySearchRequest` with the provider extras\n * unset, so the generic registration forwards directly.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<PerplexitySearch | WebSearch, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(PerplexitySearch, 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/http.d.mts

@@ -0,0 +1,10 @@
+import * as AiError from "@effect-uai/core/AiError";
+
+//#region src/http.d.ts
+/** Transport-level failure (connection dropped, DNS, etc.) before a response. */
+declare const transportFailure: (cause: unknown) => AiError.AiError;
+/** Map a >=400 HTTP status to the nearest `AiError`. */
+declare const httpStatusError: (status: number, body: string) => AiError.AiError;
+//#endregion
+export { httpStatusError, transportFailure };
+//# sourceMappingURL=http.d.mts.map

package/dist/http.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.mts","names":[],"sources":["../src/http.ts"],"mappings":";;;;cAKa,gBAAA,GAAoB,KAAA,cAAiB,OAAA,CAAQ,OAAA;AAA1D;AAAA,cAIa,eAAA,GAAmB,MAAA,UAAgB,IAAA,aAAe,OAAA,CAAQ,OAAA"}

package/dist/http.mjs

@@ -0,0 +1,48 @@
+import * as AiError from "@effect-uai/core/AiError";
+//#region src/http.ts
+const provider = "perplexity";
+/** Transport-level failure (connection dropped, DNS, etc.) before a response. */
+const transportFailure = (cause) => new AiError.Unavailable({
+	provider,
+	raw: cause
+});
+/** Map a >=400 HTTP status to the nearest `AiError`. */
+const httpStatusError = (status, body) => {
+	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
+	});
+};
+//#endregion
+export { httpStatusError, transportFailure };
+
+//# sourceMappingURL=http.mjs.map

package/dist/http.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.mjs","names":[],"sources":["../src/http.ts"],"sourcesContent":["import * as AiError from \"@effect-uai/core/AiError\"\n\nconst provider = \"perplexity\"\n\n/** Transport-level failure (connection dropped, DNS, etc.) before a response. */\nexport const transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider, raw: cause })\n\n/** Map a >=400 HTTP status to the nearest `AiError`. */\nexport const httpStatusError = (status: number, body: string): AiError.AiError => {\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"],"mappings":";;AAEA,MAAM,WAAW;;AAGjB,MAAa,oBAAoB,UAC/B,IAAI,QAAQ,YAAY;CAAE;CAAU,KAAK;CAAO,CAAC;;AAGnD,MAAa,mBAAmB,QAAgB,SAAkC;CAChF,MAAM,MAAM;AACZ,KAAI,WAAW,IAAK,QAAO,IAAI,QAAQ,YAAY;EAAE;EAAU;EAAK,CAAC;AACrE,KAAI,WAAW,OAAO,WAAW,IAAK,QAAO,IAAI,QAAQ,QAAQ;EAAE;EAAU;EAAK,CAAC;AACnF,KAAI,WAAW,IAAK,QAAO,IAAI,QAAQ,WAAW;EAAE;EAAU,SAAS;EAAQ;EAAK,CAAC;AACrF,KAAI,WAAW,IAAK,QAAO,IAAI,QAAQ,WAAW;EAAE;EAAU,SAAS;EAAc;EAAK,CAAC;AAC3F,KAAI,WAAW,IAAK,QAAO,IAAI,QAAQ,WAAW;EAAE;EAAU,SAAS;EAAW;EAAK,CAAC;AACxF,KAAI,UAAU,IAAK,QAAO,IAAI,QAAQ,YAAY;EAAE;EAAU;EAAQ;EAAK,CAAC;AAC5E,QAAO,IAAI,QAAQ,eAAe;EAAE;EAAU;EAAK,CAAC"}

package/dist/index.d.mts

@@ -1,3 +1,4 @@
-import { PerplexitySearchContextSize } from "./models.mjs";
+import { PerplexityReasoningEffort, PerplexityResearchModel, PerplexitySearchContextSize } from "./models.mjs";
+import { t as PerplexityDeepResearch_d_exports } from "./PerplexityDeepResearch.mjs";
 import { t as PerplexitySearch_d_exports } from "./PerplexitySearch.mjs";
-export { PerplexitySearch_d_exports as PerplexitySearch, PerplexitySearchContextSize };
+export { PerplexityDeepResearch_d_exports as PerplexityDeepResearch, PerplexityReasoningEffort, PerplexityResearchModel, PerplexitySearch_d_exports as PerplexitySearch, PerplexitySearchContextSize };

package/dist/index.mjs

@@ -1,3 +1,4 @@
+import { t as PerplexityDeepResearch_exports } from "./PerplexityDeepResearch.mjs";
 import { t as PerplexitySearch_exports } from "./PerplexitySearch.mjs";
 import "./models.mjs";
-export { PerplexitySearch_exports as PerplexitySearch };
+export { PerplexityDeepResearch_exports as PerplexityDeepResearch, PerplexitySearch_exports as PerplexitySearch };

package/dist/models.d.mts

@@ -12,6 +12,18 @@
  * rather than the cross-provider `CommonSearchRequest`.
  */
 type PerplexitySearchContextSize = "low" | "medium" | "high";
+/**
+ * Models the async research endpoint (`/v1/async/sonar`) accepts. Deep research
+ * is `sonar-deep-research`; the other sonar models are also submittable but are
+ * meant for the sync chat endpoint, so the default is `sonar-deep-research`.
+ */
+type PerplexityResearchModel = "sonar-deep-research" | "sonar" | "sonar-pro" | "sonar-reasoning-pro";
+/**
+ * Depth knob for reasoning-capable models. Perplexity-specific (not on the
+ * cross-provider `ResearchRequest`), it also steers how many searches
+ * `sonar-deep-research` runs.
+ */
+type PerplexityReasoningEffort = "minimal" | "low" | "medium" | "high";
 //#endregion
-export { PerplexitySearchContextSize };
+export { PerplexityReasoningEffort, PerplexityResearchModel, PerplexitySearchContextSize };
 //# 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":";;AAYA;;;;;;;;;;;KAAY,2BAAA"}
+{"version":3,"file":"models.d.mts","names":[],"sources":["../src/models.ts"],"mappings":";;AAYA;;;;;AAOA;;;;;AAWA;KAlBY,2BAAA;;;;;;KAOA,uBAAA;;;;;;KAWA,yBAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect-uai/perplexity",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Perplexity provider for @effect-uai/core (web search).",
   "keywords": [
     "ai",
@@ -34,6 +34,10 @@
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs"
     },
+    "./PerplexityDeepResearch": {
+      "types": "./dist/PerplexityDeepResearch.d.mts",
+      "import": "./dist/PerplexityDeepResearch.mjs"
+    },
     "./PerplexitySearch": {
       "types": "./dist/PerplexitySearch.d.mts",
       "import": "./dist/PerplexitySearch.mjs"
@@ -43,13 +47,13 @@
     "access": "public"
   },
   "devDependencies": {
-    "effect": "4.0.0-beta.57",
+    "effect": "4.0.0-beta.94",
     "typescript": "^6.0.3",
-    "@effect-uai/core": "0.10.0"
+    "@effect-uai/core": "0.11.0"
   },
   "peerDependencies": {
     "@effect-uai/core": ">=0.2.0 <1",
-    "effect": "4.0.0-beta.57"
+    "effect": ">=4.0.0-beta.94 <5.0.0"
   },
   "scripts": {
     "build": "tsdown",

package/src/PerplexityDeepResearch.ts

@@ -0,0 +1,291 @@
+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 type { Annotation, ContentBlock, HistoryItem, Message } from "@effect-uai/core/Items"
+import * as Job from "@effect-uai/core/Job"
+import type { ResearchJobRef, ResearchRequest, ResearchState } from "@effect-uai/core/Research"
+import type { Turn } from "@effect-uai/core/Turn"
+import { httpStatusError, transportFailure } from "./http.js"
+import type { PerplexityReasoningEffort, PerplexityResearchModel } from "./models.js"
+
+// ---------------------------------------------------------------------------
+// Public types
+// ---------------------------------------------------------------------------
+
+/**
+ * Perplexity-typed research request. Narrows `model` to the sonar research
+ * models and adds `reasoningEffort` (a Perplexity knob that also steers how
+ * many searches `sonar-deep-research` runs). Provider-portable code uses the
+ * generic `DeepResearch` tag instead.
+ */
+export type PerplexityResearchRequest = Omit<ResearchRequest, "model"> & {
+  readonly model?: PerplexityResearchModel
+  readonly reasoningEffort?: PerplexityReasoningEffort
+}
+
+export type PerplexityDeepResearchService = DeepResearchServiceShape<PerplexityResearchRequest>
+
+/**
+ * Provider-typed tag. Yield this for the Perplexity model / `reasoningEffort`
+ * knobs; yield the generic `DeepResearch` tag for provider-portable code. The
+ * async job is poll-only, so it has no live event stream: `researchStream` /
+ * `streamFrom` return the synthesized progress {@link fromJob} builds (a leading
+ * search event, then the terminal report). `cancel` fails `Unsupported` (no
+ * endpoint). A persisted ref survives a restart (the job is server-backed).
+ */
+export class PerplexityDeepResearch extends Context.Service<
+  PerplexityDeepResearch,
+  PerplexityDeepResearchService
+>()("@betalyra/effect-uai/providers/perplexity/PerplexityDeepResearch") {}
+
+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 WireSearchResult = Schema.Struct({
+  title: Schema.String,
+  url: Schema.String,
+  snippet: Schema.optional(Schema.String),
+})
+
+const WireChoice = Schema.Struct({
+  message: Schema.optional(
+    Schema.Struct({ content: Schema.optional(Schema.NullOr(Schema.String)) }),
+  ),
+})
+
+const WireUsage = Schema.Struct({
+  prompt_tokens: Schema.optional(Schema.Number),
+  completion_tokens: Schema.optional(Schema.Number),
+  total_tokens: Schema.optional(Schema.Number),
+})
+
+const WireCompletion = Schema.Struct({
+  choices: Schema.Array(WireChoice),
+  search_results: Schema.optional(Schema.Array(WireSearchResult)),
+  citations: Schema.optional(Schema.Array(Schema.String)),
+  usage: Schema.optional(WireUsage),
+})
+type WireCompletion = typeof WireCompletion.Type
+
+const WireJob = Schema.Struct({
+  id: Schema.String,
+  status: Schema.Literals(["CREATED", "IN_PROGRESS", "COMPLETED", "FAILED"]),
+  error_message: Schema.optional(Schema.NullOr(Schema.String)),
+  response: Schema.optional(Schema.NullOr(WireCompletion)),
+})
+type WireJob = typeof WireJob.Type
+
+const decodeJob = Schema.decodeUnknownEffect(WireJob)
+
+// Text of a content block; only the two text-bearing kinds contribute.
+const blockText = Match.type<ContentBlock>().pipe(
+  Match.discriminatorsExhaustive("type")({
+    input_text: (b) => b.text,
+    output_text: (b) => b.text,
+    input_image: () => "",
+    refusal: () => "",
+  }),
+)
+
+const historyToMessages = (
+  history: ReadonlyArray<HistoryItem>,
+): ReadonlyArray<{ readonly role: string; readonly content: string }> =>
+  history
+    .filter((i): i is Message => i.type === "message")
+    .map((m) => ({ role: m.role, content: m.content.map(blockText).join("") }))
+
+// Perplexity links answers to sources with positional `[n]` markers, so each
+// citation carries a 1-based `marker` (and `cited_text` from the snippet), the
+// provider-agnostic representation of that style. Prefer the richer
+// `search_results`; fall back to the legacy `citations` URL list.
+const citationsOf = (wire: WireCompletion): ReadonlyArray<Annotation> =>
+  wire.search_results !== undefined && wire.search_results.length > 0
+    ? wire.search_results.map((r, i) => ({
+        type: "url_citation" as const,
+        url: r.url,
+        title: r.title,
+        marker: i + 1,
+        ...(r.snippet !== undefined && r.snippet !== "" && { cited_text: r.snippet }),
+      }))
+    : (wire.citations ?? []).map((url, i) => ({
+        type: "url_citation" as const,
+        url,
+        title: url,
+        marker: i + 1,
+      }))
+
+const completionToTurn = (wire: WireCompletion): Turn => {
+  const text = wire.choices[0]?.message?.content ?? ""
+  const annotations = citationsOf(wire)
+  return {
+    items: [
+      {
+        type: "message",
+        role: "assistant",
+        content: [{ type: "output_text", text, ...(annotations.length > 0 && { annotations }) }],
+        providerData: wire,
+      },
+    ],
+    usage: {
+      ...(wire.usage?.prompt_tokens !== undefined && { input_tokens: wire.usage.prompt_tokens }),
+      ...(wire.usage?.completion_tokens !== undefined && {
+        output_tokens: wire.usage.completion_tokens,
+      }),
+      ...(wire.usage?.total_tokens !== undefined && { total_tokens: wire.usage.total_tokens }),
+    },
+    stop_reason: "stop",
+  }
+}
+
+// Map Perplexity's four job states onto the generic `JobState`, carrying the
+// assembled `Turn` on `Succeeded` and the provider message on `Failed`.
+const jobStateOf = (wire: WireJob): ResearchState =>
+  Match.value(wire.status).pipe(
+    Match.when("CREATED", (): ResearchState => ({ _tag: "Pending" })),
+    Match.when("IN_PROGRESS", (): ResearchState => ({ _tag: "Running" })),
+    Match.when(
+      "COMPLETED",
+      (): ResearchState =>
+        wire.response != null
+          ? { _tag: "Succeeded", result: completionToTurn(wire.response) }
+          : { _tag: "Failed", reason: "job completed with no response body", raw: wire },
+    ),
+    Match.when(
+      "FAILED",
+      (): ResearchState => ({
+        _tag: "Failed",
+        ...(wire.error_message != null && { reason: wire.error_message }),
+        raw: wire,
+      }),
+    ),
+    Match.exhaustive,
+  )
+
+// ---------------------------------------------------------------------------
+// HTTP
+// ---------------------------------------------------------------------------
+
+const baseUrl = (cfg: Config): string => cfg.baseUrl ?? "https://api.perplexity.ai"
+
+const authHeader = (cfg: Config) =>
+  HttpClientRequest.setHeader("authorization", `Bearer ${Redacted.value(cfg.apiKey)}`)
+
+const submitBody = (request: PerplexityResearchRequest): Record<string, unknown> => ({
+  request: {
+    model: request.model ?? "sonar-deep-research",
+    messages: historyToMessages(request.history),
+    ...(request.reasoningEffort !== undefined && { reasoning_effort: request.reasoningEffort }),
+  },
+})
+
+const submitJob = (
+  cfg: Config,
+  request: PerplexityResearchRequest,
+): Effect.Effect<ResearchJobRef, AiError.AiError, HttpClient.HttpClient> =>
+  Effect.gen(function* () {
+    const client = yield* HttpClient.HttpClient
+    const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/v1/async/sonar`).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* decodeJob(json).pipe(Effect.mapError(transportFailure))
+    return Job.jobRef<Turn>("perplexity", 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)}/v1/async/sonar/${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* decodeJob(json).pipe(Effect.mapError(transportFailure))
+    return jobStateOf(wire)
+  })
+
+// Perplexity exposes no cancel endpoint and no event stream on the async job.
+const unsupported = (capability: string): AiError.Unsupported =>
+  new AiError.Unsupported({
+    provider: "perplexity",
+    capability,
+    reason: "Perplexity's async research job is poll-only and cannot be cancelled.",
+  })
+
+// ---------------------------------------------------------------------------
+// Constructors
+// ---------------------------------------------------------------------------
+
+// The three job ops. Poll-only, so no `streamFrom`: `fromJob` synthesizes one.
+const jobOps = (
+  cfg: Config,
+  client: HttpClient.HttpClient,
+): ResearchJobOps<PerplexityResearchRequest> => {
+  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 a `PerplexityDeepResearchService`. For Layer setup, prefer {@link layer}. */
+export const make = (
+  cfg: Config,
+): Effect.Effect<PerplexityDeepResearchService, never, HttpClient.HttpClient> =>
+  Effect.map(HttpClient.HttpClient, (client) => fromJob(jobOps(cfg, client), cfg.job))
+
+/**
+ * Layer registering the provider-typed `PerplexityDeepResearch` tag and the
+ * generic `DeepResearch` tag. No capability markers: the whole surface (poll,
+ * collect, synthesized stream) is universal.
+ */
+export const layer = (
+  cfg: Config,
+): Layer.Layer<PerplexityDeepResearch | DeepResearch, never, HttpClient.HttpClient> => {
+  const typed = Layer.effect(PerplexityDeepResearch, 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 PerplexityResearchRequest),
+          poll: ops.poll,
+          cancel: ops.cancel,
+        },
+        cfg.job,
+      )
+    }),
+  )
+  return Layer.merge(typed, generic)
+}

package/src/PerplexitySearch.ts

@@ -209,7 +209,7 @@ const searchImpl =
 export const make = (
   cfg: Config,
 ): Effect.Effect<PerplexitySearchService, never, HttpClient.HttpClient> =>
-  Effect.map(HttpClient.HttpClient.asEffect(), (client) => ({
+  Effect.map(HttpClient.HttpClient, (client) => ({
     search: (request) =>
       searchImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),
   }))

package/src/http.ts

@@ -0,0 +1,19 @@
+import * as AiError from "@effect-uai/core/AiError"
+
+const provider = "perplexity"
+
+/** Transport-level failure (connection dropped, DNS, etc.) before a response. */
+export const transportFailure = (cause: unknown): AiError.AiError =>
+  new AiError.Unavailable({ provider, raw: cause })
+
+/** Map a >=400 HTTP status to the nearest `AiError`. */
+export const httpStatusError = (status: number, body: string): AiError.AiError => {
+  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 })
+}

package/src/index.ts

@@ -1,2 +1,3 @@
+export * as PerplexityDeepResearch from "./PerplexityDeepResearch.js"
 export * as PerplexitySearch from "./PerplexitySearch.js"
 export * from "./models.js"

package/src/models.ts

@@ -11,3 +11,21 @@
  * rather than the cross-provider `CommonSearchRequest`.
  */
 export type PerplexitySearchContextSize = "low" | "medium" | "high"
+
+/**
+ * Models the async research endpoint (`/v1/async/sonar`) accepts. Deep research
+ * is `sonar-deep-research`; the other sonar models are also submittable but are
+ * meant for the sync chat endpoint, so the default is `sonar-deep-research`.
+ */
+export type PerplexityResearchModel =
+  | "sonar-deep-research"
+  | "sonar"
+  | "sonar-pro"
+  | "sonar-reasoning-pro"
+
+/**
+ * Depth knob for reasoning-capable models. Perplexity-specific (not on the
+ * cross-provider `ResearchRequest`), it also steers how many searches
+ * `sonar-deep-research` runs.
+ */
+export type PerplexityReasoningEffort = "minimal" | "low" | "medium" | "high"