@intentius/chant-lexicon-otel 0.100.0 → 0.101.0

package/dist/genai.d.ts

@@ -17,11 +17,26 @@
  * output tokens by model). `spanmetrics` counts spans and
  * cannot sum an attribute, which is why token usage comes from the `sum`
  * connector.
+ *
+ * With `clientMetrics: "derive"`, a `signaltometrics` connector on the same
+ * branch also emits the two client metrics the conventions define at the pin,
+ * `gen_ai.client.operation.duration` and `gen_ai.client.token.usage`, under
+ * their own names, attributes, units and buckets. `clientMetrics:
+ * "passthrough"` derives nothing and relies on the SDK to send them. Either
+ * way a `metrics` pipeline passes the SDK's OTLP metrics through. Without the
+ * option the output is what it was before the option existed.
+ *
+ * `sum` emits delta sums. The `prometheus` exporter accumulates them itself,
+ * but `prometheusremotewrite` drops them, and some OTLP backends store only
+ * cumulative data; `signaltometrics` emits delta histograms too.
+ * `deltaToCumulative` puts a `deltatocumulative` processor on `metrics/genai`
+ * for those. It is on by default only with `clientMetrics: "derive"`, so a
+ * config built without either option is unchanged.
  */
 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 ForwardConnectorConfig, type SignalToMetricsConnectorConfig, 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. */
@@ -36,6 +51,11 @@ export declare const GENAI_ATTRIBUTES: Readonly<{
     readonly outputTokens: "gen_ai.usage.output_tokens";
     /** From the general conventions; GenAI spans set it on failure. */
     readonly errorType: "error.type";
+    /** A metric attribute only: `input` or `output` on `gen_ai.client.token.usage`. */
+    readonly tokenType: "gen_ai.token.type";
+    /** From the general conventions: the GenAI server's host and port. */
+    readonly serverAddress: "server.address";
+    readonly serverPort: "server.port";
 }>;
 /**
  * Attributes that carry content: what users and models said, and what tools
@@ -50,6 +70,32 @@ export declare const GENAI_CONTENT_ATTRIBUTES: readonly string[];
  * 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]+\\..+$";
+/**
+ * Attributes that take a new value per response, tool call, conversation,
+ * session or user. As a metric attribute, each one starts new time series
+ * for every value, so OTEL116 reports them (and the content keys above)
+ * wherever a connector splits a metric by one.
+ *
+ * At `GENAI_SEMCONV_PIN` (semantic-conventions v1.41.1) the conventions
+ * define `gen_ai.conversation.id`, `gen_ai.response.id` and
+ * `gen_ai.tool.call.id` in `model/gen-ai/registry.yaml`, `session.id` in
+ * `model/session/registry.yaml`, `user.id` in `model/user/registry.yaml` and
+ * `enduser.id` in `model/enduser/registry.yaml`. None of them is an attribute
+ * of any GenAI metric there (`model/gen-ai/metrics.yaml`).
+ * `gen_ai.request.previous_response.id` and `gen_ai.memory.record.id` are
+ * not at the pin: they come from the unreleased main of
+ * github.com/open-telemetry/semantic-conventions-genai, and are listed
+ * because instrumentation already sets them. Keys added with that pin
+ * (chant #3044) go here too.
+ */
+export declare const GENAI_HIGH_CARDINALITY_ATTRIBUTES: readonly string[];
+/**
+ * Why a key must not be a metric attribute: `"identifier"` for a key in
+ * `GENAI_HIGH_CARDINALITY_ATTRIBUTES`, `"content"` for a content key
+ * (`GENAI_CONTENT_ATTRIBUTES` or the indexed pattern), which is unbounded
+ * and sensitive too. Undefined for any other key.
+ */
+export declare function genAiCardinalityRisk(key: string): "identifier" | "content" | undefined;
 /**
  * Deprecated content events. Their content is in the log record body, not in
  * attributes, so the preset deletes `content`, `message` and `tool_calls`
@@ -68,20 +114,75 @@ export declare const GENAI_TOKEN_DIMENSIONS: readonly string[];
 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[];
+/**
+ * Dimensions `providerDimensions: true` adds to `genai.calls` and
+ * `genai.duration`. The token sums keep the model alone (see
+ * `GENAI_TOKEN_DIMENSIONS`); `gen_ai.client.token.usage` splits tokens by both.
+ */
+export declare const GENAI_PROVIDER_DIMENSIONS: readonly string[];
+/** The client metrics the conventions define that one span carries enough to derive. */
+export declare const GENAI_CLIENT_METRIC_NAMES: Readonly<{
+    readonly operationDuration: "gen_ai.client.operation.duration";
+    readonly tokenUsage: "gen_ai.client.token.usage";
+}>;
+/** The values of `gen_ai.token.type` on `gen_ai.client.token.usage`. */
+export declare const GENAI_TOKEN_TYPES: Readonly<{
+    readonly input: "input";
+    readonly output: "output";
+}>;
+/**
+ * The attributes the conventions give both client metrics: required
+ * (`gen_ai.operation.name`, `gen_ai.provider.name`), conditionally required
+ * (`gen_ai.request.model`, `error.type`) and recommended
+ * (`gen_ai.response.model`, `server.address`, `server.port`).
+ * `gen_ai.client.token.usage` adds `gen_ai.token.type`.
+ */
+export declare const GENAI_CLIENT_METRIC_ATTRIBUTES: readonly string[];
+/** The bucket boundaries the conventions advise for `gen_ai.client.operation.duration`, in seconds. */
+export declare const GENAI_CLIENT_DURATION_BUCKETS: readonly number[];
+/** The bucket boundaries the conventions advise for `gen_ai.client.token.usage`, in tokens. */
+export declare const GENAI_CLIENT_TOKEN_BUCKETS: readonly number[];
+/**
+ * Where the conventions' client metrics come from. `derive`: the collector
+ * builds them from spans. `passthrough`: the SDK already sends them, so the
+ * collector passes them on and derives nothing, since both would double
+ * every series.
+ */
+export type GenAiClientMetricsSource = "derive" | "passthrough";
 /** One metric the preset emits, as the collector names it and as Prometheus exposes it. */
 export type GenAiMetric = CollectorMetric;
