@effect-uai/google 0.10.0 → 0.12.0

package/dist/GoogleDeepResearch.d.mts

@@ -0,0 +1,122 @@
+import { GoogleDeepResearchModel } from "./models.mjs";
+import { Context, Effect, Layer, Option, Redacted, Schema } from "effect";
+import { HttpClient } from "effect/unstable/http";
+import { DeepResearch, DeepResearchServiceShape } from "@effect-uai/core/DeepResearch";
+import * as Items from "@effect-uai/core/Items";
+import * as Job from "@effect-uai/core/Job";
+import { ResearchRequest, ResearchState } from "@effect-uai/core/Research";
+
+//#region src/GoogleDeepResearch.d.ts
+declare namespace GoogleDeepResearch_d_exports {
+  export { Config, GeminiResearchData, GoogleDeepResearch, GoogleDeepResearchService, GoogleResearchRequest, WireInteraction, jobStateOf, layer, make, researchDataOf };
+}
+/**
+ * Gemini-typed research request. Narrows `model` to the deep-research agent ids.
+ * Provider-portable code uses the generic `DeepResearch` tag instead.
+ */
+type GoogleResearchRequest = Omit<ResearchRequest, "model"> & {
+  readonly model?: GoogleDeepResearchModel;
+};
+type GoogleDeepResearchService = DeepResearchServiceShape<GoogleResearchRequest>;
+declare const GoogleDeepResearch_base: Context.ServiceClass<GoogleDeepResearch, "@betalyra/effect-uai/providers/google/GoogleDeepResearch", GoogleDeepResearchService>;
+/**
+ * Provider-typed tag for Gemini deep research over the Interactions API
+ * (`POST /v1beta/interactions`, `agent: deep-research-*`). Yield this for the
+ * agent-id knob; yield the generic `DeepResearch` tag for portable code.
+ *
+ * `research` / `submit` / `collect` drive a background job by polling;
+ * `researchStream` consumes the real Interactions SSE (`step.delta` text /
+ * thought, terminating in `interaction.completed`). Preview surface: the SSE
+ * event shapes and the completed-interaction citation shape are decoded
+ * defensively and best confirmed against a live response.
+ */
+declare class GoogleDeepResearch extends GoogleDeepResearch_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 WireInteraction: Schema.Struct<{
+  readonly id: Schema.optional<Schema.NullOr<Schema.String>>;
+  readonly status: Schema.optional<Schema.NullOr<Schema.String>>;
+  readonly outputs: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Struct<{
+    readonly type: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly text: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly groundingMetadata: Schema.optional<Schema.NullOr<Schema.Struct<{
+      readonly groundingChunks: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Struct<{
+        readonly web: Schema.optional<Schema.NullOr<Schema.Struct<{
+          readonly uri: Schema.optional<Schema.NullOr<Schema.String>>;
+          readonly title: Schema.optional<Schema.NullOr<Schema.String>>;
+        }>>>;
+      }>>>>;
+    }>>>;
+  }>>>>;
+  readonly steps: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Struct<{
+    readonly type: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly text: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly content: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Struct<{
+      readonly type: Schema.optional<Schema.NullOr<Schema.String>>;
+      readonly text: Schema.optional<Schema.NullOr<Schema.String>>;
+      readonly groundingMetadata: Schema.optional<Schema.NullOr<Schema.Struct<{
+        readonly groundingChunks: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Struct<{
+          readonly web: Schema.optional<Schema.NullOr<Schema.Struct<{
+            readonly uri: Schema.optional<Schema.NullOr<Schema.String>>;
+            readonly title: Schema.optional<Schema.NullOr<Schema.String>>;
+          }>>>;
+        }>>>>;
+      }>>>;
+    }>>>>;
+    readonly groundingMetadata: Schema.optional<Schema.NullOr<Schema.Struct<{
+      readonly groundingChunks: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Struct<{
+        readonly web: Schema.optional<Schema.NullOr<Schema.Struct<{
+          readonly uri: Schema.optional<Schema.NullOr<Schema.String>>;
+          readonly title: Schema.optional<Schema.NullOr<Schema.String>>;
+        }>>>;
+      }>>>>;
+    }>>>;
+  }>>>>;
+  readonly groundingMetadata: Schema.optional<Schema.NullOr<Schema.Struct<{
+    readonly groundingChunks: Schema.optional<Schema.NullOr<Schema.$Array<Schema.Struct<{
+      readonly web: Schema.optional<Schema.NullOr<Schema.Struct<{
+        readonly uri: Schema.optional<Schema.NullOr<Schema.String>>;
+        readonly title: Schema.optional<Schema.NullOr<Schema.String>>;
+      }>>>;
+    }>>>>;
+  }>>>;
+  readonly error: Schema.optional<Schema.NullOr<Schema.Struct<{
+    readonly message: Schema.optional<Schema.NullOr<Schema.String>>;
+    readonly code: Schema.optional<Schema.NullOr<Schema.String>>;
+  }>>>;
+}>;
+type WireInteraction = typeof WireInteraction.Type;
+/**
+ * The research trace: what the model did at each step and which sources it
+ * consulted there. The `Turn` keeps only the final report and the deduped
+ * union of all sources, so the per-step breakdown lives here or nowhere.
+ *
+ * Lands on `providerData.gemini`; read it with {@link researchDataOf}.
+ */
+declare const GeminiResearchData: Schema.Struct<{
+  readonly steps: Schema.$Array<Schema.Struct<{
+    readonly text: Schema.String;
+    readonly sources: Schema.$Array<Schema.Struct<{
+      readonly url: Schema.String;
+      readonly title: Schema.optional<Schema.String>;
+    }>>;
+  }>>;
+}>;
+type GeminiResearchData = typeof GeminiResearchData.Type;
+/** Read this provider's data off an item, if it is there and ours. */
+declare const researchDataOf: (item: Items.HistoryItem) => Option.Option<GeminiResearchData>;
+declare const jobStateOf: (wire: WireInteraction) => ResearchState;
+/** Build a `GoogleDeepResearchService`. For Layer setup, prefer {@link layer}. */
+declare const make: (cfg: Config) => Effect.Effect<GoogleDeepResearchService, never, HttpClient.HttpClient>;
+/**
+ * Layer registering the provider-typed `GoogleDeepResearch` tag and the generic
+ * `DeepResearch` tag. No capability markers: the surface (poll, collect,
+ * synthesized stream) is universal.
+ */
+declare const layer: (cfg: Config) => Layer.Layer<GoogleDeepResearch | DeepResearch, never, HttpClient.HttpClient>;
+//#endregion
+export { Config, GeminiResearchData, GoogleDeepResearch, GoogleDeepResearchService, GoogleResearchRequest, WireInteraction, jobStateOf, layer, make, researchDataOf, GoogleDeepResearch_d_exports as t };
+//# sourceMappingURL=GoogleDeepResearch.d.mts.map

