@effect-uai/core 0.10.0 → 0.11.0

package/dist/{Image-BZmKfIdq.d.mts → Image-C4vuBmu0.d.mts}

@@ -46,16 +46,16 @@ declare const isImageUrl: <I>(input: I) => input is I & {
   readonly url: string;
   readonly mimeType?: ImageMimeType | undefined;
 };
-declare const isImageBase64: <I>(input: I) => input is I & {
-  readonly _tag: "base64";
-  readonly mimeType: ImageMimeType;
-  readonly base64: string;
-};
-declare const isImageBytes: <I>(input: I) => input is I & {
-  readonly _tag: "bytes";
-  readonly mimeType: ImageMimeType;
-  readonly bytes: Uint8Array<ArrayBufferLike>;
-};
+declare const isImageBase64: <I>(input: I) => input is I & Schema.Struct.ReadonlySide<{
+  readonly _tag: Schema.tag<"base64">;
+  readonly base64: Schema.String;
+  readonly mimeType: Schema.Schema<ImageMimeType>;
+}, "Type">;
+declare const isImageBytes: <I>(input: I) => input is I & Schema.Struct.ReadonlySide<{
+  readonly _tag: Schema.tag<"bytes">;
+  readonly bytes: Schema.Uint8Array;
+  readonly mimeType: Schema.Schema<ImageMimeType>;
+}, "Type">;
 //#endregion
 export { ImageUrlSource as a, imageBytes as c, isImageBytes as d, isImageUrl as f, ImageSource as i, imageUrl as l, ImageBytesSource as n, Image_d_exports as o, ImageMimeType as r, imageBase64 as s, ImageBase64Source as t, isImageBase64 as u };
-//# sourceMappingURL=Image-BZmKfIdq.d.mts.map
+//# sourceMappingURL=Image-C4vuBmu0.d.mts.map

package/dist/{Image-BZmKfIdq.d.mts.map → Image-C4vuBmu0.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"Image-BZmKfIdq.d.mts","names":[],"sources":["../src/domain/Image.ts"],"mappings":";;;;;;;;;;;;;;;KAWY,aAAA;AAAA,KAYA,cAAA,GAAiB,QAAA,CAAS,aAAA;AAAA,KAC1B,iBAAA,GAAoB,WAAA,CAAY,aAAA;AAAA,KAChC,gBAAA,GAAmB,UAAA,CAAW,aAAA;;;;;AAd1C;;;KAuBY,WAAA,GAAc,WAAA,CAAY,aAAA;AAAA,cAEzB,cAAA,EAAc,MAAA,CAAA,YAAA;EAAA;;;cAKd,iBAAA,EAAiB,MAAA,CAAA,YAAA;EAAA;;;cAKjB,gBAAA,EAAgB,MAAA,CAAA,YAAA;EAAA;;;cAKhB,WAAA,EAAa,MAAA,CAAO,MAAA,CAAO,WAAA;AAAA,cAM3B,QAAA,GAAY,GAAA,UAAa,QAAA,GAAW,aAAA,KAAgB,cAAA;AAAA,cAGpD,WAAA,GAAe,MAAA,UAAgB,QAAA,EAAU,aAAA,KAAgB,iBAAA;AAAA,cAMzD,UAAA,GAAc,KAAA,EAAO,UAAA,EAAY,QAAA,EAAU,aAAA,KAAgB,gBAAA;AAAA,cAM3D,UAAA,MAAU,KAAA,EAAA,CAAA,KAAA,KAAA,IAAA,CAAA;EAAA;;;;cACV,aAAA,MAAa,KAAA,EAAA,CAAA,KAAA,KAAA,IAAA,CAAA;EAAA;;;;cACb,YAAA,MAAY,KAAA,EAAA,CAAA,KAAA,KAAA,IAAA,CAAA;EAAA"}
+{"version":3,"file":"Image-C4vuBmu0.d.mts","names":[],"sources":["../src/domain/Image.ts"],"mappings":";;;;;;;;;;;;;;;KAWY,aAAA;AAAA,KAYA,cAAA,GAAiB,QAAA,CAAS,aAAA;AAAA,KAC1B,iBAAA,GAAoB,WAAA,CAAY,aAAA;AAAA,KAChC,gBAAA,GAAmB,UAAA,CAAW,aAAA;;;;;AAd1C;;;KAuBY,WAAA,GAAc,WAAA,CAAY,aAAA;AAAA,cAEzB,cAAA,EAAc,MAAA,CAAA,YAAA;EAAA;;;cAKd,iBAAA,EAAiB,MAAA,CAAA,YAAA;EAAA;;;cAKjB,gBAAA,EAAgB,MAAA,CAAA,YAAA;EAAA;;;cAKhB,WAAA,EAAa,MAAA,CAAO,MAAA,CAAO,WAAA;AAAA,cAM3B,QAAA,GAAY,GAAA,UAAa,QAAA,GAAW,aAAA,KAAgB,cAAA;AAAA,cAGpD,WAAA,GAAe,MAAA,UAAgB,QAAA,EAAU,aAAA,KAAgB,iBAAA;AAAA,cAMzD,UAAA,GAAc,KAAA,EAAO,UAAA,EAAY,QAAA,EAAU,aAAA,KAAgB,gBAAA;AAAA,cAM3D,UAAA,MAAU,KAAA,EAAA,CAAA,KAAA,KAAA,IAAA,CAAA;EAAA;;;;cACV,aAAA,MAAa,KAAA,EAAA,CAAA,KAAA,KAAA,IAAA,CAAA,GAAA,MAAA,CAAA,MAAA,CAAA,YAAA;EAAA;;;;cACb,YAAA,MAAY,KAAA,EAAA,CAAA,KAAA,KAAA,IAAA,CAAA,GAAA,MAAA,CAAA,MAAA,CAAA,YAAA;EAAA"}

package/dist/{Items-BnIduEV2.d.mts → Items-BWNu6VGp.d.mts}

@@ -1,4 +1,4 @@
-import { i as ImageSource } from "./Image-BZmKfIdq.mjs";
+import { i as ImageSource } from "./Image-C4vuBmu0.mjs";
 import { Schema } from "effect";
 
 //#region src/domain/Items.d.ts
@@ -23,12 +23,22 @@ declare const InputImage: Schema.Struct<{
   readonly source: Schema.Schema<ImageSource>;
 }>;
 type InputImage = typeof InputImage.Type;
