@intentius/chant-lexicon-otel 0.100.0 → 0.101.0

package/dist/okf/types/DeltaToCumulativeProcessor.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: DeltaToCumulativeProcessor
+description: otel resource type OTel::Processor::deltatocumulative
+name: DeltaToCumulativeProcessor
+lexicon: otel
+resource_type: OTel::Processor::deltatocumulative
+---
+`OTel::Processor::deltatocumulative`, a resource type of the otel lexicon.

package/dist/okf/types/K8sLeaderElectorExtension.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: K8sLeaderElectorExtension
+description: otel resource type OTel::Extension::k8s_leader_elector
+name: K8sLeaderElectorExtension
+lexicon: otel
+resource_type: OTel::Extension::k8s_leader_elector
+---
+`OTel::Extension::k8s_leader_elector`, a resource type of the otel lexicon.

package/dist/okf/types/SignalToMetricsConnector.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: SignalToMetricsConnector
+description: otel resource type OTel::Connector::signaltometrics
+name: SignalToMetricsConnector
+lexicon: otel
+resource_type: OTel::Connector::signaltometrics
+---
+`OTel::Connector::signaltometrics`, a resource type of the otel lexicon.

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA4B9D;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,aAyFxB,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA+B9D;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,aA4GxB,CAAC"}

package/dist/rules/otel-helpers.ts

@@ -8,16 +8,32 @@ import type { SerializerResult } from "@intentius/chant/serializer";
 import { loadAll } from "js-yaml";
 import type { Declarable } from "@intentius/chant/declarable";
 import { looksLikeCollectorConfig, type CollectorConfig } from "../../model";
+import { configMapCollectorConfigs, describeConfigMapConfig } from "../../configmap";
 import { validateCollectorConfig, validateCollectorEntities, type CollectorIssueCode, type CollectorIssue } from "../../validate-config";
 