package/dist/GoogleDeepResearch.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleDeepResearch.d.mts","names":[],"sources":["../src/GoogleDeepResearch.ts"],"mappings":";;;;;;;;;;;;;;;;KAwCY,qBAAA,GAAwB,IAAA,CAAK,eAAA;EAAA,SAC9B,KAAA,GAAQ,uBAAA;AAAA;AAAA,KAGP,yBAAA,GAA4B,wBAAA,CAAyB,qBAAA;AAAA,cAAsB,uBAAA;;;;;;;AAJvF;;;;;cAiBa,kBAAA,SAA2B,uBAAA;AAAA,KAK5B,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA,WAvBA;EAAA,SAyBA,GAAA,GAAM,GAAA,CAAI,SAAA;AAAA;AAAA,cA4BR,eAAA,EAAe,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAehB,eAAA,UAAyB,eAAA,CAAgB,IAAA;;;;;;;;cAkCxC,kBAAA,EAAkB,MAAA,CAAA,MAAA;EAAA;;;;;;;;KAQnB,kBAAA,UAA4B,kBAAA,CAAmB,IAAA;;cAK9C,cAAA,GAAkB,IAAA,EAAM,KAAA,CAAM,WAAA,KAAc,MAAA,CAAO,MAAA,CAAO,kBAAA;AAAA,cA4D1D,UAAA,GAAc,IAAA,EAAM,eAAA,KAAkB,aAAA;;cA4StC,IAAA,GACX,GAAA,EAAK,MAAA,KACJ,MAAA,CAAO,MAAA,CAAO,yBAAA,SAAkC,UAAA,CAAW,UAAA;;;;;;cAUjD,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,kBAAA,GAAqB,YAAA,SAAqB,UAAA,CAAW,UAAA"}

package/dist/GoogleDeepResearch.mjs

