@intentius/chant-lexicon-otel 0.95.0 → 0.96.0

package/dist/components/sampling.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Built-in sampling components: the tail_sampling and probabilistic_sampler
+ * processors, and the loadbalancing exporter that routes every span of a trace
+ * to the same collector so tail sampling sees whole traces.
+ *
+ * Field shapes follow `processor/tailsamplingprocessor`,
+ * `processor/probabilisticsamplerprocessor` and
+ * `exporter/loadbalancingexporter` at `COLLECTOR_PIN`.
+ */
+import type { Duration, ExporterHelperSettings, GRPCClientSettings } from "./common.js";
+/** Samples a trace whose duration is at least `threshold_ms` (and below `upper_threshold_ms`, when set). */
+export interface LatencyPolicyConfig {
+    threshold_ms: number;
+    upper_threshold_ms?: number;
+}
+/** Samples a trace with a span whose integer attribute `key` falls within `min_value` to `max_value`. */
+export interface NumericAttributePolicyConfig {
+    key: string;
+    min_value?: number;
+    max_value?: number;
+    invert_match?: boolean;
+}
+/** Samples a fixed percentage of traces by trace id hash. */
+export interface ProbabilisticPolicyConfig {
+    sampling_percentage: number;
+    hash_salt?: string;
+}
+export type SpanStatusCode = "OK" | "ERROR" | "UNSET";
+/** Samples a trace with a span whose status is one of `status_codes`. */
+export interface StatusCodePolicyConfig {
+    status_codes: SpanStatusCode[];
+}
+/** Samples a trace with a span whose string attribute `key` matches one of `values`. */
+export interface StringAttributePolicyConfig {
+    key: string;
+    values: string[];
+    enabled_regex_matching?: boolean;
+    cache_max_size?: number;
+    invert_match?: boolean;
+}
+/** Samples traces until `spans_per_second` is reached. */
+export interface RateLimitingPolicyConfig {
+    spans_per_second: number;
+}
+/** Samples a trace whose span count falls within `min_spans` to `max_spans`. */
+export interface SpanCountPolicyConfig {
+    min_spans: number;
+    max_spans?: number;
+}
+/** Samples a trace whose W3C trace state key `key` has one of `values`. */
+export interface TraceStatePolicyConfig {
+    key: string;
+    values: string[];
+}
+/** Samples a trace with a span whose boolean attribute `key` equals `value`. */
+export interface BooleanAttributePolicyConfig {
+    key: string;
+    value: boolean;
+    invert_match?: boolean;
+}
+/** Samples a trace when any OTTL condition on a span or span event is true. */
+export interface OttlConditionPolicyConfig {
+    error_mode?: "ignore" | "silent" | "propagate";
+    span?: string[];
+    spanevent?: string[];
+}
+interface PolicyBase<T extends string> {
+    /** Unique within its list; the collector refuses an empty or repeated name. */
+    name: string;
+    type: T;
+}
+export interface AlwaysSamplePolicy extends PolicyBase<"always_sample"> {
+}
+export interface LatencyPolicy extends PolicyBase<"latency"> {
+    latency: LatencyPolicyConfig;
+}
+export interface NumericAttributePolicy extends PolicyBase<"numeric_attribute"> {
+    numeric_attribute: NumericAttributePolicyConfig;
+}
+export interface ProbabilisticPolicy extends PolicyBase<"probabilistic"> {
+    probabilistic: ProbabilisticPolicyConfig;
+}
+export interface StatusCodePolicy extends PolicyBase<"status_code"> {
+    status_code: StatusCodePolicyConfig;
+}
+export interface StringAttributePolicy extends PolicyBase<"string_attribute"> {
+    string_attribute: StringAttributePolicyConfig;
+}
+export interface RateLimitingPolicy extends PolicyBase<"rate_limiting"> {
+    rate_limiting: RateLimitingPolicyConfig;
+}
+export interface SpanCountPolicy extends PolicyBase<"span_count"> {
+    span_count: SpanCountPolicyConfig;
+}
+export interface TraceStatePolicy extends PolicyBase<"trace_state"> {
+    trace_state: TraceStatePolicyConfig;
+}
+export interface BooleanAttributePolicy extends PolicyBase<"boolean_attribute"> {
+    boolean_attribute: BooleanAttributePolicyConfig;
+}
+export interface OttlConditionPolicy extends PolicyBase<"ottl_condition"> {
+    ottl_condition: OttlConditionPolicyConfig;
+}
+/** A policy that decides on its own: every type except `and`, `composite` and `drop`. Also the shape of an `and` sub-policy. */
+export type TailSamplingLeafPolicy = AlwaysSamplePolicy | LatencyPolicy | NumericAttributePolicy | ProbabilisticPolicy | StatusCodePolicy | StringAttributePolicy | RateLimitingPolicy | SpanCountPolicy | TraceStatePolicy | BooleanAttributePolicy | OttlConditionPolicy;
+/** Samples a trace only when every sub-policy samples it. */
+export interface AndPolicy extends PolicyBase<"and"> {
+    and: {
+        and_sub_policy: TailSamplingLeafPolicy[];
+    };
+}
+/** Drops a trace when every sub-policy matches it, whatever the other policies decide. */
+export interface DropPolicy extends PolicyBase<"drop"> {
+    drop: {
+        drop_sub_policy: TailSamplingLeafPolicy[];
+    };
+}
+/** A composite sub-policy: a leaf policy or an `and`. */
+export type CompositeSubPolicy = TailSamplingLeafPolicy | AndPolicy;
+/**
+ * Shares `max_total_spans_per_second` between sub-policies. Each
+ * `rate_allocation` entry names a sub-policy and its percent of the budget;
+ * `policy_order` is the order sub-policies are evaluated in.
+ */
+export interface CompositePolicy extends PolicyBase<"composite"> {
+    composite: {
+        max_total_spans_per_second: number;
+        policy_order: string[];
+        composite_sub_policy: CompositeSubPolicy[];
+        rate_allocation?: Array<{
+            policy: string;
+            percent: number;
+        }>;
+    };
+}
+/** One entry in `tail_sampling.policies`, discriminated by `type`. The config sits under the key named by `type`. */
+export type TailSamplingPolicy = TailSamplingLeafPolicy | AndPolicy | DropPolicy | CompositePolicy;
+export type TailSamplingPolicyType = TailSamplingPolicy["type"];
+export interface TailSamplingProcessorConfig {
+    /** How long after a trace's first span the decision is made. The collector's default is 30s; chant asks for it explicitly. */
+    decision_wait: Duration;
+    /** Policies, evaluated for every trace. A trace is sampled when any policy samples it and no `drop` policy drops it. */
+    policies: TailSamplingPolicy[];
+    num_traces?: number;
+    expected_new_traces_per_sec?: number;
+    decision_cache?: {
+        sampled_cache_size?: number;
+        non_sampled_cache_size?: number;
+    };
+    sample_on_first_match?: boolean;
+}
+/**
+ * Holds each trace for `decision_wait`, then samples it when a policy says so.
+ * Tail sampling needs every span of a trace in one collector: run it on a
+ * gateway behind the `loadbalancing` exporter, not on a per-node agent.
+ */
+export declare const TailSamplingProcessor: import("../index.js").ComponentClass<"processor", "tail_sampling", TailSamplingProcessorConfig>;
+export interface ProbabilisticSamplerProcessorConfig {
+    /** Percent of traces or logs kept, 0 to 100. The collector's default is 0, which keeps nothing, so chant asks for it. */
+    sampling_percentage: number;
+    /** Salt for `hash_seed` mode. Collectors that sample the same data must share it. */
+    hash_seed?: number;
+    /** `hash_seed` (the default for logs), `proportional` (the default for traces) or `equalizing`. */
+    mode?: "hash_seed" | "proportional" | "equalizing";
+    /** Default true: an item without usable randomness is dropped. */
+    fail_closed?: boolean;
+    /** Hex digits of threshold precision, 1 to 14; default 4. */
+    sampling_precision?: number;
+    /** Logs only: sample on the trace id (default) or on `from_attribute` of the record. */
+    attribute_source?: "traceID" | "record";
+    from_attribute?: string;
+    /** Logs only: an attribute whose value overrides the sampling percentage for its record. */
+    sampling_priority?: string;
+}
+/** Head sampling: keeps a fixed percentage of traces or logs, decided per item without waiting for the rest of the trace. */
+export declare const ProbabilisticSamplerProcessor: import("../index.js").ComponentClass<"processor", "probabilistic_sampler", ProbabilisticSamplerProcessorConfig>;
+/** A fixed list of backends, each `host` or `host:port` (port 4317 when omitted). */
+export interface StaticResolverConfig {
+    hostnames: string[];
+}
+/** Backends found by resolving a DNS name, e.g. a headless Service. */
+export interface DnsResolverConfig {
+    hostname: string;
+    /** Default `4317`. */
+    port?: string;
+    interval?: Duration;
+    timeout?: Duration;
+}
+/** Backends found by watching a Kubernetes Service's endpoints. Needs RBAC to list and watch EndpointSlices. */
+export interface K8sResolverConfig {
+    /** `name` or `name.namespace`. */
+    service: string;
+    /** Default `[4317]`. */
+    ports?: number[];
+    timeout?: Duration;
+    /** Use pod hostnames instead of IPs, e.g. for a StatefulSet behind a headless Service. */
+    return_hostnames?: boolean;
+}
+/** Backends found in AWS Cloud Map. */
+export interface AwsCloudMapResolverConfig {
+    namespace: string;
+    service_name: string;
+    health_status?: "HEALTHY" | "UNHEALTHY" | "ALL" | "HEALTHY_OR_ELSE_ALL";
+    interval?: Duration;
+    timeout?: Duration;
+    port?: number;
+}
+/** Exactly one resolver; the collector refuses none or several. */
+export type LoadBalancingResolver = {
+    static: StaticResolverConfig;
+    dns?: never;
+    k8s?: never;
+    aws_cloud_map?: never;
+} | {
+    dns: DnsResolverConfig;
+    static?: never;
+    k8s?: never;
+    aws_cloud_map?: never;
+} | {
+    k8s: K8sResolverConfig;
+    static?: never;
+    dns?: never;
+    aws_cloud_map?: never;
+} | {
+    aws_cloud_map: AwsCloudMapResolverConfig;
+    static?: never;
+    dns?: never;
+    k8s?: never;
+};
+/**
+ * `traceID` (the default for traces and logs), `service` or `attributes` for
+ * traces; `service` (the default for metrics), `resource`, `metric` or
+ * `streamID` for metrics. Logs always route by trace id.
+ */
+export type LoadBalancingRoutingKey = "traceID" | "service" | "attributes" | "resource" | "metric" | "streamID";
+/** The otlp exporter settings used for every backend. The endpoint comes from the resolver, so it is not set here. */
+export type LoadBalancingOtlpConfig = Omit<GRPCClientSettings, "endpoint"> & ExporterHelperSettings;
+export type LoadBalancingExporterConfig = ExporterHelperSettings & {
+    protocol?: {
+        otlp: LoadBalancingOtlpConfig;
+    };
+    resolver: LoadBalancingResolver;
+    routing_key?: LoadBalancingRoutingKey;
+    /** With `routing_key: attributes`, the span attributes to route on. */
+    routing_attributes?: string[];
+};
+/**
+ * Sends each trace (or service, or metric stream) to one backend chosen by a
+ * consistent hash over the resolver's backends. Put it on the agents in front
+ * of a multi-replica gateway that runs `tail_sampling`.
+ */
+export declare const LoadBalancingExporter: import("../index.js").ComponentClass<"exporter", "loadbalancing", LoadBalancingExporterConfig>;
+/**
+ * The backends a `loadbalancing` resolver names, as `host:port` where it can:
+ * static hostnames as given, a DNS name with its port, a Kubernetes Service
+ * once per port, a Cloud Map service as `aws-cloud-map://namespace/service`.
+ */
+export declare function loadBalancingEndpoints(resolver: LoadBalancingResolver | undefined): string[];
+export {};
+//# sourceMappingURL=sampling.d.ts.map

