effect 4.0.0-beta.70 → 4.0.0-beta.71

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
  */
@@ -45,6 +93,12 @@ declare const EmbeddingUsage_base: Schema.Class<EmbeddingUsage, Schema.Struct<{
 /**
  * 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,15 @@ declare const EmbedManyResponse_base: Schema.Class<EmbedManyResponse, Schema.Str
     readonly usage: typeof EmbeddingUsage;
 }>, {}>;
 /**
- * Response for multiple embeddings.
+ * Batch embedding response 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
@@ -100,6 +162,15 @@ declare const EmbeddingRequest_base: new <A extends Record<string, any>, Success
 /**
  * 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
  */
@@ -121,6 +192,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;;;;;;;;;;;;;GAaG;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,6 +73,13 @@ 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
  */
@@ -39,6 +87,12 @@ export class Dimensions extends /*#__PURE__*/Context.Service()("effect/unstable/
 /**
  * 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,15 @@ export class EmbedResponse extends /*#__PURE__*/Schema.Class("effect/ai/Embeddin
   vector: /*#__PURE__*/Schema.Array(Schema.Finite)
 }) {}
 /**
- * Response for multiple embeddings.
+ * Batch embedding response 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
@@ -67,6 +129,15 @@ export class EmbedManyResponse extends /*#__PURE__*/Schema.Class("effect/ai/Embe
 /**
  * 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 +152,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

@@ -252,7 +252,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.js

@@ -222,7 +222,7 @@ export const make = /*#__PURE__*/Effect.fnUntraced(function* ({
  *
  * **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/LanguageModel.d.ts

@@ -99,6 +99,20 @@ export type CodecTransformer = <T, E, RD, RE>(schema: Schema.Codec<T, E, RD, RE>
  * The default codec transformer that passes schemas through without
  * provider-specific rewrites.
  *
+ * **When to use**
+ *
+ * Use as the codec transformer for provider implementations when the provider
+ * accepts the JSON Schema generated from an `Effect` Schema codec without
+ * provider-specific rewrites.
+ *
+ * **Details**
+ *
+ * The transformer returns the original codec, resolves a top-level `$ref`, and
+ * copies schema definitions into `$defs`.
+ *
+ * @see {@link CodecTransformer} for the structured-output transformer contract
+ * @see {@link make} for where this transformer is used as the default
+ *
  * @category services
  * @since 4.0.0
  */
@@ -146,7 +160,7 @@ export interface GenerateTextOptions<Tools extends Record<string, Tool.Any>> {
      *
      * **When to use**
      *
-     * Use this when you want to include tool call definitions from an `AiToolkit`
+     * Use when you want to include tool call definitions from an `AiToolkit`
      * in requests to the large language model, while controlling tool call
      * resolver execution yourself.
      */
@@ -425,7 +439,32 @@ export interface ProviderOptions {
     readonly incrementalPrompt: Prompt.Prompt | undefined;
 }
 /**
- * Creates a LanguageModel service from provider-specific text generation and streaming implementations.
+ * Creates a LanguageModel service from provider-specific text generation and
+ * streaming implementations.
+ *
+ * **When to use**
+ *
+ * Use to build a `LanguageModel.Service` from provider-specific final and
+ * streaming text generation functions.
+ *
+ * **Details**
+ *
+ * The returned service implements `generateText`, `generateObject`, and
+ * `streamText`. It prepares `ProviderOptions` for each request, including the
+ * normalized prompt, tools, tool choice, response format, tracing span, and
+ * incremental response fields, before calling the supplied provider hook.
+ * Structured object generation uses the `generateText` hook and the configured
+ * `codecTransformer`, or `defaultCodecTransformer` when none is supplied.
+ *
+ * **Gotchas**
+ *
+ * Provider hooks must return encoded response parts that match the toolkit and
+ * response format prepared in `ProviderOptions`; invalid parts fail decoding as
+ * `AiError.InvalidOutputError`.
+ *
+ * @see {@link Service} for the returned service contract
+ * @see {@link ProviderOptions} for the normalized options passed to provider hooks
+ * @see {@link defaultCodecTransformer} for the default structured-output schema transformer
  *
  * @category constructors
  * @since 4.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"LanguageModel.d.ts","sourceRoot":"","sources":["../../../src/unstable/ai/LanguageModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LanguageModel.d.ts","sourceRoot":"","sources":["../../../src/unstable/ai/LanguageModel.ts"],"names":[],"mappings":"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"}

package/dist/unstable/ai/LanguageModel.js

@@ -47,6 +47,20 @@ export class LanguageModel extends /*#__PURE__*/Context.Service()("effect/unstab
  * The default codec transformer that passes schemas through without
  * provider-specific rewrites.
  *
+ * **When to use**
+ *
+ * Use as the codec transformer for provider implementations when the provider
+ * accepts the JSON Schema generated from an `Effect` Schema codec without
+ * provider-specific rewrites.
+ *
+ * **Details**
+ *
+ * The transformer returns the original codec, resolves a top-level `$ref`, and
+ * copies schema definitions into `$defs`.
+ *
+ * @see {@link CodecTransformer} for the structured-output transformer contract
+ * @see {@link make} for where this transformer is used as the default
+ *
  * @category services
  * @since 4.0.0
  */
@@ -194,7 +208,32 @@ export class GenerateObjectResponse extends GenerateTextResponse {
   }
 }
 /**
- * Creates a LanguageModel service from provider-specific text generation and streaming implementations.
+ * Creates a LanguageModel service from provider-specific text generation and
+ * streaming implementations.
+ *
+ * **When to use**
+ *
+ * Use to build a `LanguageModel.Service` from provider-specific final and
+ * streaming text generation functions.
+ *
+ * **Details**
+ *
+ * The returned service implements `generateText`, `generateObject`, and
+ * `streamText`. It prepares `ProviderOptions` for each request, including the
+ * normalized prompt, tools, tool choice, response format, tracing span, and
+ * incremental response fields, before calling the supplied provider hook.
+ * Structured object generation uses the `generateText` hook and the configured
+ * `codecTransformer`, or `defaultCodecTransformer` when none is supplied.
+ *
+ * **Gotchas**
+ *
+ * Provider hooks must return encoded response parts that match the toolkit and
+ * response format prepared in `ProviderOptions`; invalid parts fail decoding as
+ * `AiError.InvalidOutputError`.
+ *
+ * @see {@link Service} for the returned service contract
+ * @see {@link ProviderOptions} for the normalized options passed to provider hooks
+ * @see {@link defaultCodecTransformer} for the default structured-output schema transformer
  *
  * @category constructors
  * @since 4.0.0