@@ -0,0 +1,320 @@
+import { n as __exportAll } from "./chunk-uyGKjUfl.mjs";
+import { GroundingMetadata, groundingToAnnotations } from "./codec.mjs";
+import { Array, Context, Effect, Layer, Match, Option, Redacted, Ref, Result, Schema, Stream, pipe } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import * as AiError from "@effect-uai/core/AiError";
+import * as SSE from "@effect-uai/core/SSE";
+import { TurnEvent } from "@effect-uai/core/Turn";
+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/GoogleDeepResearch.ts
+var GoogleDeepResearch_exports = /* @__PURE__ */ __exportAll({
+	GeminiResearchData: () => GeminiResearchData,
+	GoogleDeepResearch: () => GoogleDeepResearch,
+	WireInteraction: () => WireInteraction,
+	jobStateOf: () => jobStateOf,
+	layer: () => layer,
+	make: () => make,
+	researchDataOf: () => researchDataOf
+});
+/**
+* Provider-typed tag for Gemini deep research over the Interactions API
+* (`POST /v1beta/interactions`, `agent: deep-research-*`). Yield this for the
+* agent-id knob; yield the generic `DeepResearch` tag for portable code.
+*
+* `research` / `submit` / `collect` drive a background job by polling;
+* `researchStream` consumes the real Interactions SSE (`step.delta` text /
+* thought, terminating in `interaction.completed`). Preview surface: the SSE
+* event shapes and the completed-interaction citation shape are decoded
+* defensively and best confirmed against a live response.
+*/
+var GoogleDeepResearch = class extends Context.Service()("@betalyra/effect-uai/providers/google/GoogleDeepResearch") {};
+const WireSubmit = Schema.Struct({ id: Schema.String });
+const decodeSubmit = Schema.decodeUnknownEffect(WireSubmit);
+const WireTextPart = Schema.Struct({
+	type: Schema.optional(Schema.NullOr(Schema.String)),
+	text: Schema.optional(Schema.NullOr(Schema.String)),
+	groundingMetadata: Schema.optional(Schema.NullOr(GroundingMetadata))
+});
+const WireStep = Schema.Struct({
+	type: Schema.optional(Schema.NullOr(Schema.String)),
+	text: Schema.optional(Schema.NullOr(Schema.String)),
+	content: Schema.optional(Schema.NullOr(Schema.Array(WireTextPart))),
+	groundingMetadata: Schema.optional(Schema.NullOr(GroundingMetadata))
+});
+const WireInteraction = Schema.Struct({
+	id: Schema.optional(Schema.NullOr(Schema.String)),
+	status: Schema.optional(Schema.NullOr(Schema.String)),
+	outputs: Schema.optional(Schema.NullOr(Schema.Array(WireTextPart))),
+	steps: Schema.optional(Schema.NullOr(Schema.Array(WireStep))),
+	groundingMetadata: Schema.optional(Schema.NullOr(GroundingMetadata)),
+	error: Schema.optional(Schema.NullOr(Schema.Struct({
+		message: Schema.optional(Schema.NullOr(Schema.String)),
+		code: Schema.optional(Schema.NullOr(Schema.String))
+	})))
+});
+const decodeInteraction = Schema.decodeUnknownEffect(WireInteraction);
+const textOfParts = (parts) => (parts ?? []).filter((p) => (p.type ?? "text") === "text" && p.text != null).map((p) => p.text).join("");
+const reportText = (wire) => {
+	const fromOutputs = textOfParts(wire.outputs);
+	if (fromOutputs.length > 0) return fromOutputs;
+	const lastStep = (wire.steps ?? []).at(-1);
+	const fromStep = textOfParts(lastStep?.content);
+	return fromStep.length > 0 ? fromStep : lastStep?.text ?? "";
+};
+/**
+* The subset of the domain `Citation.Source` this provider can populate.
+* Declared here rather than derived from the wire schema, so the exported
+* shape is ours and a wire change cannot silently alter it.
+*/
+const SourceSchema = Schema.Struct({
+	url: Schema.String,
+	title: Schema.optional(Schema.String)
+});
+/**
+* The research trace: what the model did at each step and which sources it
+* consulted there. The `Turn` keeps only the final report and the deduped
+* union of all sources, so the per-step breakdown lives here or nowhere.
+*
+* Lands on `providerData.gemini`; read it with {@link researchDataOf}.
+*/
+const GeminiResearchData = Schema.Struct({ steps: Schema.Array(Schema.Struct({
+	text: Schema.String,
+	sources: Schema.Array(SourceSchema)
+})) });
+const decodeResearchData = Schema.decodeUnknownResult(Schema.Struct({ gemini: GeminiResearchData }));
+/** Read this provider's data off an item, if it is there and ours. */
+const researchDataOf = (item) => pipe(decodeResearchData(item.providerData), Result.match({
+	onSuccess: (d) => Option.some(d.gemini),
+	onFailure: () => Option.none()
+}));
+const sourcesOf = (meta) => (meta?.groundingChunks ?? []).flatMap((chunk) => chunk.web?.uri == null ? [] : [{
+	url: chunk.web.uri,
+	...chunk.web.title != null && { title: chunk.web.title }
+}]);
+const researchSteps = (wire) => (wire.steps ?? []).flatMap((step) => {
+	const text = textOfParts(step.content) || (step.text ?? "");
+	const sources = [...sourcesOf(step.groundingMetadata), ...(step.content ?? []).flatMap((p) => sourcesOf(p.groundingMetadata))];
+	return text.length === 0 && sources.length === 0 ? [] : [{
+		text,
+		sources
+	}];
+});
+const interactionAnnotations = (wire) => groundingToAnnotations(wire.groundingMetadata, ...Array.map(wire.outputs ?? [], (o) => o.groundingMetadata), ...Array.map(wire.steps ?? [], (s) => s.groundingMetadata));
+const turnFromInteraction = (wire) => {
+	const annotations = interactionAnnotations(wire);
+	return {
+		items: [{
+			type: "message",
+			role: "assistant",
+			content: [{
+				type: "output_text",
+				text: reportText(wire),
+				...annotations.length > 0 && { annotations }
+			}],
+			providerData: { gemini: { steps: researchSteps(wire) } }
+		}],
+		usage: {},
+		stop_reason: "stop"
+	};
+};
+const jobStateOf = (wire) => Match.value(wire.status ?? "").pipe(Match.whenOr("queued", "pending", () => ({ _tag: "Pending" })), Match.whenOr("in_progress", "running", "processing", () => ({ _tag: "Running" })), Match.whenOr("completed", "succeeded", () => ({
+	_tag: "Succeeded",
+	result: turnFromInteraction(wire)
+})), Match.whenOr("failed", "error", "cancelled", () => ({
+	_tag: "Failed",
+	...wire.error?.message != null && { reason: wire.error.message },
+	raw: wire
+})), Match.orElse(() => ({ _tag: "Running" })));
+const baseUrl = (cfg) => cfg.baseUrl ?? "https://generativelanguage.googleapis.com/v1beta";
+const authHeader = (cfg) => HttpClientRequest.setHeader("x-goog-api-key", Redacted.value(cfg.apiKey));
+const transportFailure = (cause) => new AiError.Unavailable({
+	provider: "google",
+	raw: cause
+});
+const httpStatusError = (status, body) => {
+	const provider = "google";
+	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 === 413) return new AiError.ContextLengthExceeded({
+		provider,
+		raw
+	});
+	if (status >= 500) return new AiError.Unavailable({
+		provider,
+		status,
+		raw
+	});
+	return new AiError.InvalidRequest({
+		provider,
+		raw
+	});
+};
+const inputText = (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) => ({
+	agent: request.model ?? "deep-research-preview-04-2026",
+	input: inputText(request.history),
+	background: true,
+	store: true,
+	agent_config: {
+		type: "deep-research",
+		thinking_summaries: "auto"
+	},
+	tools: [{ type: "google_search" }]
+});
+const submitJob = (cfg, request) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/interactions`).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("google", wire.id);
+});
+const pollJob = (cfg, ref) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const httpRequest = HttpClientRequest.get(`${baseUrl(cfg)}/interactions/${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));
+	yield* Effect.logDebug("google interactions poll response", { interaction: json });
+	return jobStateOf(yield* decodeInteraction(json).pipe(Effect.mapError(transportFailure)));
+});
+const unsupported = (capability) => new AiError.Unsupported({
+	provider: "google",
+	capability,
+	reason: "Gemini deep research (preview) exposes no verified cancel endpoint."
+});
+const WireDelta = Schema.Struct({
+	type: Schema.optional(Schema.NullOr(Schema.String)),
+	text: Schema.optional(Schema.NullOr(Schema.String)),
+	content: Schema.optional(Schema.NullOr(Schema.Struct({
+		type: Schema.optional(Schema.NullOr(Schema.String)),
+		text: Schema.optional(Schema.NullOr(Schema.String))
+	})))
+});
+const WireStreamEvent = Schema.Struct({
+	event_type: Schema.optional(Schema.NullOr(Schema.String)),
+	delta: Schema.optional(Schema.NullOr(WireDelta)),
+	interaction: Schema.optional(Schema.NullOr(WireInteraction)),
+	error: Schema.optional(Schema.NullOr(Schema.Struct({ message: Schema.optional(Schema.NullOr(Schema.String)) })))
+});
+const parseJsonUnknown = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown));
+const decodeStreamEvent = Schema.decodeUnknownEffect(WireStreamEvent);
+const completedTurn = (wire, streamed) => wire != null && reportText(wire).length > 0 ? turnFromInteraction(wire) : {
+	items: [{
+		type: "message",
+		role: "assistant",
+		content: [{
+			type: "output_text",
+			text: streamed
+		}],
+		...wire != null && { providerData: { gemini: { steps: researchSteps(wire) } } }
+	}],
+	usage: {},
+	stop_reason: "stop"
+};
+const streamEventToTurnEvents = (acc, ev) => {
+	if (ev.event_type === "interaction.error") return Effect.fail(new AiError.GenerationFailed({
+		provider: "google",
+		...ev.error?.message != null && { message: ev.error.message },
+		raw: ev
+	}));
+	if (ev.event_type === "step.delta") {
+		const delta = ev.delta;
+		if (delta?.text != null) {
+			const text = delta.text;
+			return Effect.as(Ref.update(acc, (streamed) => streamed + text), [TurnEvent.TextDelta({ text })]);
+		}
+		if (delta?.content?.text != null) return Effect.succeed([TurnEvent.ReasoningDelta({
+			text: delta.content.text,
+			kind: "summary"
+		})]);
+		return Effect.succeed([]);
+	}
+	if (ev.event_type === "interaction.completed") return Effect.map(Ref.get(acc), (streamed) => [TurnEvent.TurnComplete({ turn: completedTurn(ev.interaction, streamed) })]);
+	return Effect.succeed([]);
+};
+const streamCreate = (cfg, request) => Stream.unwrap(Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const acc = yield* Ref.make("");
+	const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/interactions?stream=true`).pipe(authHeader(cfg), HttpClientRequest.bodyJsonUnsafe({
+		...submitBody(request),
+		stream: true
+	}), HttpClientRequest.accept("text/event-stream"));
+	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
+	yield* Effect.logDebug("google interactions stream response", {
+		status: response.status,
+		contentType: response.headers["content-type"]
+	});
+	if (response.status >= 400) {
+		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+		return Stream.fail(httpStatusError(response.status, text));
+	}
+	return response.stream.pipe(Stream.mapError(transportFailure), SSE.fromBytes, Stream.tap((ev) => Effect.logDebug("google interactions sse frame", {
+		event: ev.event,
+		data: ev.data
+	})), Stream.filter((ev) => ev.event !== "done" && ev.data.trim() !== "[DONE]"), Stream.mapEffect((ev) => parseJsonUnknown(ev.data).pipe(Effect.flatMap(decodeStreamEvent), Effect.mapError(transportFailure), Effect.flatMap((wire) => streamEventToTurnEvents(acc, wire)))), Stream.flatMap(Stream.fromIterable));
+}));
+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"))
+	};
+};
+const buildService = (cfg, client, ops, toGoogle) => ({
+	...fromJob(ops, cfg.job),
+	researchStream: (request) => Stream.provideService(streamCreate(cfg, toGoogle(request)), HttpClient.HttpClient, client)
+});
+/** Build a `GoogleDeepResearchService`. For Layer setup, prefer {@link layer}. */
+const make = (cfg) => Effect.map(HttpClient.HttpClient, (client) => buildService(cfg, client, jobOps(cfg, client), (request) => request));
+/**
+* Layer registering the provider-typed `GoogleDeepResearch` tag and the generic
+* `DeepResearch` tag. No capability markers: the surface (poll, collect,
+* synthesized stream) is universal.
+*/
+const layer = (cfg) => {
+	const typed = Layer.effect(GoogleDeepResearch, make(cfg));
+	const generic = Layer.effect(DeepResearch, Effect.map(HttpClient.HttpClient, (client) => {
+		const ops = jobOps(cfg, client);
+		return buildService(cfg, client, {
+			...ops,
+			submit: (request) => ops.submit(request)
+		}, (request) => request);
+	}));
+	return Layer.merge(typed, generic);
+};
+//#endregion
+export { GeminiResearchData, GoogleDeepResearch, WireInteraction, jobStateOf, layer, make, researchDataOf, GoogleDeepResearch_exports as t };
+
+//# sourceMappingURL=GoogleDeepResearch.mjs.map

package/dist/GoogleDeepResearch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleDeepResearch.mjs","names":["Arr"],"sources":["../src/GoogleDeepResearch.ts"],"sourcesContent":["import {\n  Array as Arr,\n  Context,\n  Effect,\n  Layer,\n  Match,\n  Option,\n  Redacted,\n  Ref,\n  Result,\n  Schema,\n  Stream,\n  pipe,\n} from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { Source } from \"@effect-uai/core/Citation\"\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 type { ResearchJobRef, ResearchRequest, ResearchState } from \"@effect-uai/core/Research\"\nimport * as SSE from \"@effect-uai/core/SSE\"\nimport { type Turn, TurnEvent } from \"@effect-uai/core/Turn\"\nimport { GroundingMetadata, groundingToAnnotations } from \"./codec.js\"\nimport type { GoogleDeepResearchModel } from \"./models.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Gemini-typed research request. Narrows `model` to the deep-research agent ids.\n * Provider-portable code uses the generic `DeepResearch` tag instead.\n */\nexport type GoogleResearchRequest = Omit<ResearchRequest, \"model\"> & {\n  readonly model?: GoogleDeepResearchModel\n}\n\nexport type GoogleDeepResearchService = DeepResearchServiceShape<GoogleResearchRequest>\n\n/**\n * Provider-typed tag for Gemini deep research over the Interactions API\n * (`POST /v1beta/interactions`, `agent: deep-research-*`). Yield this for the\n * agent-id knob; yield the generic `DeepResearch` tag for portable code.\n *\n * `research` / `submit` / `collect` drive a background job by polling;\n * `researchStream` consumes the real Interactions SSE (`step.delta` text /\n * thought, terminating in `interaction.completed`). Preview surface: the SSE\n * event shapes and the completed-interaction citation shape are decoded\n * defensively and best confirmed against a live response.\n */\nexport class GoogleDeepResearch extends Context.Service<\n  GoogleDeepResearch,\n  GoogleDeepResearchService\n>()(\"@betalyra/effect-uai/providers/google/GoogleDeepResearch\") {}\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\n// A completed interaction's text lives at `outputs[].text` (SDK `outputs`) or,\n// in some doc examples, `steps[].content[].text`. Decode both defensively and\n// extract from whichever is populated. Grounding sources ride Google's\n// `groundingMetadata.groundingChunks[]`; this preview surface is undocumented,\n// so decode it at every plausible level (interaction / output / step) and map\n// whichever is populated onto `url_citation` annotations. The report text also\n// carries the sources as an inline `[n]` / `**Sources:**` list.\nconst WireTextPart = Schema.Struct({\n  type: Schema.optional(Schema.NullOr(Schema.String)),\n  text: Schema.optional(Schema.NullOr(Schema.String)),\n  groundingMetadata: Schema.optional(Schema.NullOr(GroundingMetadata)),\n})\nconst WireStep = Schema.Struct({\n  type: Schema.optional(Schema.NullOr(Schema.String)),\n  text: Schema.optional(Schema.NullOr(Schema.String)),\n  content: Schema.optional(Schema.NullOr(Schema.Array(WireTextPart))),\n  groundingMetadata: Schema.optional(Schema.NullOr(GroundingMetadata)),\n})\nexport const WireInteraction = Schema.Struct({\n  id: Schema.optional(Schema.NullOr(Schema.String)),\n  status: Schema.optional(Schema.NullOr(Schema.String)),\n  outputs: Schema.optional(Schema.NullOr(Schema.Array(WireTextPart))),\n  steps: Schema.optional(Schema.NullOr(Schema.Array(WireStep))),\n  groundingMetadata: Schema.optional(Schema.NullOr(GroundingMetadata)),\n  error: Schema.optional(\n    Schema.NullOr(\n      Schema.Struct({\n        message: Schema.optional(Schema.NullOr(Schema.String)),\n        code: Schema.optional(Schema.NullOr(Schema.String)),\n      }),\n    ),\n  ),\n})\nexport type WireInteraction = typeof WireInteraction.Type\nconst decodeInteraction = Schema.decodeUnknownEffect(WireInteraction)\n\nconst textOfParts = (parts: ReadonlyArray<typeof WireTextPart.Type> | null | undefined): string =>\n  (parts ?? [])\n    .filter((p) => (p.type ?? \"text\") === \"text\" && p.text != null)\n    .map((p) => p.text)\n    .join(\"\")\n\nconst reportText = (wire: WireInteraction): string => {\n  const fromOutputs = textOfParts(wire.outputs)\n  if (fromOutputs.length > 0) return fromOutputs\n  const lastStep = (wire.steps ?? []).at(-1)\n  const fromStep = textOfParts(lastStep?.content)\n  return fromStep.length > 0 ? fromStep : (lastStep?.text ?? \"\")\n}\n\n/**\n * The subset of the domain `Citation.Source` this provider can populate.\n * Declared here rather than derived from the wire schema, so the exported\n * shape is ours and a wire change cannot silently alter it.\n */\nconst SourceSchema = Schema.Struct({\n  url: Schema.String,\n  title: Schema.optional(Schema.String),\n})\n\n/**\n * The research trace: what the model did at each step and which sources it\n * consulted there. The `Turn` keeps only the final report and the deduped\n * union of all sources, so the per-step breakdown lives here or nowhere.\n *\n * Lands on `providerData.gemini`; read it with {@link researchDataOf}.\n */\nexport const GeminiResearchData = Schema.Struct({\n  steps: Schema.Array(\n    Schema.Struct({\n      text: Schema.String,\n      sources: Schema.Array(SourceSchema),\n    }),\n  ),\n})\nexport type GeminiResearchData = typeof GeminiResearchData.Type\n\nconst decodeResearchData = Schema.decodeUnknownResult(Schema.Struct({ gemini: GeminiResearchData }))\n\n/** Read this provider's data off an item, if it is there and ours. */\nexport const researchDataOf = (item: Items.HistoryItem): Option.Option<GeminiResearchData> =>\n  pipe(\n    decodeResearchData(item.providerData),\n    Result.match({\n      onSuccess: (d) => Option.some(d.gemini),\n      onFailure: () => Option.none<GeminiResearchData>(),\n    }),\n  )\n\nconst sourcesOf = (meta: GroundingMetadata | null | undefined): ReadonlyArray<Source> =>\n  (meta?.groundingChunks ?? []).flatMap((chunk) =>\n    chunk.web?.uri == null\n      ? []\n      : [{ url: chunk.web.uri, ...(chunk.web.title != null && { title: chunk.web.title }) }],\n  )\n\n// A step contributes to the trace if it said something or consulted something.\nconst researchSteps = (wire: WireInteraction): GeminiResearchData[\"steps\"] =>\n  (wire.steps ?? []).flatMap((step) => {\n    const text = textOfParts(step.content) || (step.text ?? \"\")\n    const sources = [\n      ...sourcesOf(step.groundingMetadata),\n      ...(step.content ?? []).flatMap((p) => sourcesOf(p.groundingMetadata)),\n    ]\n    return text.length === 0 && sources.length === 0 ? [] : [{ text, sources }]\n  })\n\n// Grounding can live at any level of the interaction envelope; gather it from\n// all three (interaction / output part / step) and let `groundingToAnnotations`\n// de-dupe by url.\nconst interactionAnnotations = (wire: WireInteraction): ReadonlyArray<Items.Annotation> =>\n  groundingToAnnotations(\n    wire.groundingMetadata,\n    ...Arr.map(wire.outputs ?? [], (o) => o.groundingMetadata),\n    ...Arr.map(wire.steps ?? [], (s) => s.groundingMetadata),\n  )\n\nconst turnFromInteraction = (wire: WireInteraction): Turn => {\n  const annotations = interactionAnnotations(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: { gemini: { steps: researchSteps(wire) } },\n      },\n    ],\n    usage: {},\n    stop_reason: \"stop\",\n  }\n}\n\n// Map the interaction status onto the generic `JobState`.\nexport const jobStateOf = (wire: WireInteraction): ResearchState =>\n  Match.value(wire.status ?? \"\").pipe(\n    Match.whenOr(\"queued\", \"pending\", (): ResearchState => ({ _tag: \"Pending\" })),\n    Match.whenOr(\n      \"in_progress\",\n      \"running\",\n      \"processing\",\n      (): ResearchState => ({ _tag: \"Running\" }),\n    ),\n    Match.whenOr(\n      \"completed\",\n      \"succeeded\",\n      (): ResearchState => ({ _tag: \"Succeeded\", result: turnFromInteraction(wire) }),\n    ),\n    Match.whenOr(\n      \"failed\",\n      \"error\",\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 =>\n  cfg.baseUrl ?? \"https://generativelanguage.googleapis.com/v1beta\"\n\nconst authHeader = (cfg: Config) =>\n  HttpClientRequest.setHeader(\"x-goog-api-key\", Redacted.value(cfg.apiKey))\n\nconst transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"google\", raw: cause })\n\nconst httpStatusError = (status: number, body: string): AiError.AiError => {\n  const provider = \"google\"\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 === 413) return new AiError.ContextLengthExceeded({ provider, 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 question. Concatenate the user turns' text into the\n// Interactions `input` string.\nconst inputText = (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: GoogleResearchRequest): Record<string, unknown> => ({\n  agent: request.model ?? \"deep-research-preview-04-2026\",\n  input: inputText(request.history),\n  background: true,\n  store: true,\n  agent_config: { type: \"deep-research\", thinking_summaries: \"auto\" },\n  tools: [{ type: \"google_search\" }],\n})\n\nconst submitJob = (\n  cfg: Config,\n  request: GoogleResearchRequest,\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)}/interactions`).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>(\"google\", 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)}/interactions/${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    // Preview surface: log the raw interaction so the (undocumented) grounding\n    // path can be confirmed against a live completed job at LOG_LEVEL=Debug.\n    yield* Effect.logDebug(\"google interactions poll response\", { interaction: json })\n    const wire = yield* decodeInteraction(json).pipe(Effect.mapError(transportFailure))\n    return jobStateOf(wire)\n  })\n\n// No verified cancel endpoint on the preview Interactions surface.\nconst unsupported = (capability: string): AiError.Unsupported =>\n  new AiError.Unsupported({\n    provider: \"google\",\n    capability,\n    reason: \"Gemini deep research (preview) exposes no verified cancel endpoint.\",\n  })\n\n// ---------------------------------------------------------------------------\n// Streaming (Interactions SSE)\n// ---------------------------------------------------------------------------\n\n// The Interactions stream emits `step.delta` events in two shapes: the report\n// body arrives as `delta: { type: \"text\", text }`, while a thinking summary\n// arrives as `delta: { type: \"thought_summary\", content: { text } }` (and a\n// content-free `thought_signature` we skip). Terminates in `interaction.completed`\n// / `interaction.error`, then an OpenAI-style `[DONE]` sentinel we drop upstream.\nconst WireDelta = Schema.Struct({\n  type: Schema.optional(Schema.NullOr(Schema.String)),\n  text: Schema.optional(Schema.NullOr(Schema.String)),\n  content: Schema.optional(\n    Schema.NullOr(\n      Schema.Struct({\n        type: Schema.optional(Schema.NullOr(Schema.String)),\n        text: Schema.optional(Schema.NullOr(Schema.String)),\n      }),\n    ),\n  ),\n})\nconst WireStreamEvent = Schema.Struct({\n  event_type: Schema.optional(Schema.NullOr(Schema.String)),\n  delta: Schema.optional(Schema.NullOr(WireDelta)),\n  interaction: Schema.optional(Schema.NullOr(WireInteraction)),\n  error: Schema.optional(\n    Schema.NullOr(Schema.Struct({ message: Schema.optional(Schema.NullOr(Schema.String)) })),\n  ),\n})\ntype WireStreamEvent = typeof WireStreamEvent.Type\n\nconst parseJsonUnknown = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown))\nconst decodeStreamEvent = Schema.decodeUnknownEffect(WireStreamEvent)\n\n// Prefer the completed interaction's decoded text; when the terminal event is\n// bare (or its text decodes empty) fall back to the accumulated stream deltas,\n// so `TurnComplete.turn` always carries the report that streamed.\nconst completedTurn = (wire: WireInteraction | null | undefined, streamed: string): Turn =>\n  wire != null && reportText(wire).length > 0\n    ? turnFromInteraction(wire)\n    : {\n        items: [\n          {\n            type: \"message\",\n            role: \"assistant\",\n            content: [{ type: \"output_text\", text: streamed }],\n            ...(wire != null && { providerData: { gemini: { steps: researchSteps(wire) } } }),\n          },\n        ],\n        usage: {},\n        stop_reason: \"stop\",\n      }\n\n// Map one wire event onto `TurnEvent`s, appending text deltas to `acc` (the\n// `completedTurn` fallback) and lifting `interaction.error` to a typed failure.\nconst streamEventToTurnEvents = (\n  acc: Ref.Ref<string>,\n  ev: WireStreamEvent,\n): Effect.Effect<ReadonlyArray<TurnEvent>, AiError.AiError> => {\n  if (ev.event_type === \"interaction.error\") {\n    return Effect.fail(\n      new AiError.GenerationFailed({\n        provider: \"google\",\n        ...(ev.error?.message != null && { message: ev.error.message }),\n        raw: ev,\n      }),\n    )\n  }\n  if (ev.event_type === \"step.delta\") {\n    const delta = ev.delta\n    // Report body: `delta.text`. Accumulate it so the terminal `TurnComplete`\n    // carries the report even when `interaction.completed` arrives text-free.\n    if (delta?.text != null) {\n      const text = delta.text\n      return Effect.as(\n        Ref.update(acc, (streamed) => streamed + text),\n        [TurnEvent.TextDelta({ text })],\n      )\n    }\n    // Thinking summary: nested under `delta.content.text`. Surfaced as reasoning,\n    // not accumulated into the report.\n    if (delta?.content?.text != null) {\n      return Effect.succeed([\n        TurnEvent.ReasoningDelta({ text: delta.content.text, kind: \"summary\" }),\n      ])\n    }\n    return Effect.succeed([])\n  }\n  if (ev.event_type === \"interaction.completed\") {\n    return Effect.map(Ref.get(acc), (streamed) => [\n      TurnEvent.TurnComplete({ turn: completedTurn(ev.interaction, streamed) }),\n    ])\n  }\n  return Effect.succeed([])\n}\n\n// A streaming interaction create (`?stream=true`): consume the SSE directly,\n// mapping each event onto `TurnEvent`s via {@link streamEventToTurnEvents}.\nconst streamCreate = (\n  cfg: Config,\n  request: GoogleResearchRequest,\n): Stream.Stream<TurnEvent, AiError.AiError, HttpClient.HttpClient> =>\n  Stream.unwrap(\n    Effect.gen(function* () {\n      const client = yield* HttpClient.HttpClient\n      const acc = yield* Ref.make(\"\")\n      const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/interactions?stream=true`).pipe(\n        authHeader(cfg),\n        HttpClientRequest.bodyJsonUnsafe({ ...submitBody(request), stream: true }),\n        HttpClientRequest.accept(\"text/event-stream\"),\n      )\n      const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n      // Preview surface: log the response status + content-type so an\n      // unexpected `application/json` (i.e. `?stream=true` not triggering SSE)\n      // is visible at LOG_LEVEL=Debug rather than presenting as a silent hang.\n      yield* Effect.logDebug(\"google interactions stream response\", {\n        status: response.status,\n        contentType: response.headers[\"content-type\"],\n      })\n      if (response.status >= 400) {\n        const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n        return Stream.fail(httpStatusError(response.status, text))\n      }\n      return response.stream.pipe(\n        Stream.mapError(transportFailure),\n        SSE.fromBytes,\n        // Log each raw frame before decode: the ground truth for the (unverified)\n        // event_type / delta shapes this codec keys on.\n        Stream.tap((ev) =>\n          Effect.logDebug(\"google interactions sse frame\", { event: ev.event, data: ev.data }),\n        ),\n        // The stream ends with an OpenAI-style `[DONE]` sentinel that is not JSON;\n        // drop it (and any blank frame) before the JSON decode.\n        Stream.filter((ev) => ev.event !== \"done\" && ev.data.trim() !== \"[DONE]\"),\n        Stream.mapEffect((ev) =>\n          parseJsonUnknown(ev.data).pipe(\n            Effect.flatMap(decodeStreamEvent),\n            Effect.mapError(transportFailure),\n            Effect.flatMap((wire) => streamEventToTurnEvents(acc, wire)),\n          ),\n        ),\n        Stream.flatMap(Stream.fromIterable),\n      )\n    }),\n  )\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\nconst jobOps = (\n  cfg: Config,\n  client: HttpClient.HttpClient,\n): ResearchJobOps<GoogleResearchRequest> => {\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// fromJob's default surface, with `researchStream` overridden to the real\n// Interactions SSE (its submit-then-attach default only synthesizes progress).\nconst buildService = <Req extends ResearchRequest>(\n  cfg: Config,\n  client: HttpClient.HttpClient,\n  ops: ResearchJobOps<Req>,\n  toGoogle: (request: Req) => GoogleResearchRequest,\n): DeepResearchServiceShape<Req> => ({\n  ...fromJob(ops, cfg.job),\n  researchStream: (request) =>\n    Stream.provideService(streamCreate(cfg, toGoogle(request)), HttpClient.HttpClient, client),\n})\n\n/** Build a `GoogleDeepResearchService`. For Layer setup, prefer {@link layer}. */\nexport const make = (\n  cfg: Config,\n): Effect.Effect<GoogleDeepResearchService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient, (client) =>\n    buildService(cfg, client, jobOps(cfg, client), (request) => request),\n  )\n\n/**\n * Layer registering the provider-typed `GoogleDeepResearch` 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<GoogleDeepResearch | DeepResearch, never, HttpClient.HttpClient> => {\n  const typed = Layer.effect(GoogleDeepResearch, make(cfg))\n  const generic = Layer.effect(\n    DeepResearch,\n    Effect.map(HttpClient.HttpClient, (client): DeepResearchService => {\n      const ops = jobOps(cfg, client)\n      const genericOps: ResearchJobOps<ResearchRequest> = {\n        ...ops,\n        submit: (request) => ops.submit(request as GoogleResearchRequest),\n      }\n      return buildService(cfg, client, genericOps, (request) => request as GoogleResearchRequest)\n    }),\n  )\n  return Layer.merge(typed, generic)\n}\n"],"mappings":"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"}