package/dist/components/sampling.d.ts.map

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

package/dist/define.d.ts

@@ -2,9 +2,9 @@
  * `defineComponent()`, the one way a collector component type enters this
  * lexicon.
  *
- * The built-in receivers, processors, exporters and extensions are defined
- * through it, and so is a component a team or plugin adds for something chant
- * doesn't ship (a vendor exporter, an in-house processor). Both produce the
+ * The built-in receivers, processors, exporters, connectors and extensions are
+ * defined through it, and so is a component a team or plugin adds for something
+ * chant doesn't ship (a vendor exporter, an in-house processor). Both produce the
  * same kind of class, register in the same table, serialize through the same
  * code and are checked by the same post-synth checks, so there is no second
  * path for a custom component to fall off.
@@ -24,9 +24,15 @@
  *   the top of the emitted YAML, so the file says which schema each
  *   non-built-in component was checked against. The collector ignores it.
  * - OTEL109 fails a build whose custom component has no usable pin.
+ *
+ * Semantic-convention pins (`GENAI_SEMCONV_PIN`) record which version of an
+ * attribute vocabulary a preset's keys follow. They are not tied to a
+ * component type, so `collectorTopology()` reports them under `semconv` for
+ * each component whose config uses that vocabulary, and the serializer writes
+ * one `# chant: semconv` line for them.
  */
 import type { Declarable } from "@intentius/chant/declarable";
