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

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

@@ -1 +1 @@
-{"version":3,"file":"Response.js","names":["Effect","identity","Predicate","Schema","SchemaTransformation","PartTypeId","isPart","u","hasProperty","AllParts","toolkit","toolCalls","toolResults","tool","Object","values","tools","toolCall","ToolCallPart","name","parametersSchema","toolResult","ToolResultPart","successSchema","failureSchema","push","Union","TextPart","TextStartPart","TextDeltaPart","TextEndPart","ReasoningPart","ReasoningStartPart","ReasoningDeltaPart","ReasoningEndPart","ToolParamsStartPart","ToolParamsDeltaPart","ToolParamsEndPart","ToolApprovalRequestPart","FilePart","DocumentSourcePart","UrlSourcePart","ResponseMetadataPart","FinishPart","ErrorPart","Part","StreamPart","ProviderMetadata","Record","String","NullOr","Json","BasePart","Struct","tag","pipe","withDecodingDefaultKey","succeed","encodingStrategy","metadata","withDecodingDefault","makePart","type","params","fields","text","annotate","identifier","id","delta","providerExecuted","Boolean","Literal","toolCallPart","success","failure","ResultSchema","Common","isFailure","Decoded","result","encodedResult","toEncoded","preliminary","Encoded","optional","encodeTo","transform","decode","encoded","encode","toolResultPart","approvalId","toolCallId","toolApprovalRequestPart","mediaType","data","Uint8ArrayFromBase64","sourceType","title","fileName","optionalKey","url","URLFromString","HttpRequestDetails","method","Literals","urlParams","Array","Tuple","hash","UndefinedOr","headers","Redacted","HttpResponseDetails","status","Number","modelId","timestamp","DateTimeUtcFromString","request","FinishReason","Usage","Class","inputTokens","uncached","total","cacheRead","cacheWrite","outputTokens","reasoning","reason","usage","response","error","Unknown"],"sources":["../../../src/unstable/ai/Response.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Response.js","names":["Effect","identity","Predicate","Schema","SchemaTransformation","PartTypeId","isPart","u","hasProperty","AllParts","toolkit","toolCalls","toolResults","tool","Object","values","tools","toolCall","ToolCallPart","name","parametersSchema","toolResult","ToolResultPart","successSchema","failureSchema","push","Union","TextPart","TextStartPart","TextDeltaPart","TextEndPart","ReasoningPart","ReasoningStartPart","ReasoningDeltaPart","ReasoningEndPart","ToolParamsStartPart","ToolParamsDeltaPart","ToolParamsEndPart","ToolApprovalRequestPart","FilePart","DocumentSourcePart","UrlSourcePart","ResponseMetadataPart","FinishPart","ErrorPart","Part","StreamPart","ProviderMetadata","Record","String","NullOr","Json","BasePart","Struct","tag","pipe","withDecodingDefaultKey","succeed","encodingStrategy","metadata","withDecodingDefault","makePart","type","params","fields","text","annotate","identifier","id","delta","providerExecuted","Boolean","Literal","toolCallPart","success","failure","ResultSchema","Common","isFailure","Decoded","result","encodedResult","toEncoded","preliminary","Encoded","optional","encodeTo","transform","decode","encoded","encode","toolResultPart","approvalId","toolCallId","toolApprovalRequestPart","mediaType","data","Uint8ArrayFromBase64","sourceType","title","fileName","optionalKey","url","URLFromString","HttpRequestDetails","method","Literals","urlParams","Array","Tuple","hash","UndefinedOr","headers","Redacted","HttpResponseDetails","status","Number","modelId","timestamp","DateTimeUtcFromString","request","FinishReason","Usage","Class","inputTokens","uncached","total","cacheRead","cacheWrite","outputTokens","reasoning","reason","usage","response","error","Unknown"],"sources":["../../../src/unstable/ai/Response.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -1,15 +1,37 @@
 /**
- * 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.
+ * Track provider response IDs for incremental language model calls.
+ *
+ * Some providers can continue from a prior response by accepting a
+ * `previousResponseId` plus only the messages added after that response. This
+ * module exposes a small mutable service that remembers which prompt message
+ * objects were included in each provider response and prepares a shorter prompt
+ * when a later call extends the same conversation.
+ *
+ * **Mental model**
+ *
+ * The tracker is an optimization cache, not conversation storage. `markParts`
+ * associates the exact message objects that were sent with the response ID the
+ * provider returned. `prepareUnsafe` scans a future prompt, finds the latest
+ * assistant-message boundary whose prefix is tracked, and returns that response
+ * ID with only the messages after the boundary. If the prompt cannot be matched
+ * safely, the cache is cleared and no incremental send is attempted.
+ *
+ * **Common tasks**
+ *
+ * - Provide `ResponseIdTracker` to a language model implementation that can use
+ *   provider previous-response IDs
+ * - Mark prompt messages after a successful provider response
+ * - Prepare follow-up prompts so unchanged history is replaced by
+ *   `previousResponseId`
+ *
+ * **Gotchas**
+ *
+ * - Tracking is based on object identity; equivalent message values are not
+ *   recognized unless they are the same objects.
+ * - The service is mutable and intentionally exposes `Unsafe` methods because
+ *   callers coordinate it inside provider request/response code.
+ * - A mismatch clears tracked state to avoid reusing a response ID for the
+ *   wrong prompt prefix.
  *
  * @since 4.0.0
  */
@@ -59,7 +81,7 @@ declare const ResponseIdTracker_base: Context.ServiceClass<ResponseIdTracker, "e
  *
  * **When to use**
  *
- * When provided, language model operations can use the tracker to send only new
+ * Use when 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

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

@@ -1 +1 @@
-{"version":3,"file":"ResponseIdTracker.d.ts","sourceRoot":"","sources":["../../../src/unstable/ai/ResponseIdTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAA;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,OAAO;IACtB,WAAW,IAAI,IAAI,CAAA;IACnB,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACjE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;CACnE;;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,sBAA4E;CAAG;AAEtH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAyDtC,CAAA"}
+{"version":3,"file":"ResponseIdTracker.d.ts","sourceRoot":"","sources":["../../../src/unstable/ai/ResponseIdTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAA;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,OAAO;IACtB,WAAW,IAAI,IAAI,CAAA;IACnB,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACjE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;CACnE;;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,sBAA4E;CAAG;AAEtH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAyDtC,CAAA"}

package/dist/unstable/ai/ResponseIdTracker.js

@@ -1,15 +1,37 @@
 /**
- * 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.
+ * Track provider response IDs for incremental language model calls.
  *
- * 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.
+ * Some providers can continue from a prior response by accepting a
+ * `previousResponseId` plus only the messages added after that response. This
+ * module exposes a small mutable service that remembers which prompt message
+ * objects were included in each provider response and prepares a shorter prompt
+ * when a later call extends the same conversation.
+ *
+ * **Mental model**
+ *
+ * The tracker is an optimization cache, not conversation storage. `markParts`
+ * associates the exact message objects that were sent with the response ID the
+ * provider returned. `prepareUnsafe` scans a future prompt, finds the latest
+ * assistant-message boundary whose prefix is tracked, and returns that response
+ * ID with only the messages after the boundary. If the prompt cannot be matched
+ * safely, the cache is cleared and no incremental send is attempted.
+ *
+ * **Common tasks**
+ *
+ * - Provide `ResponseIdTracker` to a language model implementation that can use
+ *   provider previous-response IDs
+ * - Mark prompt messages after a successful provider response
+ * - Prepare follow-up prompts so unchanged history is replaced by
+ *   `previousResponseId`
+ *
+ * **Gotchas**
+ *
+ * - Tracking is based on object identity; equivalent message values are not
+ *   recognized unless they are the same objects.
+ * - The service is mutable and intentionally exposes `Unsafe` methods because
+ *   callers coordinate it inside provider request/response code.
+ * - A mismatch clears tracked state to avoid reusing a response ID for the
+ *   wrong prompt prefix.
  *
  * @since 4.0.0
  */
@@ -23,7 +45,7 @@ import * as Prompt from "./Prompt.js";
  *
  * **When to use**
  *
- * When provided, language model operations can use the tracker to send only new
+ * Use when 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

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;;;;;;;;;;;;;;;AAeA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,aAAa;AAuCrC;;;;;;;;;;;;AAYA,OAAM,MAAOC,iBAAkB,sBAAQJ,OAAO,CAACK,OAAO,EAA8B,CAAC,6BAA6B,CAAC;AAEnH;;;;;;;;;;;;;AAaA,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AACzC,OAAO,KAAKC,MAAM,MAAM,aAAa;AAuCrC;;;;;;;;;;;;AAYA,OAAM,MAAOC,iBAAkB,sBAAQJ,OAAO,CAACK,OAAO,EAA8B,CAAC,6BAA6B,CAAC;AAEnH;;;;;;;;;;;;;AAaA,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

@@ -1,34 +1,35 @@
 /**
- * The `Telemetry` module provides OpenTelemetry integration for operations
- * performed against a large language model provider by defining telemetry
- * attributes and utilities that follow the OpenTelemetry GenAI semantic
- * conventions.
+ * OpenTelemetry span annotation helpers for Effect AI operations.
  *
- * **Example** (Annotating AI spans)
+ * The `Telemetry` module models the OpenTelemetry GenAI semantic-convention
+ * attributes used by language model and embedding providers, and exposes small
+ * helpers for writing those attributes onto Effect tracing spans. It is used by
+ * provider implementations and by applications that want consistent
+ * `gen_ai.*` span metadata around model requests, responses, token usage, and
+ * provider-specific identifiers.
  *
- * ```ts
- * import { Effect } from "effect"
- * import { Telemetry } from "effect/unstable/ai"
+ * **Mental model**
  *
- * // Add telemetry attributes to a span
- * const addTelemetry = Effect.gen(function*() {
- *   const span = yield* Effect.currentSpan
+ * Attribute options are grouped by semantic-convention namespace: base
+ * `gen_ai`, `operation`, `request`, `response`, `token`, and `usage`.
+ * `addGenAIAnnotations` flattens those groups into span attributes, ignores
+ * nullish values, and converts camelCase field names to snake_case keys.
+ * `addSpanAttributes` provides the same prefix-and-transform behavior for
+ * custom namespaces.
  *
- *   Telemetry.addGenAIAnnotations(span, {
- *     system: "openai",
- *     operation: { name: "chat" },
- *     request: {
- *       model: "gpt-4",
- *       temperature: 0.7,
- *       maxTokens: 1000
- *     },
- *     usage: {
- *       inputTokens: 100,
- *       outputTokens: 50
- *     }
- *   })
- * })
- * ```
+ * **Common tasks**
+ *
+ * - Add standard GenAI attributes to the current span with
+ *   `addGenAIAnnotations`.
+ * - Create a custom attribute writer with `addSpanAttributes`.
+ * - Provide `CurrentSpanTransformer` so a language model implementation can
+ *   annotate the span after seeing the provider response.
+ *
+ * **Gotchas**
+ *
+ * These helpers annotate spans that already exist; they do not create or scope
+ * spans. Attribute writers mutate the provided span, and only non-nullish
+ * values are emitted.
  *
  * @since 4.0.0
  */
@@ -41,7 +42,12 @@ import type * as Response from "./Response.ts";
  * The attributes used to describe telemetry in the context of Generative
  * Artificial Intelligence (GenAI) models requests and responses.
  *
- * @see https://opentelemetry.io/docs/specs/semconv/attributes-registry/gen-ai/
+ * **Details**
+ *
+ * These attributes follow the OpenTelemetry generative AI semantic
+ * conventions:
+ * https://opentelemetry.io/docs/specs/semconv/attributes-registry/gen-ai/
+ *
  * @category models
  * @since 4.0.0
  */
@@ -502,6 +508,13 @@ declare const CurrentSpanTransformer_base: Context.ServiceClass<CurrentSpanTrans
  * Service tag for providing a `SpanTransformer` to large language model
  * operations.
  *
+ * **When to use**
+ *
+ * Use to retrieve or provide the current `SpanTransformer` through context for
+ * language model span annotation.
+ *
+ * @see {@link SpanTransformer} for the transformer contract provided by this service
+ *
  * @category services
  * @since 4.0.0
  */

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

@@ -1,34 +1,35 @@
 /**
- * The `Telemetry` module provides OpenTelemetry integration for operations
- * performed against a large language model provider by defining telemetry
- * attributes and utilities that follow the OpenTelemetry GenAI semantic
- * conventions.
+ * OpenTelemetry span annotation helpers for Effect AI operations.
  *
- * **Example** (Annotating AI spans)
+ * The `Telemetry` module models the OpenTelemetry GenAI semantic-convention
+ * attributes used by language model and embedding providers, and exposes small
+ * helpers for writing those attributes onto Effect tracing spans. It is used by
+ * provider implementations and by applications that want consistent
+ * `gen_ai.*` span metadata around model requests, responses, token usage, and
+ * provider-specific identifiers.
  *
- * ```ts
- * import { Effect } from "effect"
- * import { Telemetry } from "effect/unstable/ai"
+ * **Mental model**
  *
- * // Add telemetry attributes to a span
- * const addTelemetry = Effect.gen(function*() {
- *   const span = yield* Effect.currentSpan
+ * Attribute options are grouped by semantic-convention namespace: base
+ * `gen_ai`, `operation`, `request`, `response`, `token`, and `usage`.
+ * `addGenAIAnnotations` flattens those groups into span attributes, ignores
+ * nullish values, and converts camelCase field names to snake_case keys.
+ * `addSpanAttributes` provides the same prefix-and-transform behavior for
+ * custom namespaces.
  *
- *   Telemetry.addGenAIAnnotations(span, {
- *     system: "openai",
- *     operation: { name: "chat" },
- *     request: {
- *       model: "gpt-4",
- *       temperature: 0.7,
- *       maxTokens: 1000
- *     },
- *     usage: {
- *       inputTokens: 100,
- *       outputTokens: 50
- *     }
- *   })
- * })
- * ```
+ * **Common tasks**
+ *
+ * - Add standard GenAI attributes to the current span with
+ *   `addGenAIAnnotations`.
+ * - Create a custom attribute writer with `addSpanAttributes`.
+ * - Provide `CurrentSpanTransformer` so a language model implementation can
+ *   annotate the span after seeing the provider response.
+ *
+ * **Gotchas**
+ *
+ * These helpers annotate spans that already exist; they do not create or scope
+ * spans. Attribute writers mutate the provided span, and only non-nullish
+ * values are emitted.
  *
  * @since 4.0.0
  */
@@ -144,6 +145,13 @@ export const addGenAIAnnotations = /*#__PURE__*/dual(2, (span, options) => {
  * Service tag for providing a `SpanTransformer` to large language model
  * operations.
  *
+ * **When to use**
+ *
+ * Use to retrieve or provide the current `SpanTransformer` through context for
+ * language model span annotation.
+ *
+ * @see {@link SpanTransformer} for the transformer contract provided by this service
+ *
  * @category services
  * @since 4.0.0
  */

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,SAASC,IAAI,QAAQ,mBAAmB;AACxC,OAAO,KAAKC,SAAS,MAAM,oBAAoB;AAC/C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAwQzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,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;AA+DtG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,OAAO,MAAMM,mBAAmB,gBAmE5BrB,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;AAwCF;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,SAASC,IAAI,QAAQ,mBAAmB;AACxC,OAAO,KAAKC,SAAS,MAAM,oBAAoB;AAC/C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AA6QzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,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;AA+DtG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,OAAO,MAAMM,mBAAmB,gBAmE5BrB,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;AAwCF;;;;;;;;;;;;;;AAcA,OAAM,MAAOC,sBAAuB,sBAAQ9B,OAAO,CAAC+B,OAAO,EAA2C,CACpG,4CAA4C,CAC7C","ignoreList":[]}

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

@@ -1,38 +1,49 @@
 /**
- * The `Tokenizer` module provides tokenization and text truncation capabilities
- * for large language model text processing workflows.
+ * Token counting and prompt truncation for AI integrations. A tokenizer is a
+ * service because tokenization depends on the target model, provider, and
+ * encoding rules rather than on Effect itself.
  *
- * This module offers services for converting text into tokens and truncating
- * prompts based on token limits, essential for managing context length
- * constraints in large language models.
+ * **Mental model**
  *
- * **Example** (Tokenizing text)
+ * {@link Tokenizer} provides two operations over prompt input: `tokenize`
+ * converts a prompt into provider-specific token ids, and `truncate` keeps a
+ * prompt within a token budget before it is sent to a model. Implementations
+ * are usually provided by an AI provider package or by wrapping the tokenizer
+ * used by the model.
  *
- * ```ts
- * import { Effect } from "effect"
- * import { Tokenizer } from "effect/unstable/ai"
+ * **Common tasks**
  *
- * const tokenizeText = Effect.gen(function*() {
- *   const tokenizer = yield* Tokenizer.Tokenizer
- *   const tokens = yield* tokenizer.tokenize("Hello, world!")
- *   console.log(`Token count: ${tokens.length}`)
- *   return tokens
- * })
- * ```
+ * - Count prompt tokens before choosing a model or request size
+ * - Drop older conversation messages before a chat completion call
+ * - Provide a custom tokenizer with {@link make} for tests or unsupported
+ *   providers
+ *
+ * **Gotchas**
  *
- * **Example** (Truncating a prompt)
+ * - Token ids are model-specific. Counts from one tokenizer may not match
+ *   another model's tokenizer.
+ * - The `truncate` implementation produced by {@link make} keeps complete
+ *   messages from the end of the prompt; it does not split a message to fit the
+ *   remaining budget.
+ * - Programs that access {@link Tokenizer} require a tokenizer service to be
+ *   provided.
+ *
+ * **Example** (Providing a test tokenizer)
  *
  * ```ts
  * import { Effect } from "effect"
  * import { Tokenizer } from "effect/unstable/ai"
  *
- * // Truncate a prompt to fit within token limits
- * const truncatePrompt = Effect.gen(function*() {
- *   const tokenizer = yield* Tokenizer.Tokenizer
- *   const longPrompt = "This is a very long prompt..."
- *   const truncated = yield* tokenizer.truncate(longPrompt, 100)
- *   return truncated
+ * const tokenizer = Tokenizer.make({
+ *   tokenize: (prompt) =>
+ *     Effect.succeed(prompt.content.map((_, index) => index))
  * })
+ *
+ * const program = Effect.gen(function*() {
+ *   const service = yield* Tokenizer.Tokenizer
+ *   const tokens = yield* service.tokenize("Count this prompt")
+ *   return tokens.length
+ * }).pipe(Effect.provideService(Tokenizer.Tokenizer, tokenizer))
  * ```
  *
  * @since 4.0.0
@@ -43,7 +54,12 @@ import type * as AiError from "./AiError.ts";
 import * as Prompt from "./Prompt.ts";
 declare const Tokenizer_base: Context.ServiceClass<Tokenizer, "effect/ai/Tokenizer", Service>;
 /**
- * The `Tokenizer` service tag for dependency injection.
+ * Service tag for model tokenization services.
+ *
+ * **When to use**
+ *
+ * Use to access or provide model-specific token counting and prompt truncation
+ * operations.
  *
  * **Details**
  *
@@ -63,7 +79,7 @@ declare const Tokenizer_base: Context.ServiceClass<Tokenizer, "effect/ai/Tokeniz
  * })
  * ```
  *
- * @category services
+ * @category tags
  * @since 4.0.0
  */
 export declare class Tokenizer extends Tokenizer_base {

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;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

@@ -1,38 +1,49 @@
 /**
- * The `Tokenizer` module provides tokenization and text truncation capabilities
- * for large language model text processing workflows.
+ * Token counting and prompt truncation for AI integrations. A tokenizer is a
+ * service because tokenization depends on the target model, provider, and
+ * encoding rules rather than on Effect itself.
  *
- * This module offers services for converting text into tokens and truncating
- * prompts based on token limits, essential for managing context length
- * constraints in large language models.
+ * **Mental model**
  *
- * **Example** (Tokenizing text)
+ * {@link Tokenizer} provides two operations over prompt input: `tokenize`
+ * converts a prompt into provider-specific token ids, and `truncate` keeps a
+ * prompt within a token budget before it is sent to a model. Implementations
+ * are usually provided by an AI provider package or by wrapping the tokenizer
+ * used by the model.
  *
- * ```ts
- * import { Effect } from "effect"
- * import { Tokenizer } from "effect/unstable/ai"
+ * **Common tasks**
  *
- * const tokenizeText = Effect.gen(function*() {
- *   const tokenizer = yield* Tokenizer.Tokenizer
- *   const tokens = yield* tokenizer.tokenize("Hello, world!")
- *   console.log(`Token count: ${tokens.length}`)
- *   return tokens
- * })
- * ```
+ * - Count prompt tokens before choosing a model or request size
+ * - Drop older conversation messages before a chat completion call
+ * - Provide a custom tokenizer with {@link make} for tests or unsupported
+ *   providers
+ *
+ * **Gotchas**
  *
- * **Example** (Truncating a prompt)
+ * - Token ids are model-specific. Counts from one tokenizer may not match
+ *   another model's tokenizer.
+ * - The `truncate` implementation produced by {@link make} keeps complete
+ *   messages from the end of the prompt; it does not split a message to fit the
+ *   remaining budget.
+ * - Programs that access {@link Tokenizer} require a tokenizer service to be
+ *   provided.
+ *
+ * **Example** (Providing a test tokenizer)
  *
  * ```ts
  * import { Effect } from "effect"
  * import { Tokenizer } from "effect/unstable/ai"
  *
- * // Truncate a prompt to fit within token limits
- * const truncatePrompt = Effect.gen(function*() {
- *   const tokenizer = yield* Tokenizer.Tokenizer
- *   const longPrompt = "This is a very long prompt..."
- *   const truncated = yield* tokenizer.truncate(longPrompt, 100)
- *   return truncated
+ * const tokenizer = Tokenizer.make({
+ *   tokenize: (prompt) =>
+ *     Effect.succeed(prompt.content.map((_, index) => index))
  * })
+ *
+ * const program = Effect.gen(function*() {
+ *   const service = yield* Tokenizer.Tokenizer
+ *   const tokens = yield* service.tokenize("Count this prompt")
+ *   return tokens.length
+ * }).pipe(Effect.provideService(Tokenizer.Tokenizer, tokenizer))
  * ```
  *
  * @since 4.0.0
@@ -42,7 +53,12 @@ import * as Effect from "../../Effect.js";
 import * as Predicate from "../../Predicate.js";
 import * as Prompt from "./Prompt.js";
 /**
- * The `Tokenizer` service tag for dependency injection.
+ * Service tag for model tokenization services.
+ *
+ * **When to use**
+ *
+ * Use to access or provide model-specific token counting and prompt truncation
+ * operations.
  *
  * **Details**
  *
@@ -62,7 +78,7 @@ import * as Prompt from "./Prompt.js";
  * })
  * ```
  *
- * @category services
+ * @category tags
  * @since 4.0.0
  */
 export class Tokenizer extends /*#__PURE__*/Context.Service()("effect/ai/Tokenizer") {}