effect 4.0.0-beta.70 → 4.0.0-beta.72

package/dist/unstable/ai/Chat.js

@@ -1,48 +1,58 @@
 /**
- * The `Chat` module provides a stateful conversation interface for AI language
- * models.
+ * Stateful conversation sessions on top of a language model.
  *
- * This module enables persistent chat sessions that maintain conversation
- * history, support tool calling, and offer both streaming and non-streaming
- * text generation. It integrates seamlessly with the Effect AI ecosystem,
- * providing type-safe conversational AI capabilities.
+ * A `Chat` keeps `Prompt` history in a `Ref` and reuses it for text generation,
+ * streaming, and structured output. Each generation call combines the current
+ * history with the caller's new prompt, invokes the active language model, and
+ * appends the response parts back into history. Constructors create fresh
+ * sessions, seed sessions from prompts, restore exported history, or connect a
+ * chat to persistence.
  *
- * **Example** (Creating a chat session)
+ * **Mental model**
+ *
+ * A {@link Service} is a mutable conversation handle. It stores history, while
+ * the language model implementation is still supplied through the Effect
+ * environment when `generateText`, `streamText`, or `generateObject` runs.
+ * Local sessions created with {@link empty} and {@link fromPrompt} live only in
+ * memory; persisted sessions add a backing store and save after generation.
+ *
+ * **Common tasks**
+ *
+ * - Start an empty session with {@link empty}.
+ * - Seed system prompts or prior messages with {@link fromPrompt}.
+ * - Restore saved history with {@link fromExport} or {@link fromJson}.
+ * - Persist sessions by providing {@link Persistence} with {@link makePersisted}
+ *   or {@link layerPersisted}.
+ *
+ * **Example** (Starting a chat session)
  *
  * ```ts
  * import { Effect } from "effect"
  * import { Chat } from "effect/unstable/ai"
  *
- * // Create a new chat session
  * const program = Effect.gen(function*() {
- *   const chat = yield* Chat.empty
+ *   const chat = yield* Chat.fromPrompt([{
+ *     role: "system",
+ *     content: "Answer in one sentence."
+ *   }])
  *
- *   // Send a message and get response
  *   const response = yield* chat.generateText({
- *     prompt: "Hello! What can you help me with?"
+ *     prompt: "What does Effect provide for TypeScript applications?"
  *   })
  *
- *   console.log(response.content)
+ *   const saved = yield* chat.exportJson
  *
- *   return response
+ *   return { text: response.text, saved }
  * })
  * ```
  *
- * **Example** (Streaming chat responses)
- *
- * ```ts
- * import { Effect, Stream } from "effect"
- * import { Chat } from "effect/unstable/ai"
- *
- * // Streaming chat with tool support
- * const streamingChat = Effect.gen(function*() {
- *   const chat = yield* Chat.empty
+ * **Gotchas**
  *
- *   yield* chat.streamText({
- *     prompt: "Generate a creative story"
- *   }).pipe(Stream.runForEach((part) => Effect.sync(() => console.log(part))))
- * })
- * ```
+ * Generation requires a language model service in the environment. `streamText`
+ * records the parts emitted by the stream when the stream finalizes, so consume
+ * the stream to completion when the full assistant response should become part
+ * of history. Direct writes to `history` are possible, but bypass the helpers
+ * that encode, decode, export, and persist the conversation.
  *
  * @since 4.0.0
  */
@@ -64,7 +74,12 @@ import * as IdGenerator from "./IdGenerator.js";
 import * as LanguageModel from "./LanguageModel.js";
 import * as Prompt from "./Prompt.js";
 /**
- * The `Chat` service tag for dependency injection.
+ * Service tag for stateful AI conversation sessions.
+ *
+ * **When to use**
+ *
+ * Use to access or provide conversational AI sessions through the Effect
+ * context.
  *
  * **Details**
  *
@@ -87,7 +102,7 @@ import * as Prompt from "./Prompt.js";
  * })
  * ```
  *
- * @category services
+ * @category tags
  * @since 4.0.0
  */
 export class Chat extends /*#__PURE__*/Context.Service()("effect/ai/Chat") {}