+/** 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;
+  /** 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, 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.
+ * 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 function collectorConfigs(ctx: PostSynthContext): Array<{ source: string; config: CollectorConfig }> {
-  const out: Array<{ source: string; config: CollectorConfig }> = [];
+export function collectorConfigs(ctx: PostSynthContext): FoundCollectorConfig[] {
+  const out: FoundCollectorConfig[] = [];
   for (const [lexicon, output] of ctx.outputs) {
     const texts: Array<[string, string]> =
       typeof output === "string"
@@ -35,6 +51,10 @@ export function collectorConfigs(ctx: PostSynthContext): Array<{ source: string;
         if (typeof doc !== "object" || doc === null || Array.isArray(doc)) continue;
         if ((lexicon === "otel" && source === lexicon) || looksLikeCollectorConfig(doc)) {
           out.push({ source, config: doc as CollectorConfig });
+          continue;
+        }
+        for (const { config, ...configMap } of configMapCollectorConfigs(doc)) {
+          out.push({ source, config, configMap });
         }
       }
     }
@@ -42,22 +62,34 @@ export function collectorConfigs(ctx: PostSynthContext): Array<{ source: string;
   return out;
 }
 
-function toDiagnostic(issue: CollectorIssue, source?: string): PostSynthDiagnostic {
+function toDiagnostic(issue: CollectorIssue, found?: Omit<FoundCollectorConfig, "config">): PostSynthDiagnostic {
+  const where = found?.configMap ? describeConfigMapConfig(found.configMap) : found && found.source !== "otel" ? found.source : undefined;
   return {
     checkId: issue.code,
     severity: issue.severity,
-    message: source && source !== "otel" ? `${source}: ${issue.message}` : issue.message,
+    message: where ? `${where}: ${issue.message}` : issue.message,
     ...(issue.component ? { entity: issue.component } : issue.pipeline ? { entity: issue.pipeline } : {}),
     lexicon: "otel",
   };
 }
 
-/** Diagnostics for one config-level code (OTEL101-OTEL106, OTEL112) across every collector config in the output. */
+/**
+ * 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 function collectorConfigDiagnostics(ctx: PostSynthContext, opts: { configMapsOnly?: boolean } = {}): PostSynthDiagnostic[] {
+  return collectorConfigs(ctx)
+    .filter((found) => !opts.configMapsOnly || found.configMap)
+    .flatMap(({ config, ...found }) => validateCollectorConfig(config).map((i) => toDiagnostic(i, found)));
+}
+
+/** Diagnostics for one config-level code (OTEL101-OTEL106, OTEL112-OTEL117) across every collector config in the output. */
 export function configDiagnostics(ctx: PostSynthContext, code: CollectorIssueCode): PostSynthDiagnostic[] {
-  return collectorConfigs(ctx).flatMap(({ source, config }) =>
+  return collectorConfigs(ctx).flatMap(({ config, ...found }) =>
     validateCollectorConfig(config)
       .filter((i) => i.code === code)
-      .map((i) => toDiagnostic(i, source)),
+      .map((i) => toDiagnostic(i, found)),
   );
 }
 

package/dist/rules/otel113.ts

@@ -0,0 +1,17 @@
+/**
+ * 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, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { configDiagnostics } from "./otel-helpers";
+
+export const otel113: PostSynthCheck = {
+  id: "OTEL113",
+  description: "Pipelines form a cycle through connectors",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return configDiagnostics(ctx, "OTEL113");
+  },
+};

package/dist/rules/otel114.ts

@@ -0,0 +1,17 @@
+/**
+ * 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, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { configDiagnostics } from "./otel-helpers";
+
+export const otel114: PostSynthCheck = {
+  id: "OTEL114",
+  description: "A connector id is also declared as a receiver or exporter",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return configDiagnostics(ctx, "OTEL114");
+  },
+};

package/dist/rules/otel115.ts

@@ -0,0 +1,17 @@
+/**
+ * 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, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { configDiagnostics } from "./otel-helpers";
+
+export const otel115: PostSynthCheck = {
+  id: "OTEL115",
+  description: "A routing connector routes to a pipeline that does not receive from it",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return configDiagnostics(ctx, "OTEL115");
+  },
+};

package/dist/rules/otel116.ts

@@ -0,0 +1,17 @@
+/**
+ * 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, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { configDiagnostics } from "./otel-helpers";
+
+export const otel116: PostSynthCheck = {
+  id: "OTEL116",
+  description: "A connector splits metrics by a high-cardinality GenAI attribute",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return configDiagnostics(ctx, "OTEL116");
+  },
+};

package/dist/rules/otel117.ts

@@ -0,0 +1,17 @@
+/**
+ * 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, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";
+import { configDiagnostics } from "./otel-helpers";
+
+export const otel117: PostSynthCheck = {
+  id: "OTEL117",
+  description: "Two components the collector starts listen on the same address",
+
+  check(ctx: PostSynthContext): PostSynthDiagnostic[] {
+    return configDiagnostics(ctx, "OTEL117");
+  },
+};

package/dist/skills/chant-otel.md

@@ -15,6 +15,10 @@ The otel lexicon (`@intentius/chant-lexicon-otel`) types collector config. Each
 export default { lexicons: ["otel"] };
 ```
 
+`chant init --lexicon otel` scaffolds a collector; `--template k8s-agent` scaffolds a per-node Kubernetes agent and `--template genai` a GenAI collector.
+
+For a per-node Kubernetes agent, `NodeAgent({ exporters, metricExporters?, clusterName?, kubeletStats? })` declares the whole config: OTLP, host metrics, container logs, `k8sattributes` filtered to the node, and `memory_limiter` first and `batch` last on every pipeline. Pass `Object.values(agent.members)` wherever an entity list is taken, such as the k8s lexicon's `OtelCollector` `config`.
+
 ## Declaring components
 
 Every component class takes the collector's own config keys (snake_case, as in the collector docs) plus an optional `name`. The id is `type`, or `type/name` when `name` is set.
@@ -41,10 +45,10 @@ Emits `receivers.otlp`, `processors.memory_limiter` and `processors.batch`, `exp
 | Kind | Types |
 |---|---|
 | receivers | otlp, prometheus, hostmetrics, filelog, k8s_cluster, kubeletstats |
-| processors | batch, memory_limiter, resource, attributes, k8sattributes, resourcedetection, filter, transform, redaction, tail_sampling, probabilistic_sampler |
+| processors | batch, memory_limiter, resource, attributes, k8sattributes, resourcedetection, filter, transform, redaction, tail_sampling, probabilistic_sampler, deltatocumulative |
 | exporters | otlp, otlphttp, debug, prometheus, googlecloud, loadbalancing |
-| connectors | spanmetrics, servicegraph, routing, forward, count, sum |
-| extensions | health_check, pprof, zpages |
+| connectors | spanmetrics, servicegraph, routing, forward, count, sum, signaltometrics |
+| extensions | health_check, pprof, zpages, k8s_leader_elector |
 
 Anything else goes through `defineComponent`; see the `chant-otel-custom-components` skill.
 
@@ -58,7 +62,7 @@ export const traces = new Pipeline({ signal: "traces", receivers: [otlp], export
 export const red = new Pipeline({ signal: "metrics", name: "red", receivers: [spanmetrics], exporters: [prom] });
 ```
 
-`spanmetrics` and `servicegraph` turn traces into metrics, `count` and `sum` turn any signal into metrics (`sum` adds up a numeric attribute), `routing` and `forward` keep the signal. A connector on one side only fails OTEL101; a pipeline whose signal the connector can't pair fails OTEL112.
+`spanmetrics` and `servicegraph` turn traces into metrics, `count` and `sum` turn any signal into metrics (`sum` adds up a numeric attribute), `signaltometrics` builds metrics you name, of any type, from any signal with OTTL values, `routing` and `forward` keep the signal. A connector on one side only fails OTEL101; a pipeline whose signal the connector can't pair fails OTEL112. Pipelines that feed each other in a loop through connectors fail OTEL113, a connector id that is also a receiver or exporter id fails OTEL114, and every pipeline a `routing` connector routes to must list it in `receivers` (OTEL115).
 
 ## GenAI workloads
 
@@ -68,7 +72,7 @@ For services that emit GenAI spans, start from the preset instead of writing the
 export const collector = genAiPipeline({ traceExporters: [tempo], metricExporters: [prom] });
 ```
 
-It deletes prompt, completion, system-instruction and tool-call content from spans, span events and logs, and derives call, error, duration and token metrics (`genai_calls_total`, `genai_duration_seconds`, `genai_tokens_input_total`, `genai_tokens_output_total`) from every GenAI span before sampling. Keep content only when asked, with `keepContent: true`. `genAiComponents()` returns the pieces for hand-built pipelines.
+It deletes prompt, completion, system-instruction and tool-call content from spans, span events and logs, and derives call, error, duration and token metrics (`genai_calls_total`, `genai_duration_seconds`, `genai_tokens_input_total`, `genai_tokens_output_total`) from every GenAI span before sampling. Keep content only when asked, with `keepContent: true`. When a dashboard or backend expects the semantic conventions' names, add `clientMetrics: "derive"` for `gen_ai.client.operation.duration` and `gen_ai.client.token.usage` from spans, or `"passthrough"` when the SDK already records them; never both. Read metric names from `genAiMetrics(options)` (`.client` for the conventions' ones) instead of writing them out. `genAiComponents()` returns the pieces for hand-built pipelines. The token sums and derived client metrics are deltas: `deltaToCumulative: "auto"` puts a `deltatocumulative` processor in front of any metric exporter other than `prometheus` or `debug` (the default with `clientMetrics: "derive"`), `true` always, `false` never.
 
 ## Rules
 
@@ -76,6 +80,8 @@ It deletes prompt, completion, system-instruction and tool-call content from spa
 - Put `memory_limiter` first in `processors` (OTEL105).
 - Never write a credential literally. Use `"${env:NAME}"` and the collector reads it at start-up (OTEL002).
 - Every pipeline needs at least one receiver and one exporter (OTEL102). A declared component no pipeline uses is a warning (OTEL103).
+- Don't split metrics by a per-request id (`gen_ai.conversation.id`, `gen_ai.response.id`, `gen_ai.tool.call.id`, `session.id`, `user.id`, `enduser.id`) or a content key: each value starts new time series (OTEL116).
+- Give every listener its own port. The collector's own metrics already use localhost:8888, so a `prometheus` exporter there makes it exit with "address already in use" (OTEL117).
 - Declared extensions are enabled in declaration order unless a `Service` lists `extensions` itself.
 
 ## Starting from an existing config

package/dist/topology.d.ts

@@ -36,6 +36,11 @@ export interface TopologyComponent {
     schema?: SchemaPin;
     /** Addresses it listens on or sends to, as the config states them. Empty when the config names none. */
     endpoints: string[];
+    /**
+     * The wire protocols it speaks, as OTLP SDKs name them (`grpc`, `http/protobuf`, `http/json`).
+     * Empty when its definition states none, which a protocol check reads as unknown.
+     */
+    protocols: string[];
     /** The pipelines that use it. For a connector, those on either side; for an extension, empty. */
     pipelines: string[];
 }

