effect 4.0.0-beta.67 → 4.0.0-beta.68

package/src/testing/FastCheck.ts

@@ -22,7 +22,7 @@
  * **Example** (Checking an array reversal property)
  *
  * ```ts
- * import * as FastCheck from "effect/testing/FastCheck"
+ * import { FastCheck } from "effect/testing"
  *
  * // Property: reverse of reverse should equal original
  * const reverseProp = FastCheck.property(
@@ -41,7 +41,7 @@
  * **Example** (Checking string concatenation properties)
  *
  * ```ts
- * import * as FastCheck from "effect/testing/FastCheck"
+ * import { FastCheck } from "effect/testing"
  *
  * // Test string concatenation properties
  * const concatProp = FastCheck.property(
@@ -61,7 +61,7 @@
  * **Example** (Generating record data for properties)
  *
  * ```ts
- * import * as FastCheck from "effect/testing/FastCheck"
+ * import { FastCheck } from "effect/testing"
  *
  * // Generate random data for testing
  * const personArbitrary = FastCheck.record({

package/src/testing/TestClock.ts

@@ -142,8 +142,7 @@ export interface TestClock extends Clock.Clock {
  * })
  * ```
  *
- * @category models
- * @since 4.0.0
+ * @since 2.0.0
  */
 export declare namespace TestClock {
   /**
@@ -524,7 +523,7 @@ export const setTime = (timestamp: number): Effect.Effect<void> =>
  * ```
  *
  * @category utils
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const withLive = <A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>
   testClockWith((testClock) => testClock.withLive(effect))

package/src/testing/TestConsole.ts

@@ -28,7 +28,7 @@ import * as Layer from "../Layer.ts"
  *
  * ```ts
  * import { Console, Effect } from "effect"
- * import * as TestConsole from "effect/testing/TestConsole"
+ * import { TestConsole } from "effect/testing"
  *
  * const program = Effect.gen(function*() {
  *   yield* Console.log("Hello, World!")
@@ -62,7 +62,6 @@ export interface TestConsole extends Console.Console {
  * The `TestConsole` namespace provides types and utilities for working with
  * test console implementations.
  *
- * @category models
  * @since 4.0.0
  */
 export declare namespace TestConsole {
@@ -73,7 +72,7 @@ export declare namespace TestConsole {
    * **Example** (Typing captured console methods)
    *
    * ```ts
-   * import type * as TestConsole from "effect/testing/TestConsole"
+   * import type { TestConsole } from "effect/testing"
    *
    * const method: TestConsole.TestConsole.Method = "log"
    *
@@ -92,7 +91,7 @@ export declare namespace TestConsole {
    * **Example** (Typing captured console entries)
    *
    * ```ts
-   * import type * as TestConsole from "effect/testing/TestConsole"
+   * import type { TestConsole } from "effect/testing"
    *
    * const entry: TestConsole.TestConsole.Entry = {
    *   method: "error",
@@ -121,7 +120,7 @@ export declare namespace TestConsole {
  *
  * ```ts
  * import { Console, Effect } from "effect"
- * import * as TestConsole from "effect/testing/TestConsole"
+ * import { TestConsole } from "effect/testing"
  *
  * const program = Effect.gen(function*() {
  *   yield* Console.log("Debug message")
@@ -186,7 +185,7 @@ export const make = Effect.gen(function*() {
  *
  * ```ts
  * import { Effect } from "effect"
- * import * as TestConsole from "effect/testing/TestConsole"
+ * import { TestConsole } from "effect/testing"
  *
  * const program = TestConsole.testConsoleWith((testConsole) =>
  *   Effect.gen(function*() {
@@ -217,7 +216,7 @@ export const testConsoleWith = <A, E, R>(f: (console: TestConsole) => Effect.Eff
  *
  * ```ts
  * import { Console, Effect } from "effect"
- * import * as TestConsole from "effect/testing/TestConsole"
+ * import { TestConsole } from "effect/testing"
  *
  * const program = Effect.gen(function*() {
  *   yield* Console.log("This will be captured")
@@ -244,7 +243,7 @@ export const layer: Layer.Layer<TestConsole> = Layer.effect(Console.Console)(mak
  *
  * ```ts
  * import { Console, Effect } from "effect"
- * import * as TestConsole from "effect/testing/TestConsole"
+ * import { TestConsole } from "effect/testing"
  *
  * const program = Effect.gen(function*() {
  *   yield* Console.log("First message")
@@ -277,7 +276,7 @@ export const logLines: Effect.Effect<ReadonlyArray<unknown>, never, never> = tes
  *
  * ```ts
  * import { Console, Effect } from "effect"
- * import * as TestConsole from "effect/testing/TestConsole"
+ * import { TestConsole } from "effect/testing"
  *
  * const program = Effect.gen(function*() {
  *   yield* Console.error("Error message")

package/src/testing/TestSchema.ts

@@ -106,6 +106,7 @@ import * as FastCheck from "../testing/FastCheck.ts"
  * @see {@link Decoding}
  * @see {@link Encoding}
  *
+ * @category testing
  * @since 4.0.0
  */
 export class Asserts<S extends Schema.Top> {
@@ -345,6 +346,7 @@ export class Asserts<S extends Schema.Top> {
  * @see {@link Asserts}
  * @see {@link Encoding}
  *
+ * @category testing
  * @since 4.0.0
  */
 export class Decoding<S extends Schema.Top> {

package/src/testing/index.ts

@@ -18,11 +18,45 @@
 export * as FastCheck from "./FastCheck.ts"
 
 /**
+ * The `TestClock` module provides a controllable implementation of the Effect
+ * `Clock` service for tests. Instead of waiting for real time to pass, effects
+ * that use `Effect.sleep`, timeouts, schedules, retries, and other time-based
+ * operators can be driven deterministically by advancing the test clock.
+ *
+ * **Common use cases**
+ *
+ * - Testing sleeps, delays, timeouts, debouncing, retries, and schedules without
+ *   slowing the test suite down
+ * - Advancing time with {@link adjust} or jumping to an exact timestamp with
+ *   {@link setTime}
+ * - Running a specific effect against the live clock with {@link withLive}
+ *   while the rest of the test remains under test-clock control
+ *
+ * **Testing gotchas**
+ *
+ * - Effects that sleep semantically block until the clock is advanced far
+ *   enough, so tests usually fork the time-dependent effect before calling
+ *   {@link adjust} or {@link setTime}
+ * - Scheduled sleeps are resumed in clock-time order as the test clock moves
+ *   forward
+ * - If a test uses time but never advances the `TestClock`, the module starts a
+ *   delayed warning to help identify a hanging test
+ *
  * @since 2.0.0
  */
 export * as TestClock from "./TestClock.ts"
 
 /**
+ * The `TestConsole` module provides a test implementation of the `Console`
+ * service that records console calls instead of writing them to the host
+ * environment. It is useful when testing workflows that use `Console.log` or
+ * `Console.error` and need to assert on the produced output.
+ *
+ * Use {@link layer} to provide the test console to an effect, then inspect
+ * captured output with {@link logLines} and {@link errorLines}. Because console
+ * operations are service-based effects, programs under test must be run with
+ * this layer for their output to be captured.
+ *
  * @since 4.0.0
  */
 export * as TestConsole from "./TestConsole.ts"

package/src/unstable/ai/AiError.ts

@@ -182,7 +182,6 @@ export class NetworkError extends Schema.ErrorClass<NetworkError>(
    * const aiError = AiError.NetworkError.fromRequestError(platformError)
    * ```
    *
-   * @category constructors
    * @since 4.0.0
    */
   static fromRequestError(error: HttpClientError.RequestError): NetworkError {
@@ -276,7 +275,7 @@ export type ProviderMetadata = typeof ProviderMetadata.Type
 /**
  * Provider-specific metadata attached to `RateLimitError`.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface RateLimitErrorMetadata extends ProviderMetadata {}
@@ -284,7 +283,7 @@ export interface RateLimitErrorMetadata extends ProviderMetadata {}
 /**
  * Provider-specific metadata attached to `QuotaExhaustedError`.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface QuotaExhaustedErrorMetadata extends ProviderMetadata {}
@@ -292,7 +291,7 @@ export interface QuotaExhaustedErrorMetadata extends ProviderMetadata {}
 /**
  * Provider-specific metadata attached to `AuthenticationError`.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface AuthenticationErrorMetadata extends ProviderMetadata {}
@@ -300,7 +299,7 @@ export interface AuthenticationErrorMetadata extends ProviderMetadata {}
 /**
  * Provider-specific metadata attached to `ContentPolicyError`.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ContentPolicyErrorMetadata extends ProviderMetadata {}
@@ -308,7 +307,7 @@ export interface ContentPolicyErrorMetadata extends ProviderMetadata {}
 /**
  * Provider-specific metadata attached to `InvalidRequestError`.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface InvalidRequestErrorMetadata extends ProviderMetadata {}
@@ -316,7 +315,7 @@ export interface InvalidRequestErrorMetadata extends ProviderMetadata {}
 /**
  * Provider-specific metadata attached to `InternalProviderError`.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface InternalProviderErrorMetadata extends ProviderMetadata {}
@@ -324,7 +323,7 @@ export interface InternalProviderErrorMetadata extends ProviderMetadata {}
 /**
  * Provider-specific metadata attached to `InvalidOutputError`.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface InvalidOutputErrorMetadata extends ProviderMetadata {}
@@ -332,7 +331,7 @@ export interface InvalidOutputErrorMetadata extends ProviderMetadata {}
 /**
  * Provider-specific metadata attached to `StructuredOutputError`.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface StructuredOutputErrorMetadata extends ProviderMetadata {}
@@ -340,7 +339,7 @@ export interface StructuredOutputErrorMetadata extends ProviderMetadata {}
 /**
  * Provider-specific metadata attached to `UnsupportedSchemaError`.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface UnsupportedSchemaErrorMetadata extends ProviderMetadata {}
@@ -348,7 +347,7 @@ export interface UnsupportedSchemaErrorMetadata extends ProviderMetadata {}
 /**
  * Provider-specific metadata attached to `UnknownError`.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface UnknownErrorMetadata extends ProviderMetadata {}
@@ -765,7 +764,6 @@ export class InvalidOutputError extends Schema.ErrorClass<InvalidOutputError>(
    * const parseError = AiError.InvalidOutputError.fromSchemaError(schemaError)
    * ```
    *
-   * @category constructors
    * @since 4.0.0
    */
   static fromSchemaError(error: Schema.SchemaError): InvalidOutputError {
@@ -843,7 +841,6 @@ export class StructuredOutputError extends Schema.ErrorClass<StructuredOutputErr
    * const parseError = AiError.StructuredOutputError.fromSchemaError(schemaError, rawText)
    * ```
    *
-   * @category constructors
    * @since 4.0.0
    */
   static fromSchemaError(error: Schema.SchemaError, responseText: string): StructuredOutputError {
@@ -1497,9 +1494,6 @@ export type AiErrorEncoded = typeof AiError["Encoded"]
 /**
  * Type guard to check if a value is an `AiError`.
  *
- * @param u - The value to check
- * @returns `true` if the value is an `AiError`, `false` otherwise
- *
  * **Example** (Checking for an AI error)
  *
  * ```ts
@@ -1524,9 +1518,6 @@ export const isAiError = (u: unknown): u is AiError => Predicate.hasProperty(u,
 /**
  * Type guard to check if a value is an `AiErrorReason`.
  *
- * @param u - The value to check
- * @returns `true` if the value is an `AiErrorReason`, `false` otherwise
- *
  * **Example** (Checking for an AI error reason)
  *
  * ```ts

package/src/unstable/ai/Chat.ts

@@ -680,7 +680,6 @@ export class Persistence extends Context.Service<Persistence, Persistence.Servic
 /**
  * Namespace containing the service contract for chat persistence.
  *
- * @category models
  * @since 4.0.0
  */
 export declare namespace Persistence {

package/src/unstable/ai/McpSchema.ts

@@ -49,6 +49,7 @@ import * as RpcMiddleware from "../rpc/RpcMiddleware.ts"
  * It represents an optional struct field that supplies a default value when the
  * field is absent during decoding or construction.
  *
+ * @category models
  * @since 4.0.0
  */
 export interface optionalWithDefault<S extends Schema.Top & Schema.WithoutConstructorDefault>
@@ -62,6 +63,7 @@ export interface optionalWithDefault<S extends Schema.Top & Schema.WithoutConstr
  * The default is used during decoding and as the constructor default for the
  * schema field.
  *
+ * @category schemas
  * @since 4.0.0
  */
 export const optionalWithDefault = <S extends Schema.Top & Schema.WithoutConstructorDefault>(
@@ -86,6 +88,7 @@ export const optionalWithDefault = <S extends Schema.Top & Schema.WithoutConstru
  * The field may be absent, and explicit `undefined` values are omitted when
  * encoding.
  *
+ * @category schemas
  * @since 4.0.0
  */
 export const optional = <S extends Schema.Top>(schema: S): Schema.decodeTo<Schema.optional<S>, Schema.optionalKey<S>> =>

package/src/unstable/ai/McpServer.ts

@@ -561,8 +561,8 @@ export const layer = (options: {
  * **Example** (Running an MCP server over stdio)
  *
  * ```ts
- * import { NodeRuntime, NodeStdio } from "@effect/platform-node"
  * import { Effect, Layer, Logger, Schema } from "effect"
+ * import { NodeRuntime, NodeStdio } from "@effect/platform-node"
  * import { McpSchema, McpServer } from "effect/unstable/ai"
  *
  * const idParam = McpSchema.param("id", Schema.Number)
@@ -737,6 +737,7 @@ export const toolkit = <Tools extends Record<string, Tool.Any>>(
  * Utility type that validates a completion-handler record against the allowed
  * parameter keys.
  *
+ * @category utility types
  * @since 4.0.0
  */
 export type ValidateCompletions<Completions, Keys extends string> =
@@ -752,6 +753,7 @@ export type ValidateCompletions<Completions, Keys extends string> =
  * `Param` name when present or `paramN` otherwise, and each handler returns
  * candidate values for that parameter.
  *
+ * @category models
  * @since 4.0.0
  */
 export type ResourceCompletions<Schemas extends ReadonlyArray<Schema.Top>> = {

package/src/unstable/ai/Model.ts

@@ -9,8 +9,8 @@
  * **Example** (Creating a provider-specific model)
  *
  * ```ts
- * import type { Layer } from "effect"
  * import { Effect } from "effect"
+ * import type { Layer } from "effect"
  * import { LanguageModel, Model } from "effect/unstable/ai"
  *
  * declare const myAnthropicLayer: Layer.Layer<LanguageModel.LanguageModel>
@@ -47,10 +47,6 @@ const TypeId = "~effect/ai/Model" as const
  * constructor into the parent Effect. This is particularly useful when you
  * want to use a Model from within an Effect service.
  *
- * @template Provider - String literal type identifying the AI provider.
- * @template Provides - Services that this model provides.
- * @template Requires - Services that this model requires.
- *
  * @category models
  * @since 4.0.0
  */
@@ -130,8 +126,8 @@ const Proto = {
  * **Example** (Providing model metadata)
  *
  * ```ts
- * import type { Layer } from "effect"
  * import { Effect } from "effect"
+ * import type { Layer } from "effect"
  * import { LanguageModel, Model } from "effect/unstable/ai"
  *
  * declare const bedrockLayer: Layer.Layer<LanguageModel.LanguageModel>

package/src/unstable/ai/Prompt.ts

@@ -109,7 +109,7 @@ const PartTypeId = "~effect/ai/Prompt/Part" as const
 /**
  * Type guard to check if a value is a Part.
  *
- * @category Guards
+ * @category guards
  * @since 4.0.0
  */
 export const isPart = (u: unknown): u is Part => Predicate.hasProperty(u, PartTypeId)
@@ -982,7 +982,7 @@ const MessageTypeId = "~effect/ai/Prompt/Message" as const
 /**
  * Type guard to check if a value is a Message.
  *
- * @category Guards
+ * @category guards
  * @since 4.0.0
  */
 export const isMessage = (u: unknown): u is Message => Predicate.hasProperty(u, MessageTypeId)
@@ -1010,8 +1010,6 @@ export interface BaseMessage<Role extends string, Options extends ProviderOption
 /**
  * Base interface for encoded message types.
  *
- * @template Role - String literal type for the message role
- *
  * @category models
  * @since 4.0.0
  */
@@ -2288,7 +2286,7 @@ export const setSystem: {
  * // result content: "You are a helpful assistant. You are an expert in programming."
  * ```
  *
- * @category Combinators
+ * @category combinators
  * @since 4.0.0
  */
 export const prependSystem: {
@@ -2319,7 +2317,7 @@ export const prependSystem: {
    * // result content: "You are a helpful assistant. You are an expert in programming."
    * ```
    *
-   * @category Combinators
+   * @category combinators
    * @since 4.0.0
    */
   (content: string): (self: Prompt) => Prompt
@@ -2350,7 +2348,7 @@ export const prependSystem: {
    * // result content: "You are a helpful assistant. You are an expert in programming."
    * ```
    *
-   * @category Combinators
+   * @category combinators
    * @since 4.0.0
    */
   (self: Prompt, content: string): Prompt
@@ -2397,7 +2395,7 @@ export const prependSystem: {
  * // result content: "You are an expert in programming. You are a helpful assistant."
  * ```
  *
- * @category Combinators
+ * @category combinators
  * @since 4.0.0
  */
 export const appendSystem: {
@@ -2428,7 +2426,7 @@ export const appendSystem: {
    * // result content: "You are an expert in programming. You are a helpful assistant."
    * ```
    *
-   * @category Combinators
+   * @category combinators
    * @since 4.0.0
    */
   (content: string): (self: Prompt) => Prompt
@@ -2459,7 +2457,7 @@ export const appendSystem: {
    * // result content: "You are an expert in programming. You are a helpful assistant."
    * ```
    *
-   * @category Combinators
+   * @category combinators
    * @since 4.0.0
    */
   (self: Prompt, content: string): Prompt

package/src/unstable/ai/Response.ts

@@ -608,7 +608,7 @@ export interface TextPartEncoded extends BasePartEncoded<"text", TextPartMetadat
  * Represents provider-specific metadata that can be associated with a
  * `TextPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface TextPartMetadata extends ProviderMetadata {}
@@ -668,7 +668,7 @@ export interface TextStartPartEncoded extends BasePartEncoded<"text-start", Text
  * Represents provider-specific metadata that can be associated with a
  * `TextStartPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface TextStartPartMetadata extends ProviderMetadata {}
@@ -735,7 +735,7 @@ export interface TextDeltaPartEncoded extends BasePartEncoded<"text-delta", Text
  * Represents provider-specific metadata that can be associated with a
  * `TextDeltaPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface TextDeltaPartMetadata extends ProviderMetadata {}
@@ -797,7 +797,7 @@ export interface TextEndPartEncoded extends BasePartEncoded<"text-end", TextEndP
  * Represents provider-specific metadata that can be associated with a
  * `TextEndPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface TextEndPartMetadata extends ProviderMetadata {}
@@ -868,7 +868,7 @@ export interface ReasoningPartEncoded extends BasePartEncoded<"reasoning", Reaso
  * Represents provider-specific metadata that can be associated with a
  * `ReasoningPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ReasoningPartMetadata extends ProviderMetadata {}
@@ -928,7 +928,7 @@ export interface ReasoningStartPartEncoded extends BasePartEncoded<"reasoning-st
  * Represents provider-specific metadata that can be associated with a
  * `ReasoningStartPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ReasoningStartPartMetadata extends ProviderMetadata {}
@@ -995,7 +995,7 @@ export interface ReasoningDeltaPartEncoded extends BasePartEncoded<"reasoning-de
  * Represents provider-specific metadata that can be associated with a
  * `ReasoningDeltaPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ReasoningDeltaPartMetadata extends ProviderMetadata {}
@@ -1057,7 +1057,7 @@ export interface ReasoningEndPartEncoded extends BasePartEncoded<"reasoning-end"
  * Represents provider-specific metadata that can be associated with a
  * `ReasoningEndPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ReasoningEndPartMetadata extends ProviderMetadata {}
@@ -1136,7 +1136,7 @@ export interface ToolParamsStartPartEncoded extends BasePartEncoded<"tool-params
  * Represents provider-specific metadata that can be associated with a
  * `ToolParamsStartPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ToolParamsStartPartMetadata extends ProviderMetadata {}
@@ -1212,7 +1212,7 @@ export interface ToolParamsDeltaPartEncoded extends BasePartEncoded<"tool-params
  * Represents provider-specific metadata that can be associated with a
  * `ToolParamsDeltaPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ToolParamsDeltaPartMetadata extends ProviderMetadata {}
@@ -1278,7 +1278,7 @@ export interface ToolParamsEndPartEncoded extends BasePartEncoded<"tool-params-e
  * Represents provider-specific metadata that can be associated with a
  * `ToolParamsEndPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ToolParamsEndPartMetadata extends ProviderMetadata {}
@@ -1387,7 +1387,7 @@ export interface ToolCallPartEncoded extends BasePartEncoded<"tool-call", ToolCa
  * Represents provider-specific metadata that can be associated with a
  * `ToolCallPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ToolCallPartMetadata extends ProviderMetadata {}
@@ -1594,7 +1594,7 @@ export interface ToolResultPartEncoded extends BasePartEncoded<"tool-result", To
  * Represents provider-specific metadata that can be associated with a
  * `ToolResultPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ToolResultPartMetadata extends ProviderMetadata {}
@@ -1776,7 +1776,7 @@ export interface ToolApprovalRequestPartEncoded
  * Represents provider-specific metadata that can be associated with a
  * `ToolApprovalRequestPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ToolApprovalRequestPartMetadata extends ProviderMetadata {}
@@ -1870,7 +1870,7 @@ export interface FilePartEncoded extends BasePartEncoded<"file", FilePartMetadat
  * Represents provider-specific metadata that can be associated with a
  * `FilePart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface FilePartMetadata extends ProviderMetadata {}
@@ -1964,7 +1964,7 @@ export interface DocumentSourcePartEncoded extends BasePartEncoded<"source", Doc
  * Represents provider-specific metadata that can be associated with a
  * `DocumentSourcePart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface DocumentSourcePartMetadata extends ProviderMetadata {}
@@ -2056,7 +2056,7 @@ export interface UrlSourcePartEncoded extends BasePartEncoded<"source", UrlSourc
  * Represents provider-specific metadata that can be associated with a
  * `UrlSourcePart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface UrlSourcePartMetadata extends ProviderMetadata {}
@@ -2240,7 +2240,7 @@ export interface ResponseMetadataPartEncoded
  * Represents provider-specific metadata that can be associated with a
  * `ResponseMetadataPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ResponseMetadataPartMetadata extends ProviderMetadata {}
@@ -2446,7 +2446,7 @@ export interface FinishPartEncoded extends BasePartEncoded<"finish", FinishPartM
  * Represents provider-specific metadata that can be associated with a
  * `FinishPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface FinishPartMetadata extends ProviderMetadata {}
@@ -2521,7 +2521,7 @@ export interface ErrorPartEncoded extends BasePartEncoded<"error", ErrorPartMeta
  * Represents provider-specific metadata that can be associated with a
  * `ErrorPart` through module augmentation.
  *
- * @category provider options
+ * @category configuration
  * @since 4.0.0
  */
 export interface ErrorPartMetadata extends ProviderMetadata {}

package/src/unstable/ai/ResponseIdTracker.ts

@@ -58,7 +58,7 @@ export interface Service {
  * When provided, language model operations can use the tracker to send only new
  * prompt messages together with the provider's prior response ID.
  *
- * @category Services
+ * @category services
  * @since 4.0.0
  */
 export class ResponseIdTracker extends Context.Service<ResponseIdTracker, Service>()("effect/ai/ResponseIdTracker") {}