@@ -162,7 +177,7 @@ const makeUnsafe = history => {
  *
  * **When to use**
  *
- * This is the most common way to start a fresh chat session without
+ * Use when this is the most common way to start a fresh chat session without
  * any initial context or system prompts.
  *
  * **Example** (Creating an empty chat)
@@ -344,9 +359,14 @@ export const fromJson = data => Effect.flatMap(decodeHistoryJson(data), fromProm
 // Chat Persistence
 // =============================================================================
 /**
- * An error that occurs when attempting to retrieve a persisted `Chat` that
+ * Represents an error that occurs when attempting to retrieve a persisted `Chat` that
  * does not exist in the backing persistence store.
  *
+ * **When to use**
+ *
+ * Use to represent a missing persisted conversation when lookup by id cannot
+ * find stored history.
+ *
  * @category errors
  * @since 4.0.0
  */
@@ -355,9 +375,14 @@ export class ChatNotFoundError extends /*#__PURE__*/Schema.ErrorClass("effect/ai
   chatId: Schema.String
 }) {}
 /**
- * The context tag for chat persistence.
+ * Service tag for persistence-backed AI conversation storage.
+ *
+ * **When to use**
+ *
+ * Use to provide the storage operations needed by persisted conversation
+ * sessions.
  *
- * @category services
+ * @category tags
  * @since 4.0.0
  */
 // @effect-diagnostics effect/leakingRequirements:off
@@ -365,11 +390,19 @@ export class Persistence extends /*#__PURE__*/Context.Service()("effect/ai/Chat/
 /**
  * Creates a new chat persistence service.
  *
+ * **When to use**
+ *
+ * Use to construct the `Chat.Persistence` service from the current
+ * `BackingPersistence` when you want to create and retrieve persisted chats
+ * programmatically by chat id.
+ *
  * **Details**
  *
  * The provided store identifier will be used to indicate which "store" the
  * backing persistence should load chats from.
  *
+ * @see {@link layerPersisted} for the `Layer`-based constructor
+ *
  * @category constructors
  * @since 4.0.0
  */
@@ -477,11 +510,18 @@ export const makePersisted = /*#__PURE__*/Effect.fnUntraced(function* (options)
 /**
  * Creates a `Layer` for a new chat persistence service.
  *
+ * **When to use**
+ *
+ * Use to provide `Chat.Persistence` from a configured `BackingPersistence` when
+ * your application needs persisted chat sessions backed by a named store.
+ *
  * **Details**
  *
  * The provided store identifier will be used to indicate which "store" the
  * backing persistence should load chats from.
  *
+ * @see {@link makePersisted} for the effect constructor when building the service directly instead of providing it as a layer
+ *
  * @category constructors
  * @since 4.0.0
  */

package/dist/unstable/ai/Chat.js.map

@@ -1 +1 @@
-{"version":3,"file":"Chat.js","names":["Channel","Chunk","Context","Duration","Effect","Layer","Option","Predicate","Ref","Schema","Semaphore","Stream","BackingPersistence","AiError","IdGenerator","LanguageModel","Prompt","Chat","Service","decodeHistory","decodeUnknownEffect","encodeHistory","encodeUnknownEffect","decodeHistoryJson","fromJsonString","encodeHistoryJson","makeUnsafe","history","semaphore","of","export","get","pipe","flatMap","catchTag","error","fail","make","module","method","reason","InvalidOutputError","fromSchemaError","withSpan","exportJson","generateText","fnUntraced","options","newPrompt","prompt","oldPrompt","concat","response","newHistory","fromResponseParts","content","set","withPermits","effect","captureStackTrace","streamText","parts","empty","fromChannel","acquireUseRelease","take","map","mapArray","chunk","appendAll","fromArrayUnsafe","toChannel","andThen","Array","from","release","unwrap","generateObject","attributes","objectName","getObjectName","schema","sync","fromPrompt","fromExport","data","fromJson","ChatNotFoundError","ErrorClass","_tag","tag","chatId","String","Persistence","makePersisted","persistence","store","storeId","toPersisted","chat","ttl","idGenerator","serviceOption","getOrElse","defaultIdGenerator","saveChat","prevHistory","lastMessage","length","messageId","undefined","isNotUndefined","role","key","isUndefined","generateId","i","message","exported","orDie","timeToLive","getOrUndefined","fromInput","persisted","id","save","ensuring","stream","createChat","getChat","previousHistory","die","getOrCreate","layerPersisted"],"sources":["../../../src/unstable/ai/Chat.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Chat.js","names":["Channel","Chunk","Context","Duration","Effect","Layer","Option","Predicate","Ref","Schema","Semaphore","Stream","BackingPersistence","AiError","IdGenerator","LanguageModel","Prompt","Chat","Service","decodeHistory","decodeUnknownEffect","encodeHistory","encodeUnknownEffect","decodeHistoryJson","fromJsonString","encodeHistoryJson","makeUnsafe","history","semaphore","of","export","get","pipe","flatMap","catchTag","error","fail","make","module","method","reason","InvalidOutputError","fromSchemaError","withSpan","exportJson","generateText","fnUntraced","options","newPrompt","prompt","oldPrompt","concat","response","newHistory","fromResponseParts","content","set","withPermits","effect","captureStackTrace","streamText","parts","empty","fromChannel","acquireUseRelease","take","map","mapArray","chunk","appendAll","fromArrayUnsafe","toChannel","andThen","Array","from","release","unwrap","generateObject","attributes","objectName","getObjectName","schema","sync","fromPrompt","fromExport","data","fromJson","ChatNotFoundError","ErrorClass","_tag","tag","chatId","String","Persistence","makePersisted","persistence","store","storeId","toPersisted","chat","ttl","idGenerator","serviceOption","getOrElse","defaultIdGenerator","saveChat","prevHistory","lastMessage","length","messageId","undefined","isNotUndefined","role","key","isUndefined","generateId","i","message","exported","orDie","timeToLive","getOrUndefined","fromInput","persisted","id","save","ensuring","stream","createChat","getChat","previousHistory","die","getOrCreate","layerPersisted"],"sources":["../../../src/unstable/ai/Chat.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/ai/EmbeddingModel.d.ts

@@ -1,18 +1,50 @@
 /**
- * The `EmbeddingModel` module provides provider-agnostic text embedding capabilities.
+ * The `EmbeddingModel` module defines the provider-neutral service for turning
+ * text into embedding vectors. It exposes single-input `embed` and ordered
+ * batch `embedMany` operations, and keeps provider failures represented as
+ * `AiError` values.
  *
- * **Example** (Embedding text with a model)
+ * **Mental model**
+ *
+ * Providers supply one batch embedding function through `make`. The module
+ * derives single-input `embed` calls from a request resolver, so concurrent
+ * single-input requests can be batched into one provider call. Provider
+ * vectors are wrapped as `EmbedResponse` values, while `EmbedManyResponse`
+ * preserves input order and carries token usage when the provider reports it.
+ *
+ * **Common tasks**
+ *
+ * - Build an `EmbeddingModel` service from a provider implementation.
+ * - Use `embed` for one query or document, and `embedMany` when the caller
+ *   already has a batch.
+ * - Read `Dimensions` when downstream code needs the configured vector size.
+ *
+ * **Example** (Building a small embedding model)
  *
  * ```ts
  * import { Effect } from "effect"
  * import { EmbeddingModel } from "effect/unstable/ai"
  *
  * const program = Effect.gen(function*() {
- *   const model = yield* EmbeddingModel.EmbeddingModel
- *   return yield* model.embed("hello world")
+ *   const model = yield* EmbeddingModel.make({
+ *     embedMany: ({ inputs }) =>
+ *       Effect.succeed({
+ *         results: inputs.map((input) => [input.length]),
+ *         usage: { inputTokens: inputs.join(" ").length }
+ *       })
+ *   })
+ *
+ *   const response = yield* model.embed("hello")
+ *   return response.vector
  * })
  * ```
  *
+ * **Gotchas**
+ *
+ * - `embedMany([])` returns an empty response without invoking the provider.
+ * - Provider batch responses must contain exactly one vector for each input,
+ *   in the same order as the input array.
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.ts";
@@ -25,6 +57,15 @@ declare const EmbeddingModel_base: Context.ServiceClass<EmbeddingModel, "effect/
 /**
  * Service tag for embedding model operations.
  *
+ * **When to use**
+ *
+ * Use to retrieve or provide an `EmbeddingModel.Service` when an `Effect`
+ * program needs to embed text into vectors.
+ *
+ * @see {@link Service} for the service contract provided by this tag
+ * @see {@link make} for constructing an embedding model service from a provider
+ * @see {@link Dimensions} for the current embedding vector size service
+ *
  * @category services
  * @since 4.0.0
  */
@@ -34,6 +75,13 @@ declare const Dimensions_base: Context.ServiceClass<Dimensions, "effect/unstable
 /**
  * Service tag that provides the current embedding dimensions.
  *
+ * **When to use**
+ *
+ * Use to retrieve or provide the configured embedding vector size through
+ * context.
+ *
+ * @see {@link EmbeddingModel} for the embedding service that uses these dimensions
+ *
  * @category services
  * @since 4.0.0
  */
@@ -43,7 +91,13 @@ declare const EmbeddingUsage_base: Schema.Class<EmbeddingUsage, Schema.Struct<{
     readonly inputTokens: Schema.UndefinedOr<Schema.Finite>;
 }>, {}>;
 /**
- * Token usage metadata for embedding operations.
+ * Represents token usage metadata for embedding operations.
+ *
+ * **Details**
+ *
+ * Contains optional provider-reported `inputTokens`. The value may be
+ * `undefined` when the provider does not report usage or when `embedMany([])`
+ * bypasses the provider.
  *
  * @category models
  * @since 4.0.0
@@ -66,7 +120,16 @@ declare const EmbedManyResponse_base: Schema.Class<EmbedManyResponse, Schema.Str
     readonly usage: typeof EmbeddingUsage;
 }>, {}>;
 /**
- * Response for multiple embeddings.
+ * Response for batch embedding requests containing per-input embeddings and usage
+ * metadata.
+ *
+ * **Details**
+ *
+ * `embeddings` preserves batch order, and `usage` carries token metadata for
+ * the operation.
+ *
+ * @see {@link EmbedResponse} for individual embedding responses
+ * @see {@link EmbeddingUsage} for token usage metadata
  *
  * @category models
  * @since 4.0.0
@@ -98,7 +161,16 @@ declare const EmbeddingRequest_base: new <A extends Record<string, any>, Success
     readonly _tag: "EmbeddingRequest";
 };
 /**
- * Tagged request used by request resolvers for embedding operations.
+ * Represents a tagged request used by request resolvers for embedding operations.
+ *
+ * **When to use**
+ *
+ * Use when building or calling a low-level embedding request resolver and you
+ * need a typed request for one input that resolves to `EmbedResponse`.
+ *
+ * @see {@link Service} for the resolver-bearing service contract
+ * @see {@link make} for constructing the request resolver from a provider implementation
+ * @see {@link EmbedResponse} for the response produced by this request
  *
  * @category constructors
  * @since 4.0.0
@@ -108,7 +180,7 @@ export declare class EmbeddingRequest extends EmbeddingRequest_base<{
 }, EmbedResponse, AiError.AiError> {
 }
 /**
- * Service interface for embedding operations.
+ * Defines the service interface for embedding operations.
  *
  * @category models
  * @since 4.0.0
@@ -121,6 +193,30 @@ export interface Service {
 /**
  * Creates an EmbeddingModel service from a provider embedMany implementation.
  *
+ * **When to use**
+ *
+ * Use to adapt a provider's batch embedding implementation into an
+ * `EmbeddingModel.Service` that offers single-input and batch embedding
+ * operations.
+ *
+ * **Details**
+ *
+ * The returned service builds single-input `embed` calls through a request
+ * resolver, so concurrent `embed` requests can be batched into one provider
+ * `embedMany` call. Direct `embedMany` calls pass the input array to the
+ * provider, while `embedMany([])` returns an empty response without calling the
+ * provider.
+ *
+ * **Gotchas**
+ *
+ * Provider responses are interpreted positionally and must contain exactly one
+ * result for each requested input. If the provider returns a different number
+ * of results, `embed` and `embedMany` fail with `AiError.InvalidOutputError`.
+ *
+ * @see {@link Service} for the service shape returned by this constructor
+ * @see {@link ProviderOptions} for the input passed to the provider implementation
+ * @see {@link ProviderResponse} for the provider response contract consumed by this constructor
+ *
  * @category constructors
  * @since 4.0.0
  */

package/dist/unstable/ai/EmbeddingModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EmbeddingModel.d.ts","sourceRoot":"","sources":["../../../src/unstable/ai/EmbeddingModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,eAAe,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;;AAEvC;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,mBAEnC;CAAG;;AAEJ;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,eAE/B;CAAG;;;;AAEJ;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,mBAIlC;CAAG;;;;AAEL;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,kBAIjC;CAAG;;;;;AAEL;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,sBAKrC;CAAG;AAEL;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;KACzC,CAAA;CACF;;;;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,sBACpC;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC1B,aAAa,EACb,OAAO,CAAC,OAAO,CAChB;CAAG;AAEJ;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAA;IACpE,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAChF,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CACxG;AASD;;;;;GAKG;AACH,eAAO,MAAM,IAAI,EAAE,CAAC,MAAM,EAAE;IAC1B,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CACnG,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CA8CzB,CAAA"}
+{"version":3,"file":"EmbeddingModel.d.ts","sourceRoot":"","sources":["../../../src/unstable/ai/EmbeddingModel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,eAAe,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;;AAEvC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,SAAQ,mBAEnC;CAAG;;AAEJ;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAW,SAAQ,eAE/B;CAAG;;;;AAEJ;;;;;;;;;;;GAWG;AACH,qBAAa,cAAe,SAAQ,mBAIlC;CAAG;;;;AAEL;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,kBAIjC;CAAG;;;;;AAEL;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,SAAQ,sBAKrC;CAAG;AAEL;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;KACzC,CAAA;CACF;;;;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAiB,SAAQ,sBACpC;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC1B,aAAa,EACb,OAAO,CAAC,OAAO,CAChB;CAAG;AAEJ;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAA;IACpE,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAChF,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CACxG;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,IAAI,EAAE,CAAC,MAAM,EAAE;IAC1B,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CACnG,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CA8CzB,CAAA"}

package/dist/unstable/ai/EmbeddingModel.js

@@ -1,18 +1,50 @@
 /**
- * The `EmbeddingModel` module provides provider-agnostic text embedding capabilities.
+ * The `EmbeddingModel` module defines the provider-neutral service for turning
+ * text into embedding vectors. It exposes single-input `embed` and ordered
+ * batch `embedMany` operations, and keeps provider failures represented as
+ * `AiError` values.
  *
- * **Example** (Embedding text with a model)
+ * **Mental model**
+ *
+ * Providers supply one batch embedding function through `make`. The module
+ * derives single-input `embed` calls from a request resolver, so concurrent
+ * single-input requests can be batched into one provider call. Provider
+ * vectors are wrapped as `EmbedResponse` values, while `EmbedManyResponse`
+ * preserves input order and carries token usage when the provider reports it.
+ *
+ * **Common tasks**
+ *
+ * - Build an `EmbeddingModel` service from a provider implementation.
+ * - Use `embed` for one query or document, and `embedMany` when the caller
+ *   already has a batch.
+ * - Read `Dimensions` when downstream code needs the configured vector size.
+ *
+ * **Example** (Building a small embedding model)
  *
  * ```ts
  * import { Effect } from "effect"
  * import { EmbeddingModel } from "effect/unstable/ai"
  *
  * const program = Effect.gen(function*() {
- *   const model = yield* EmbeddingModel.EmbeddingModel
- *   return yield* model.embed("hello world")
+ *   const model = yield* EmbeddingModel.make({
+ *     embedMany: ({ inputs }) =>
+ *       Effect.succeed({
+ *         results: inputs.map((input) => [input.length]),
+ *         usage: { inputTokens: inputs.join(" ").length }
+ *       })
+ *   })
+ *
+ *   const response = yield* model.embed("hello")
+ *   return response.vector
  * })
  * ```
  *
+ * **Gotchas**
+ *
+ * - `embedMany([])` returns an empty response without invoking the provider.
+ * - Provider batch responses must contain exactly one vector for each input,
+ *   in the same order as the input array.
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.js";
@@ -25,6 +57,15 @@ import * as AiError from "./AiError.js";
 /**
  * Service tag for embedding model operations.
  *
+ * **When to use**
+ *
+ * Use to retrieve or provide an `EmbeddingModel.Service` when an `Effect`
+ * program needs to embed text into vectors.
+ *
+ * @see {@link Service} for the service contract provided by this tag
+ * @see {@link make} for constructing an embedding model service from a provider
+ * @see {@link Dimensions} for the current embedding vector size service
+ *
  * @category services
  * @since 4.0.0
  */
@@ -32,12 +73,25 @@ export class EmbeddingModel extends /*#__PURE__*/Context.Service()("effect/unsta
 /**
  * Service tag that provides the current embedding dimensions.
  *
+ * **When to use**
+ *
+ * Use to retrieve or provide the configured embedding vector size through
+ * context.
+ *
+ * @see {@link EmbeddingModel} for the embedding service that uses these dimensions
+ *
  * @category services
  * @since 4.0.0
  */
 export class Dimensions extends /*#__PURE__*/Context.Service()("effect/unstable/ai/EmbeddingModel/Dimensions") {}
 /**
- * Token usage metadata for embedding operations.
+ * Represents token usage metadata for embedding operations.
+ *
+ * **Details**
+ *
+ * Contains optional provider-reported `inputTokens`. The value may be
+ * `undefined` when the provider does not report usage or when `embedMany([])`
+ * bypasses the provider.
  *
  * @category models
  * @since 4.0.0
@@ -55,7 +109,16 @@ export class EmbedResponse extends /*#__PURE__*/Schema.Class("effect/ai/Embeddin
   vector: /*#__PURE__*/Schema.Array(Schema.Finite)
 }) {}
 /**
- * Response for multiple embeddings.
+ * Response for batch embedding requests containing per-input embeddings and usage
+ * metadata.
+ *
+ * **Details**
+ *
+ * `embeddings` preserves batch order, and `usage` carries token metadata for
+ * the operation.
+ *
+ * @see {@link EmbedResponse} for individual embedding responses
+ * @see {@link EmbeddingUsage} for token usage metadata
  *
  * @category models
  * @since 4.0.0
@@ -65,7 +128,16 @@ export class EmbedManyResponse extends /*#__PURE__*/Schema.Class("effect/ai/Embe
   usage: EmbeddingUsage
 }) {}
 /**
- * Tagged request used by request resolvers for embedding operations.
+ * Represents a tagged request used by request resolvers for embedding operations.
+ *
+ * **When to use**
+ *
+ * Use when building or calling a low-level embedding request resolver and you
+ * need a typed request for one input that resolves to `EmbedResponse`.
+ *
+ * @see {@link Service} for the resolver-bearing service contract
+ * @see {@link make} for constructing the request resolver from a provider implementation
+ * @see {@link EmbedResponse} for the response produced by this request
  *
  * @category constructors
  * @since 4.0.0
@@ -81,6 +153,30 @@ const invalidProviderResponse = description => AiError.make({
 /**
  * Creates an EmbeddingModel service from a provider embedMany implementation.
  *
+ * **When to use**
+ *
+ * Use to adapt a provider's batch embedding implementation into an
+ * `EmbeddingModel.Service` that offers single-input and batch embedding
+ * operations.
+ *
+ * **Details**
+ *
+ * The returned service builds single-input `embed` calls through a request
+ * resolver, so concurrent `embed` requests can be batched into one provider
+ * `embedMany` call. Direct `embedMany` calls pass the input array to the
+ * provider, while `embedMany([])` returns an empty response without calling the
+ * provider.
+ *
+ * **Gotchas**
+ *
+ * Provider responses are interpreted positionally and must contain exactly one
+ * result for each requested input. If the provider returns a different number
+ * of results, `embed` and `embedMany` fail with `AiError.InvalidOutputError`.
+ *
+ * @see {@link Service} for the service shape returned by this constructor
+ * @see {@link ProviderOptions} for the input passed to the provider implementation
+ * @see {@link ProviderResponse} for the provider response contract consumed by this constructor
+ *
  * @category constructors
  * @since 4.0.0
  */

package/dist/unstable/ai/EmbeddingModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmbeddingModel.js","names":["Context","Effect","Exit","Request","RequestResolver","Schema","AiError","EmbeddingModel","Service","Dimensions","EmbeddingUsage","Class","inputTokens","UndefinedOr","Finite","EmbedResponse","vector","Array","EmbedManyResponse","embeddings","usage","EmbeddingRequest","TaggedClass","invalidProviderResponse","description","make","module","method","reason","InvalidOutputError","fnUntraced","params","resolver","entries","flatMap","embedMany","inputs","map","entry","request","input","response","mapProviderResults","length","results","i","completeUnsafe","succeed","pipe","withSpan","of","embed","undefined","inputLength","fail"],"sources":["../../../src/unstable/ai/EmbeddingModel.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"EmbeddingModel.js","names":["Context","Effect","Exit","Request","RequestResolver","Schema","AiError","EmbeddingModel","Service","Dimensions","EmbeddingUsage","Class","inputTokens","UndefinedOr","Finite","EmbedResponse","vector","Array","EmbedManyResponse","embeddings","usage","EmbeddingRequest","TaggedClass","invalidProviderResponse","description","make","module","method","reason","InvalidOutputError","fnUntraced","params","resolver","entries","flatMap","embedMany","inputs","map","entry","request","input","response","mapProviderResults","length","results","i","completeUnsafe","succeed","pipe","withSpan","of","embed","undefined","inputLength","fail"],"sources":["../../../src/unstable/ai/EmbeddingModel.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/ai/IdGenerator.d.ts

@@ -53,7 +53,12 @@ import * as Effect from "../../Effect.ts";
 import * as Layer from "../../Layer.ts";
 declare const IdGenerator_base: Context.ServiceClass<IdGenerator, "@effect/ai/IdGenerator", Service>;
 /**
- * The `IdGenerator` service tag for dependency injection.
+ * Service tag for AI identifier generation services.
+ *
+ * **When to use**
+ *
+ * Use to access or provide the service that creates identifiers for AI tool
+ * calls and related generated values.
  *
  * **Details**
  *
@@ -74,7 +79,7 @@ declare const IdGenerator_base: Context.ServiceClass<IdGenerator, "@effect/ai/Id
  * })
  * ```
  *
- * @category models
+ * @category tags
  * @since 4.0.0
  */
 export declare class IdGenerator extends IdGenerator_base {
@@ -252,7 +257,7 @@ export declare const make: (args_0: MakeOptions) => Effect.Effect<{
  *
  * **When to use**
  *
- * This is the recommended way to provide ID generation capabilities to your
+ * Use when this is the recommended way to provide ID generation capabilities to your
  * application. The layer will fail during construction if the configuration is
  * invalid.
  *

package/dist/unstable/ai/IdGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdGenerator.d.ts","sourceRoot":"","sources":["../../../src/unstable/ai/IdGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;;AAIvC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,WAAY,SAAQ,gBAEhC;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAEhC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,IAAI;;qCAgBf,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,KAAK,GAAI,SAAS,WAAW,KAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,oBAAoB,CACtD,CAAA"}
+{"version":3,"file":"IdGenerator.d.ts","sourceRoot":"","sources":["../../../src/unstable/ai/IdGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;;AAIvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,WAAY,SAAQ,gBAEhC;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAEhC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,IAAI;;qCAgBf,CAAA;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,KAAK,GAAI,SAAS,WAAW,KAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,oBAAoB,CACtD,CAAA"}