+/** The conventions' client metrics, under their own names. */
+export interface GenAiClientMetrics {
+    source: GenAiClientMetricsSource;
+    /** `gen_ai.client.operation.duration`, a histogram in seconds. Its `_count` is the operation count. */
+    operationDuration: GenAiMetric;
+    /** `gen_ai.client.token.usage`, a histogram in tokens; select `gen_ai_token_type` `input` or `output`. */
+    tokenUsage: GenAiMetric;
+}
 export interface GenAiMetrics {
     /** Span count, with `status.code` = `STATUS_CODE_ERROR` for errors. */
     calls: GenAiMetric;
     duration: GenAiMetric;
     inputTokens: GenAiMetric;
     outputTokens: GenAiMetric;
+    /** The conventions' client metrics. Present only when `clientMetrics` is set. */
+    client?: GenAiClientMetrics;
 }
 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[];
+    /** Add `gen_ai.provider.name` and `gen_ai.response.model` to `genai.calls` and `genai.duration`. Default false. */
+    providerDimensions?: boolean;
+    /**
+     * Also produce the conventions' client metrics, `gen_ai.client.operation.duration`
+     * and `gen_ai.client.token.usage`. `derive` builds them from spans;
+     * `passthrough` expects the SDK to send them. Either adds a `metrics`
+     * pipeline that passes the SDK's OTLP metrics through. Unset (the default)
+     * leaves the output as it was. The `genai.*` metrics are emitted either way.
+     */
+    clientMetrics?: GenAiClientMetricsSource;
 }
 /**
  * The metrics `genAiPipeline()` emits for the given options: names,
@@ -128,16 +229,43 @@ export interface GenAiComponents {
     spanMetrics: OTelComponent<"connector", "spanmetrics", SpanMetricsConnectorConfig>;
     /** Input and output token sums (`sum/genai_tokens`). */
     tokenUsage: OTelComponent<"connector", "sum", SumConnectorConfig>;
+    /**
+     * `gen_ai.client.operation.duration` and `gen_ai.client.token.usage` from
+     * spans (`signaltometrics/genai_client`). Present with `clientMetrics: "derive"`;
+     * wire it like `spanMetrics`.
+     */
+    clientMetrics?: OTelComponent<"connector", "signaltometrics", SignalToMetricsConnectorConfig>;
+    /**
+     * Drops the SDK's own copies of the derived client metrics from metrics
+     * passed through from the SDK (`filter/genai_sdk_client`), so each series
+     * is counted once. Present with `clientMetrics: "derive"`; put it on the
+     * pipeline that receives the SDK's OTLP metrics.
+     */
+    sdkClientMetricsFilter?: OTelComponent<"processor", "filter", FilterProcessorConfig>;
     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;