+/**
+ * A cited source. `url` + `title` are the only near-universal fields; the
+ * link from a source to the answer text varies by provider, so it is optional
+ * and expressed three ways: `start_index`/`end_index` (a character span into
+ * the answer), `cited_text` (an exact quote of the source, when no offsets are
+ * given), or `marker` (a positional `[n]` reference into an ordered list). A
+ * provider populates whichever it has; a bare source list sets none.
+ */
 declare const UrlCitation: Schema.Struct<{
   readonly type: Schema.Literal<"url_citation">;
   readonly url: Schema.String;
-  readonly start_index: Schema.Number;
-  readonly end_index: Schema.Number;
   readonly title: Schema.String;
+  readonly start_index: Schema.optional<Schema.Number>;
+  readonly end_index: Schema.optional<Schema.Number>;
+  readonly cited_text: Schema.optional<Schema.String>;
+  readonly marker: Schema.optional<Schema.Number>;
 }>;
 type UrlCitation = typeof UrlCitation.Type;
 declare const FileCitation: Schema.Struct<{
@@ -54,9 +64,11 @@ type FilePath = typeof FilePath.Type;
 declare const Annotation: Schema.Union<readonly [Schema.Struct<{
   readonly type: Schema.Literal<"url_citation">;
   readonly url: Schema.String;
-  readonly start_index: Schema.Number;
-  readonly end_index: Schema.Number;
   readonly title: Schema.String;
+  readonly start_index: Schema.optional<Schema.Number>;
+  readonly end_index: Schema.optional<Schema.Number>;
+  readonly cited_text: Schema.optional<Schema.String>;
+  readonly marker: Schema.optional<Schema.Number>;
 }>, Schema.Struct<{
   readonly type: Schema.Literal<"file_citation">;
   readonly file_id: Schema.String;
@@ -76,36 +88,40 @@ type Annotation = typeof Annotation.Type;
 declare const isUrlCitation: <I>(input: I) => input is I & {
   readonly url: string;
   readonly type: "url_citation";
-  readonly start_index: number;
-  readonly end_index: number;
   readonly title: string;
+  readonly start_index?: number | undefined;
+  readonly end_index?: number | undefined;
+  readonly cited_text?: string | undefined;
+  readonly marker?: number | undefined;
 };
-declare const isFileCitation: <I>(input: I) => input is I & {
-  readonly type: "file_citation";
-  readonly file_id: string;
-  readonly index: number;
-};
-declare const isContainerFileCitation: <I>(input: I) => input is I & {
-  readonly type: "container_file_citation";
-  readonly start_index: number;
-  readonly end_index: number;
-  readonly file_id: string;
-  readonly container_id: string;
-};
-declare const isFilePath: <I>(input: I) => input is I & {
-  readonly type: "file_path";
-  readonly file_id: string;
-  readonly index: number;
-};
+declare const isFileCitation: <I>(input: I) => input is I & Schema.Struct.ReadonlySide<{
+  readonly type: Schema.Literal<"file_citation">;
+  readonly file_id: Schema.String;
+  readonly index: Schema.Number;
+}, "Type">;
+declare const isContainerFileCitation: <I>(input: I) => input is I & Schema.Struct.ReadonlySide<{
+  readonly type: Schema.Literal<"container_file_citation">;
+  readonly container_id: Schema.String;
+  readonly file_id: Schema.String;
+  readonly start_index: Schema.Number;
+  readonly end_index: Schema.Number;
+}, "Type">;
+declare const isFilePath: <I>(input: I) => input is I & Schema.Struct.ReadonlySide<{
+  readonly type: Schema.Literal<"file_path">;
+  readonly file_id: Schema.String;
+  readonly index: Schema.Number;
+}, "Type">;
 declare const OutputText: Schema.Struct<{
   readonly type: Schema.Literal<"output_text">;
   readonly text: Schema.String;
   readonly annotations: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
     readonly type: Schema.Literal<"url_citation">;
     readonly url: Schema.String;
-    readonly start_index: Schema.Number;
-    readonly end_index: Schema.Number;
     readonly title: Schema.String;
+    readonly start_index: Schema.optional<Schema.Number>;
+    readonly end_index: Schema.optional<Schema.Number>;
+    readonly cited_text: Schema.optional<Schema.String>;
+    readonly marker: Schema.optional<Schema.Number>;
   }>, Schema.Struct<{
     readonly type: Schema.Literal<"file_citation">;
     readonly file_id: Schema.String;
@@ -146,9 +162,11 @@ declare const ContentBlock: Schema.Union<readonly [Schema.Struct<{
   readonly annotations: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
     readonly type: Schema.Literal<"url_citation">;
     readonly url: Schema.String;
-    readonly start_index: Schema.Number;
-    readonly end_index: Schema.Number;
     readonly title: Schema.String;
+    readonly start_index: Schema.optional<Schema.Number>;
+    readonly end_index: Schema.optional<Schema.Number>;
+    readonly cited_text: Schema.optional<Schema.String>;
+    readonly marker: Schema.optional<Schema.Number>;
   }>, Schema.Struct<{
     readonly type: Schema.Literal<"file_citation">;
     readonly file_id: Schema.String;
@@ -186,9 +204,11 @@ declare const Message: Schema.Struct<{
     readonly annotations: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
       readonly type: Schema.Literal<"url_citation">;
       readonly url: Schema.String;
-      readonly start_index: Schema.Number;
-      readonly end_index: Schema.Number;
       readonly title: Schema.String;
+      readonly start_index: Schema.optional<Schema.Number>;
+      readonly end_index: Schema.optional<Schema.Number>;
+      readonly cited_text: Schema.optional<Schema.String>;
+      readonly marker: Schema.optional<Schema.Number>;
     }>, Schema.Struct<{
       readonly type: Schema.Literal<"file_citation">;
       readonly file_id: Schema.String;
@@ -255,9 +275,11 @@ declare const HistoryItem: Schema.Union<readonly [Schema.Struct<{
     readonly annotations: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
       readonly type: Schema.Literal<"url_citation">;
       readonly url: Schema.String;
-      readonly start_index: Schema.Number;
-      readonly end_index: Schema.Number;
       readonly title: Schema.String;
+      readonly start_index: Schema.optional<Schema.Number>;
+      readonly end_index: Schema.optional<Schema.Number>;
+      readonly cited_text: Schema.optional<Schema.String>;
+      readonly marker: Schema.optional<Schema.Number>;
     }>, Schema.Struct<{
       readonly type: Schema.Literal<"file_citation">;
       readonly file_id: Schema.String;
@@ -297,79 +319,83 @@ declare const HistoryItem: Schema.Union<readonly [Schema.Struct<{
   readonly providerData: Schema.optional<Schema.Unknown>;
 }>]>;
 type HistoryItem = typeof HistoryItem.Type;
-declare const isInputText: <I>(input: I) => input is I & {
-  readonly text: string;
-  readonly type: "input_text";
-};
-declare const isInputImage: <I>(input: I) => input is I & {
-  readonly type: "input_image";
-  readonly source: ImageSource;
-};
+declare const isInputText: <I>(input: I) => input is I & Schema.Struct.ReadonlySide<{
+  readonly type: Schema.Literal<"input_text">;
+  readonly text: Schema.String;
+}, "Type">;
+declare const isInputImage: <I>(input: I) => input is I & Schema.Struct.ReadonlySide<{
+  readonly type: Schema.Literal<"input_image">;
+  readonly source: Schema.Schema<ImageSource>;
+}, "Type">;
 declare const isOutputText: <I>(input: I) => input is I & {
   readonly text: string;
   readonly type: "output_text";
   readonly annotations?: readonly ({
     readonly url: string;
     readonly type: "url_citation";
-    readonly start_index: number;
-    readonly end_index: number;
     readonly title: string;
-  } | {
-    readonly type: "file_citation";
-    readonly file_id: string;
-    readonly index: number;
-  } | {
-    readonly type: "container_file_citation";
-    readonly start_index: number;
-    readonly end_index: number;
-    readonly file_id: string;
-    readonly container_id: string;
-  } | {
-    readonly type: "file_path";
-    readonly file_id: string;
-    readonly index: number;
-  })[] | undefined;
-};
-declare const isRefusal: <I>(input: I) => input is I & {
-  readonly text: string;
-  readonly type: "refusal";
+    readonly start_index?: number | undefined;
+    readonly end_index?: number | undefined;
+    readonly cited_text?: string | undefined;
+    readonly marker?: number | undefined;
+  } | Schema.Struct.ReadonlySide<{
+    readonly type: Schema.Literal<"file_citation">;
+    readonly file_id: Schema.String;
+    readonly index: Schema.Number;
+  }, "Type"> | Schema.Struct.ReadonlySide<{
+    readonly type: Schema.Literal<"container_file_citation">;
+    readonly container_id: Schema.String;
+    readonly file_id: Schema.String;
+    readonly start_index: Schema.Number;
+    readonly end_index: Schema.Number;
+  }, "Type"> | Schema.Struct.ReadonlySide<{
+    readonly type: Schema.Literal<"file_path">;
+    readonly file_id: Schema.String;
+    readonly index: Schema.Number;
+  }, "Type">)[] | undefined;
 };
+declare const isRefusal: <I>(input: I) => input is I & Schema.Struct.ReadonlySide<{
+  readonly type: Schema.Literal<"refusal">;
+  readonly text: Schema.String;
+}, "Type">;
 declare const isMessage: <I>(input: I) => input is I & {
   readonly type: "message";
-  readonly content: readonly ({
-    readonly text: string;
-    readonly type: "input_text";
-  } | {
-    readonly type: "input_image";
-    readonly source: ImageSource;
-  } | {
+  readonly content: readonly (Schema.Struct.ReadonlySide<{
+    readonly type: Schema.Literal<"input_text">;
+    readonly text: Schema.String;
+  }, "Type"> | Schema.Struct.ReadonlySide<{
+    readonly type: Schema.Literal<"input_image">;
+    readonly source: Schema.Schema<ImageSource>;
+  }, "Type"> | {
     readonly text: string;
     readonly type: "output_text";
     readonly annotations?: readonly ({
       readonly url: string;
       readonly type: "url_citation";
-      readonly start_index: number;
-      readonly end_index: number;
       readonly title: string;
-    } | {
-      readonly type: "file_citation";
-      readonly file_id: string;
-      readonly index: number;
-    } | {
-      readonly type: "container_file_citation";
-      readonly start_index: number;
-      readonly end_index: number;
-      readonly file_id: string;
-      readonly container_id: string;
-    } | {
-      readonly type: "file_path";
-      readonly file_id: string;
-      readonly index: number;
-    })[] | undefined;
-  } | {
-    readonly text: string;
-    readonly type: "refusal";
-  })[];
+      readonly start_index?: number | undefined;
+      readonly end_index?: number | undefined;
+      readonly cited_text?: string | undefined;
+      readonly marker?: number | undefined;
+    } | Schema.Struct.ReadonlySide<{
+      readonly type: Schema.Literal<"file_citation">;
+      readonly file_id: Schema.String;
+      readonly index: Schema.Number;
+    }, "Type"> | Schema.Struct.ReadonlySide<{
+      readonly type: Schema.Literal<"container_file_citation">;
+      readonly container_id: Schema.String;
+      readonly file_id: Schema.String;
+      readonly start_index: Schema.Number;
+      readonly end_index: Schema.Number;
+    }, "Type"> | Schema.Struct.ReadonlySide<{
+      readonly type: Schema.Literal<"file_path">;
+      readonly file_id: Schema.String;
+      readonly index: Schema.Number;
+    }, "Type">)[] | undefined;
+  } | Schema.Struct.ReadonlySide<{
+    readonly type: Schema.Literal<"refusal">;
+    readonly text: Schema.String;
+  }, "Type">)[];
   readonly role: "user" | "assistant" | "system";
   readonly providerData?: unknown;
 };
@@ -421,4 +447,4 @@ declare const assistantText: (text: string) => Message;
 declare const toolCallOutput: (call_id: string, output: string) => ToolCallOutput;
 //#endregion
 export { isReasoning as A, isContainerFileCitation as C, isInputText as D, isInputImage as E, systemText as F, toolCallOutput as I, userText as L, isToolCall as M, isToolCallOutput as N, isMessage as O, isUrlCitation as P, assistantText as S, isFilePath as T, StopReason as _, FilePath as a, UrlCitation as b, InputText as c, Message as d, OutputText as f, Role as g, Refusal as h, FileCitation as i, isRefusal as j, isOutputText as k, InputTokensDetails as l, Reasoning as m, ContainerFileCitation as n, HistoryItem as o, OutputTokensDetails as p, ContentBlock as r, InputImage as s, Annotation as t, Items_d_exports as u, ToolCall as v, isFileCitation as w, Usage as x, ToolCallOutput as y };
-//# sourceMappingURL=Items-BnIduEV2.d.mts.map
+//# sourceMappingURL=Items-BWNu6VGp.d.mts.map

package/dist/Items-BWNu6VGp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Items-BWNu6VGp.d.mts","names":[],"sources":["../src/domain/Items.ts"],"mappings":"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"}

package/dist/{Tool-2lC_XMth.d.mts → Tool-CXFHCQrT.d.mts}

@@ -1,11 +1,11 @@
-import { v as ToolCall, y as ToolCallOutput } from "./Items-BnIduEV2.mjs";
+import { v as ToolCall, y as ToolCallOutput } from "./Items-BWNu6VGp.mjs";
 import { Effect, Schema } from "effect";
 import * as _$effect_Cause0 from "effect/Cause";
 import { StandardJSONSchemaV1, StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/tool/Tool.d.ts
 declare namespace Tool_d_exports {
-  export { AnyLocalTool, AnyTool, DecodableTool, DecodeResult, Emit, InteractionTool, ProviderTool, SignalTool, Tool, ToolDescriptor, ToolE, ToolError, ToolFailed, ToolInputSchema, ToolR, ToolValidationError, decodeArgs, decodeCallInput, descriptorsOf, execute, fail, fromEffectSchema, fromStandardSchema, interaction, make, noInput, provider, signal, toDescriptors, withName, withRun };
+  export { AnyLocalTool, AnyTool, DecodableTool, DecodeResult, Emit, InteractionTool, ProviderTool, SignalTool, Tool, ToolDescriptor, ToolE, ToolError, ToolFailed, ToolInputSchema, ToolR, ToolValidationError, decodeArgs, decodeCallInput, descriptorsOf, execute, fail, fromEffectSchema, fromStandardSchema, interaction, isProviderTool, make, noInput, provider, providerToolsOf, signal, toDescriptors, withName, withRun };
 }
 declare const ToolError_base: Schema.Class<ToolError, Schema.TaggedStruct<"ToolError", {
   readonly call_id: Schema.String;
@@ -193,25 +193,45 @@ type ToolDescriptor = {
   readonly strict?: boolean;
 };
 /** A model-visible tool with a local `Effect` executor. */
-declare const make: <Name extends string, Input, Event, Output, E = never, R = never>(spec: Omit<Tool<Name, Input, Event, Output, E, R>, "_tag">) => Tool<Name, Input, Event, Output, E, R>;
+declare const make: {
+  <Name extends string, S extends Schema.Codec<any, any, never, any>, Event, Output, E = never, R = never>(spec: Omit<Tool<Name, S["Type"], Event, Output, E, R>, "_tag" | "inputSchema"> & {
+    readonly inputSchema: S;
+  }): Tool<Name, S["Type"], Event, Output, E, R>;
+  <Name extends string, Input, Event, Output, E = never, R = never>(spec: Omit<Tool<Name, Input, Event, Output, E, R>, "_tag">): Tool<Name, Input, Event, Output, E, R>;
+};
 /**
  * A provider-hosted tool (native web search, code execution, RAG grounding).
  * No local executor — `provider`/`config` drive the provider adapter's
  * rendering. The model sees it; `Toolkit.run` reports it as `non_local_tool`.
  */
-declare const provider: <Name extends string, Input, Provider extends string, Config>(spec: Omit<ProviderTool<Name, Input, Provider, Config>, "_tag">) => ProviderTool<Name, Input, Provider, Config>;
+declare const provider: {
+  <Name extends string, S extends Schema.Codec<any, any, never, any>, Provider extends string, Config>(spec: Omit<ProviderTool<Name, S["Type"], Provider, Config>, "_tag" | "inputSchema"> & {
+    readonly inputSchema: S;
+  }): ProviderTool<Name, S["Type"], Provider, Config>;
+  <Name extends string, Input, Provider extends string, Config>(spec: Omit<ProviderTool<Name, Input, Provider, Config>, "_tag">): ProviderTool<Name, Input, Provider, Config>;
+};
 /**
  * A typed control-flow signal to the agent loop (escalate, pause, schedule,
  * hand off). Decode-only: the loop interprets the call rather than executing a
  * handler, so there is no `run`.
  */
-declare const signal: <Name extends string, Input>(spec: Omit<SignalTool<Name, Input>, "_tag">) => SignalTool<Name, Input>;
+declare const signal: {
+  <Name extends string, S extends Schema.Codec<any, any, never, any>>(spec: Omit<SignalTool<Name, S["Type"]>, "_tag" | "inputSchema"> & {
+    readonly inputSchema: S;
+  }): SignalTool<Name, S["Type"]>;
+  <Name extends string, Input>(spec: Omit<SignalTool<Name, Input>, "_tag">): SignalTool<Name, Input>;
+};
 /**
  * A typed request for an external actor to respond before the loop resumes
  * (frontend, Telegram, CLI prompt). Decode-only; the loop stops/pauses and
  * resumes by appending the actor's `function_call_output`.
  */
-declare const interaction: <Name extends string, Input>(spec: Omit<InteractionTool<Name, Input>, "_tag">) => InteractionTool<Name, Input>;
+declare const interaction: {
+  <Name extends string, S extends Schema.Codec<any, any, never, any>>(spec: Omit<InteractionTool<Name, S["Type"]>, "_tag" | "inputSchema"> & {
+    readonly inputSchema: S;
+  }): InteractionTool<Name, S["Type"]>;
+  <Name extends string, Input>(spec: Omit<InteractionTool<Name, Input>, "_tag">): InteractionTool<Name, Input>;
+};
 /**
  * Return a copy of a tool under a new `name`. Useful for resolving a name
  * clash before combining tools into one `Toolkit`. Literal-preserving, so the
@@ -232,7 +252,20 @@ declare const withName: <N extends string, T extends AnyTool>(tool: T, name: N)
  * from the contract the model sees.
  */
 declare const withRun: <Name extends string, Input, Event, Output, E, R, Output2, E2 = never, R2 = never>(tool: Tool<Name, Input, Event, Output, E, R>, run: (input: Input, emit: Emit<Event>) => Effect.Effect<Output2, E2, R2>) => Tool<Name, Input, Event, Output2, E2, R2>;
-/** Render tools to provider-agnostic descriptors. Every kind is model-visible. */
+/** True for provider-hosted tools — the kind a provider renders natively. */
+declare const isProviderTool: (tool: AnyTool) => tool is ProviderTool<string, any, string, any>;
+/**
+ * The `ProviderTool`s in a toolkit, for a provider adapter to render as its
+ * native hosted-tool entries (web search, code execution, grounding). The other
+ * kinds render as function declarations via `descriptorsOf`.
+ */
+declare const providerToolsOf: (toolkit?: Readonly<Record<string, AnyTool>>) => ReadonlyArray<ProviderTool<string, any, string, any>>;
+/**
+ * Render tools to provider-agnostic descriptors. `ProviderTool`s are excluded:
+ * they are provider-hosted and must never leak into the function-declaration
+ * list — each adapter renders them natively via `providerToolsOf`. Every other
+ * kind is model-visible as a declaration.
+ */
 declare const toDescriptors: (tools: ReadonlyArray<AnyTool>) => ReadonlyArray<ToolDescriptor>;
 /**
  * Render a `Toolkit` (a name-indexed record of tools) to descriptors, treating
@@ -280,5 +313,5 @@ declare const decodeArgs: <Input>(tool: DecodableTool<Input>, call: ToolCall) =>
  */
 declare const execute: <Name extends string, Input, Event, Output, E, R>(tool: Tool<Name, Input, Event, Output, E, R>, call: ToolCall) => Effect.Effect<ToolCallOutput, E | ToolError | ToolValidationError, R>;
 //#endregion
-export { toDescriptors as A, fromEffectSchema as C, noInput as D, make as E, withRun as M, provider as O, fail as S, interaction as T, Tool_d_exports as _, Emit as a, descriptorsOf as b, SignalTool as c, ToolE as d, ToolError as f, ToolValidationError as g, ToolR as h, DecodeResult as i, withName as j, signal as k, Tool as l, ToolInputSchema as m, AnyTool as n, InteractionTool as o, ToolFailed as p, DecodableTool as r, ProviderTool as s, AnyLocalTool as t, ToolDescriptor as u, decodeArgs as v, fromStandardSchema as w, execute as x, decodeCallInput as y };
-//# sourceMappingURL=Tool-2lC_XMth.d.mts.map
+export { providerToolsOf as A, fromEffectSchema as C, make as D, isProviderTool as E, toDescriptors as M, withName as N, noInput as O, withRun as P, fail as S, interaction as T, Tool_d_exports as _, Emit as a, descriptorsOf as b, SignalTool as c, ToolE as d, ToolError as f, ToolValidationError as g, ToolR as h, DecodeResult as i, signal as j, provider as k, Tool as l, ToolInputSchema as m, AnyTool as n, InteractionTool as o, ToolFailed as p, DecodableTool as r, ProviderTool as s, AnyLocalTool as t, ToolDescriptor as u, decodeArgs as v, fromStandardSchema as w, execute as x, decodeCallInput as y };
+//# sourceMappingURL=Tool-CXFHCQrT.d.mts.map

package/dist/Tool-CXFHCQrT.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tool-CXFHCQrT.d.mts","names":[],"sources":["../src/tool/Tool.ts"],"mappings":"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"}

package/dist/{ToolEvent-cWZ2BnbS.d.mts → ToolEvent-nVijCrvm.d.mts}

@@ -1,4 +1,4 @@
-import { t as ToolResult } from "./ToolResult-CL4hK_9z.mjs";
+import { t as ToolResult } from "./ToolResult-CQqKkcDa.mjs";
 import { Data } from "effect";
 import * as _$effect_Unify0 from "effect/Unify";
 
@@ -148,4 +148,4 @@ declare const isOutput: (u: unknown) => u is {
 };
 //#endregion
 export { isProgress as a, isOutput as i, ToolEvent_d_exports as n, isApprovalRequested as r, ToolEvent as t };
-//# sourceMappingURL=ToolEvent-cWZ2BnbS.d.mts.map
+//# sourceMappingURL=ToolEvent-nVijCrvm.d.mts.map

package/dist/{ToolEvent-cWZ2BnbS.d.mts.map → ToolEvent-nVijCrvm.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"ToolEvent-cWZ2BnbS.d.mts","names":[],"sources":["../src/tool/ToolEvent.ts"],"mappings":";;;;;;;;KAkBY,SAAA,GAAY,IAAA,CAAK,UAAA;EAC3B,iBAAA;IAAA,SACW,OAAA;IAAA,SACA,IAAA;IAAA,SACA,SAAA;EAAA;EAEX,QAAA;IAAA,SACW,OAAA;IAAA,SACA,IAAA;IAAA,SACA,IAAA;EAAA;EAEX,MAAA;IAAA,SACW,MAAA,EAAQ,UAAA;EAAA;AAAA;;;;;;;;cAWR,SAAA;EAAA;;;;;;;;;;;;;;qBAXQ,UAAA;EAAA;EAAA;;;;;;;;;;;;;;;;qBAAA,UAAA;EAAA;IAAA;;;;;;;;;;;;;;;;;;yBAAA,UAAA;MAAA;IAAA;;;;;;;;;;;;uBAAA,UAAA;IAAA;;;;;;;;;;;;;;;;yBAAA,UAAA;MAAA;IAAA;;;;;;;;;;;;uBAAA,UAAA;IAAA;;;cAaR,mBAAA,GAAmB,CAAA,cAAA,CAAA;EAAA;;;;;cACnB,UAAA,GAAU,CAAA,cAAA,CAAA;EAAA;;;;;cACV,QAAA,GAAQ,CAAA,cAAA,CAAA;EAAA;mBAfA,UAAA;AAAA"}
+{"version":3,"file":"ToolEvent-nVijCrvm.d.mts","names":[],"sources":["../src/tool/ToolEvent.ts"],"mappings":";;;;;;;;KAkBY,SAAA,GAAY,IAAA,CAAK,UAAA;EAC3B,iBAAA;IAAA,SACW,OAAA;IAAA,SACA,IAAA;IAAA,SACA,SAAA;EAAA;EAEX,QAAA;IAAA,SACW,OAAA;IAAA,SACA,IAAA;IAAA,SACA,IAAA;EAAA;EAEX,MAAA;IAAA,SACW,MAAA,EAAQ,UAAA;EAAA;AAAA;;;;;;;;cAWR,SAAA;EAAA;;;;;;;;;;;;;;qBAXQ,UAAA;EAAA;EAAA;;;;;;;;;;;;;;;;qBAAA,UAAA;EAAA;IAAA;;;;;;;;;;;;;;;;;;yBAAA,UAAA;MAAA;IAAA;;;;;;;;;;;;uBAAA,UAAA;IAAA;;;;;;;;;;;;;;;;yBAAA,UAAA;MAAA;IAAA;;;;;;;;;;;;uBAAA,UAAA;IAAA;;;cAaR,mBAAA,GAAmB,CAAA,cAAA,CAAA;EAAA;;;;;cACnB,UAAA,GAAU,CAAA,cAAA,CAAA;EAAA;;;;;cACV,QAAA,GAAQ,CAAA,cAAA,CAAA;EAAA;mBAfA,UAAA;AAAA"}

package/dist/{ToolResult-CL4hK_9z.d.mts → ToolResult-CQqKkcDa.d.mts}

@@ -1,4 +1,4 @@
-import { v as ToolCall, y as ToolCallOutput } from "./Items-BnIduEV2.mjs";
+import { v as ToolCall, y as ToolCallOutput } from "./Items-BWNu6VGp.mjs";
 import { Data } from "effect";
 import * as _$effect_Unify0 from "effect/Unify";
 
@@ -154,4 +154,4 @@ declare const serializeValue: (value: unknown) => string;
 declare const toToolCallOutput: (r: ToolResult) => ToolCallOutput;
 //#endregion
 export { executionError as a, isOk as c, toToolCallOutput as d, validationError as f, denied as i, nonLocalTool as l, ToolResult_d_exports as n, failed as o, cancelled as r, isFailure as s, ToolResult as t, serializeValue as u };
-//# sourceMappingURL=ToolResult-CL4hK_9z.d.mts.map
+//# sourceMappingURL=ToolResult-CQqKkcDa.d.mts.map

package/dist/{ToolResult-CL4hK_9z.d.mts.map → ToolResult-CQqKkcDa.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"ToolResult-CL4hK_9z.d.mts","names":[],"sources":["../src/tool/ToolResult.ts"],"mappings":";;;;;;;;KAqBY,UAAA,GAAa,IAAA,CAAK,UAAA;EAC5B,EAAA;IAAA,SACW,OAAA;IAAA,SACA,IAAA;IAAA,SACA,KAAA;EAAA;EAEX,OAAA;IAAA,SACW,OAAA;IAAA,SACA,IAAA;IAAA,SACA,IAAA;IAAA,SACA,MAAA;EAAA;AAAA;;;;;;;;;cAYA,UAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAEA,IAAA,GAAI,CAAA,cAAA,CAAA;EAAA;;;;;cACJ,SAAA,GAAS,CAAA,cAAA,CAAA;EAAA;;;;;;cAMT,MAAA,GAAU,IAAA,EAAM,QAAA,EAAU,IAAA,UAAc,MAAA,cAAkB,UAAA;;cAS1D,MAAA,GAAU,IAAA,EAAM,QAAA,EAAU,MAAA,cAAkB,UAAA;;cAI5C,SAAA,GAAa,IAAA,EAAM,QAAA,EAAU,MAAA,cAAkB,UAAA;;cAI/C,cAAA,GAAkB,IAAA,EAAM,QAAA,EAAU,MAAA,aAAiB,UAAA;;;;;;;cASnD,YAAA,GAAgB,IAAA,EAAM,QAAA,EAAU,MAAA,cAAkB,UAAA;;;;;;cAYlD,eAAA,GAAmB,IAAA,EAAM,QAAA,EAAU,MAAA,cAAkB,UAAA;;AA7ClE;;;;cAyDa,cAAA,GAAkB,KAAA;AAAA,cAOlB,gBAAA,GAAoB,CAAA,EAAG,UAAA,KAAa,cAAA"}
+{"version":3,"file":"ToolResult-CQqKkcDa.d.mts","names":[],"sources":["../src/tool/ToolResult.ts"],"mappings":";;;;;;;;KAqBY,UAAA,GAAa,IAAA,CAAK,UAAA;EAC5B,EAAA;IAAA,SACW,OAAA;IAAA,SACA,IAAA;IAAA,SACA,KAAA;EAAA;EAEX,OAAA;IAAA,SACW,OAAA;IAAA,SACA,IAAA;IAAA,SACA,IAAA;IAAA,SACA,MAAA;EAAA;AAAA;;;;;;;;;cAYA,UAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAEA,IAAA,GAAI,CAAA,cAAA,CAAA;EAAA;;;;;cACJ,SAAA,GAAS,CAAA,cAAA,CAAA;EAAA;;;;;;cAMT,MAAA,GAAU,IAAA,EAAM,QAAA,EAAU,IAAA,UAAc,MAAA,cAAkB,UAAA;;cAS1D,MAAA,GAAU,IAAA,EAAM,QAAA,EAAU,MAAA,cAAkB,UAAA;;cAI5C,SAAA,GAAa,IAAA,EAAM,QAAA,EAAU,MAAA,cAAkB,UAAA;;cAI/C,cAAA,GAAkB,IAAA,EAAM,QAAA,EAAU,MAAA,aAAiB,UAAA;;;;;;;cASnD,YAAA,GAAgB,IAAA,EAAM,QAAA,EAAU,MAAA,cAAkB,UAAA;;;;;;cAYlD,eAAA,GAAmB,IAAA,EAAM,QAAA,EAAU,MAAA,cAAkB,UAAA;;AA7ClE;;;;cAyDa,cAAA,GAAkB,KAAA;AAAA,cAOlB,gBAAA,GAAoB,CAAA,EAAG,UAAA,KAAa,cAAA"}

package/dist/{Toolkit-Dr9l_hNy.d.mts → Toolkit-BYPwwu-j.d.mts}

@@ -1,9 +1,9 @@
-import { o as HistoryItem, v as ToolCall } from "./Items-BnIduEV2.mjs";
-import { a as Emit, c as SignalTool, d as ToolE, h as ToolR, l as Tool, n as AnyTool, o as InteractionTool, p as ToolFailed, s as ProviderTool, u as ToolDescriptor } from "./Tool-2lC_XMth.mjs";
+import { o as HistoryItem, v as ToolCall } from "./Items-BWNu6VGp.mjs";
+import { a as Emit, c as SignalTool, d as ToolE, h as ToolR, l as Tool, n as AnyTool, o as InteractionTool, p as ToolFailed, s as ProviderTool, u as ToolDescriptor } from "./Tool-CXFHCQrT.mjs";
 import { Turn } from "./domain/Turn.mjs";
 import { r as Step } from "./Loop-D8nWpowc.mjs";
-import { t as ToolResult } from "./ToolResult-CL4hK_9z.mjs";
-import { t as ToolEvent } from "./ToolEvent-cWZ2BnbS.mjs";
+import { t as ToolResult } from "./ToolResult-CQqKkcDa.mjs";
+import { t as ToolEvent } from "./ToolEvent-nVijCrvm.mjs";
 import { Cause, Effect, Stream } from "effect";
 import * as _$effect_Types0 from "effect/Types";
 
@@ -66,7 +66,7 @@ declare class DuplicateToolName extends DuplicateToolName_base<{
   readonly sources: ReadonlyArray<string>;
 }> {}
 type PrefixName<Prefix extends string, Name extends string> = `${Prefix}__${Name}`;
-type PrefixTool<Prefix extends string, T extends AnyTool> = T extends Tool<infer N, infer I, infer Ev, infer O, infer R> ? Tool<PrefixName<Prefix, N>, I, Ev, O, R> : T extends ProviderTool<infer N, infer I, infer P, infer C> ? ProviderTool<PrefixName<Prefix, N>, I, P, C> : T extends SignalTool<infer N, infer I> ? SignalTool<PrefixName<Prefix, N>, I> : T extends InteractionTool<infer N, infer I> ? InteractionTool<PrefixName<Prefix, N>, I> : T;
+type PrefixTool<Prefix extends string, T extends AnyTool> = T extends Tool<infer N, infer I, infer Ev, infer O, infer E, infer R> ? Tool<PrefixName<Prefix, N>, I, Ev, O, E, R> : T extends ProviderTool<infer N, infer I, infer P, infer C> ? ProviderTool<PrefixName<Prefix, N>, I, P, C> : T extends SignalTool<infer N, infer I> ? SignalTool<PrefixName<Prefix, N>, I> : T extends InteractionTool<infer N, infer I> ? InteractionTool<PrefixName<Prefix, N>, I> : T;
 type Namespaced<Prefix extends string, T extends ToolMap> = { readonly [K in keyof T & string as PrefixName<Prefix, K>]: T[K] extends AnyTool ? PrefixTool<Prefix, T[K]> : never };
 /**
  * Prefix every tool name with `<namespace>__`, returning a new toolkit. Use it
@@ -193,4 +193,4 @@ declare const continueWithResults: {
 };
 //#endregion
 export { wrap as S, fromArray as _, ToolMap as a, namespace as b, ToolkitR as c, appendToolResults as d, collectResults as f, descriptors as g, describeFailures as h, NoDuplicateNames as i, Toolkit_d_exports as l, continueWithResults as m, ExecuteOptions as n, Toolkit as o, compose as p, Middleware as r, ToolkitE as s, DuplicateToolName as t, UniqueTools as u, make as v, run as x, makeNamespaced as y };
-//# sourceMappingURL=Toolkit-Dr9l_hNy.d.mts.map
+//# sourceMappingURL=Toolkit-BYPwwu-j.d.mts.map

package/dist/Toolkit-BYPwwu-j.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toolkit-BYPwwu-j.d.mts","names":[],"sources":["../src/tool/Toolkit.ts"],"mappings":"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"}

package/dist/browser/Browser.mjs

@@ -15,19 +15,19 @@ var Browser = class extends Context.Service()("@betalyra/effect-uai/Browser") {}
 * Provision a session bound to the caller's scope. Drop the `Scope.Scope`
 * requirement with `Effect.scoped`.
 */
-const create = (request) => Effect.flatMap(Browser.asEffect(), (s) => s.create(request));
+const create = (request) => Effect.flatMap(Browser, (s) => s.create(request));
 /**
 * Re-acquire an existing session by id. Same scope semantics as `create`,
 * but the finalizer detaches rather than destroying.
 */
-const attach = (id) => Effect.flatMap(Browser.asEffect(), (s) => s.attach(id));
+const attach = (id) => Effect.flatMap(Browser, (s) => s.attach(id));
 /** Enumerate sessions for the configured account / project. */
-const list = Effect.flatMap(Browser.asEffect(), (s) => s.list);
+const list = Effect.flatMap(Browser, (s) => s.list);
 /**
 * Destroy a session from outside its owning scope. Most callers should let
 * the scope finalizer handle this automatically.
 */
-const destroy = (id) => Effect.flatMap(Browser.asEffect(), (s) => s.destroy(id));
+const destroy = (id) => Effect.flatMap(Browser, (s) => s.destroy(id));
 //#endregion
 export { Browser, BrowserSessionId, attach, create, destroy, list, Browser_exports as t };
 

package/dist/browser/Browser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Browser.mjs","names":[],"sources":["../../src/browser/Browser.ts"],"sourcesContent":["import { Brand, Context, type Duration, Effect, Scope } from \"effect\"\nimport type * as BrowserError from \"./BrowserError.js\"\n\n// ---------------------------------------------------------------------------\n// Identity\n// ---------------------------------------------------------------------------\n\n/**\n * Session identifier. Branded `string` so providers don't accidentally\n * accept a raw user-supplied id, and so a session id can't be passed where\n * another service's id is expected. Each provider mints these per its own\n * scheme; core code treats them opaquely. Mint via `BrowserSessionId(...)`.\n */\nexport type BrowserSessionId = Brand.Branded<string, \"BrowserSessionId\">\nexport const BrowserSessionId = Brand.nominal<BrowserSessionId>()\n\n/** Reference returned by `list`; enough to `attach`. */\nexport type BrowserSessionRef = {\n  readonly id: BrowserSessionId\n  /** Current top-level URL, when the provider reports it. */\n  readonly url?: string\n}\n\n/**\n * Output representation for {@link BrowserSession.content}. `markdown` is\n * the default.\n */\nexport type PageFormat = \"markdown\" | \"html\"\n\n// ---------------------------------------------------------------------------\n// Create request\n// ---------------------------------------------------------------------------\n\n/**\n * Cross-provider session-create request. Provider-specific knobs (proxy,\n * stealth, persistent profile, ...) live on each provider's narrowed\n * request type which extends this.\n */\nexport type CommonSessionRequest = {\n  /**\n   * Hard max lifetime of the session. Enforced locally (the handle is\n   * disposed and further calls fail with `BrowserSessionExpired`) and,\n   * where the provider supports it, passed through as a server-side cap so\n   * a crashed client still gets the session reclaimed. The provider cap\n   * must be >= the local reaper. Accepts millis, a string like\n   * `\"5 minutes\"`, or a `Duration`.\n   */\n  readonly timeout?: Duration.Input\n  /**\n   * Idle teardown: dispose the session after this much inactivity, the\n   * timer resetting on each operation. Opt-in; omit for no idle limit.\n   */\n  readonly idleTimeout?: Duration.Input\n  /** Initial viewport size. Providers default differently. */\n  readonly viewport?: { readonly width: number; readonly height: number }\n}\n\n// ---------------------------------------------------------------------------\n// Observation shapes\n// ---------------------------------------------------------------------------\n\nexport type BoundingBox = {\n  readonly x: number\n  readonly y: number\n  readonly width: number\n  readonly height: number\n}\n\n/**\n * One element returned by {@link BrowserSession.query}. Serializable data,\n * not a live handle (handles go stale across navigation and do not cross a\n * provider boundary cleanly).\n */\nexport type ElementInfo = {\n  /**\n   * Reference usable as a selector for a follow-up action. Valid until the\n   * next navigation; do not cache across `goto` or a page-changing click.\n   */\n  readonly ref: string\n  readonly tag: string\n  readonly text?: string\n  readonly attributes: Readonly<Record<string, string>>\n  readonly box?: BoundingBox\n}\n\n/** Accessibility-tree node returned by {@link BrowserSession.snapshot}. */\nexport type AxNode = {\n  readonly role: string\n  readonly name?: string\n  readonly value?: string\n  /**\n   * Reference usable as a selector for a follow-up action. Valid until the\n   * next navigation; do not cache across `goto` or a page-changing click.\n   */\n  readonly ref?: string\n  readonly children: ReadonlyArray<AxNode>\n}\n\n// ---------------------------------------------------------------------------\n// Interaction shapes\n// ---------------------------------------------------------------------------\n\nexport type ScrollDirection = \"up\" | \"down\" | \"left\" | \"right\"\n\nexport type ScrollOptions = {\n  readonly direction: ScrollDirection\n  /** Distance in CSS pixels. Provider default applies when omitted. */\n  readonly pixels?: number\n}\n\nexport type ScreenshotOptions = {\n  /** Clip to the first element matching this selector. */\n  readonly selector?: string\n  /** Capture the full scrollable page rather than the viewport. */\n  readonly fullPage?: boolean\n}\n\nexport type Cookie = {\n  readonly name: string\n  readonly value: string\n  readonly domain?: string\n  readonly path?: string\n  readonly expires?: number\n  readonly httpOnly?: boolean\n  readonly secure?: boolean\n  readonly sameSite?: \"Strict\" | \"Lax\" | \"None\"\n}\n\n/** Read / write the session's cookie jar. Needed for authenticated flows. */\nexport type CookieApi = {\n  readonly get: Effect.Effect<ReadonlyArray<Cookie>, BrowserError.BrowserError>\n  readonly set: (cookies: ReadonlyArray<Cookie>) => Effect.Effect<void, BrowserError.BrowserError>\n}\n\n// ---------------------------------------------------------------------------\n// Live session handle\n// ---------------------------------------------------------------------------\n\n/**\n * Live session handle. Actions take a CSS selector string (so `#id` is\n * just `#id`). Methods are plain `Effect` values; disposal is the scope\n * finalizer, not a method here (see {@link BrowserService}). Anything not\n * covered by a verb is reachable via `evaluate`. Per-operation time budgets\n * are the provider's default; wrap any call in `Effect.timeout` for a\n * tighter bound.\n */\nexport type BrowserSession = {\n  readonly id: BrowserSessionId\n\n  // Navigation and waiting\n  readonly goto: (url: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly waitFor: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n\n  // Interaction\n  readonly click: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly dblclick: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly fill: (selector: string, text: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly type: (selector: string, text: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly press: (key: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly hover: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly focus: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly select: (\n    selector: string,\n    value: string,\n  ) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly check: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly uncheck: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly scroll: (options: ScrollOptions) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly scrollIntoView: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n\n  // Observation\n  readonly content: (format?: PageFormat) => Effect.Effect<string, BrowserError.BrowserError>\n  readonly screenshot: (\n    options?: ScreenshotOptions,\n  ) => Effect.Effect<Uint8Array, BrowserError.BrowserError>\n  readonly snapshot: Effect.Effect<AxNode, BrowserError.BrowserError>\n  readonly query: (\n    selector: string,\n  ) => Effect.Effect<ReadonlyArray<ElementInfo>, BrowserError.BrowserError>\n\n  // State and escape hatch\n  readonly cookies: CookieApi\n  readonly evaluate: (script: string) => Effect.Effect<unknown, BrowserError.BrowserError>\n}\n\n// ---------------------------------------------------------------------------\n// Service definition\n// ---------------------------------------------------------------------------\n\n/**\n * Cross-provider browser service.\n *\n * Lifetime: `create` and `attach` return a handle in `Scope.Scope`. The\n * scope finalizer disposes the session (close the transport, destroy or\n * detach the remote session, kill the local engine). Bind with\n * `Effect.scoped` for a single call, or hold a wider scope to keep a\n * session warm across many calls. This is why there is no `dispose()` on\n * {@link BrowserSession}; the scope is the lifecycle handle.\n */\nexport type BrowserService = {\n  /**\n   * Provision a new session, bound to the caller's scope. Disposed on\n   * scope close.\n   */\n  readonly create: (\n    request: CommonSessionRequest,\n  ) => Effect.Effect<BrowserSession, BrowserError.BrowserError, Scope.Scope>\n\n  /**\n   * Re-acquire an existing session by id. Scope-bound, but the finalizer\n   * detaches rather than destroying, for sessions kept warm beyond a\n   * single run.\n   */\n  readonly attach: (\n    id: BrowserSessionId,\n  ) => Effect.Effect<BrowserSession, BrowserError.BrowserError, Scope.Scope>\n\n  /** Enumerate sessions visible to the configured account / project. */\n  readonly list: Effect.Effect<ReadonlyArray<BrowserSessionRef>, BrowserError.BrowserError>\n\n  /**\n   * Destroy a session from outside its owning scope. Most callers should\n   * let the scope finalizer handle this.\n   */\n  readonly destroy: (id: BrowserSessionId) => Effect.Effect<void, BrowserError.BrowserError>\n}\n\nexport class Browser extends Context.Service<Browser, BrowserService>()(\n  \"@betalyra/effect-uai/Browser\",\n) {}\n\n// ---------------------------------------------------------------------------\n// Free helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Provision a session bound to the caller's scope. Drop the `Scope.Scope`\n * requirement with `Effect.scoped`.\n */\nexport const create = (\n  request: CommonSessionRequest,\n): Effect.Effect<BrowserSession, BrowserError.BrowserError, Browser | Scope.Scope> =>\n  Effect.flatMap(Browser.asEffect(), (s) => s.create(request))\n\n/**\n * Re-acquire an existing session by id. Same scope semantics as `create`,\n * but the finalizer detaches rather than destroying.\n */\nexport const attach = (\n  id: BrowserSessionId,\n): Effect.Effect<BrowserSession, BrowserError.BrowserError, Browser | Scope.Scope> =>\n  Effect.flatMap(Browser.asEffect(), (s) => s.attach(id))\n\n/** Enumerate sessions for the configured account / project. */\nexport const list: Effect.Effect<\n  ReadonlyArray<BrowserSessionRef>,\n  BrowserError.BrowserError,\n  Browser\n> = Effect.flatMap(Browser.asEffect(), (s) => s.list)\n\n/**\n * Destroy a session from outside its owning scope. Most callers should let\n * the scope finalizer handle this automatically.\n */\nexport const destroy = (\n  id: BrowserSessionId,\n): Effect.Effect<void, BrowserError.BrowserError, Browser> =>\n  Effect.flatMap(Browser.asEffect(), (s) => s.destroy(id))\n"],"mappings":";;;;;;;;;;;AAcA,MAAa,mBAAmB,MAAM,SAA2B;AAqNjE,IAAa,UAAb,cAA6B,QAAQ,SAAkC,CACrE,+BACD,CAAC;;;;;AAUF,MAAa,UACX,YAEA,OAAO,QAAQ,QAAQ,UAAU,GAAG,MAAM,EAAE,OAAO,QAAQ,CAAC;;;;;AAM9D,MAAa,UACX,OAEA,OAAO,QAAQ,QAAQ,UAAU,GAAG,MAAM,EAAE,OAAO,GAAG,CAAC;;AAGzD,MAAa,OAIT,OAAO,QAAQ,QAAQ,UAAU,GAAG,MAAM,EAAE,KAAK;;;;;AAMrD,MAAa,WACX,OAEA,OAAO,QAAQ,QAAQ,UAAU,GAAG,MAAM,EAAE,QAAQ,GAAG,CAAC"}
+{"version":3,"file":"Browser.mjs","names":[],"sources":["../../src/browser/Browser.ts"],"sourcesContent":["import { Brand, Context, type Duration, Effect, Scope } from \"effect\"\nimport type * as BrowserError from \"./BrowserError.js\"\n\n// ---------------------------------------------------------------------------\n// Identity\n// ---------------------------------------------------------------------------\n\n/**\n * Session identifier. Branded `string` so providers don't accidentally\n * accept a raw user-supplied id, and so a session id can't be passed where\n * another service's id is expected. Each provider mints these per its own\n * scheme; core code treats them opaquely. Mint via `BrowserSessionId(...)`.\n */\nexport type BrowserSessionId = Brand.Branded<string, \"BrowserSessionId\">\nexport const BrowserSessionId = Brand.nominal<BrowserSessionId>()\n\n/** Reference returned by `list`; enough to `attach`. */\nexport type BrowserSessionRef = {\n  readonly id: BrowserSessionId\n  /** Current top-level URL, when the provider reports it. */\n  readonly url?: string\n}\n\n/**\n * Output representation for {@link BrowserSession.content}. `markdown` is\n * the default.\n */\nexport type PageFormat = \"markdown\" | \"html\"\n\n// ---------------------------------------------------------------------------\n// Create request\n// ---------------------------------------------------------------------------\n\n/**\n * Cross-provider session-create request. Provider-specific knobs (proxy,\n * stealth, persistent profile, ...) live on each provider's narrowed\n * request type which extends this.\n */\nexport type CommonSessionRequest = {\n  /**\n   * Hard max lifetime of the session. Enforced locally (the handle is\n   * disposed and further calls fail with `BrowserSessionExpired`) and,\n   * where the provider supports it, passed through as a server-side cap so\n   * a crashed client still gets the session reclaimed. The provider cap\n   * must be >= the local reaper. Accepts millis, a string like\n   * `\"5 minutes\"`, or a `Duration`.\n   */\n  readonly timeout?: Duration.Input\n  /**\n   * Idle teardown: dispose the session after this much inactivity, the\n   * timer resetting on each operation. Opt-in; omit for no idle limit.\n   */\n  readonly idleTimeout?: Duration.Input\n  /** Initial viewport size. Providers default differently. */\n  readonly viewport?: { readonly width: number; readonly height: number }\n}\n\n// ---------------------------------------------------------------------------\n// Observation shapes\n// ---------------------------------------------------------------------------\n\nexport type BoundingBox = {\n  readonly x: number\n  readonly y: number\n  readonly width: number\n  readonly height: number\n}\n\n/**\n * One element returned by {@link BrowserSession.query}. Serializable data,\n * not a live handle (handles go stale across navigation and do not cross a\n * provider boundary cleanly).\n */\nexport type ElementInfo = {\n  /**\n   * Reference usable as a selector for a follow-up action. Valid until the\n   * next navigation; do not cache across `goto` or a page-changing click.\n   */\n  readonly ref: string\n  readonly tag: string\n  readonly text?: string\n  readonly attributes: Readonly<Record<string, string>>\n  readonly box?: BoundingBox\n}\n\n/** Accessibility-tree node returned by {@link BrowserSession.snapshot}. */\nexport type AxNode = {\n  readonly role: string\n  readonly name?: string\n  readonly value?: string\n  /**\n   * Reference usable as a selector for a follow-up action. Valid until the\n   * next navigation; do not cache across `goto` or a page-changing click.\n   */\n  readonly ref?: string\n  readonly children: ReadonlyArray<AxNode>\n}\n\n// ---------------------------------------------------------------------------\n// Interaction shapes\n// ---------------------------------------------------------------------------\n\nexport type ScrollDirection = \"up\" | \"down\" | \"left\" | \"right\"\n\nexport type ScrollOptions = {\n  readonly direction: ScrollDirection\n  /** Distance in CSS pixels. Provider default applies when omitted. */\n  readonly pixels?: number\n}\n\nexport type ScreenshotOptions = {\n  /** Clip to the first element matching this selector. */\n  readonly selector?: string\n  /** Capture the full scrollable page rather than the viewport. */\n  readonly fullPage?: boolean\n}\n\nexport type Cookie = {\n  readonly name: string\n  readonly value: string\n  readonly domain?: string\n  readonly path?: string\n  readonly expires?: number\n  readonly httpOnly?: boolean\n  readonly secure?: boolean\n  readonly sameSite?: \"Strict\" | \"Lax\" | \"None\"\n}\n\n/** Read / write the session's cookie jar. Needed for authenticated flows. */\nexport type CookieApi = {\n  readonly get: Effect.Effect<ReadonlyArray<Cookie>, BrowserError.BrowserError>\n  readonly set: (cookies: ReadonlyArray<Cookie>) => Effect.Effect<void, BrowserError.BrowserError>\n}\n\n// ---------------------------------------------------------------------------\n// Live session handle\n// ---------------------------------------------------------------------------\n\n/**\n * Live session handle. Actions take a CSS selector string (so `#id` is\n * just `#id`). Methods are plain `Effect` values; disposal is the scope\n * finalizer, not a method here (see {@link BrowserService}). Anything not\n * covered by a verb is reachable via `evaluate`. Per-operation time budgets\n * are the provider's default; wrap any call in `Effect.timeout` for a\n * tighter bound.\n */\nexport type BrowserSession = {\n  readonly id: BrowserSessionId\n\n  // Navigation and waiting\n  readonly goto: (url: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly waitFor: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n\n  // Interaction\n  readonly click: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly dblclick: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly fill: (selector: string, text: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly type: (selector: string, text: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly press: (key: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly hover: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly focus: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly select: (\n    selector: string,\n    value: string,\n  ) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly check: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly uncheck: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly scroll: (options: ScrollOptions) => Effect.Effect<void, BrowserError.BrowserError>\n  readonly scrollIntoView: (selector: string) => Effect.Effect<void, BrowserError.BrowserError>\n\n  // Observation\n  readonly content: (format?: PageFormat) => Effect.Effect<string, BrowserError.BrowserError>\n  readonly screenshot: (\n    options?: ScreenshotOptions,\n  ) => Effect.Effect<Uint8Array, BrowserError.BrowserError>\n  readonly snapshot: Effect.Effect<AxNode, BrowserError.BrowserError>\n  readonly query: (\n    selector: string,\n  ) => Effect.Effect<ReadonlyArray<ElementInfo>, BrowserError.BrowserError>\n\n  // State and escape hatch\n  readonly cookies: CookieApi\n  readonly evaluate: (script: string) => Effect.Effect<unknown, BrowserError.BrowserError>\n}\n\n// ---------------------------------------------------------------------------\n// Service definition\n// ---------------------------------------------------------------------------\n\n/**\n * Cross-provider browser service.\n *\n * Lifetime: `create` and `attach` return a handle in `Scope.Scope`. The\n * scope finalizer disposes the session (close the transport, destroy or\n * detach the remote session, kill the local engine). Bind with\n * `Effect.scoped` for a single call, or hold a wider scope to keep a\n * session warm across many calls. This is why there is no `dispose()` on\n * {@link BrowserSession}; the scope is the lifecycle handle.\n */\nexport type BrowserService = {\n  /**\n   * Provision a new session, bound to the caller's scope. Disposed on\n   * scope close.\n   */\n  readonly create: (\n    request: CommonSessionRequest,\n  ) => Effect.Effect<BrowserSession, BrowserError.BrowserError, Scope.Scope>\n\n  /**\n   * Re-acquire an existing session by id. Scope-bound, but the finalizer\n   * detaches rather than destroying, for sessions kept warm beyond a\n   * single run.\n   */\n  readonly attach: (\n    id: BrowserSessionId,\n  ) => Effect.Effect<BrowserSession, BrowserError.BrowserError, Scope.Scope>\n\n  /** Enumerate sessions visible to the configured account / project. */\n  readonly list: Effect.Effect<ReadonlyArray<BrowserSessionRef>, BrowserError.BrowserError>\n\n  /**\n   * Destroy a session from outside its owning scope. Most callers should\n   * let the scope finalizer handle this.\n   */\n  readonly destroy: (id: BrowserSessionId) => Effect.Effect<void, BrowserError.BrowserError>\n}\n\nexport class Browser extends Context.Service<Browser, BrowserService>()(\n  \"@betalyra/effect-uai/Browser\",\n) {}\n\n// ---------------------------------------------------------------------------\n// Free helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Provision a session bound to the caller's scope. Drop the `Scope.Scope`\n * requirement with `Effect.scoped`.\n */\nexport const create = (\n  request: CommonSessionRequest,\n): Effect.Effect<BrowserSession, BrowserError.BrowserError, Browser | Scope.Scope> =>\n  Effect.flatMap(Browser, (s) => s.create(request))\n\n/**\n * Re-acquire an existing session by id. Same scope semantics as `create`,\n * but the finalizer detaches rather than destroying.\n */\nexport const attach = (\n  id: BrowserSessionId,\n): Effect.Effect<BrowserSession, BrowserError.BrowserError, Browser | Scope.Scope> =>\n  Effect.flatMap(Browser, (s) => s.attach(id))\n\n/** Enumerate sessions for the configured account / project. */\nexport const list: Effect.Effect<\n  ReadonlyArray<BrowserSessionRef>,\n  BrowserError.BrowserError,\n  Browser\n> = Effect.flatMap(Browser, (s) => s.list)\n\n/**\n * Destroy a session from outside its owning scope. Most callers should let\n * the scope finalizer handle this automatically.\n */\nexport const destroy = (\n  id: BrowserSessionId,\n): Effect.Effect<void, BrowserError.BrowserError, Browser> =>\n  Effect.flatMap(Browser, (s) => s.destroy(id))\n"],"mappings":";;;;;;;;;;;AAcA,MAAa,mBAAmB,MAAM,SAA2B;AAqNjE,IAAa,UAAb,cAA6B,QAAQ,SAAkC,CACrE,+BACD,CAAC;;;;;AAUF,MAAa,UACX,YAEA,OAAO,QAAQ,UAAU,MAAM,EAAE,OAAO,QAAQ,CAAC;;;;;AAMnD,MAAa,UACX,OAEA,OAAO,QAAQ,UAAU,MAAM,EAAE,OAAO,GAAG,CAAC;;AAG9C,MAAa,OAIT,OAAO,QAAQ,UAAU,MAAM,EAAE,KAAK;;;;;AAM1C,MAAa,WACX,OAEA,OAAO,QAAQ,UAAU,MAAM,EAAE,QAAQ,GAAG,CAAC"}