-import { type ComponentKind } from "./model.js";
+import { type ComponentKind, type ConnectorSignalPair } from "./model.js";
 /** Where a component's config schema comes from, and which version of it the type follows. */
 export interface SchemaPin {
     /** The package, Go module or URL that defines the component's config, e.g. `@acme/otel-datadog`. */
@@ -41,6 +47,20 @@ export interface SchemaPin {
  * lexicon change like any other, released with this package.
  */
 export declare const COLLECTOR_PIN: SchemaPin;
+/**
+ * The OpenTelemetry GenAI semantic conventions the GenAI preset
+ * (`genAiPipeline()`) follows: which attributes carry prompt and completion
+ * content, and which name the operation, model, tool and token usage.
+ *
+ * v1.41.1 is the last semantic-conventions release that defines `gen_ai.*`
+ * itself. From v1.42.0 the GenAI conventions live in
+ * github.com/open-telemetry/semantic-conventions-genai, which had published no
+ * release when this pin was set; move the pin there once it does. Like
+ * `COLLECTOR_PIN`, it moves only when this package does, and
+ * `collectorTopology()` reports it for every component whose config names a
+ * `gen_ai.` attribute.
+ */
+export declare const GENAI_SEMCONV_PIN: SchemaPin;
 /** A zod-compatible schema: anything with `safeParse`. Keeps zod optional. */
 export interface SafeParseSchema {
     safeParse(value: unknown): {
@@ -70,6 +90,13 @@ export interface ComponentDefinition<K extends ComponentKind = ComponentKind, T
     validate?: ConfigValidator<C>;
     /** Where this component sends or listens, for `collectorTopology()`. */
     endpoints?: (config: C) => string[];
+    /**
+     * Connectors only: the signal pairs the connector supports, as its factory
+     * registers them. OTEL112 checks each pipeline a connector joins against
+     * these, and `collectorTopology()` reports an edge only for a supported
+     * pair. A connector without them is not checked.
+     */
+    connects?: ReadonlyArray<ConnectorSignalPair>;
 }
 /** What a custom component supplies. `builtin` is always false for these. */
 export type CustomComponentOptions<K extends ComponentKind, T extends string, C> = Omit<ComponentDefinition<K, T, C>, "builtin">;

package/dist/define.d.ts.map

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

package/dist/genai.d.ts

@@ -0,0 +1,165 @@
+/**
+ * A collector preset for workloads that emit OpenTelemetry GenAI spans:
+ * content removal, and agent RED and token metrics.
+ *
+ * Attribute keys follow `GENAI_SEMCONV_PIN`. Content (prompts, completions,
+ * system instructions, tool-call arguments and results, retrieval queries and
+ * documents) is deleted from spans, span events and log records unless the
+ * caller passes `keepContent: true`. A `transform` processor deletes the keys;
+ * `redaction` cannot delete one named key while keeping the rest, so it runs
+ * after the transform as a masking backstop on the same keys and for any
+ * value patterns the caller adds.
+ *
+ * Metrics come from a branch taken before any sampling: the traces pipeline
+ * forwards every span to `traces/genai`, which keeps only spans with a
+ * `gen_ai.operation.name`, and feeds `spanmetrics` (calls, errors and
+ * duration by operation, model, tool and error type) and `sum` (input and
+ * output tokens by model). `spanmetrics` counts spans and
+ * cannot sum an attribute, which is why token usage comes from the `sum`
+ * connector.
+ */
+import type { Declarable } from "@intentius/chant/declarable";
+import { type OTelComponent, type SchemaPin } from "./define.js";
+import { type FilterProcessorConfig, type RedactionProcessorConfig, type TransformProcessorConfig } from "./components/filtering.js";
+import { type ForwardConnectorConfig, type SpanMetricsConnectorConfig, type SpanMetricsDimension, type SumConnectorConfig } from "./components/connectors.js";
+import type { Duration } from "./components/common.js";
+import { type CollectorMetric } from "./metric-names.js";
+/** GenAI attributes the preset reads. */
+export declare const GENAI_ATTRIBUTES: Readonly<{
+    readonly operationName: "gen_ai.operation.name";
+    readonly providerName: "gen_ai.provider.name";
+    readonly requestModel: "gen_ai.request.model";
+    readonly responseModel: "gen_ai.response.model";
+    readonly agentName: "gen_ai.agent.name";
+    readonly toolName: "gen_ai.tool.name";
+    readonly inputTokens: "gen_ai.usage.input_tokens";
+    readonly outputTokens: "gen_ai.usage.output_tokens";
+    /** From the general conventions; GenAI spans set it on failure. */
+    readonly errorType: "error.type";
+}>;
+/**
+ * Attributes that carry content: what users and models said, and what tools
+ * were given and returned. The conventions mark each opt-in and sensitive.
+ * `gen_ai.prompt` and `gen_ai.completion` are deprecated, but older
+ * instrumentation still sets them.
+ */
+export declare const GENAI_CONTENT_ATTRIBUTES: readonly string[];
+/**
+ * Indexed content keys some instrumentation libraries write outside the
+ * conventions (`gen_ai.prompt.0.content`, `gen_ai.completion.1.role`). The
+ * index keeps `gen_ai.prompt.name`, a convention attribute, out of it.
+ */
+export declare const GENAI_INDEXED_CONTENT_PATTERN = "^gen_ai\\.(prompt|completion)\\.[0-9]+\\..+$";
+/**
+ * Deprecated content events. Their content is in the log record body, not in
+ * attributes, so the preset deletes `content`, `message` and `tool_calls`
+ * from the body of these events.
+ */
+export declare const GENAI_CONTENT_EVENTS: readonly string[];
+/** The spanmetrics dimensions the preset adds to service.name, span.name, span.kind and status.code. */
+export declare const GENAI_SPAN_METRIC_DIMENSIONS: readonly string[];
+/**
+ * The attribute token sums are split by. One only: the pinned `sum`
+ * connector adds each value once per attribute, so a second one would double
+ * every sum.
+ */
+export declare const GENAI_TOKEN_DIMENSIONS: readonly string[];
+/** The model label on token sums for a span that names no model, so its tokens are counted rather than skipped. */
+export declare const GENAI_UNKNOWN_MODEL = "unknown";
+/** Default duration buckets, sized for model and tool calls rather than HTTP handlers. */
+export declare const GENAI_DURATION_BUCKETS: readonly Duration[];
+/** One metric the preset emits, as the collector names it and as Prometheus exposes it. */
+export type GenAiMetric = CollectorMetric;
+export interface GenAiMetrics {
+    /** Span count, with `status.code` = `STATUS_CODE_ERROR` for errors. */
+    calls: GenAiMetric;
+    duration: GenAiMetric;
+    inputTokens: GenAiMetric;
+    outputTokens: GenAiMetric;
+}
+export interface GenAiMetricsOptions {
+    /** Prefix of the emitted metric names. Default `genai`, outside the conventions' own `gen_ai` namespace. */
+    namespace?: string;
+    /** Dimensions added to the span metrics beyond the GenAI ones. */
+    dimensions?: SpanMetricsDimension[];
+}
+/**
+ * The metrics `genAiPipeline()` emits for the given options: names,
+ * Prometheus names and dimensions. A dashboard reads this instead of
+ * repeating the names, so renaming the namespace moves the panels with it.
+ */
+export declare function genAiMetrics(options?: GenAiMetricsOptions): GenAiMetrics;
+type Exporter = OTelComponent<"exporter", string, any>;
+type Processor = OTelComponent<"processor", string, any>;
+export interface GenAiComponentsOptions extends GenAiMetricsOptions {
+    /**
+     * Keep content attributes and bodies. Default false: they are deleted.
+     * Setting this is the one way to keep prompts and completions, so a config
+     * that keeps them says so where it is declared.
+     */
+    keepContent?: boolean;
+    /** More attribute keys that hold content, deleted along with the convention ones. */
+    contentAttributes?: string[];
+    /** RE2 patterns masked in every attribute value (redaction `blocked_values`), whether content is kept or not. */
+    maskValues?: string[];
+    /** Hash masked values with this function instead of writing `****`. */
+    hashFunction?: RedactionProcessorConfig["hash_function"];
+    /** Duration histogram buckets. Default `GENAI_DURATION_BUCKETS`. */
+    buckets?: Duration[];
+    /** How often span and token metrics are flushed. Default 15s. */
+    metricsFlushInterval?: Duration;
+}
+export interface GenAiComponents {
+    /** Deletes content keys and event bodies (`transform/genai_content`). Absent when content is kept. */
+    contentRemoval?: OTelComponent<"processor", "transform", TransformProcessorConfig>;
+    /**
+     * Masks what is left (`redaction/genai_content`): the content keys, as a
+     * backstop behind the transform, and `maskValues`. Absent when content is
+     * kept and nothing is masked.
+     */
+    redaction?: OTelComponent<"processor", "redaction", RedactionProcessorConfig>;
+    /** Content removal then redaction, in the order a pipeline should run them. */
+    processors: Processor[];
+    /** Carries every span from the traces pipeline to `traces/genai` (`forward/genai`). */
+    forward: OTelComponent<"connector", "forward", ForwardConnectorConfig>;
+    /** Keeps only GenAI spans in `traces/genai` (`filter/genai_spans`). */
+    genAiSpans: OTelComponent<"processor", "filter", FilterProcessorConfig>;
+    /** Calls, errors and duration per GenAI dimension (`spanmetrics/genai`). */
+    spanMetrics: OTelComponent<"connector", "spanmetrics", SpanMetricsConnectorConfig>;
+    /** Input and output token sums (`sum/genai_tokens`). */
+    tokenUsage: OTelComponent<"connector", "sum", SumConnectorConfig>;
+    metrics: GenAiMetrics;
+    /** The semantic conventions the attribute keys follow. */
+    semconv: SchemaPin;
+}
+/** The pieces of the GenAI preset, for wiring into pipelines you declare yourself. */
+export declare function genAiComponents(options?: GenAiComponentsOptions): GenAiComponents;
+export interface GenAiPipelineOptions extends GenAiComponentsOptions {
+    /** Where traces go. Default: one `debug` exporter at `basic` verbosity. */
+    traceExporters?: Exporter[];
+    /** Where the span and token metrics go. Default: the same `debug` exporter. */
+    metricExporters?: Exporter[];
+    /** Where logs (and events sent as logs) go. Default: the same `debug` exporter. */
+    logExporters?: Exporter[];
+    /** Give logs a pipeline, so event-based content is removed too. Default: true. */
+    logs?: boolean;
+    /**
+     * Processors that thin exported traces, such as `tail_sampling`. They run
+     * in a `traces/sampled` pipeline after the metrics branch, so metrics still
+     * count every span.
+     */
+    sampling?: Processor[];
+    /** Serve `health_check` on 0.0.0.0:13133. Default: true. */
+    healthCheck?: boolean;
+}
+/**
+ * The entities of an OTLP collector for GenAI workloads: an `otlp` receiver
+ * on 4317 and 4318; `memory_limiter`, content removal and `batch` on traces
+ * and logs; a `traces/genai` branch that turns GenAI spans into metrics
+ * before any sampling; and a `metrics/genai` pipeline that exports them. Pass
+ * the result to `collectorYaml`, or use `genAiComponents()` to wire the
+ * pieces into pipelines of your own.
+ */
+export declare function genAiPipeline(options?: GenAiPipelineOptions): Declarable[];
+export {};
+//# sourceMappingURL=genai.d.ts.map

package/dist/genai.d.ts.map

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

package/dist/index.d.ts

@@ -2,11 +2,14 @@ export { otelPlugin } from "./plugin.js";
 export { otelSerializer } from "./serializer.js";
 export * from "./components/index.js";
 export { Pipeline, Service, PIPELINE_TYPE, SERVICE_TYPE, isPipelineEntity, isServiceEntity, type ComponentRef, type PipelineProps, type PipelineEntity, type ServiceProps, type ServiceEntity, type ServiceTelemetry, } from "./pipeline.js";
-export { defineComponent, definitionFor, definitionOf, registeredDefinitions, componentEntityType, isOTelComponent, COLLECTOR_PIN, type SchemaPin, type SafeParseSchema, type ConfigValidator, type ComponentDefinition, type CustomComponentOptions, type ComponentProps, type ComponentClass, type OTelComponent, } from "./define.js";
+export { defineComponent, definitionFor, definitionOf, registeredDefinitions, componentEntityType, isOTelComponent, COLLECTOR_PIN, GENAI_SEMCONV_PIN, type SchemaPin, type SafeParseSchema, type ConfigValidator, type ComponentDefinition, type CustomComponentOptions, type ComponentProps, type ComponentClass, type OTelComponent, } from "./define.js";
 export * from "./model.js";
 export { buildCollectorConfig, collectorYaml, componentConfig, type BuiltCollector } from "./collector.js";
 export { emitCollectorYaml, type EmitOptions } from "./yaml.js";
 export { validateCollectorConfig, validateCollectorEntities, type CollectorIssue, type CollectorIssueCode, } from "./validate-config.js";
-export { collectorTopology, collectorTopologyOf, type CollectorTopology, type TopologyPipeline, type TopologyComponent, type TopologyExporter, } from "./topology.js";
+export { collectorTopology, collectorTopologyOf, type CollectorTopology, type TopologyPipeline, type TopologyComponent, type TopologyExporter, type TopologyEdge, type SemconvUsage, } from "./topology.js";
+export { semconvUsage, SEMCONV_VOCABULARIES, type SemconvVocabulary } from "./semconv.js";
 export { otlpCollector, collectorEndpoints, COLLECTOR_IMAGE, COLLECTOR_CONFIG_PATH, type OtlpCollectorOptions, type CollectorPort, type CollectorEndpoints, } from "./platform.js";
+export { genAiPipeline, genAiComponents, genAiMetrics, GENAI_ATTRIBUTES, GENAI_CONTENT_ATTRIBUTES, GENAI_CONTENT_EVENTS, GENAI_INDEXED_CONTENT_PATTERN, GENAI_SPAN_METRIC_DIMENSIONS, GENAI_TOKEN_DIMENSIONS, GENAI_DURATION_BUCKETS, GENAI_UNKNOWN_MODEL, type GenAiPipelineOptions, type GenAiComponentsOptions, type GenAiComponents, type GenAiMetricsOptions, type GenAiMetrics, type GenAiMetric, } from "./genai.js";
+export { spanMetricsNames, prometheusMetricName, prometheusLabel, SPANMETRICS_DEFAULT_DIMENSIONS, SPANMETRICS_DEFAULT_NAMESPACE, SPAN_STATUS_ERROR, type CollectorMetric, type SpanMetricsNames, type SpanMetricsNamingConfig, type PrometheusNaming, } from "./metric-names.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,cAAc,cAAc,CAAC;AAG7B,OAAO,EACL,QAAQ,EACR,OAAO,EACP,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,UAAU,CAAC;AAGlB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,cAAc,cAAc,CAAC;AAG7B,OAAO,EACL,QAAQ,EACR,OAAO,EACP,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,UAAU,CAAC;AAGlB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGvF,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,6BAA6B,EAC7B,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,8BAA8B,EAC9B,6BAA6B,EAC7B,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC"}

package/dist/integrity.json

@@ -1,25 +1,26 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "4a8d9d556fdeb81a52a09067ab474738a68a39295bad9cb7371a9f08ac88433c",
-    "meta.json": "71cb0ffb29568f7c915c02f0883149af2e972228502885a847ec2989feca4a0a",
+    "manifest.json": "d55dfd02a3f59eed669170add564fa591994a8c4dcc74754b52ea5b1f4560bb9",
+    "meta.json": "664490c2bee6c839f22994b789adc4708b01a37195f9c193dfb3c974959c5d74",
     "types/index.d.ts": "a1070fd1cb3e8d8a9002fc5a75a80b3bdda02965be351e8aed2dbc2f63d36e3c",
     "rules/component-id-syntax.ts": "95f507614d2626159140d906bce9d086e8ecba18ede22f5ddfbda13ac1c08169",
     "rules/literal-credential.ts": "7a48049b25a157cb36942399d5fcec810e9aba4c6fc318fb5b098296eb37069c",
     "rules/otel-ast.ts": "cf286102f778bd010d130ad8de6adc279de517fffffcd49d7cfb3c419b4bec66",
-    "rules/otel-helpers.ts": "10012bfd7e90d5db57e759b3a34ce2e6c22a66b545f5952683537c90793d4d03",
-    "rules/otel101.ts": "28315d1431075fd830fdfd9bcc599e46d92db287f438ce3b7cfede004c54e8e0",
+    "rules/otel-helpers.ts": "22f5ed00f5cf33638558eb4363c7deeeefa2cdc3e666404f5235caf471fb1466",
+    "rules/otel101.ts": "9a9d5f79403fb07e78752f904741ab4cec8c0f00975b44fe0b6eace63fda4c13",
     "rules/otel102.ts": "4b3612bc28097e46b33d6f7b187903fe1ecba4e5bda88189e9b1a5aaf37062a8",
-    "rules/otel103.ts": "2f5f5b343c46535450da7845e811a0bcdcf49842cf336358e42c2716edd2506c",
+    "rules/otel103.ts": "8e404d7c7104a678de6351a4a4caf0aab1e6ae63c810cce889975bbeebc1a632",
     "rules/otel104.ts": "f7f3a7110cb9d1565b5d39ee18caa0029cfe3a1fafb6118dfcdaf70ea81fd75d",
     "rules/otel105.ts": "f1eaf43ac59ff300f970eda637addfc6c60d16860f8b675b0f0a84f8af316561",
     "rules/otel106.ts": "7b6b5c5f1a1c15a114624c0b9f45af9db02b8b792c616c0e909136083ac93e6d",
     "rules/otel107.ts": "db5d7c8a23d510159e203ed101ce71b23f1e0319b60ee4b1445fe7a0d973d978",
     "rules/otel108.ts": "5eddca667b3ec563a1a7bc745139738d438c4307b4861b999a4d8cff975856b6",
     "rules/otel109.ts": "db025b5f09cc8c5199b420fdfd6e4bae0dd5abd1860903d8c9b4d625162a32b9",
-    "skills/chant-otel.md": "16c6ccce89122de3f767f089ebcce7ca6c64ce3ef3db4f5329aa8f754eb72212",
+    "rules/otel112.ts": "0a6d9a7d6ba281f3b011dde18646f7c15280dcb8cfeddaa6d20c6080a2c92cb0",
+    "skills/chant-otel.md": "ffb9463406afe9a5b275e71cd3af4bb57bb181bec77ec9a1d4e0bf8d453cb8dd",
     "skills/chant-otel-custom-components.md": "82e53bb482281f79b428e66fb80a1c194ead74a1a34a88bbebb11c6ad5493258",
     "skills/chant-otel-platforms.md": "c90836952dc5c88d668b890152a5063bdb656bce73fc7fa3233a3ea58ad85686"
   },
-  "composite": "fefa5fc236297ea680de2dec9e0ce389d4961b6fec5446a042586e72478e203e"
+  "composite": "02a6eb470ce218c6060cb8b8900803ad4a7701aaaf09ef0249e2a2cd5752ee92"
 }

