autotel-bedrock 0.1.0 → 2.0.0

package/README.md

@@ -1,10 +1,10 @@
 # autotel-bedrock
 
-**Bedrock is a provider, not a destination.**
+Amazon Bedrock facts for autotel's canonical `gen_ai.*` spans.
 
-`autotel-genai` already emits canonical `gen_ai.*` spans for every AI SDK call
-against Amazon Bedrock — `gen_ai.provider.name = aws.bedrock`, the model id,
-token usage, input and output messages — from nothing but the observer:
+`autotel-genai` emits `gen_ai.*` spans for every AI SDK call against Amazon
+Bedrock (`gen_ai.provider.name = aws.bedrock`, the model id, token usage, input
+and output messages) from the observer alone:
 
 ```ts
 import { registerTelemetry } from 'ai';
@@ -13,8 +13,8 @@ import { autotelTelemetry } from 'autotel-genai/observer';
 registerTelemetry(autotelTelemetry());
 ```
 
-**This package is not required for any of it.** It fills in the Bedrock facts
-no OpenTelemetry convention covers and no generic price table knows.
+This package adds the Bedrock facts that no OpenTelemetry convention covers
+and no generic price table knows.
 
 ## What this package adds
 
@@ -61,24 +61,24 @@ and keeps the rest as their own attributes:
 | Attribute                              | Value                                       |
 | -------------------------------------- | ------------------------------------------- |
 | `gen_ai.request.model`                 | `anthropic.claude-sonnet-4-5-20250929-v1:0` |
-| `aws.bedrock.model.id_raw`             | what the request actually said              |
+| `aws.bedrock.model.id_raw`             | the id as the request spelled it            |
 | `aws.bedrock.model.arn`                | the ARN, when one was used                  |
 | `aws.bedrock.inference_profile.region` | `eu`, `us`, `global`…                       |
 | `aws.bedrock.model.vendor`             | `anthropic`, `amazon`, `meta`, `zai`…       |
 | `cloud.provider` / `cloud.region`      | `aws` / the option or `AWS_REGION`          |
 
-Pass `normalizeModel: false` to keep the requested spelling and only add the
-extra attributes. Spans from every other provider pass through untouched.
+Pass `normalizeModel: false` to keep the requested spelling and add the extra
+attributes only. Spans from other providers pass through untouched.
 
-Use `spanEnrichers`, not `spanProcessors`. The latter replaces the pipeline
-autotel builds, which would switch off the destinations you just configured.
+Register it under `spanEnrichers`. `spanProcessors` replaces the pipeline
+autotel builds, including the destinations you configured.
 
 ### Stop reason and guardrails
 
 The AI SDK folds Bedrock's stop reasons into its own (`guardrail_intervened`
 and `content_filtered` both become `content-filter`; `malformed_tool_use` and