+/**
+ * Metric exporters that take delta sums and histograms as they are: the
+ * `prometheus` exporter accumulates them itself, and `debug` prints them.
+ * Any other exporter gets cumulative data under `deltaToCumulative: "auto"`.
+ * `prometheusremotewrite`, for one, drops non-cumulative monotonic sums,
+ * histograms and summaries (its README at collector-contrib v0.130.0).
+ */
+export declare const DELTA_READY_EXPORTERS: readonly string[];
+/** Whether `deltaToCumulative` puts a `deltatocumulative` processor on `metrics/genai` for these exporters. */
+export declare function genAiNeedsDeltaToCumulative(setting: GenAiPipelineOptions["deltaToCumulative"], metricExporters: readonly Exporter[]): boolean;
 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. */
+    /**
+     * Where the span and token metrics go, and with `clientMetrics` the SDK's
+     * metrics too. Default: the same `debug` exporter. See `deltaToCumulative`
+     * for exporters that need cumulative data.
+     */
     metricExporters?: Exporter[];
     /** Where logs (and events sent as logs) go. Default: the same `debug` exporter. */
     logExporters?: Exporter[];
@@ -151,6 +279,21 @@ export interface GenAiPipelineOptions extends GenAiComponentsOptions {
     sampling?: Processor[];
     /** Serve `health_check` on 0.0.0.0:13133. Default: true. */
     healthCheck?: boolean;
+    /**
+     * Put a `deltatocumulative/genai` processor in front of `batch` on
+     * `metrics/genai`, so the delta token sums of the `sum` connector, and with
+     * `clientMetrics: "derive"` the delta histograms of `signaltometrics`, reach
+     * exporters as cumulative data. The span metrics are cumulative already and
+     * pass through unchanged. `"auto"`: when a metric exporter is not in
+     * `DELTA_READY_EXPORTERS` (`prometheus`, `debug`), such as
+     * `prometheusremotewrite` or `otlp`. `true`: always. `false`: never, such
+     * as for an OTLP backend that wants deltas. Unset: `"auto"` with
+     * `clientMetrics: "derive"`, otherwise `false`, which is the output from
+     * before the option existed. The processor keeps running totals in memory,
+     * so a collector behind a load balancer needs each stream to reach one
+     * replica.
+     */
+    deltaToCumulative?: boolean | "auto";
 }
 /**
  * The entities of an OTLP collector for GenAI workloads: an `otlp` receiver

package/dist/genai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"genai.d.ts","sourceRoot":"","sources":["../src/genai.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"genai.d.ts","sourceRoot":"","sources":["../src/genai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAKjF,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAE9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAKL,KAAK,sBAAsB,EAE3B,KAAK,8BAA8B,EAEnC,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAwD,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAI5G,yCAAyC;AACzC,eAAO,MAAM,gBAAgB;;;;;;;;;IAS3B,mEAAmE;;IAEnE,mFAAmF;;IAEnF,sEAAsE;;;EAG7D,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAUpD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,iDAAiD,CAAC;AAE5F;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iCAAiC,EAAE,SAAS,MAAM,EAS7D,CAAC;AAIH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAItF;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAMhD,CAAC;AAIH,wGAAwG;AACxG,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAKxD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAmD,CAAC;AAExG,mHAAmH;AACnH,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,EAAE,SAAS,QAAQ,EAWpD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAGrD,CAAC;AAIH,wFAAwF;AACxF,eAAO,MAAM,yBAAyB;;;EAG3B,CAAC;AAEZ,wEAAwE;AACxE,eAAO,MAAM,iBAAiB;;;EAA+D,CAAC;AAE9F;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAQ1D,CAAC;AAEH,uGAAuG;AACvG,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAEzD,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAEtD,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEhE,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAE1C,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,wBAAwB,CAAC;IACjC,uGAAuG;IACvG,iBAAiB,EAAE,WAAW,CAAC;IAC/B,0GAA0G;IAC1G,UAAU,EAAE,WAAW,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,WAAW,CAAC;IAC1B,iFAAiF;IACjF,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,4GAA4G;IAC5G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,mHAAmH;IACnH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,wBAAwB,CAAC;CAC1C;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CA+B5E;AA2CD,KAAK,QAAQ,GAAG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AACvD,KAAK,SAAS,GAAG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAEzD,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,iHAAiH;IACjH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uEAAuE;IACvE,YAAY,CAAC,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC;IACzD,oEAAoE;IACpE,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;IACrB,iEAAiE;IACjE,oBAAoB,CAAC,EAAE,QAAQ,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,sGAAsG;IACtG,cAAc,CAAC,EAAE,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,wBAAwB,CAAC,CAAC;IACnF;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC,WAAW,EAAE,WAAW,EAAE,wBAAwB,CAAC,CAAC;IAC9E,+EAA+E;IAC/E,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,uFAAuF;IACvF,OAAO,EAAE,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC;IACvE,uEAAuE;IACvE,UAAU,EAAE,aAAa,CAAC,WAAW,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IACxE,4EAA4E;IAC5E,WAAW,EAAE,aAAa,CAAC,WAAW,EAAE,aAAa,EAAE,0BAA0B,CAAC,CAAC;IACnF,wDAAwD;IACxD,UAAU,EAAE,aAAa,CAAC,WAAW,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;IAClE;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC,WAAW,EAAE,iBAAiB,EAAE,8BAA8B,CAAC,CAAC;IAC9F;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,aAAa,CAAC,WAAW,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IACrF,OAAO,EAAE,YAAY,CAAC;IACtB,0DAA0D;IAC1D,OAAO,EAAE,SAAS,CAAC;CACpB;AAkBD,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAkHrF;AAmDD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAA2C,CAAC;AAE/F,+GAA+G;AAC/G,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,EAClD,eAAe,EAAE,SAAS,QAAQ,EAAE,GACnC,OAAO,CAKT;AAED,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAClE,2EAA2E;IAC3E,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC5B;;;;OAIG;IACH,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC7B,mFAAmF;IACnF,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC1B,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,UAAU,EAAE,CA6F9E"}

package/dist/index.d.ts

@@ -6,10 +6,12 @@ export { defineComponent, definitionFor, definitionOf, registeredDefinitions, co
 export * from "./model.js";
 export { buildCollectorConfig, collectorYaml, componentConfig, type BuiltCollector } from "./collector.js";
 export { emitCollectorYaml, type EmitOptions } from "./yaml.js";
+export { configMapCollectorConfigs, describeConfigMapConfig, parseCollectorConfig, type ConfigMapCollectorConfig } from "./configmap.js";
 export { validateCollectorConfig, validateCollectorEntities, type CollectorIssue, type CollectorIssueCode, } from "./validate-config.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 { NodeAgent, nodeAgentPropsProblem, type NodeAgentProps, type NodeAgentMembers, type NodeAgentInstance } from "./composites/index.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 { genAiPipeline, genAiComponents, genAiMetrics, GENAI_ATTRIBUTES, GENAI_CONTENT_ATTRIBUTES, GENAI_CONTENT_EVENTS, GENAI_INDEXED_CONTENT_PATTERN, GENAI_HIGH_CARDINALITY_ATTRIBUTES, genAiCardinalityRisk, GENAI_SPAN_METRIC_DIMENSIONS, GENAI_TOKEN_DIMENSIONS, GENAI_DURATION_BUCKETS, GENAI_UNKNOWN_MODEL, GENAI_PROVIDER_DIMENSIONS, GENAI_CLIENT_METRIC_NAMES, GENAI_CLIENT_METRIC_ATTRIBUTES, GENAI_CLIENT_DURATION_BUCKETS, GENAI_CLIENT_TOKEN_BUCKETS, GENAI_TOKEN_TYPES, DELTA_READY_EXPORTERS, genAiNeedsDeltaToCumulative, type GenAiPipelineOptions, type GenAiComponentsOptions, type GenAiComponents, type GenAiMetricsOptions, type GenAiMetrics, type GenAiMetric, type GenAiClientMetrics, type GenAiClientMetricsSource, } 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,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"}
+{"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,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACtI,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,EAAE,SAAS,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGpI,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,iCAAiC,EACjC,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,8BAA8B,EAC9B,6BAA6B,EAC7B,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,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/init-templates.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `chant init --lexicon otel` scaffolds.
+ *
+ * - default: OTLP in, `memory_limiter` and `batch`, traces to an OTLP
+ *   backend and logs to `debug`, with a `health_check`.
+ * - `k8s-agent`: the config a per-node agent runs as a Kubernetes DaemonSet
+ *   (`NodeAgent`): OTLP from the node's pods, host metrics and container
+ *   logs, Kubernetes metadata on all of it, traces and logs on to a gateway
+ *   and metrics served for Prometheus to scrape on each node.
+ * - `genai`: a collector for an agent service instrumented with the
+ *   OpenTelemetry GenAI conventions (`genAiPipeline`): prompt and completion
+ *   content removed, RED and token metrics and the conventions' client
+ *   metrics derived from every GenAI span, traces to Tempo.
+ *
+ * Each template builds with the otel lexicon alone, which is all
+ * `chant init --lexicon otel` installs.
+ */
+import type { InitTemplateSet } from "@intentius/chant/lexicon";
+export declare const DEFAULT_TEMPLATE: InitTemplateSet;
+export declare const K8S_AGENT_TEMPLATE: InitTemplateSet;
+export declare const GENAI_TEMPLATE: InitTemplateSet;
+/** The template names `chant init --lexicon otel --template <name>` takes, besides the default. */
+export declare const TEMPLATE_NAMES: readonly ["k8s-agent", "genai"];
+//# sourceMappingURL=init-templates.d.ts.map