package/dist/topology.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../src/topology.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAgD,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AACjH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE5D,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kHAAkH;IAClH,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,wGAAwG;IACxG,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iGAAiG;IACjG,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kEAAkE;IAClE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,oFAAoF;IACpF,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B;;;;OAIG;IACH,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB;;;;OAIG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAeD,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CA2D5E;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,iBAAiB,CAE/G"}
+{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../src/topology.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAgD,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AACjH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE5D,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kHAAkH;IAClH,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,wGAAwG;IACxG,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iGAAiG;IACjG,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kEAAkE;IAClE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,oFAAoF;IACpF,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B;;;;OAIG;IACH,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB;;;;OAIG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAyBD,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CA4D5E;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,iBAAiB,CAE/G"}

package/dist/validate-config.d.ts

@@ -10,7 +10,7 @@
 import type { Declarable } from "@intentius/chant/declarable";
 import { type CollectorConfig } from "./model.js";
 import "./components/connectors.js";
-export type CollectorIssueCode = "OTEL101" | "OTEL102" | "OTEL103" | "OTEL104" | "OTEL105" | "OTEL106" | "OTEL107" | "OTEL108" | "OTEL109" | "OTEL112";
+export type CollectorIssueCode = "OTEL101" | "OTEL102" | "OTEL103" | "OTEL104" | "OTEL105" | "OTEL106" | "OTEL107" | "OTEL108" | "OTEL109" | "OTEL112" | "OTEL113" | "OTEL114" | "OTEL115" | "OTEL116" | "OTEL117";
 export interface CollectorIssue {
     code: CollectorIssueCode;
     severity: "error" | "warning";
@@ -22,7 +22,11 @@ export interface CollectorIssue {
 }
 /**
  * Check a collector config's references and pipeline shape (OTEL101-OTEL106),
- * and each connector's signals against its definition (OTEL112).
+ * each connector's signals against its definition (OTEL112), cycles through
+ * connectors (OTEL113), connector ids shared with a receiver or exporter
+ * (OTEL114), `routing` connector targets (OTEL115), the attributes
+ * connectors split metrics by (OTEL116), and started components that listen
+ * on the same address (OTEL117).
  */
 export declare function validateCollectorConfig(config: CollectorConfig): CollectorIssue[];
 /**

package/dist/validate-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../src/validate-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,EAA4D,KAAK,eAAe,EAA4B,MAAM,SAAS,CAAC;AAGnI,OAAO,yBAAyB,CAAC;AAEjC,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkBD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CA0JjF;AA2CD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,cAAc,EAAE,CAyDpH"}
+{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../src/validate-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,EAA4D,KAAK,eAAe,EAA4B,MAAM,SAAS,CAAC;AAMnI,OAAO,yBAAyB,CAAC;AAEjC,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CAkKjF;AAobD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,cAAc,EAAE,CAyDpH"}

package/dist/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAMvF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEvF,0DAA0D;AAC1D,eAAO,MAAM,cAAc,UA6B1B,CAAC;AAEF,wBAAsB,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CA2CxD"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAMvF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEvF,0DAA0D;AAC1D,eAAO,MAAM,cAAc,UAsC1B,CAAC;AAEF,wBAAsB,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CAmDxD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-otel",
-  "version": "0.100.0",
+  "version": "0.101.0",
   "description": "OpenTelemetry Collector lexicon for chant — typed receivers, processors, exporters, connectors, extensions and pipelines, serialized to collector YAML",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -68,7 +68,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.100.0",
+    "@intentius/chant": "^0.101.0",
     "typescript": "^5.9.3"
   }
 }

package/src/codegen/docs.ts

@@ -35,10 +35,10 @@ export const traces = new Pipeline({
 The built-in component set is otlp, prometheus, hostmetrics, filelog,
 k8s_cluster and kubeletstats receivers; batch, memory_limiter, resource,
 attributes, k8sattributes, resourcedetection, filter, transform, redaction,
-tail_sampling and probabilistic_sampler processors; otlp, otlphttp, debug,
+tail_sampling, probabilistic_sampler and deltatocumulative processors; otlp, otlphttp, debug,
 prometheus, googlecloud and loadbalancing exporters; spanmetrics,
-servicegraph, routing, forward, count and sum connectors; and the
-health_check, pprof and zpages extensions. \`genAiPipeline()\` is a preset for
+servicegraph, routing, forward, count, sum and signaltometrics connectors; and the
+health_check, pprof, zpages and k8s_leader_elector extensions. \`genAiPipeline()\` is a preset for
 GenAI workloads: it removes prompt and completion content and derives agent
 RED and token metrics.
 Their config types follow the collector-contrib release named on the
@@ -50,7 +50,12 @@ TypeScript (see Importing a Collector Config).
 Checks catch a pipeline that uses a component nobody declared (OTEL101), a
 pipeline with no receivers or exporters (OTEL102), a declared component no
 pipeline uses (OTEL103), a connector joining pipelines of signals it can't
-convert (OTEL112), and a literal credential in source (OTEL002).
+convert (OTEL112), pipelines feeding each other in a cycle (OTEL113), a
+connector id shared with a receiver or exporter (OTEL114), a \`routing\` route
+to a pipeline that doesn't receive from it (OTEL115), a connector
+splitting metrics by a per-request GenAI attribute such as
+\`gen_ai.conversation.id\` (OTEL116), two started components listening
+on the same address (OTEL117), and a literal credential in source (OTEL002).
 `;
 
 const outputFormat = `The otel lexicon serializes every otel entity in a build into **one

package/src/components/common.ts

@@ -13,6 +13,23 @@
  */
 export type Duration = string | number;
 
+const GO_DURATION_UNITS: Record<string, number> = { ns: 1e-6, us: 1e-3, "µs": 1e-3, "μs": 1e-3, ms: 1, s: 1e3, m: 60e3, h: 3600e3 };
+
+/** A Go duration in milliseconds, `fallback` when unset, or undefined when it isn't one this can read. */
+export function goDurationMs(d: Duration | undefined, fallback: number): number | undefined {
+  if (d === undefined) return fallback;
+  if (typeof d === "number") return d / 1e6;
+  // time.ParseDuration takes a bare "0" without a unit.
+  if (/^[+-]?0$/.test(d.trim())) return 0;
+  const m = d.trim().match(/^([+-]?)((?:\d+(?:\.\d*)?|\.\d+)(?:ns|us|µs|μs|ms|s|m|h))+$/);
+  if (!m) return undefined;
+  let total = 0;
+  for (const part of d.trim().matchAll(/(\d+(?:\.\d*)?|\.\d+)(ns|us|µs|μs|ms|s|m|h)/g)) {
+    total += Number(part[1]) * GO_DURATION_UNITS[part[2]];
+  }
+  return m[1] === "-" ? -total : total;
+}
+
 export interface TLSClientSettings {
   insecure?: boolean;
   insecure_skip_verify?: boolean;

package/src/components/connectors.ts

@@ -1,5 +1,6 @@
 /**
- * Built-in connectors: spanmetrics, servicegraph, routing, forward, count, sum.
+ * Built-in connectors: spanmetrics, servicegraph, routing, forward, count, sum,
+ * signaltometrics.
  *
  * A connector is an exporter in one pipeline and a receiver in another. Put
  * the same entity in `exporters` of the pipeline that feeds it and in
@@ -274,3 +275,210 @@ export const SumConnector = defineBuiltin<SumConnectorConfig, "connector", "sum"
     return problems;
   },
 });
+
+// ── signaltometrics ──────────────────────────────────────────────────
+//
+// Typed against connector/signaltometricsconnector at COLLECTOR_PIN
+// (collector-contrib v0.130.0): config/config.go and README.md at that tag,
+// https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.130.0/connector/signaltometricsconnector
+// The collector type is `signaltometrics`. Upstream marks every signal pair
+// alpha. At v0.130.0 there is no span event section; spans, data points,
+// logs and profiles each take a list of metrics.
+
+/** The input sections of a `signaltometrics` connector, one per signal it reads. */
+export const SIGNAL_TO_METRICS_SIGNALS = ["spans", "datapoints", "logs", "profiles"] as const;
+export type SignalToMetricsSignal = (typeof SIGNAL_TO_METRICS_SIGNALS)[number];
+
+/** The metric types a `signaltometrics` entry can produce. Each entry names exactly one. */
+export const SIGNAL_TO_METRICS_TYPES = ["sum", "gauge", "histogram", "exponential_histogram"] as const;
+export type SignalToMetricsType = (typeof SIGNAL_TO_METRICS_TYPES)[number];
+
+/**
+ * The connector's default explicit histogram bounds, used when `histogram`
+ * sets no `buckets`. They are plain numbers in whatever unit `value` returns,
+ * not durations.
+ */
+export const SIGNAL_TO_METRICS_DEFAULT_BUCKETS: readonly number[] = Object.freeze([
+  2, 4, 6, 8, 10, 50, 100, 200, 400, 800, 1000, 1400, 2000, 5000, 10_000, 15_000,
+]);
+
+/**
+ * An attribute of the produced metric.
+ *
+ * In `attributes`: without `default_value` or `optional`, an item lacking the
+ * attribute is not counted at all; with `default_value`, it is counted under
+ * that value; with `optional: true`, it is counted without the attribute.
+ * Set at most one of the two.
+ *
+ * In `include_resource_attributes`: an include list. `default_value` fills a
+ * missing resource attribute; `optional` changes nothing.
+ */
+export interface SignalToMetricsAttribute {
+  key: string;
+  default_value?: string | number | boolean;
+  optional?: boolean;
+}
+
+/** A delta sum of `value` over the items in each batch. */
+export interface SignalToMetricsSum {
+  /** OTTL value expression; its result type (int or double) is the sum's. A constant is a string: `"1"`. */
+  value: string;
+}
+
+/** The last `value` seen in each batch. */
+export interface SignalToMetricsGauge {
+  /** OTTL value expression. With `ExtractGrokPatterns`, select one key: `ExtractGrokPatterns(...)["key"]`. */
+  value: string;
+}
+
+/** An explicit-bucket histogram of `value`. */
+export interface SignalToMetricsHistogram {
+  /** Upper bounds, increasing, in the unit `value` returns. Default `SIGNAL_TO_METRICS_DEFAULT_BUCKETS`. */
+  buckets?: number[];
+  /** OTTL value expression for how many observations each item counts as. Default: one per item. */
+  count?: string;
+  /** OTTL value expression for the observed value, e.g. `Seconds(end_time - start_time)` or an attribute. */
+  value: string;
+}
+
+/** A base-2 exponential histogram of `value`. */
+export interface SignalToMetricsExponentialHistogram {
+  /** Buckets per positive or negative range, 2 to 16384. Default 160. */
+  max_size?: number;
+  /** OTTL value expression for how many observations each item counts as. Default: one per item. */
+  count?: string;
+  /** OTTL value expression for the observed value. */
+  value: string;
+}
+
+/** What every `signaltometrics` entry has, whatever metric type it produces. */
+export interface SignalToMetricsMetricBase {
+  /** The OTLP metric name, used as written. */
+  name: string;
+  description?: string;
+  /** The metric's unit, e.g. `s` or `{token}`. */
+  unit?: string;
+  /** Resource attributes the metric keeps. Unset or empty keeps them all. */
+  include_resource_attributes?: SignalToMetricsAttribute[];
+  /** Attributes of the item (span, data point, log record) the metric is split by. Unset: no attributes. */
+  attributes?: SignalToMetricsAttribute[];
+  /** OTTL conditions, ORed; an item counts when any matches. Unset counts every item. */
+  conditions?: string[];
+}
+
+type OneMetricType<K extends SignalToMetricsType, V> = { [P in K]: V } & { [P in Exclude<SignalToMetricsType, K>]?: never };
+
+/** One metric a `signaltometrics` connector produces: a name and exactly one metric type. */
+export type SignalToMetricsMetric = SignalToMetricsMetricBase &
+  (
+    | OneMetricType<"sum", SignalToMetricsSum>
+    | OneMetricType<"gauge", SignalToMetricsGauge>
+    | OneMetricType<"histogram", SignalToMetricsHistogram>
+    | OneMetricType<"exponential_histogram", SignalToMetricsExponentialHistogram>
+  );
+
+/**
+ * The metrics to produce, per input signal. The connector emits delta
+ * temporality and aggregates only within each batch it receives, so an
+ * exporter that needs cumulative input (Prometheus remote write) wants a
+ * `deltatocumulative` processor in front of it.
+ */
+export interface SignalToMetricsConnectorConfig {
+  spans?: SignalToMetricsMetric[];
+  datapoints?: SignalToMetricsMetric[];
+  logs?: SignalToMetricsMetric[];
+  profiles?: SignalToMetricsMetric[];
+}
+
+/** One entry of a `signaltometrics` config, with where it sits. */
+export interface SignalToMetricsEntry {
+  signal: SignalToMetricsSignal;
+  index: number;
+  metric: SignalToMetricsMetric;
+  /** The metric types the entry names. A valid entry names exactly one. */
+  types: SignalToMetricsType[];
+}
+
+/** Every metric entry of a `signaltometrics` config, in section order. Reads untyped config too. */
+export function signalToMetricsEntries(config: SignalToMetricsConnectorConfig): SignalToMetricsEntry[] {
+  const out: SignalToMetricsEntry[] = [];
+  for (const signal of SIGNAL_TO_METRICS_SIGNALS) {
+    const list = (config as Record<string, unknown>)?.[signal];
+    if (!Array.isArray(list)) continue;
+    list.forEach((metric, index) => {
+      const m = (metric ?? {}) as Record<string, unknown>;
+      const types = SIGNAL_TO_METRICS_TYPES.filter((t) => m[t] !== undefined && m[t] !== null);
+      out.push({ signal, index, metric: m as unknown as SignalToMetricsMetric, types });
+    });
+  }
+  return out;
+}
+
+const GROK_KEY_SELECTOR = /ExtractGrokPatterns\([^)]*\)\s*\[[^\]]+\]/;
+
+/** The checks config/config.go makes at v0.130.0 that need no OTTL parser, plus increasing buckets. */
+function validateSignalToMetrics(c: SignalToMetricsConnectorConfig): string[] {
+  const problems: string[] = [];
+  const entries = signalToMetricsEntries(c);
+  if (entries.length === 0) {
+    problems.push("no metric is configured under spans, datapoints, logs or profiles; the collector refuses the connector");
+  }
+  for (const { signal, index, metric, types } of entries) {
+    const m = metric as unknown as SignalToMetricsMetricBase & Partial<Record<SignalToMetricsType, Record<string, unknown>>>;
+    const at = m.name ? `${signal}[${index}] (${m.name})` : `${signal}[${index}]`;
+    if (!m.name) problems.push(`${at}: name is missing`);
+    if (types.length !== 1) {
+      problems.push(
+        `${at}: name exactly one metric type (sum, gauge, histogram or exponential_histogram); ${types.length === 0 ? "found none" : `found ${types.join(" and ")}`}`,
+      );
+    }
+    for (const t of types) {
+      const body = m[t];
+      if (typeof body?.value !== "string" || body.value === "") problems.push(`${at}: ${t}.value is missing`);
+    }
+    const buckets = m.histogram?.buckets;
+    if (Array.isArray(buckets) && buckets.some((b, i) => i > 0 && !((b as number) > (buckets[i - 1] as number)))) {
+      problems.push(`${at}: histogram.buckets must increase`);
+    }
+    const maxSize = m.exponential_histogram?.max_size;
+    if (typeof maxSize === "number" && maxSize !== 0 && (maxSize < 2 || maxSize > 16384)) {
+      problems.push(`${at}: exponential_histogram.max_size must be between 2 and 16384`);
+    }
+    const gauge = m.gauge?.value;
+    if (typeof gauge === "string" && gauge.includes("ExtractGrokPatterns") && !GROK_KEY_SELECTOR.test(gauge)) {
+      problems.push(`${at}: gauge.value with ExtractGrokPatterns needs one key selector, ExtractGrokPatterns(...)["key"]`);
+    }
+    const seen = new Set<string>();
+    (m.attributes ?? []).forEach((a, i) => {
+      if (!a?.key) {
+        problems.push(`${at}: attributes[${i}]: key is missing`);
+        return;
+      }
+      if (a.default_value !== undefined && a.optional) {
+        problems.push(`${at}: attributes "${a.key}": set default_value or optional, not both`);
+      }
+      if (seen.has(a.key)) problems.push(`${at}: attributes "${a.key}" is listed twice`);
+      seen.add(a.key);
+    });
+  }
+  return problems;
+}
+
+/**
+ * Builds metrics from spans, data points, logs or profiles, each with the
+ * name, type, unit, attributes and conditions you choose. A histogram, sum or
+ * gauge takes its value from an OTTL expression, such as an attribute or the
+ * span's duration.
+ */
+export const SignalToMetricsConnector = defineBuiltin<SignalToMetricsConnectorConfig, "connector", "signaltometrics">({
+  kind: "connector",
+  type: "signaltometrics",
+  description: "Builds named sum, gauge and histogram metrics from spans, data points, logs or profiles, with values and conditions in OTTL",
+  connects: [
+    { from: "traces", to: "metrics" },
+    { from: "metrics", to: "metrics" },
+    { from: "logs", to: "metrics" },
+    { from: "profiles", to: "metrics" },
+  ],
+  validate: validateSignalToMetrics,
+});

package/src/components/exporters.ts

@@ -16,6 +16,7 @@ export const OtlpExporter = defineBuiltin<OtlpExporterConfig, "exporter", "otlp"
   description: "Sends traces, metrics and logs over OTLP gRPC",
   validate: (c) => (c.endpoint ? [] : ["endpoint is empty"]),
   endpoints: (c) => (c.endpoint ? [c.endpoint] : []),
+  protocols: () => ["grpc"],
 });
 
 // ── otlphttp ─────────────────────────────────────────────────────────
@@ -39,6 +40,7 @@ export const OtlpHttpExporter = defineBuiltin<OtlpHttpExporterConfig, "exporter"
       : ["set endpoint, or at least one of traces_endpoint, metrics_endpoint and logs_endpoint"],
   endpoints: (c) =>
     [c.endpoint, c.traces_endpoint, c.metrics_endpoint, c.logs_endpoint].filter((e): e is string => typeof e === "string" && e !== ""),
+  protocols: (c) => [c.encoding === "json" ? "http/json" : "http/protobuf"],
 });
 
 // ── debug ────────────────────────────────────────────────────────────