package/dist/lint/audit-catalog.d.ts

@@ -2,7 +2,8 @@
  * The otel lexicon's chant audit catalog, contributed via
  * `otelPlugin.auditCatalog()` (#687, #1346).
  *
- * OTEL101-OTEL106 read the emitted collector YAML, so they are `yamlBased`.
+ * OTEL101-OTEL106 and OTEL112 read the emitted collector YAML, so they are
+ * `yamlBased`.
  * OTEL107-OTEL109 read the declared entities (a component's definition, its
  * schema pin), which a standalone YAML file does not carry, so they are
  * constructed with `yamlBased: false`. The two source-level lint rules are

package/dist/lint/audit-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-catalog.d.ts","sourceRoot":"","sources":["../../src/lint/audit-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAW1E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA+ErD,CAAC"}
+{"version":3,"file":"audit-catalog.d.ts","sourceRoot":"","sources":["../../src/lint/audit-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAW1E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAuFrD,CAAC"}

package/dist/lint/post-synth/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAWvE,eAAO,MAAM,eAAe,EAAE,cAAc,EAU3C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAYvE,eAAO,MAAM,eAAe,EAAE,cAAc,EAW3C,CAAC"}

package/dist/lint/post-synth/otel-helpers.d.ts

@@ -15,7 +15,7 @@ export declare function collectorConfigs(ctx: PostSynthContext): Array<{
     source: string;
     config: CollectorConfig;
 }>;
-/** Diagnostics for one config-level code (OTEL101-OTEL106) across every collector config in the output. */
+/** Diagnostics for one config-level code (OTEL101-OTEL106, OTEL112) across every collector config in the output. */
 export declare function configDiagnostics(ctx: PostSynthContext, code: CollectorIssueCode): PostSynthDiagnostic[];
 /** Diagnostics for one entity-level code (OTEL107-OTEL109) over the build's otel entities. */
 export declare function entityDiagnostics(ctx: PostSynthContext, code: CollectorIssueCode): PostSynthDiagnostic[];

package/dist/lint/post-synth/otel-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otel-helpers.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/otel-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAI9F,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAsD,KAAK,kBAAkB,EAAuB,MAAM,uBAAuB,CAAC;AAEzI;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAwB1G;AAYD,2GAA2G;AAC3G,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,EAAE,CAMxG;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,EAAE,CAKxG"}
+{"version":3,"file":"otel-helpers.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/otel-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAI9F,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAsD,KAAK,kBAAkB,EAAuB,MAAM,uBAAuB,CAAC;AAEzI;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAwB1G;AAYD,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,EAAE,CAMxG;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,kBAAkB,GAAG,mBAAmB,EAAE,CAKxG"}