package/dist/init-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../src/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAmHhE,eAAO,MAAM,gBAAgB,EAAE,eAE9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,eAEhC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,eAE5B,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,cAAc,iCAAkC,CAAC"}

package/dist/integrity.json

@@ -1,13 +1,13 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "0d3aebbc1678b4e82762ab6465eb538bf7d9f59f48a1ab208100a6db7b348b38",
-    "meta.json": "664490c2bee6c839f22994b789adc4708b01a37195f9c193dfb3c974959c5d74",
+    "manifest.json": "00c193d9c673fad45a3a6f1fb866d8a6b0ab2b3ef7b5c580eb0a211f18e4a8e3",
+    "meta.json": "884042882639c4dd91a8a97b9826869de90553ec4420fd1e6a0b08bb16fc5181",
     "types/index.d.ts": "a1070fd1cb3e8d8a9002fc5a75a80b3bdda02965be351e8aed2dbc2f63d36e3c",
     "rules/component-id-syntax.ts": "95f507614d2626159140d906bce9d086e8ecba18ede22f5ddfbda13ac1c08169",
     "rules/literal-credential.ts": "48a235a772476bd56cdaaae3f6e90f8a9b2675317be6dcb48c89e54d2f7a5708",
     "rules/otel-ast.ts": "cf286102f778bd010d130ad8de6adc279de517fffffcd49d7cfb3c419b4bec66",