package/dist/GoogleDeepResearch.test.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/GoogleDeepResearch.test.mjs

@@ -0,0 +1,66 @@
+import { i as it, n as globalExpect, r as describe } from "./dist-CWoAuwS9.mjs";
+import { WireInteraction, jobStateOf } from "./GoogleDeepResearch.mjs";
+import { Schema } from "effect";
+import * as Turn$1 from "@effect-uai/core/Turn";
+//#region src/GoogleDeepResearch.test.ts
+const decode = Schema.decodeUnknownSync(WireInteraction);
+const turnOf = (raw) => {
+	const state = jobStateOf(decode(raw));
+	if (state._tag !== "Succeeded") throw new Error(`expected Succeeded, got ${state._tag}`);
+	return state.result;
+};
+describe("GoogleDeepResearch grounding", () => {
+	it("maps grounding chunks on a completed interaction to url_citation annotations", () => {
+		const turn = turnOf({
+			id: "int_1",
+			status: "completed",
+			outputs: [{
+				type: "text",
+				text: "Report body [1][2].",
+				groundingMetadata: { groundingChunks: [{ web: {
+					uri: "https://vertexaisearch.cloud.google.com/grounding-api-redirect/abc",
+					title: "example.com"
+				} }, { web: { uri: "https://vertexaisearch.cloud.google.com/grounding-api-redirect/def" } }] }
+			}]
+		});
+		globalExpect(Turn$1.assistantText(turn)).toBe("Report body [1][2].");
+		globalExpect(Turn$1.citations(turn)).toEqual([{
+			type: "url_citation",
+			url: "https://vertexaisearch.cloud.google.com/grounding-api-redirect/abc",
+			title: "example.com"
+		}, {
+			type: "url_citation",
+			url: "https://vertexaisearch.cloud.google.com/grounding-api-redirect/def",
+			title: "https://vertexaisearch.cloud.google.com/grounding-api-redirect/def"
+		}]);
+	});
+	it("gathers and de-dupes grounding across interaction / output / step levels", () => {
+		const turn = turnOf({
+			id: "int_2",
+			status: "completed",
+			groundingMetadata: { groundingChunks: [{ web: {
+				uri: "https://a.example",
+				title: "a"
+			} }] },
+			outputs: [{
+				type: "text",
+				text: "Body."
+			}],
+			steps: [{
+				type: "research",
+				groundingMetadata: { groundingChunks: [{ web: {
+					uri: "https://a.example",
+					title: "a"
+				} }, { web: {
+					uri: "https://b.example",
+					title: "b"
+				} }] }
+			}]
+		});
+		globalExpect(Turn$1.citations(turn).map((c) => c.type === "url_citation" && c.url)).toEqual(["https://a.example", "https://b.example"]);
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=GoogleDeepResearch.test.mjs.map

package/dist/GoogleDeepResearch.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleDeepResearch.test.mjs","names":["Turn"],"sources":["../src/GoogleDeepResearch.test.ts"],"sourcesContent":["import { Schema } from \"effect\"\nimport * as Turn from \"@effect-uai/core/Turn\"\nimport { describe, expect, it } from \"vitest\"\nimport { WireInteraction, jobStateOf } from \"./GoogleDeepResearch.js\"\n\nconst decode = Schema.decodeUnknownSync(WireInteraction)\n\n// Extract the `Turn` from a completed interaction the way the service does.\nconst turnOf = (raw: unknown): Turn.Turn => {\n  const state = jobStateOf(decode(raw))\n  if (state._tag !== \"Succeeded\") throw new Error(`expected Succeeded, got ${state._tag}`)\n  return state.result\n}\n\ndescribe(\"GoogleDeepResearch grounding\", () => {\n  it(\"maps grounding chunks on a completed interaction to url_citation annotations\", () => {\n    const turn = turnOf({\n      id: \"int_1\",\n      status: \"completed\",\n      outputs: [\n        {\n          type: \"text\",\n          text: \"Report body [1][2].\",\n          groundingMetadata: {\n            groundingChunks: [\n              {\n                web: {\n                  uri: \"https://vertexaisearch.cloud.google.com/grounding-api-redirect/abc\",\n                  title: \"example.com\",\n                },\n              },\n              {\n                web: { uri: \"https://vertexaisearch.cloud.google.com/grounding-api-redirect/def\" },\n              },\n            ],\n          },\n        },\n      ],\n    })\n    expect(Turn.assistantText(turn)).toBe(\"Report body [1][2].\")\n    expect(Turn.citations(turn)).toEqual([\n      {\n        type: \"url_citation\",\n        url: \"https://vertexaisearch.cloud.google.com/grounding-api-redirect/abc\",\n        title: \"example.com\",\n      },\n      {\n        type: \"url_citation\",\n        url: \"https://vertexaisearch.cloud.google.com/grounding-api-redirect/def\",\n        title: \"https://vertexaisearch.cloud.google.com/grounding-api-redirect/def\",\n      },\n    ])\n  })\n\n  it(\"gathers and de-dupes grounding across interaction / output / step levels\", () => {\n    const turn = turnOf({\n      id: \"int_2\",\n      status: \"completed\",\n      groundingMetadata: {\n        groundingChunks: [{ web: { uri: \"https://a.example\", title: \"a\" } }],\n      },\n      outputs: [{ type: \"text\", text: \"Body.\" }],\n      steps: [\n        {\n          type: \"research\",\n          groundingMetadata: {\n            groundingChunks: [\n              { web: { uri: \"https://a.example\", title: \"a\" } },\n              { web: { uri: \"https://b.example\", title: \"b\" } },\n            ],\n          },\n        },\n      ],\n    })\n    expect(Turn.citations(turn).map((c) => c.type === \"url_citation\" && c.url)).toEqual([\n      \"https://a.example\",\n      \"https://b.example\",\n    ])\n  })\n})\n"],"mappings":";;;;;AAKA,MAAM,SAAS,OAAO,kBAAkB,gBAAgB;AAGxD,MAAM,UAAU,QAA4B;CAC1C,MAAM,QAAQ,WAAW,OAAO,IAAI,CAAC;AACrC,KAAI,MAAM,SAAS,YAAa,OAAM,IAAI,MAAM,2BAA2B,MAAM,OAAO;AACxF,QAAO,MAAM;;AAGf,SAAS,sCAAsC;AAC7C,IAAG,sFAAsF;EACvF,MAAM,OAAO,OAAO;GAClB,IAAI;GACJ,QAAQ;GACR,SAAS,CACP;IACE,MAAM;IACN,MAAM;IACN,mBAAmB,EACjB,iBAAiB,CACf,EACE,KAAK;KACH,KAAK;KACL,OAAO;KACR,EACF,EACD,EACE,KAAK,EAAE,KAAK,sEAAsE,EACnF,CACF,EACF;IACF,CACF;GACF,CAAC;AACF,eAAOA,OAAK,cAAc,KAAK,CAAC,CAAC,KAAK,sBAAsB;AAC5D,eAAOA,OAAK,UAAU,KAAK,CAAC,CAAC,QAAQ,CACnC;GACE,MAAM;GACN,KAAK;GACL,OAAO;GACR,EACD;GACE,MAAM;GACN,KAAK;GACL,OAAO;GACR,CACF,CAAC;GACF;AAEF,IAAG,kFAAkF;EACnF,MAAM,OAAO,OAAO;GAClB,IAAI;GACJ,QAAQ;GACR,mBAAmB,EACjB,iBAAiB,CAAC,EAAE,KAAK;IAAE,KAAK;IAAqB,OAAO;IAAK,EAAE,CAAC,EACrE;GACD,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM;IAAS,CAAC;GAC1C,OAAO,CACL;IACE,MAAM;IACN,mBAAmB,EACjB,iBAAiB,CACf,EAAE,KAAK;KAAE,KAAK;KAAqB,OAAO;KAAK,EAAE,EACjD,EAAE,KAAK;KAAE,KAAK;KAAqB,OAAO;KAAK,EAAE,CAClD,EACF;IACF,CACF;GACF,CAAC;AACF,eAAOA,OAAK,UAAU,KAAK,CAAC,KAAK,MAAM,EAAE,SAAS,kBAAkB,EAAE,IAAI,CAAC,CAAC,QAAQ,CAClF,qBACA,oBACD,CAAC;GACF;EACF"}

package/dist/LyriaGenerator.mjs

@@ -188,7 +188,7 @@ const streamGenerationFromUnsupported = (_input, _request) => {
 		reason: "Lyria 3 sync does not support bidirectional sessions. Use the Lyria RealTime Layer (WebSocket BidiGenerateMusic) for interactive mid-session prompts."
 	}));
 };
-const make = (cfg) => Effect.map(HttpClient.HttpClient.asEffect(), (client) => ({
+const make = (cfg) => Effect.map(HttpClient.HttpClient, (client) => ({
 	generate: (request) => generateImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),
 	streamGeneration: (request) => streamGenerationImpl(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client)),
 	streamGenerationFrom: streamGenerationFromUnsupported