effect 4.0.0-beta.66 → 4.0.0-beta.67

package/dist/unstable/ai/ResponseIdTracker.js

@@ -1,4 +1,16 @@
 /**
+ * The `ResponseIdTracker` module provides a small service for reusing provider
+ * response IDs across incremental language model calls. It records which prompt
+ * message objects were sent for a provider response, then prepares a later
+ * prompt by returning the recognized `previousResponseId` together with only
+ * the new messages that should be sent.
+ *
+ * Use this when integrating providers that support continuing a conversation
+ * from a prior response ID instead of resending the entire prompt. The tracker
+ * is intentionally identity-based and mutable: it only recognizes the same
+ * message objects that were previously marked, and it clears its state when a
+ * prompt can no longer be matched safely.
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.js";
@@ -6,13 +18,26 @@ import * as Effect from "../../Effect.js";
 import * as Option from "../../Option.js";
 import * as Prompt from "./Prompt.js";
 /**
- * @since 4.0.0
+ * Service tag for enabling provider previous-response ID reuse across language
+ * model calls.
+ *
+ * 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
+ * @since 4.0.0
  */
 export class ResponseIdTracker extends /*#__PURE__*/Context.Service()("effect/ai/ResponseIdTracker") {}
 /**
- * @since 4.0.0
+ * Creates an in-memory `ResponseIdTracker` service.
+ *
+ * The tracker maps prompt message object identities to provider response IDs.
+ * `prepareUnsafe` returns a previous response ID and the messages after the
+ * latest assistant turn only when the existing prompt prefix is fully tracked;
+ * otherwise it clears the tracked state and returns `Option.none()`.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export const make = /*#__PURE__*/Effect.sync(() => {
   const sentParts = new Map();

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

@@ -1 +1 @@
-{"version":3,"file":"ResponseIdTracker.js","names":["Context","Effect","Option","Prompt","ResponseIdTracker","Service","make","sync","sentParts","Map","none","clear","clearUnsafe","markParts","parts","responseId","i","length","set","prepareUnsafe","prompt","messages","content","anyTracked","has","lastAssistantIndex","role","id","get","undefined","partsAfterLastAssistant","slice","some","previousResponseId","fromMessages"],"sources":["../../../src/unstable/ai/ResponseIdTracker.ts"],"sourcesContent":[null],"mappings":"AAAA;;;AAGA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,aAAa;AAqBrC;;;;AAIA,OAAM,MAAOC,iBAAkB,sBAAQJ,OAAO,CAACK,OAAO,EAA8B,CAAC,6BAA6B,CAAC;AAEnH;;;;AAIA,OAAO,MAAMC,IAAI,gBAA2BL,MAAM,CAACM,IAAI,CAAC,MAAK;EAC3D,MAAMC,SAAS,GAAG,IAAIC,GAAG,EAAkB;EAE3C,MAAMC,IAAI,GAAGA,CAAA,KAAK;IAChBF,SAAS,CAACG,KAAK,EAAE;IACjB,OAAOT,MAAM,CAACQ,IAAI,EAAiB;EACrC,CAAC;EAED,OAAO;IACLE,WAAWA,CAAA;MACTJ,SAAS,CAACG,KAAK,EAAE;IACnB,CAAC;IACDE,SAASA,CAACC,KAAK,EAAEC,UAAU;MACzB,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGF,KAAK,CAACG,MAAM,EAAED,CAAC,EAAE,EAAE;QACrCR,SAAS,CAACU,GAAG,CAACJ,KAAK,CAACE,CAAC,CAAC,EAAED,UAAU,CAAC;MACrC;IACF,CAAC;IACDI,aAAaA,CAACC,MAAM;MAClB,MAAMC,QAAQ,GAAGD,MAAM,CAACE,OAAO;MAE/B,IAAIC,UAAU,GAAG,KAAK;MACtB,KAAK,IAAIP,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGK,QAAQ,CAACJ,MAAM,EAAED,CAAC,EAAE,EAAE;QACxC,IAAIR,SAAS,CAACgB,GAAG,CAACH,QAAQ,CAACL,CAAC,CAAC,CAAC,EAAE;UAC9BO,UAAU,GAAG,IAAI;UACjB;QACF;MACF;MACA,IAAI,CAACA,UAAU,EAAE,OAAOb,IAAI,EAAE;MAE9B,IAAIe,kBAAkB,GAAG,CAAC,CAAC;MAC3B,KAAK,IAAIT,CAAC,GAAGK,QAAQ,CAACJ,MAAM,GAAG,CAAC,EAAED,CAAC,IAAI,CAAC,EAAEA,CAAC,EAAE,EAAE;QAC7C,IAAIK,QAAQ,CAACL,CAAC,CAAC,CAACU,IAAI,KAAK,WAAW,EAAE;UACpCD,kBAAkB,GAAGT,CAAC;UACtB;QACF;MACF;MACA,IAAIS,kBAAkB,KAAK,CAAC,CAAC,EAAE,OAAOf,IAAI,EAAE;MAE5C,IAAIK,UAA8B;MAClC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGS,kBAAkB,EAAET,CAAC,EAAE,EAAE;QAC3C,MAAMW,EAAE,GAAGnB,SAAS,CAACoB,GAAG,CAACP,QAAQ,CAACL,CAAC,CAAC,CAAC;QACrC,IAAIW,EAAE,KAAKE,SAAS,EAAE,OAAOnB,IAAI,EAAE;QACnCK,UAAU,GAAGY,EAAE;MACjB;MACA,IAAIZ,UAAU,KAAKc,SAAS,EAAE,OAAOnB,IAAI,EAAE;MAE3C,MAAMoB,uBAAuB,GAAGT,QAAQ,CAACU,KAAK,CAACN,kBAAkB,GAAG,CAAC,CAAC;MACtE,IAAIK,uBAAuB,CAACb,MAAM,KAAK,CAAC,EAAE;QACxC,OAAOP,IAAI,EAAE;MACf;MAEA,OAAOR,MAAM,CAAC8B,IAAI,CAAC;QACjBC,kBAAkB,EAAElB,UAAU;QAC9BK,MAAM,EAAEjB,MAAM,CAAC+B,YAAY,CAACJ,uBAAuB;OACpD,CAAC;IACJ;GACD;AACH,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"ResponseIdTracker.js","names":["Context","Effect","Option","Prompt","ResponseIdTracker","Service","make","sync","sentParts","Map","none","clear","clearUnsafe","markParts","parts","responseId","i","length","set","prepareUnsafe","prompt","messages","content","anyTracked","has","lastAssistantIndex","role","id","get","undefined","partsAfterLastAssistant","slice","some","previousResponseId","fromMessages"],"sources":["../../../src/unstable/ai/ResponseIdTracker.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;AAeA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,aAAa;AAmCrC;;;;;;;;;;AAUA,OAAM,MAAOC,iBAAkB,sBAAQJ,OAAO,CAACK,OAAO,EAA8B,CAAC,6BAA6B,CAAC;AAEnH;;;;;;;;;;;AAWA,OAAO,MAAMC,IAAI,gBAA2BL,MAAM,CAACM,IAAI,CAAC,MAAK;EAC3D,MAAMC,SAAS,GAAG,IAAIC,GAAG,EAAkB;EAE3C,MAAMC,IAAI,GAAGA,CAAA,KAAK;IAChBF,SAAS,CAACG,KAAK,EAAE;IACjB,OAAOT,MAAM,CAACQ,IAAI,EAAiB;EACrC,CAAC;EAED,OAAO;IACLE,WAAWA,CAAA;MACTJ,SAAS,CAACG,KAAK,EAAE;IACnB,CAAC;IACDE,SAASA,CAACC,KAAK,EAAEC,UAAU;MACzB,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGF,KAAK,CAACG,MAAM,EAAED,CAAC,EAAE,EAAE;QACrCR,SAAS,CAACU,GAAG,CAACJ,KAAK,CAACE,CAAC,CAAC,EAAED,UAAU,CAAC;MACrC;IACF,CAAC;IACDI,aAAaA,CAACC,MAAM;MAClB,MAAMC,QAAQ,GAAGD,MAAM,CAACE,OAAO;MAE/B,IAAIC,UAAU,GAAG,KAAK;MACtB,KAAK,IAAIP,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGK,QAAQ,CAACJ,MAAM,EAAED,CAAC,EAAE,EAAE;QACxC,IAAIR,SAAS,CAACgB,GAAG,CAACH,QAAQ,CAACL,CAAC,CAAC,CAAC,EAAE;UAC9BO,UAAU,GAAG,IAAI;UACjB;QACF;MACF;MACA,IAAI,CAACA,UAAU,EAAE,OAAOb,IAAI,EAAE;MAE9B,IAAIe,kBAAkB,GAAG,CAAC,CAAC;MAC3B,KAAK,IAAIT,CAAC,GAAGK,QAAQ,CAACJ,MAAM,GAAG,CAAC,EAAED,CAAC,IAAI,CAAC,EAAEA,CAAC,EAAE,EAAE;QAC7C,IAAIK,QAAQ,CAACL,CAAC,CAAC,CAACU,IAAI,KAAK,WAAW,EAAE;UACpCD,kBAAkB,GAAGT,CAAC;UACtB;QACF;MACF;MACA,IAAIS,kBAAkB,KAAK,CAAC,CAAC,EAAE,OAAOf,IAAI,EAAE;MAE5C,IAAIK,UAA8B;MAClC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGS,kBAAkB,EAAET,CAAC,EAAE,EAAE;QAC3C,MAAMW,EAAE,GAAGnB,SAAS,CAACoB,GAAG,CAACP,QAAQ,CAACL,CAAC,CAAC,CAAC;QACrC,IAAIW,EAAE,KAAKE,SAAS,EAAE,OAAOnB,IAAI,EAAE;QACnCK,UAAU,GAAGY,EAAE;MACjB;MACA,IAAIZ,UAAU,KAAKc,SAAS,EAAE,OAAOnB,IAAI,EAAE;MAE3C,MAAMoB,uBAAuB,GAAGT,QAAQ,CAACU,KAAK,CAACN,kBAAkB,GAAG,CAAC,CAAC;MACtE,IAAIK,uBAAuB,CAACb,MAAM,KAAK,CAAC,EAAE;QACxC,OAAOP,IAAI,EAAE;MACf;MAEA,OAAOR,MAAM,CAAC8B,IAAI,CAAC;QACjBC,kBAAkB,EAAElB,UAAU;QAC9BK,MAAM,EAAEjB,MAAM,CAAC+B,YAAY,CAACJ,uBAAuB;OACpD,CAAC;IACJ;GACD;AACH,CAAC,CAAC","ignoreList":[]}

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

@@ -4,7 +4,8 @@
  * attributes and utilities that follow the OpenTelemetry GenAI semantic
  * conventions.
  *
- * @example
+ * **Example** (Annotating AI spans)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Telemetry } from "effect/unstable/ai"
@@ -42,23 +43,23 @@ import type * as Response from "./Response.ts";
  *
  * {@see https://opentelemetry.io/docs/specs/semconv/attributes-registry/gen-ai/}
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export type GenAITelemetryAttributes = Struct.Simplify<AttributesWithPrefix<BaseAttributes, "gen_ai"> & AttributesWithPrefix<OperationAttributes, "gen_ai.operation"> & AttributesWithPrefix<TokenAttributes, "gen_ai.token"> & AttributesWithPrefix<UsageAttributes, "gen_ai.usage"> & AttributesWithPrefix<RequestAttributes, "gen_ai.request"> & AttributesWithPrefix<ResponseAttributes, "gen_ai.response">>;
 /**
  * All telemetry attributes which are part of the GenAI specification.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export type AllAttributes = BaseAttributes & OperationAttributes & TokenAttributes & UsageAttributes & RequestAttributes & ResponseAttributes;
 /**
  * Telemetry attributes which are part of the GenAI specification and are
  * namespaced by `gen_ai`.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface BaseAttributes {
     /**
@@ -71,8 +72,8 @@ export interface BaseAttributes {
  * Telemetry attributes which are part of the GenAI specification and are
  * namespaced by `gen_ai.operation`.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface OperationAttributes {
     readonly name?: (string & {}) | WellKnownOperationName | null | undefined;
@@ -81,8 +82,8 @@ export interface OperationAttributes {
  * Telemetry attributes which are part of the GenAI specification and are
  * namespaced by `gen_ai.token`.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface TokenAttributes {
     readonly type?: string | null | undefined;
@@ -91,8 +92,8 @@ export interface TokenAttributes {
  * Telemetry attributes which are part of the GenAI specification and are
  * namespaced by `gen_ai.usage`.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface UsageAttributes {
     readonly inputTokens?: number | null | undefined;
@@ -102,8 +103,8 @@ export interface UsageAttributes {
  * Telemetry attributes which are part of the GenAI specification and are
  * namespaced by `gen_ai.request`.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface RequestAttributes {
     /**
@@ -153,8 +154,8 @@ export interface RequestAttributes {
  * Telemetry attributes which are part of the GenAI specification and are
  * namespaced by `gen_ai.response`.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface ResponseAttributes {
     /**
@@ -178,8 +179,8 @@ export interface ResponseAttributes {
  * If one of them applies, then the respective value **MUST** be used;
  * otherwise, a custom value **MAY** be used.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export type WellKnownOperationName = "chat" | "embeddings" | "text_completion";
 /**
@@ -188,8 +189,8 @@ export type WellKnownOperationName = "chat" | "embeddings" | "text_completion";
  * If one of them applies, then the respective value **MUST** be used;
  * otherwise, a custom value **MAY** be used.
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export type WellKnownSystem = "anthropic" | "aws.bedrock" | "az.ai.inference" | "az.ai.openai" | "cohere" | "deepseek" | "gemini" | "groq" | "ibm.watsonx.ai" | "mistral_ai" | "openai" | "perplexity" | "vertex_ai" | "xai";
 /**
@@ -198,7 +199,8 @@ export type WellKnownSystem = "anthropic" | "aws.bedrock" | "az.ai.inference" |
  * Transforms attribute keys by adding a prefix and formatting them according to
  * OpenTelemetry conventions (camelCase to snake_case).
  *
- * @example
+ * **Example** (Prefixing telemetry attributes)
+ *
  * ```ts
  * import type { Telemetry } from "effect/unstable/ai"
  *
@@ -217,8 +219,8 @@ export type WellKnownSystem = "anthropic" | "aws.bedrock" | "az.ai.inference" |
  * // }
  * ```
  *
- * @since 4.0.0
  * @category utility types
+ * @since 4.0.0
  */
 export type AttributesWithPrefix<Attributes extends Record<string, any>, Prefix extends string> = {
     [Name in keyof Attributes as `${Prefix}.${FormatAttributeName<Name>}`]: Attributes[Name];
@@ -229,7 +231,8 @@ export type AttributesWithPrefix<Attributes extends Record<string, any>, Prefix
  * This type recursively transforms string literal types from camelCase to
  * snake_case, which is the standard format for OpenTelemetry attributes.
  *
- * @example
+ * **Example** (Formatting attribute names)
+ *
  * ```ts
  * import type { Telemetry } from "effect/unstable/ai"
  *
@@ -238,17 +241,19 @@ export type AttributesWithPrefix<Attributes extends Record<string, any>, Prefix
  * type Formatted3 = Telemetry.FormatAttributeName<"temperature"> // "temperature"
  * ```
  *
- * @since 4.0.0
  * @category utility types
+ * @since 4.0.0
  */
 export type FormatAttributeName<T extends string | number | symbol> = T extends string ? T extends `${infer First}${infer Rest}` ? `${First extends Uppercase<First> ? "_" : ""}${Lowercase<First>}${FormatAttributeName<Rest>}` : T : never;
 /**
- * Creates a function to add attributes to a span with a given prefix and key transformation.
+ * Creates a reusable span-attribute writer for a key prefix and key
+ * transformer.
  *
- * This utility function is used internally to create specialized functions for adding
- * different types of telemetry attributes to OpenTelemetry spans.
+ * The returned function mutates the supplied span by adding each non-nullish
+ * attribute as `${prefix}.${transformedKey}`.
+ *
+ * **Example** (Adding prefixed span attributes)
  *
- * @example
  * ```ts
  * import type { Tracer } from "effect"
  * import { String } from "effect"
@@ -268,8 +273,8 @@ export type FormatAttributeName<T extends string | number | symbol> = T extends
  * // Results in attributes: "custom.ai.model_name" and "custom.ai.max_tokens"
  * ```
  *
- * @since 4.0.0
  * @category utilities
+ * @since 4.0.0
  */
 export declare const addSpanAttributes: (
 /**
@@ -294,7 +299,8 @@ attributes: Attributes) => void;
  * Combines base attributes with optional grouped attributes for comprehensive
  * telemetry coverage of AI operations.
  *
- * @example
+ * **Example** (Configuring GenAI telemetry attributes)
+ *
  * ```ts
  * import type { Telemetry } from "effect/unstable/ai"
  *
@@ -320,8 +326,8 @@ attributes: Attributes) => void;
  * }
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export type GenAITelemetryAttributeOptions = BaseAttributes & {
     /**
@@ -353,7 +359,8 @@ export type GenAITelemetryAttributeOptions = BaseAttributes & {
  *
  * **Note**: This function mutates the provided span in-place.
  *
- * @example
+ * **Example** (Adding GenAI telemetry annotations)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Telemetry } from "effect/unstable/ai"
@@ -369,8 +376,8 @@ export type GenAITelemetryAttributeOptions = BaseAttributes & {
  * })
  * ```
  *
- * @since 4.0.0
  * @category utilities
+ * @since 4.0.0
  */
 export declare const addGenAIAnnotations: {
     /**
@@ -381,7 +388,8 @@ export declare const addGenAIAnnotations: {
      *
      * **Note**: This function mutates the provided span in-place.
      *
-     * @example
+     * **Example** (Adding GenAI telemetry annotations)
+     *
      * ```ts
      * import { Effect } from "effect"
      * import { Telemetry } from "effect/unstable/ai"
@@ -397,8 +405,8 @@ export declare const addGenAIAnnotations: {
      * })
      * ```
      *
-     * @since 4.0.0
      * @category utilities
+     * @since 4.0.0
      */
     (options: GenAITelemetryAttributeOptions): (span: Span) => void;
     /**
@@ -409,7 +417,8 @@ export declare const addGenAIAnnotations: {
      *
      * **Note**: This function mutates the provided span in-place.
      *
-     * @example
+     * **Example** (Adding GenAI telemetry annotations)
+     *
      * ```ts
      * import { Effect } from "effect"
      * import { Telemetry } from "effect/unstable/ai"
@@ -425,8 +434,8 @@ export declare const addGenAIAnnotations: {
      * })
      * ```
      *
-     * @since 4.0.0
      * @category utilities
+     * @since 4.0.0
      */
     (span: Span, options: GenAITelemetryAttributeOptions): void;
 };
@@ -436,7 +445,8 @@ export declare const addGenAIAnnotations: {
  * Span transformers receive the complete request/response context from AI operations
  * and can add custom telemetry attributes, metrics, or other observability data.
  *
- * @example
+ * **Example** (Transforming AI spans)
+ *
  * ```ts
  * import type { Telemetry } from "effect/unstable/ai"
  *
@@ -451,8 +461,8 @@ export declare const addGenAIAnnotations: {
  * }
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface SpanTransformer {
     (options: ProviderOptions & {
@@ -464,11 +474,11 @@ export interface SpanTransformer {
 }
 declare const CurrentSpanTransformer_base: Context.ServiceClass<CurrentSpanTransformer, "effect/ai/Telemetry/CurrentSpanTransformer", SpanTransformer>;
 /**
- * Service key for providing a span transformer to large langauge model
+ * Service tag for providing a `SpanTransformer` to large language model
  * operations.
  *
- * @since 4.0.0
  * @category services
+ * @since 4.0.0
  */
 export declare class CurrentSpanTransformer extends CurrentSpanTransformer_base {
 }

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

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

package/dist/unstable/ai/Telemetry.js

@@ -4,7 +4,8 @@
  * attributes and utilities that follow the OpenTelemetry GenAI semantic
  * conventions.
  *
- * @example
+ * **Example** (Annotating AI spans)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Telemetry } from "effect/unstable/ai"
@@ -36,12 +37,14 @@ import { dual } from "../../Function.js";
 import * as Predicate from "../../Predicate.js";
 import * as String from "../../String.js";
 /**
- * Creates a function to add attributes to a span with a given prefix and key transformation.
+ * Creates a reusable span-attribute writer for a key prefix and key
+ * transformer.
+ *
+ * The returned function mutates the supplied span by adding each non-nullish
+ * attribute as `${prefix}.${transformedKey}`.
  *
- * This utility function is used internally to create specialized functions for adding
- * different types of telemetry attributes to OpenTelemetry spans.
+ * **Example** (Adding prefixed span attributes)
  *
- * @example
  * ```ts
  * import type { Tracer } from "effect"
  * import { String } from "effect"
@@ -61,8 +64,8 @@ import * as String from "../../String.js";
  * // Results in attributes: "custom.ai.model_name" and "custom.ai.max_tokens"
  * ```
  *
- * @since 4.0.0
  * @category utilities
+ * @since 4.0.0
  */
 export const addSpanAttributes = (
 /**
@@ -101,7 +104,8 @@ const addSpanUsageAttributes = /*#__PURE__*/addSpanAttributes("gen_ai.usage", St
  *
  * **Note**: This function mutates the provided span in-place.
  *
- * @example
+ * **Example** (Adding GenAI telemetry annotations)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Telemetry } from "effect/unstable/ai"
@@ -117,8 +121,8 @@ const addSpanUsageAttributes = /*#__PURE__*/addSpanAttributes("gen_ai.usage", St
  * })
  * ```
  *
- * @since 4.0.0
  * @category utilities
+ * @since 4.0.0
  */
 export const addGenAIAnnotations = /*#__PURE__*/dual(2, (span, options) => {
   addSpanBaseAttributes(span, {
@@ -131,11 +135,11 @@ export const addGenAIAnnotations = /*#__PURE__*/dual(2, (span, options) => {
   if (Predicate.isNotNullish(options.usage)) addSpanUsageAttributes(span, options.usage);
 });
 /**
- * Service key for providing a span transformer to large langauge model
+ * Service tag for providing a `SpanTransformer` to large language model
  * operations.
  *
- * @since 4.0.0
  * @category services
+ * @since 4.0.0
  */
 export class CurrentSpanTransformer extends /*#__PURE__*/Context.Service()("effect/ai/Telemetry/CurrentSpanTransformer") {}
 //# sourceMappingURL=Telemetry.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Telemetry.js","names":["Context","dual","Predicate","String","addSpanAttributes","keyPrefix","transformKey","span","attributes","key","value","Object","entries","isNotNullish","attribute","addSpanBaseAttributes","camelToSnake","addSpanOperationAttributes","addSpanRequestAttributes","addSpanResponseAttributes","addSpanTokenAttributes","addSpanUsageAttributes","addGenAIAnnotations","options","system","operation","request","response","token","usage","CurrentSpanTransformer","Service"],"sources":["../../../src/unstable/ai/Telemetry.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,SAASC,IAAI,QAAQ,mBAAmB;AACxC,OAAO,KAAKC,SAAS,MAAM,oBAAoB;AAC/C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AA+PzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,OAAO,MAAMC,iBAAiB,GAAGA;AAC/B;;;AAGAC,SAAiB;AACjB;;;AAGAC,YAAqC,KAEvC;AACE;;;AAGAC,IAAU;AACV;;;AAGAC,UAAsB,KACd;EACR,KAAK,MAAM,CAACC,GAAG,EAAEC,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACJ,UAAU,CAAC,EAAE;IACrD,IAAIN,SAAS,CAACW,YAAY,CAACH,KAAK,CAAC,EAAE;MACjCH,IAAI,CAACO,SAAS,CAAC,GAAGT,SAAS,IAAIC,YAAY,CAACG,GAAG,CAAC,EAAE,EAAEC,KAAK,CAAC;IAC5D;EACF;AACF,CAAC;AAED,MAAMK,qBAAqB,gBAAGX,iBAAiB,CAAC,QAAQ,EAAED,MAAM,CAACa,YAAY,CAAiB;AAC9F,MAAMC,0BAA0B,gBAAGb,iBAAiB,CAAC,kBAAkB,EAAED,MAAM,CAACa,YAAY,CAAsB;AAClH,MAAME,wBAAwB,gBAAGd,iBAAiB,CAAC,gBAAgB,EAAED,MAAM,CAACa,YAAY,CAAoB;AAC5G,MAAMG,yBAAyB,gBAAGf,iBAAiB,CAAC,iBAAiB,EAAED,MAAM,CAACa,YAAY,CAAqB;AAC/G,MAAMI,sBAAsB,gBAAGhB,iBAAiB,CAAC,cAAc,EAAED,MAAM,CAACa,YAAY,CAAkB;AACtG,MAAMK,sBAAsB,gBAAGjB,iBAAiB,CAAC,cAAc,EAAED,MAAM,CAACa,YAAY,CAAkB;AA4DtG;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,OAAO,MAAMM,mBAAmB,gBAyD5BrB,IAAI,CAAC,CAAC,EAAE,CAACM,IAAU,EAAEgB,OAAuC,KAAI;EAClER,qBAAqB,CAACR,IAAI,EAAE;IAAEiB,MAAM,EAAED,OAAO,CAACC;EAAM,CAAE,CAAC;EACvD,IAAItB,SAAS,CAACW,YAAY,CAACU,OAAO,CAACE,SAAS,CAAC,EAAER,0BAA0B,CAACV,IAAI,EAAEgB,OAAO,CAACE,SAAS,CAAC;EAClG,IAAIvB,SAAS,CAACW,YAAY,CAACU,OAAO,CAACG,OAAO,CAAC,EAAER,wBAAwB,CAACX,IAAI,EAAEgB,OAAO,CAACG,OAAO,CAAC;EAC5F,IAAIxB,SAAS,CAACW,YAAY,CAACU,OAAO,CAACI,QAAQ,CAAC,EAAER,yBAAyB,CAACZ,IAAI,EAAEgB,OAAO,CAACI,QAAQ,CAAC;EAC/F,IAAIzB,SAAS,CAACW,YAAY,CAACU,OAAO,CAACK,KAAK,CAAC,EAAER,sBAAsB,CAACb,IAAI,EAAEgB,OAAO,CAACK,KAAK,CAAC;EACtF,IAAI1B,SAAS,CAACW,YAAY,CAACU,OAAO,CAACM,KAAK,CAAC,EAAER,sBAAsB,CAACd,IAAI,EAAEgB,OAAO,CAACM,KAAK,CAAC;AACxF,CAAC,CAAC;AAqCF;;;;;;;AAOA,OAAM,MAAOC,sBAAuB,sBAAQ9B,OAAO,CAAC+B,OAAO,EAA2C,CACpG,4CAA4C,CAC7C","ignoreList":[]}
+{"version":3,"file":"Telemetry.js","names":["Context","dual","Predicate","String","addSpanAttributes","keyPrefix","transformKey","span","attributes","key","value","Object","entries","isNotNullish","attribute","addSpanBaseAttributes","camelToSnake","addSpanOperationAttributes","addSpanRequestAttributes","addSpanResponseAttributes","addSpanTokenAttributes","addSpanUsageAttributes","addGenAIAnnotations","options","system","operation","request","response","token","usage","CurrentSpanTransformer","Service"],"sources":["../../../src/unstable/ai/Telemetry.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,SAASC,IAAI,QAAQ,mBAAmB;AACxC,OAAO,KAAKC,SAAS,MAAM,oBAAoB;AAC/C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAiQzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,OAAO,MAAMC,iBAAiB,GAAGA;AAC/B;;;AAGAC,SAAiB;AACjB;;;AAGAC,YAAqC,KAEvC;AACE;;;AAGAC,IAAU;AACV;;;AAGAC,UAAsB,KACd;EACR,KAAK,MAAM,CAACC,GAAG,EAAEC,KAAK,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACJ,UAAU,CAAC,EAAE;IACrD,IAAIN,SAAS,CAACW,YAAY,CAACH,KAAK,CAAC,EAAE;MACjCH,IAAI,CAACO,SAAS,CAAC,GAAGT,SAAS,IAAIC,YAAY,CAACG,GAAG,CAAC,EAAE,EAAEC,KAAK,CAAC;IAC5D;EACF;AACF,CAAC;AAED,MAAMK,qBAAqB,gBAAGX,iBAAiB,CAAC,QAAQ,EAAED,MAAM,CAACa,YAAY,CAAiB;AAC9F,MAAMC,0BAA0B,gBAAGb,iBAAiB,CAAC,kBAAkB,EAAED,MAAM,CAACa,YAAY,CAAsB;AAClH,MAAME,wBAAwB,gBAAGd,iBAAiB,CAAC,gBAAgB,EAAED,MAAM,CAACa,YAAY,CAAoB;AAC5G,MAAMG,yBAAyB,gBAAGf,iBAAiB,CAAC,iBAAiB,EAAED,MAAM,CAACa,YAAY,CAAqB;AAC/G,MAAMI,sBAAsB,gBAAGhB,iBAAiB,CAAC,cAAc,EAAED,MAAM,CAACa,YAAY,CAAkB;AACtG,MAAMK,sBAAsB,gBAAGjB,iBAAiB,CAAC,cAAc,EAAED,MAAM,CAACa,YAAY,CAAkB;AA6DtG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,OAAO,MAAMM,mBAAmB,gBA2D5BrB,IAAI,CAAC,CAAC,EAAE,CAACM,IAAU,EAAEgB,OAAuC,KAAI;EAClER,qBAAqB,CAACR,IAAI,EAAE;IAAEiB,MAAM,EAAED,OAAO,CAACC;EAAM,CAAE,CAAC;EACvD,IAAItB,SAAS,CAACW,YAAY,CAACU,OAAO,CAACE,SAAS,CAAC,EAAER,0BAA0B,CAACV,IAAI,EAAEgB,OAAO,CAACE,SAAS,CAAC;EAClG,IAAIvB,SAAS,CAACW,YAAY,CAACU,OAAO,CAACG,OAAO,CAAC,EAAER,wBAAwB,CAACX,IAAI,EAAEgB,OAAO,CAACG,OAAO,CAAC;EAC5F,IAAIxB,SAAS,CAACW,YAAY,CAACU,OAAO,CAACI,QAAQ,CAAC,EAAER,yBAAyB,CAACZ,IAAI,EAAEgB,OAAO,CAACI,QAAQ,CAAC;EAC/F,IAAIzB,SAAS,CAACW,YAAY,CAACU,OAAO,CAACK,KAAK,CAAC,EAAER,sBAAsB,CAACb,IAAI,EAAEgB,OAAO,CAACK,KAAK,CAAC;EACtF,IAAI1B,SAAS,CAACW,YAAY,CAACU,OAAO,CAACM,KAAK,CAAC,EAAER,sBAAsB,CAACd,IAAI,EAAEgB,OAAO,CAACM,KAAK,CAAC;AACxF,CAAC,CAAC;AAsCF;;;;;;;AAOA,OAAM,MAAOC,sBAAuB,sBAAQ9B,OAAO,CAAC+B,OAAO,EAA2C,CACpG,4CAA4C,CAC7C","ignoreList":[]}

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

@@ -6,7 +6,8 @@
  * prompts based on token limits, essential for managing context length
  * constraints in large language models.
  *
- * @example
+ * **Example** (Tokenizing text)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Tokenizer } from "effect/unstable/ai"
@@ -19,7 +20,8 @@
  * })
  * ```
  *
- * @example
+ * **Example** (Truncating a prompt)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Tokenizer } from "effect/unstable/ai"
@@ -46,7 +48,8 @@ declare const Tokenizer_base: Context.ServiceClass<Tokenizer, "effect/ai/Tokeniz
  * This tag provides access to tokenization functionality throughout your
  * application, enabling token counting and prompt truncation capabilities.
  *
- * @example
+ * **Example** (Accessing the Tokenizer service)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Tokenizer } from "effect/unstable/ai"
@@ -58,8 +61,8 @@ declare const Tokenizer_base: Context.ServiceClass<Tokenizer, "effect/ai/Tokeniz
  * })
  * ```
  *
- * @since 4.0.0
  * @category services
+ * @since 4.0.0
  */
 export declare class Tokenizer extends Tokenizer_base {
 }
@@ -70,7 +73,8 @@ export declare class Tokenizer extends Tokenizer_base {
  * This interface defines the core operations for converting text to tokens and
  * managing content length within token limits for AI model compatibility.
  *
- * @example
+ * **Example** (Implementing a custom tokenizer)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import type { Tokenizer } from "effect/unstable/ai"
@@ -84,8 +88,8 @@ export declare class Tokenizer extends Tokenizer_base {
  * }
  * ```
  *
- * @since 4.0.0
  * @category models
+ * @since 4.0.0
  */
 export interface Service {
     /**
@@ -116,7 +120,8 @@ export interface Service {
  * tokenization function. The service handles both tokenization and
  * truncation operations using the provided tokenizer.
  *
- * @example
+ * **Example** (Creating a word tokenizer)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Tokenizer } from "effect/unstable/ai"
@@ -138,8 +143,8 @@ export interface Service {
  * })
  * ```
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export declare const make: (options: {
     readonly tokenize: (content: Prompt.Prompt) => Effect.Effect<Array<number>, AiError.AiError>;

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

@@ -1 +1 @@
-{"version":3,"file":"Tokenizer.d.ts","sourceRoot":"","sources":["../../../src/unstable/ai/Tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;;AAErC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE;IACjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,QAAQ,KACnB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAClD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE;IACjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,QAAQ;IACtB;;OAEG;IACH,MAAM,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,IAAI,GAAI,SAAS;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7F,KAAG,OAQA,CAAA"}
+{"version":3,"file":"Tokenizer.d.ts","sourceRoot":"","sources":["../../../src/unstable/ai/Tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AAEzC,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE;IACjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,QAAQ,KACnB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAClD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE;IACjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,QAAQ;IACtB;;OAEG;IACH,MAAM,EAAE,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,IAAI,GAAI,SAAS;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7F,KAAG,OAQA,CAAA"}

package/dist/unstable/ai/Tokenizer.js

@@ -6,7 +6,8 @@
  * prompts based on token limits, essential for managing context length
  * constraints in large language models.
  *
- * @example
+ * **Example** (Tokenizing text)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Tokenizer } from "effect/unstable/ai"
@@ -19,7 +20,8 @@
  * })
  * ```
  *
- * @example
+ * **Example** (Truncating a prompt)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Tokenizer } from "effect/unstable/ai"
@@ -45,7 +47,8 @@ import * as Prompt from "./Prompt.js";
  * This tag provides access to tokenization functionality throughout your
  * application, enabling token counting and prompt truncation capabilities.
  *
- * @example
+ * **Example** (Accessing the Tokenizer service)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Tokenizer } from "effect/unstable/ai"
@@ -57,8 +60,8 @@ import * as Prompt from "./Prompt.js";
  * })
  * ```
  *
- * @since 4.0.0
  * @category services
+ * @since 4.0.0
  */
 export class Tokenizer extends /*#__PURE__*/Context.Service()("effect/ai/Tokenizer") {}
 /**
@@ -68,7 +71,8 @@ export class Tokenizer extends /*#__PURE__*/Context.Service()("effect/ai/Tokeniz
  * tokenization function. The service handles both tokenization and
  * truncation operations using the provided tokenizer.
  *
- * @example
+ * **Example** (Creating a word tokenizer)
+ *
  * ```ts
  * import { Effect } from "effect"
  * import { Tokenizer } from "effect/unstable/ai"
@@ -90,8 +94,8 @@ export class Tokenizer extends /*#__PURE__*/Context.Service()("effect/ai/Tokeniz
  * })
  * ```
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export const make = options => Tokenizer.of({
   tokenize(input) {

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

@@ -1 +1 @@
-{"version":3,"file":"Tokenizer.js","names":["Context","Effect","Predicate","Prompt","Tokenizer","Service","make","options","of","tokenize","input","truncate","tokens","self","maxTokens","suspend","count","inputMessages","content","outputMessages","loop","message","length","isUndefined","succeed","fromMessages","slice","flatMap"],"sources":["../../../src/unstable/ai/Tokenizer.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,SAAS,MAAM,oBAAoB;AAE/C,OAAO,KAAKC,MAAM,MAAM,aAAa;AAErC;;;;;;;;;;;;;;;;;;;;;AAqBA,OAAM,MAAOC,SAAU,sBAAQJ,OAAO,CAACK,OAAO,EAAsB,CAClE,qBAAqB,CACtB;AAmDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,OAAO,MAAMC,IAAI,GAAIC,OAEpB,IACCH,SAAS,CAACI,EAAE,CAAC;EACXC,QAAQA,CAACC,KAAK;IACZ,OAAOH,OAAO,CAACE,QAAQ,CAACN,MAAM,CAACG,IAAI,CAACI,KAAK,CAAC,CAAC;EAC7C,CAAC;EACDC,QAAQA,CAACD,KAAK,EAAEE,MAAM;IACpB,OAAOD,QAAQ,CAACR,MAAM,CAACG,IAAI,CAACI,KAAK,CAAC,EAAEH,OAAO,CAACE,QAAQ,EAAEG,MAAM,CAAC;EAC/D;CACD,CAAC;AAEJ,MAAMD,QAAQ,GAAGA,CACfE,IAAmB,EACnBJ,QAAiF,EACjFK,SAAiB,KAEjBb,MAAM,CAACc,OAAO,CAAC,MAAK;EAClB,IAAIC,KAAK,GAAG,CAAC;EACb,IAAIC,aAAa,GAAGJ,IAAI,CAACK,OAAO;EAChC,IAAIC,cAAc,GAA0B,EAAE;EAC9C,MAAMC,IAAI,GAAkDnB,MAAM,CAACc,OAAO,CAAC,MAAK;IAC9E,MAAMM,OAAO,GAAGJ,aAAa,CAACA,aAAa,CAACK,MAAM,GAAG,CAAC,CAAC;IACvD,IAAIpB,SAAS,CAACqB,WAAW,CAACF,OAAO,CAAC,EAAE;MAClC,OAAOpB,MAAM,CAACuB,OAAO,CAACrB,MAAM,CAACsB,YAAY,CAACN,cAAc,CAAC,CAAC;IAC5D;IACAF,aAAa,GAAGA,aAAa,CAACS,KAAK,CAAC,CAAC,EAAET,aAAa,CAACK,MAAM,GAAG,CAAC,CAAC;IAChE,OAAOrB,MAAM,CAAC0B,OAAO,CAAClB,QAAQ,CAACN,MAAM,CAACsB,YAAY,CAAC,CAACJ,OAAO,CAAC,CAAC,CAAC,EAAGT,MAAM,IAAI;MACzEI,KAAK,IAAIJ,MAAM,CAACU,MAAM;MACtB,IAAIN,KAAK,GAAGF,SAAS,EAAE;QACrB,OAAOb,MAAM,CAACuB,OAAO,CAACrB,MAAM,CAACsB,YAAY,CAACN,cAAc,CAAC,CAAC;MAC5D;MACAA,cAAc,GAAG,CAACE,OAAO,EAAE,GAAGF,cAAc,CAAC;MAC7C,OAAOC,IAAI;IACb,CAAC,CAAC;EACJ,CAAC,CAAC;EACF,OAAOA,IAAI;AACb,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"Tokenizer.js","names":["Context","Effect","Predicate","Prompt","Tokenizer","Service","make","options","of","tokenize","input","truncate","tokens","self","maxTokens","suspend","count","inputMessages","content","outputMessages","loop","message","length","isUndefined","succeed","fromMessages","slice","flatMap"],"sources":["../../../src/unstable/ai/Tokenizer.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,SAAS,MAAM,oBAAoB;AAE/C,OAAO,KAAKC,MAAM,MAAM,aAAa;AAErC;;;;;;;;;;;;;;;;;;;;;;AAsBA,OAAM,MAAOC,SAAU,sBAAQJ,OAAO,CAACK,OAAO,EAAsB,CAClE,qBAAqB,CACtB;AAoDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,OAAO,MAAMC,IAAI,GAAIC,OAEpB,IACCH,SAAS,CAACI,EAAE,CAAC;EACXC,QAAQA,CAACC,KAAK;IACZ,OAAOH,OAAO,CAACE,QAAQ,CAACN,MAAM,CAACG,IAAI,CAACI,KAAK,CAAC,CAAC;EAC7C,CAAC;EACDC,QAAQA,CAACD,KAAK,EAAEE,MAAM;IACpB,OAAOD,QAAQ,CAACR,MAAM,CAACG,IAAI,CAACI,KAAK,CAAC,EAAEH,OAAO,CAACE,QAAQ,EAAEG,MAAM,CAAC;EAC/D;CACD,CAAC;AAEJ,MAAMD,QAAQ,GAAGA,CACfE,IAAmB,EACnBJ,QAAiF,EACjFK,SAAiB,KAEjBb,MAAM,CAACc,OAAO,CAAC,MAAK;EAClB,IAAIC,KAAK,GAAG,CAAC;EACb,IAAIC,aAAa,GAAGJ,IAAI,CAACK,OAAO;EAChC,IAAIC,cAAc,GAA0B,EAAE;EAC9C,MAAMC,IAAI,GAAkDnB,MAAM,CAACc,OAAO,CAAC,MAAK;IAC9E,MAAMM,OAAO,GAAGJ,aAAa,CAACA,aAAa,CAACK,MAAM,GAAG,CAAC,CAAC;IACvD,IAAIpB,SAAS,CAACqB,WAAW,CAACF,OAAO,CAAC,EAAE;MAClC,OAAOpB,MAAM,CAACuB,OAAO,CAACrB,MAAM,CAACsB,YAAY,CAACN,cAAc,CAAC,CAAC;IAC5D;IACAF,aAAa,GAAGA,aAAa,CAACS,KAAK,CAAC,CAAC,EAAET,aAAa,CAACK,MAAM,GAAG,CAAC,CAAC;IAChE,OAAOrB,MAAM,CAAC0B,OAAO,CAAClB,QAAQ,CAACN,MAAM,CAACsB,YAAY,CAAC,CAACJ,OAAO,CAAC,CAAC,CAAC,EAAGT,MAAM,IAAI;MACzEI,KAAK,IAAIJ,MAAM,CAACU,MAAM;MACtB,IAAIN,KAAK,GAAGF,SAAS,EAAE;QACrB,OAAOb,MAAM,CAACuB,OAAO,CAACrB,MAAM,CAACsB,YAAY,CAACN,cAAc,CAAC,CAAC;MAC5D;MACAA,cAAc,GAAG,CAACE,OAAO,EAAE,GAAGF,cAAc,CAAC;MAC7C,OAAOC,IAAI;IACb,CAAC,CAAC;EACJ,CAAC,CAAC;EACF,OAAOA,IAAI;AACb,CAAC,CAAC","ignoreList":[]}