-    "rules/otel-helpers.ts": "22f5ed00f5cf33638558eb4363c7deeeefa2cdc3e666404f5235caf471fb1466",
+    "rules/otel-helpers.ts": "83976d3eae20d7532f59b2cc0bbdf4535e7de5c4ba9abf2915cf2974f43dd241",
     "rules/otel101.ts": "9a9d5f79403fb07e78752f904741ab4cec8c0f00975b44fe0b6eace63fda4c13",
     "rules/otel102.ts": "4b3612bc28097e46b33d6f7b187903fe1ecba4e5bda88189e9b1a5aaf37062a8",
     "rules/otel103.ts": "8e404d7c7104a678de6351a4a4caf0aab1e6ae63c810cce889975bbeebc1a632",
@@ -18,9 +18,14 @@
     "rules/otel108.ts": "5eddca667b3ec563a1a7bc745139738d438c4307b4861b999a4d8cff975856b6",
     "rules/otel109.ts": "db025b5f09cc8c5199b420fdfd6e4bae0dd5abd1860903d8c9b4d625162a32b9",
     "rules/otel112.ts": "0a6d9a7d6ba281f3b011dde18646f7c15280dcb8cfeddaa6d20c6080a2c92cb0",
-    "skills/chant-otel.md": "f77c11e59c9ee782525fd28b1450397754762c045f917735b7d2697a4ee608b5",
+    "rules/otel113.ts": "7a62792f391fb8e96da0275442d60e597f1cbac4bcc73066c31f13f588fdd204",
+    "rules/otel114.ts": "58fa6380c6999cf1ba50f0159745c52aec1d44074c861b0c46e11eaccd0b1452",
+    "rules/otel115.ts": "09b20b93af83e7ebed0d189bfc34ffea51cb727a495d06fc4421e00e641633e2",
+    "rules/otel116.ts": "7a5b4b8ab497616549cdc748857a9ab367d83b23d97def4236d43ea85fa2b83c",
+    "rules/otel117.ts": "520a4316e42917f50e5541b0b0314eeb043d96186ec9332afc71a79fecc67fef",
+    "skills/chant-otel.md": "f24bee06a4286785e9a0e978dc6507a0932567c22541e65d7aaa4a91813a1345",
     "skills/chant-otel-custom-components.md": "82e53bb482281f79b428e66fb80a1c194ead74a1a34a88bbebb11c6ad5493258",
     "skills/chant-otel-platforms.md": "c90836952dc5c88d668b890152a5063bdb656bce73fc7fa3233a3ea58ad85686"
   },