-`model_context_window_exceeded` become `other`), and the lifecycle events
-never see the guardrail trace. `bedrockProviderAttributes` puts both back:
+`model_context_window_exceeded` become `other`), and its lifecycle events omit
+the guardrail trace. `bedrockProviderAttributes` records both:
 
 ```ts
 registerTelemetry(
@@ -96,23 +96,22 @@ registerTelemetry(
 | `aws.bedrock.guardrail.id`         | from the trace, so set `guardrailConfig.trace: 'enabled'` |
 
 `gen_ai.response.finish_reasons` keeps the AI SDK's unified value, so a
-dashboard built on it still works. An intervention is a policy outcome, not a
-failure: the span's status stays unset, and `guardrail.intervened / total` is
-one query away.
+dashboard built on it keeps working. An intervention is a policy outcome: the
+span's status stays unset, and `guardrail.intervened / total` is one query.
 
 ### Bedrock-only pricing
 
 `BEDROCK_PRICING` is a table for `autotelTelemetry({ pricing })` covering the
 models that exist only behind Bedrock: Nova, Llama, Mistral, DeepSeek, GLM.
-Anthropic models are deliberately absent — Bedrock bills them at Anthropic's
-rates and `autotel-genai` prices those by family already.
+Bedrock bills Anthropic models at Anthropic's rates, and `autotel-genai`
+prices those by family, so they are not listed here.
 
-Keys match the way `autotel-genai/cost` resolves ids — exact, then prefix,
-tried again after each region/vendor prefix is peeled — so
+Keys match the way `autotel-genai/cost` resolves ids (exact, then prefix, tried
+again after each region and vendor prefix is peeled), so
 `eu.amazon.nova-pro-v1:0` resolves via `amazon.nova-pro`.
 
-Approximate list prices at the time of writing; a convenience default, not a
-billing source of truth. Spread and override what you use:
+The prices are list prices at the time of writing, a convenience default rather
+than a billing source of truth. Spread and override what you use:
 
 ```ts
 autotelTelemetry({
@@ -123,9 +122,11 @@ autotelTelemetry({
 });
 ```
 
-## What you do not need this for
+Runnable example: [`apps/example-bedrock`](../../apps/example-bedrock), a Lambda handler around an AI SDK tool-loop agent, run in-process against Bedrock.
 
-| Already arrives from                     |                                        |
+## Already covered elsewhere
+
+| Signal                                   | Comes from                             |
 | ---------------------------------------- | -------------------------------------- |
 | `gen_ai.provider.name = aws.bedrock`     | `autotel-genai` provider normalisation |
 | Anthropic model cost on Bedrock          | `autotel-genai/cost` family pricing    |

package/dist/index.d.cts

@@ -31,12 +31,12 @@ declare function parseBedrockModelId(raw: string): ParsedBedrockModelId;
  * foundation model id, tried again after each vendor/region prefix is
  * peeled off. So `eu.amazon.nova-pro-v1:0` resolves via `amazon.nova-pro`.
  *
- * Anthropic models are deliberately absent: Bedrock bills them at the same
- * rates as Anthropic direct, and `autotel-genai` already prices those by
- * family. This table is for the models that only exist behind Bedrock.
+ * Bedrock bills Anthropic models at Anthropic's rates and `autotel-genai`
+ * prices those by family, so this table covers the models that only exist
+ * behind Bedrock.
  *
- * Approximate public prices at the time of writing (eu-west-1 / us-east-1
- * on-demand). A convenience default, not a billing source of truth — check
+ * Public prices at the time of writing (eu-west-1 / us-east-1 on-demand), a
+ * convenience default rather than a billing source of truth. Check
  * https://aws.amazon.com/bedrock/pricing/ and override what you use.
  */
 interface BedrockModelPricing {
@@ -77,13 +77,13 @@ interface BedrockCompatibilityOptions {
    * `AWS_REGION` from the environment (set on every Lambda); left off when
    * neither is known.
    */
-  region?: string;
+  region?: string | undefined;
   /**
    * Rewrite `gen_ai.request.model` / `gen_ai.response.model` to the foundation
    * model id when the request used an inference profile or ARN. The original
    * spelling is always kept in `aws.bedrock.model.id_raw`. Default `true`.
    */
-  normalizeModel?: boolean;
+  normalizeModel?: boolean | undefined;
 }
 /**
  * A span processor that fills in the Bedrock-specific fields on the way out.

package/dist/index.d.ts

@@ -31,12 +31,12 @@ declare function parseBedrockModelId(raw: string): ParsedBedrockModelId;
  * foundation model id, tried again after each vendor/region prefix is
  * peeled off. So `eu.amazon.nova-pro-v1:0` resolves via `amazon.nova-pro`.
  *
- * Anthropic models are deliberately absent: Bedrock bills them at the same
- * rates as Anthropic direct, and `autotel-genai` already prices those by
- * family. This table is for the models that only exist behind Bedrock.
+ * Bedrock bills Anthropic models at Anthropic's rates and `autotel-genai`
+ * prices those by family, so this table covers the models that only exist
+ * behind Bedrock.
  *
- * Approximate public prices at the time of writing (eu-west-1 / us-east-1
- * on-demand). A convenience default, not a billing source of truth — check
+ * Public prices at the time of writing (eu-west-1 / us-east-1 on-demand), a
+ * convenience default rather than a billing source of truth. Check
  * https://aws.amazon.com/bedrock/pricing/ and override what you use.
  */
 interface BedrockModelPricing {
@@ -77,13 +77,13 @@ interface BedrockCompatibilityOptions {
    * `AWS_REGION` from the environment (set on every Lambda); left off when
    * neither is known.
    */
-  region?: string;
+  region?: string | undefined;
   /**
    * Rewrite `gen_ai.request.model` / `gen_ai.response.model` to the foundation
    * model id when the request used an inference profile or ARN. The original
    * spelling is always kept in `aws.bedrock.model.id_raw`. Default `true`.
    */
-  normalizeModel?: boolean;
+  normalizeModel?: boolean | undefined;
 }
 /**
  * A span processor that fills in the Bedrock-specific fields on the way out.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-bedrock",
-  "version": "0.1.0",
+  "version": "2.0.0",
   "description": "Amazon Bedrock facts for autotel's canonical gen_ai.* spans: model-id normalisation for inference profiles and ARNs, cloud.region, and a Bedrock price table",
   "type": "module",
   "sideEffects": false,
@@ -24,12 +24,12 @@
   },
   "peerDependencies": {
     "@opentelemetry/sdk-trace-base": ">=2.0.0",
-    "autotel-genai": ">=1.0.0"
+    "autotel-genai": "^0.15.0"
   },
   "devDependencies": {
     "@opentelemetry/sdk-trace-base": "^2.11.0",
     "@types/node": "^26.1.2",
-    "autotel-genai": "0.13.1",
+    "autotel-genai": "0.15.0",
     "tsdown": "^0.22.14",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"