-  "composite": "4ac8f418f9c0caebe31a3ff2c012cb32e119b8f04cffaf6fc618869585eddb88"
+  "composite": "df9754e540b750994772eee1488d9627e7b478f2cd613ba54f143753014cfe68"
 }

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

@@ -2,7 +2,7 @@
  * The otel lexicon's chant audit catalog, contributed via
  * `otelPlugin.auditCatalog()` (#687, #1346).
  *
- * OTEL101-OTEL106 and OTEL112 read the emitted collector YAML, so they are
+ * OTEL101-OTEL106 and OTEL112-OTEL117 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

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;;;;;;;;;;GAUG;AAEH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAW1E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAuFrD,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,CA+HrD,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;AAYvE,eAAO,MAAM,eAAe,EAAE,cAAc,EAW3C,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;AAiBvE,eAAO,MAAM,eAAe,EAAE,cAAc,EAgB3C,CAAC"}

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

@@ -5,17 +5,40 @@
 import type { PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
 import { type CollectorConfig } from "../../model.js";
 import { type CollectorIssueCode } from "../../validate-config.js";
-/**
- * Every collector config in the output: the otel lexicon's own, and any YAML
- * document shaped like one. Parsed with js-yaml rather than `ctx.docs`,
- * because collector configs are written with flow lists (`[otlp, batch]`)
- * that core's small YAML reader keeps as strings.
- */
-export declare function collectorConfigs(ctx: PostSynthContext): Array<{
+/** Where a collector config was found in the build output. */
+export interface FoundCollectorConfig {
+    /** The lexicon output, or the output file, the config came from. */
     source: string;
     config: CollectorConfig;
-}>;
-/** Diagnostics for one config-level code (OTEL101-OTEL106, OTEL112) across every collector config in the output. */
+    /** Set when the config is a value in a Kubernetes ConfigMap (chant #2930). */
+    configMap?: {
+        namespace: string;
+        name: string;
+        key: string;
+    };
+}
+/**
+ * Every collector config in the output: the otel lexicon's own, any YAML
+ * document shaped like one, and any ConfigMap data value that parses as one
+ * (how `OtelCollector`, `OtelCollectorGateway` and `GkeOtelCollector` carry
+ * theirs). Parsed with js-yaml rather than `ctx.docs`, because collector
+ * configs are written with flow lists (`[otlp, batch]`) that core's small
+ * YAML reader keeps as strings.
+ *
+ * `chant build` hands each lexicon's checks only that lexicon's output, so
+ * the otel checks see ConfigMaps only in a context that includes k8s output.
+ * The k8s lexicon's WK8604 runs the same config checks over its own output.
+ */
+export declare function collectorConfigs(ctx: PostSynthContext): FoundCollectorConfig[];
+/**
+ * Every config-level diagnostic (OTEL101-OTEL106, OTEL112-OTEL117 and any later
+ * config check) over the collector configs in the output. `configMapsOnly`
+ * keeps the configs held in ConfigMaps, which is what WK8604 reads.
+ */
+export declare function collectorConfigDiagnostics(ctx: PostSynthContext, opts?: {
+    configMapsOnly?: boolean;
+}): PostSynthDiagnostic[];
+/** Diagnostics for one config-level code (OTEL101-OTEL106, OTEL112-OTEL117) 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,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"}
+{"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;AAE7E,OAAO,EAAsD,KAAK,kBAAkB,EAAuB,MAAM,uBAAuB,CAAC;AAEzI,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,8EAA8E;IAC9E,SAAS,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,oBAAoB,EAAE,CA4B9E;AAaD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,mBAAmB,EAAE,CAIhI;AAED,4HAA4H;AAC5H,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"}

package/dist/lint/post-synth/otel113.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OTEL113: Pipelines form a cycle through connectors
+ *
+ * A connector carries data from the pipeline that lists it as an exporter to the pipeline that lists it as a receiver. When those hops lead back to a pipeline already on the path (traces/a feeds traces/b through one connector and traces/b feeds traces/a through another, or one pipeline lists the same `forward` connector on both sides), the collector refuses to start. The check walks the `edges` `collectorTopology()` returns and names one cycle per group of pipelines caught in it.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const otel113: PostSynthCheck;
+//# sourceMappingURL=otel113.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel113.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/otel113.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}

package/dist/lint/post-synth/otel114.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OTEL114: A connector id is also declared as a receiver or exporter
+ *
+ * A pipeline names a connector the same way it names a receiver or an exporter, so the collector refuses a config where a connector id is also declared under `receivers` or `exporters`, whether or not any pipeline uses it.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const otel114: PostSynthCheck;
+//# sourceMappingURL=otel114.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel114.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/otel114.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}

package/dist/lint/post-synth/otel115.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OTEL115: A routing connector routes to a pipeline that does not receive from it
+ *
+ * Every pipeline a `routing` connector names in `table[].pipelines` or `default_pipelines` must list that connector in its receivers. The connector can only hand data to the pipelines it feeds, and the collector refuses to start when a route names any other pipeline or one that does not exist.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const otel115: PostSynthCheck;
+//# sourceMappingURL=otel115.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel115.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/otel115.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}

package/dist/lint/post-synth/otel116.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OTEL116: A connector splits metrics by a high-cardinality GenAI attribute
+ *
+ * `gen_ai.conversation.id`, `gen_ai.response.id`, `gen_ai.tool.call.id`, `session.id`, `user.id`, `enduser.id` and the other keys in `GENAI_HIGH_CARDINALITY_ATTRIBUTES` take a new value per response, conversation or user, and the content keys (`gen_ai.input.messages` and the rest of `GENAI_CONTENT_ATTRIBUTES`) are unbounded. Used as a metric attribute in `spanmetrics` or `servicegraph` dimensions, `sum` or `count` attributes, or `signaltometrics` attributes or `include_resource_attributes`, each value starts new time series. The collector accepts such a config without a warning.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const otel116: PostSynthCheck;
+//# sourceMappingURL=otel116.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel116.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/otel116.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}

package/dist/lint/post-synth/otel117.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OTEL117: Two components the collector starts listen on the same address
+ *
+ * A receiver or exporter a pipeline lists, an extension in `service.extensions`, and the collector's own metrics endpoint (`localhost:8888` unless `service.telemetry.metrics` says otherwise) each bind an address when the collector starts. Two on the same port, on the same host or with either on a wildcard host (`0.0.0.0`, `::`), make the second bind fail with "address already in use", and the collector exits. `otelcol validate` does not bind, so it accepts such a config. The listeners checked are the otlp, zipkin and jaeger receivers, the prometheus exporter, and the health_check, zpages and pprof extensions, with their defaults at the pinned collector release.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const otel117: PostSynthCheck;
+//# sourceMappingURL=otel117.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel117.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/otel117.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "otel",
-  "version": "0.100.0",
+  "version": "0.101.0",
   "chantVersion": ">=0.1.0",
   "namespace": "OTel",
   "intrinsics": [],

package/dist/meta.json

@@ -19,6 +19,11 @@
     "kind": "resource",
     "lexicon": "otel"
   },
+  "DeltaToCumulativeProcessor": {
+    "resourceType": "OTel::Processor::deltatocumulative",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
   "FileLogReceiver": {
     "resourceType": "OTel::Receiver::filelog",
     "kind": "resource",
@@ -59,6 +64,11 @@
     "kind": "resource",
     "lexicon": "otel"
   },
+  "K8sLeaderElectorExtension": {
+    "resourceType": "OTel::Extension::k8s_leader_elector",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
   "KubeletStatsReceiver": {
     "resourceType": "OTel::Receiver::kubeletstats",
     "kind": "resource",
@@ -144,6 +154,11 @@
     "kind": "resource",
     "lexicon": "otel"
   },
+  "SignalToMetricsConnector": {
+    "resourceType": "OTel::Connector::signaltometrics",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
   "SpanMetricsConnector": {
     "resourceType": "OTel::Connector::spanmetrics",
     "kind": "resource",

package/dist/okf/index.md

@@ -8,6 +8,7 @@ okf_version: '0.2'
 * [BatchProcessor](/types/BatchProcessor.md) - OTel::Processor::batch
 * [CountConnector](/types/CountConnector.md) - OTel::Connector::count
 * [DebugExporter](/types/DebugExporter.md) - OTel::Exporter::debug
+* [DeltaToCumulativeProcessor](/types/DeltaToCumulativeProcessor.md) - OTel::Processor::deltatocumulative
 * [FileLogReceiver](/types/FileLogReceiver.md) - OTel::Receiver::filelog
 * [FilterProcessor](/types/FilterProcessor.md) - OTel::Processor::filter
 * [ForwardConnector](/types/ForwardConnector.md) - OTel::Connector::forward
@@ -16,6 +17,7 @@ okf_version: '0.2'
 * [HostMetricsReceiver](/types/HostMetricsReceiver.md) - OTel::Receiver::hostmetrics
 * [K8sAttributesProcessor](/types/K8sAttributesProcessor.md) - OTel::Processor::k8sattributes
 * [K8sClusterReceiver](/types/K8sClusterReceiver.md) - OTel::Receiver::k8s_cluster
+* [K8sLeaderElectorExtension](/types/K8sLeaderElectorExtension.md) - OTel::Extension::k8s_leader_elector
 * [KubeletStatsReceiver](/types/KubeletStatsReceiver.md) - OTel::Receiver::kubeletstats
 * [LoadBalancingExporter](/types/LoadBalancingExporter.md) - OTel::Exporter::loadbalancing
 * [MemoryLimiterProcessor](/types/MemoryLimiterProcessor.md) - OTel::Processor::memory_limiter
@@ -33,6 +35,7 @@ okf_version: '0.2'
 * [RoutingConnector](/types/RoutingConnector.md) - OTel::Connector::routing
 * [Service](/types/Service.md) - OTel::Service
 * [ServiceGraphConnector](/types/ServiceGraphConnector.md) - OTel::Connector::servicegraph
+* [SignalToMetricsConnector](/types/SignalToMetricsConnector.md) - OTel::Connector::signaltometrics
 * [SpanMetricsConnector](/types/SpanMetricsConnector.md) - OTel::Connector::spanmetrics
 * [SumConnector](/types/SumConnector.md) - OTel::Connector::sum
 * [TailSamplingProcessor](/types/TailSamplingProcessor.md) - OTel::Processor::tail_sampling
@@ -53,3 +56,8 @@ okf_version: '0.2'
 * [OTEL108](/rules/OTEL108.md) - Two components or two pipelines declare the same id
 * [OTEL109](/rules/OTEL109.md) - A custom component has no schema pin
 * [OTEL112](/rules/OTEL112.md) - A connector joins pipelines whose signals it does not convert
+* [OTEL113](/rules/OTEL113.md) - Pipelines form a cycle through connectors
+* [OTEL114](/rules/OTEL114.md) - A connector id is also declared as a receiver or exporter
+* [OTEL115](/rules/OTEL115.md) - A routing connector routes to a pipeline that does not receive from it
+* [OTEL116](/rules/OTEL116.md) - A connector splits metrics by a high-cardinality GenAI attribute
+* [OTEL117](/rules/OTEL117.md) - Two components the collector starts listen on the same address

package/dist/okf/rules/OTEL113.md

@@ -0,0 +1,11 @@
+---
+type: post-synth-check
+title: OTEL113
+description: Pipelines form a cycle through connectors
+id: OTEL113
+severity: error
+category: post-synth
+lexicon: otel
+docs: https://intentius.io/chant/lexicons/otel/rules/
+---
+Pipelines form a cycle through connectors

package/dist/okf/rules/OTEL114.md

@@ -0,0 +1,11 @@
+---
+type: post-synth-check
+title: OTEL114
+description: A connector id is also declared as a receiver or exporter
+id: OTEL114
+severity: error
+category: post-synth
+lexicon: otel
+docs: https://intentius.io/chant/lexicons/otel/rules/
+---
+A connector id is also declared as a receiver or exporter

package/dist/okf/rules/OTEL115.md

@@ -0,0 +1,11 @@
+---
+type: post-synth-check
+title: OTEL115
+description: A routing connector routes to a pipeline that does not receive from it
+id: OTEL115
+severity: error
+category: post-synth
+lexicon: otel
+docs: https://intentius.io/chant/lexicons/otel/rules/
+---
+A routing connector routes to a pipeline that does not receive from it

package/dist/okf/rules/OTEL116.md

@@ -0,0 +1,11 @@
+---
+type: post-synth-check
+title: OTEL116
+description: A connector splits metrics by a high-cardinality GenAI attribute
+id: OTEL116
+severity: error
+category: post-synth
+lexicon: otel
+docs: https://intentius.io/chant/lexicons/otel/rules/
+---
+A connector splits metrics by a high-cardinality GenAI attribute

package/dist/okf/rules/OTEL117.md

@@ -0,0 +1,11 @@
+---
+type: post-synth-check
+title: OTEL117
+description: Two components the collector starts listen on the same address
+id: OTEL117
+severity: error
+category: post-synth
+lexicon: otel
+docs: https://intentius.io/chant/lexicons/otel/rules/
+---
+Two components the collector starts listen on the same address