@intentius/chant-lexicon-otel 0.95.1 → 0.96.0

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

@@ -1,7 +1,7 @@
 /**
  * OTEL101: A pipeline uses a receiver, processor or exporter that is not declared
  *
- * The collector refuses to start on this. Typed entity references cannot go wrong this way, so it mostly catches id strings (`"otlp/backend"`) and hand-edited or parsed configs. A connector id is accepted in receivers and exporters.
+ * The collector refuses to start on this. Typed entity references cannot go wrong this way, so it mostly catches id strings (`"otlp/backend"`) and hand-edited or parsed configs. A connector id is accepted in receivers and exporters, but a connector counts as used only when one pipeline lists it as an exporter and another lists it as a receiver; listed on one side only, it fails this check.
  */
 import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
 export declare const otel101: PostSynthCheck;

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

@@ -1,7 +1,7 @@
 /**
  * OTEL103: A declared component is never used
  *
- * A receiver, processor or exporter no pipeline lists, or an extension missing from service.extensions, is ignored by the collector. Usually it means a pipeline was meant to list it. A warning, since the config still runs.
+ * A receiver, processor, exporter or connector no pipeline lists, or an extension missing from service.extensions, is ignored by the collector. Usually it means a pipeline was meant to list it. A warning, since the config still runs.
  */
 import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
 export declare const otel103: PostSynthCheck;

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

@@ -0,0 +1,8 @@
+/**
+ * OTEL112: A connector joins pipelines whose signals it does not convert
+ *
+ * Each connector supports fixed signal pairs: `spanmetrics` and `servicegraph` read traces and write metrics, `count` writes metrics from any signal, `routing` and `forward` keep the signal. Every pipeline that feeds a connector must pair with a pipeline it feeds through one of those pairs, and the other way round, or the collector refuses to start. A traces pipeline that receives from `spanmetrics` fails this check. Custom connectors are checked when their `defineComponent` call lists `connects`.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const otel112: PostSynthCheck;
+//# sourceMappingURL=otel112.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel112.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/otel112.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.95.1",
+  "version": "0.96.0",
   "chantVersion": ">=0.1.0",
   "namespace": "OTel",
   "intrinsics": [],

package/dist/meta.json

@@ -9,6 +9,11 @@
     "kind": "resource",
     "lexicon": "otel"
   },
+  "CountConnector": {
+    "resourceType": "OTel::Connector::count",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
   "DebugExporter": {
     "resourceType": "OTel::Exporter::debug",
     "kind": "resource",
@@ -19,6 +24,16 @@
     "kind": "resource",
     "lexicon": "otel"
   },
+  "FilterProcessor": {
+    "resourceType": "OTel::Processor::filter",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
+  "ForwardConnector": {
+    "resourceType": "OTel::Connector::forward",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
   "GoogleCloudExporter": {
     "resourceType": "OTel::Exporter::googlecloud",
     "kind": "resource",
@@ -39,6 +54,21 @@
     "kind": "resource",
     "lexicon": "otel"
   },
+  "K8sClusterReceiver": {
+    "resourceType": "OTel::Receiver::k8s_cluster",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
+  "KubeletStatsReceiver": {
+    "resourceType": "OTel::Receiver::kubeletstats",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
+  "LoadBalancingExporter": {
+    "resourceType": "OTel::Exporter::loadbalancing",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
   "MemoryLimiterProcessor": {
     "resourceType": "OTel::Processor::memory_limiter",
     "kind": "resource",
@@ -69,6 +99,11 @@
     "kind": "resource",
     "lexicon": "otel"
   },
+  "ProbabilisticSamplerProcessor": {
+    "resourceType": "OTel::Processor::probabilistic_sampler",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
   "PrometheusExporter": {
     "resourceType": "OTel::Exporter::prometheus",
     "kind": "resource",
@@ -79,6 +114,11 @@
     "kind": "resource",
     "lexicon": "otel"
   },
+  "RedactionProcessor": {
+    "resourceType": "OTel::Processor::redaction",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
   "ResourceDetectionProcessor": {
     "resourceType": "OTel::Processor::resourcedetection",
     "kind": "resource",
@@ -89,11 +129,41 @@
     "kind": "resource",
     "lexicon": "otel"
   },
+  "RoutingConnector": {
+    "resourceType": "OTel::Connector::routing",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
   "Service": {
     "resourceType": "OTel::Service",
     "kind": "resource",
     "lexicon": "otel"
   },
+  "ServiceGraphConnector": {
+    "resourceType": "OTel::Connector::servicegraph",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
+  "SpanMetricsConnector": {
+    "resourceType": "OTel::Connector::spanmetrics",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
+  "SumConnector": {
+    "resourceType": "OTel::Connector::sum",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
+  "TailSamplingProcessor": {
+    "resourceType": "OTel::Processor::tail_sampling",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
+  "TransformProcessor": {
+    "resourceType": "OTel::Processor::transform",
+    "kind": "resource",
+    "lexicon": "otel"
+  },
   "ZPagesExtension": {
     "resourceType": "OTel::Extension::zpages",
     "kind": "resource",

package/dist/metric-names.d.ts

@@ -0,0 +1,121 @@
+/**
+ * The metric names a collector emits, as the `prometheus` exporter serves
+ * them: `spanMetricsNames()` for a `spanmetrics` connector, and the naming
+ * rules `genAiMetrics()` uses too.
+ *
+ * A dashboard or an SLO reads names from here instead of repeating them, so
+ * renaming the connector's namespace (or the exporter's) moves every query
+ * built from it.
+ *
+ * Naming follows the collector's Prometheus translation at `COLLECTOR_PIN`
+ * with the exporter's defaults: `.` and any other character Prometheus does
+ * not allow become `_`; counters take `_total`; a unit becomes a suffix
+ * (`ms` is `_milliseconds`, `s` is `_seconds`); the exporter's `namespace`
+ * is a prefix joined with `_`; `add_metric_suffixes: false` drops the
+ * suffixes. Attribute names become label names the same way
+ * (`service.name` is `service_name`).
+ *
+ * This module holds types and string functions only, so a lexicon that
+ * builds queries from it does not load the collector components.
+ */
+/** A metric a collector component emits, as the collector names it and as Prometheus exposes it. */
+export interface CollectorMetric {
+    /** The OTLP metric name. */
+    name: string;
+    /** The name the `prometheus` exporter serves; histograms add `_bucket`, `_sum` and `_count`. */
+    prometheus: string;
+    type: "sum" | "histogram";
+    unit?: string;
+    /** Attribute names on its data points, beyond the resource. Prometheus labels replace `.` with `_`. */
+    dimensions: string[];
+}
+/** The four dimensions spanmetrics puts on every metric unless `exclude_dimensions` names them. */
+export declare const SPANMETRICS_DEFAULT_DIMENSIONS: readonly string[];
+/** The spanmetrics namespace when the connector sets none. */
+export declare const SPANMETRICS_DEFAULT_NAMESPACE = "traces.span.metrics";
+/** The `status.code` value of a span that ended in error: the value an error-ratio query selects. */
+export declare const SPAN_STATUS_ERROR = "STATUS_CODE_ERROR";
+/** How the `prometheus` exporter is configured, as far as naming goes. */
+export interface PrometheusNaming {
+    /** The exporter's `namespace`, put in front of every name and joined with `_`. */
+    namespace?: string;
+    /** The exporter's `add_metric_suffixes` (default true): unit and `_total` suffixes. */
+    add_metric_suffixes?: boolean;
+}
+/** An attribute name as a Prometheus label: `service.name` is `service_name`. */
+export declare function prometheusLabel(attribute: string): string;
+/**
+ * An OTLP metric name as the `prometheus` exporter serves it.
+ *
+ * @param type `sum` (a monotonic counter, `_total`) or `histogram`.
+ * @param unit The metric's unit, e.g. `ms`. Units in braces (`{call}`) add nothing.
+ */
+export declare function prometheusMetricName(name: string, type: "sum" | "histogram", unit?: string, naming?: PrometheusNaming): string;
+/** The parts of a spanmetrics config the metric names depend on. */
+export interface SpanMetricsNamingConfig {
+    namespace?: string;
+    dimensions?: Array<{
+        name: string;
+    }>;
+    calls_dimensions?: Array<{
+        name: string;
+    }>;
+    exclude_dimensions?: string[];
+    histogram?: {
+        disable?: boolean;
+        unit?: "ms" | "s";
+        dimensions?: Array<{
+            name: string;
+        }>;
+    };
+    events?: {
+        enabled?: boolean;
+        dimensions?: Array<{
+            name: string;
+        }>;
+    };
+}
+/** The metrics one `spanmetrics` connector emits, and the labels a query selects them by. */
+export interface SpanMetricsNames {
+    /** The connector's namespace (empty: no prefix). */
+    namespace: string;
+    /** Span count; `status.code` = `STATUS_CODE_ERROR` selects the errors. */
+    calls: CollectorMetric;
+    /** Span duration histogram. Absent when `histogram.disable` is set. */
+    duration?: CollectorMetric;
+    /** Span event count. Present only when `events.enabled` is set. */
+    events?: CollectorMetric;
+    /**
+     * The default dimensions as Prometheus labels. One is absent when
+     * `exclude_dimensions` leaves it out, so a query can't select by it.
+     */
+    labels: {
+        service?: string;
+        spanName?: string;
+        spanKind?: string;
+        statusCode?: string;
+    };
+    /** The `status_code` value of an error span. */
+    errorStatus: string;
+}
+type Declared = {
+    componentType?: unknown;
+    props?: unknown;
+};
+/**
+ * The Prometheus names of the metrics a `spanmetrics` connector emits, read
+ * from its declaration: its namespace, dimensions and histogram unit, and
+ * optionally the `prometheus` exporter's namespace and suffix setting.
+ *
+ * @example
+ * ```ts
+ * const spans = new SpanMetricsConnector({ namespace: "shop", histogram: { unit: "s" } });
+ * spanMetricsNames(spans).calls.prometheus;    // "shop_calls_total"
+ * spanMetricsNames(spans).duration!.prometheus; // "shop_duration_seconds"
+ * ```
+ */
+export declare function spanMetricsNames(connector: SpanMetricsNamingConfig | Declared, exporter?: PrometheusNaming | {
+    props?: PrometheusNaming;
+}): SpanMetricsNames;
+export {};
+//# sourceMappingURL=metric-names.d.ts.map

package/dist/metric-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-names.d.ts","sourceRoot":"","sources":["../src/metric-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,oGAAoG;AACpG,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,WAAW,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uGAAuG;IACvG,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,mGAAmG;AACnG,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAA6E,CAAC;AAE1I,8DAA8D;AAC9D,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAEnE,qGAAqG;AACrG,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAYrD,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,gBAAqB,GAAG,MAAM,CAQlI;AAED,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrC,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,GAAG,GAAG,CAAC;QAAC,UAAU,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC3F,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CACtE;AAED,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,KAAK,EAAE,eAAe,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,mEAAmE;IACnE,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxF,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,QAAQ,GAAG;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAW7D;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,uBAAuB,GAAG,QAAQ,EAC7C,QAAQ,CAAC,EAAE,gBAAgB,GAAG;IAAE,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,GACzD,gBAAgB,CAsClB"}

package/dist/model.d.ts

@@ -10,14 +10,33 @@
 /** The three signals a collector pipeline can carry. */
 export declare const SIGNALS: readonly ["traces", "metrics", "logs"];
 export type Signal = (typeof SIGNALS)[number];
-/** The component kinds this lexicon types. Connectors are not modeled yet. */
-export declare const COMPONENT_KINDS: readonly ["receiver", "processor", "exporter", "extension"];
+/**
+ * The component kinds this lexicon types. A connector is an exporter in one
+ * pipeline and a receiver in another, which is how one pipeline feeds another
+ * (traces into span metrics, say).
+ */
+export declare const COMPONENT_KINDS: readonly ["receiver", "processor", "exporter", "connector", "extension"];
 export type ComponentKind = (typeof COMPONENT_KINDS)[number];
+/** A top-level config section that holds components. */
+export type ComponentSection = "receivers" | "processors" | "exporters" | "connectors" | "extensions";
 /** The top-level config section each component kind lives under. */
-export declare const SECTION_OF: Record<ComponentKind, "receivers" | "processors" | "exporters" | "extensions">;
+export declare const SECTION_OF: Record<ComponentKind, ComponentSection>;
+/**
+ * One signal pair a connector supports: it is an exporter in a `from`
+ * pipeline and a receiver in a `to` pipeline. `spanmetrics` has one,
+ * traces to metrics; `forward` has one per signal. `profiles` is the
+ * collector's experimental fourth signal, which `count` reads.
+ */
+export interface ConnectorSignalPair {
+    from: Signal | "profiles";
+    to: Signal | "profiles";
+}
 /** A component id, `type` or `type/name`, exactly as the collector spells it. */
 export type ComponentId = string;
-/** One pipeline under `service.pipelines`. */
+/**
+ * One pipeline under `service.pipelines`. `receivers` and `exporters` may name
+ * connectors as well as receivers and exporters.
+ */
 export interface PipelineConfig {
     receivers?: ComponentId[];
     processors?: ComponentId[];

package/dist/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wDAAwD;AACxD,eAAO,MAAM,OAAO,wCAAyC,CAAC;AAC9D,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,8EAA8E;AAC9E,eAAO,MAAM,eAAe,6DAA8D,CAAC;AAC3F,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,oEAAoE;AACpE,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAKrG,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAED,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAKD,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAEpE;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIxF;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAQjF"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wDAAwD;AACxD,eAAO,MAAM,OAAO,wCAAyC,CAAC;AAC9D,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,eAAe,0EAA2E,CAAC;AACxG,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;AAEtG,oEAAoE;AACpE,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAM9D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC;CACzB;AAED,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAED,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAKD,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAEpE;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIxF;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAQjF"}

package/dist/okf/index.md

@@ -6,23 +6,37 @@ okf_version: '0.2'
 
 * [AttributesProcessor](/types/AttributesProcessor.md) - OTel::Processor::attributes
 * [BatchProcessor](/types/BatchProcessor.md) - OTel::Processor::batch
+* [CountConnector](/types/CountConnector.md) - OTel::Connector::count
 * [DebugExporter](/types/DebugExporter.md) - OTel::Exporter::debug
 * [FileLogReceiver](/types/FileLogReceiver.md) - OTel::Receiver::filelog
+* [FilterProcessor](/types/FilterProcessor.md) - OTel::Processor::filter
+* [ForwardConnector](/types/ForwardConnector.md) - OTel::Connector::forward
 * [GoogleCloudExporter](/types/GoogleCloudExporter.md) - OTel::Exporter::googlecloud
 * [HealthCheckExtension](/types/HealthCheckExtension.md) - OTel::Extension::health_check
 * [HostMetricsReceiver](/types/HostMetricsReceiver.md) - OTel::Receiver::hostmetrics
 * [K8sAttributesProcessor](/types/K8sAttributesProcessor.md) - OTel::Processor::k8sattributes
+* [K8sClusterReceiver](/types/K8sClusterReceiver.md) - OTel::Receiver::k8s_cluster
+* [KubeletStatsReceiver](/types/KubeletStatsReceiver.md) - OTel::Receiver::kubeletstats
+* [LoadBalancingExporter](/types/LoadBalancingExporter.md) - OTel::Exporter::loadbalancing
 * [MemoryLimiterProcessor](/types/MemoryLimiterProcessor.md) - OTel::Processor::memory_limiter
 * [OtlpExporter](/types/OtlpExporter.md) - OTel::Exporter::otlp
 * [OtlpHttpExporter](/types/OtlpHttpExporter.md) - OTel::Exporter::otlphttp
 * [OtlpReceiver](/types/OtlpReceiver.md) - OTel::Receiver::otlp
 * [Pipeline](/types/Pipeline.md) - OTel::Pipeline
 * [PprofExtension](/types/PprofExtension.md) - OTel::Extension::pprof
+* [ProbabilisticSamplerProcessor](/types/ProbabilisticSamplerProcessor.md) - OTel::Processor::probabilistic_sampler
 * [PrometheusExporter](/types/PrometheusExporter.md) - OTel::Exporter::prometheus
 * [PrometheusReceiver](/types/PrometheusReceiver.md) - OTel::Receiver::prometheus
+* [RedactionProcessor](/types/RedactionProcessor.md) - OTel::Processor::redaction
 * [ResourceDetectionProcessor](/types/ResourceDetectionProcessor.md) - OTel::Processor::resourcedetection
 * [ResourceProcessor](/types/ResourceProcessor.md) - OTel::Processor::resource
+* [RoutingConnector](/types/RoutingConnector.md) - OTel::Connector::routing
 * [Service](/types/Service.md) - OTel::Service
+* [ServiceGraphConnector](/types/ServiceGraphConnector.md) - OTel::Connector::servicegraph
+* [SpanMetricsConnector](/types/SpanMetricsConnector.md) - OTel::Connector::spanmetrics
+* [SumConnector](/types/SumConnector.md) - OTel::Connector::sum
+* [TailSamplingProcessor](/types/TailSamplingProcessor.md) - OTel::Processor::tail_sampling
+* [TransformProcessor](/types/TransformProcessor.md) - OTel::Processor::transform
 * [ZPagesExtension](/types/ZPagesExtension.md) - OTel::Extension::zpages
 
 # Rules
@@ -38,3 +52,4 @@ okf_version: '0.2'
 * [OTEL107](/rules/OTEL107.md) - A component's config breaks its definition's rules
 * [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

package/dist/okf/rules/OTEL112.md

@@ -0,0 +1,11 @@
+---
+type: post-synth-check
+title: OTEL112
+description: A connector joins pipelines whose signals it does not convert
+id: OTEL112
+severity: error
+category: post-synth
+lexicon: otel
+docs: https://intentius.io/chant/lexicons/otel/rules/
+---
+A connector joins pipelines whose signals it does not convert

package/dist/okf/types/CountConnector.md

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

package/dist/okf/types/FilterProcessor.md

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

package/dist/okf/types/ForwardConnector.md

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

package/dist/okf/types/K8sClusterReceiver.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: K8sClusterReceiver
+description: otel resource type OTel::Receiver::k8s_cluster
+name: K8sClusterReceiver
+lexicon: otel
+resource_type: OTel::Receiver::k8s_cluster
+---
+`OTel::Receiver::k8s_cluster`, a resource type of the otel lexicon.

package/dist/okf/types/KubeletStatsReceiver.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: KubeletStatsReceiver
+description: otel resource type OTel::Receiver::kubeletstats
+name: KubeletStatsReceiver
+lexicon: otel
+resource_type: OTel::Receiver::kubeletstats
+---
+`OTel::Receiver::kubeletstats`, a resource type of the otel lexicon.

package/dist/okf/types/LoadBalancingExporter.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: LoadBalancingExporter
+description: otel resource type OTel::Exporter::loadbalancing
+name: LoadBalancingExporter
+lexicon: otel
+resource_type: OTel::Exporter::loadbalancing
+---
+`OTel::Exporter::loadbalancing`, a resource type of the otel lexicon.

package/dist/okf/types/ProbabilisticSamplerProcessor.md

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

package/dist/okf/types/RedactionProcessor.md

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

package/dist/okf/types/RoutingConnector.md

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

package/dist/okf/types/ServiceGraphConnector.md

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

package/dist/okf/types/SpanMetricsConnector.md

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

package/dist/okf/types/SumConnector.md

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

package/dist/okf/types/TailSamplingProcessor.md

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

package/dist/okf/types/TransformProcessor.md

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

package/dist/pipeline.d.ts

@@ -5,19 +5,25 @@
  * keeps the reference checked by TypeScript, or by id string (`otlp/backend`)
  * for a component declared somewhere chant can't see. OTEL101 catches a
  * string that names nothing declared.
+ *
+ * A connector goes in `exporters` of the pipeline that feeds it and in
+ * `receivers` of the pipeline it feeds. The same entity on both sides is what
+ * joins the two pipelines.
  */
 import type { Declarable } from "@intentius/chant/declarable";
 import type { OTelComponent } from "./define.js";
 import { type ComponentKind, type Signal } from "./model.js";
-/** A reference to a component of kind `K`: the declared entity, or its id. */
+/** A reference to a component of kind `K` (or of any kind in a union): the declared entity, or its id. */
 export type ComponentRef<K extends ComponentKind> = OTelComponent<K, string, any> | string;
 export interface PipelineProps {
     signal: Signal;
     /** The instance name. The pipeline id becomes `signal/name`. */
     name?: string;
-    receivers: ComponentRef<"receiver">[];
+    /** Receivers, and connectors this pipeline takes data from. */
+    receivers: ComponentRef<"receiver" | "connector">[];
     processors?: ComponentRef<"processor">[];
-    exporters: ComponentRef<"exporter">[];
+    /** Exporters, and connectors this pipeline hands data to. */
+    exporters: ComponentRef<"exporter" | "connector">[];
 }
 export interface PipelineEntity extends Declarable {
     readonly props: PipelineProps;

package/dist/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAEvE,8EAA8E;AAE9E,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,aAAa,IAAI,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;AAE3F,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;IACtC,UAAU,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;IACzC,SAAS,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAC9C,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAI5C,2CAA2C;AAC3C,eAAO,MAAM,QAAQ,EAGL,KAAK,KAAK,EAAE,aAAa,KAAK,cAAc,CAAC;AAG7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC5C,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;QAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;QACjD,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KAC1C,CAAC;IACF,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED,mFAAmF;AACnF,eAAO,MAAM,OAAO,EAA0D,KAAK,KAAK,EAAE,YAAY,KAAK,aAAa,CAAC;AAEzH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAEvE,0GAA0G;AAE1G,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,aAAa,IAAI,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;AAE3F,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,SAAS,EAAE,YAAY,CAAC,UAAU,GAAG,WAAW,CAAC,EAAE,CAAC;IACpD,UAAU,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;IACzC,6DAA6D;IAC7D,SAAS,EAAE,YAAY,CAAC,UAAU,GAAG,WAAW,CAAC,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAC9C,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAI5C,2CAA2C;AAC3C,eAAO,MAAM,QAAQ,EAGL,KAAK,KAAK,EAAE,aAAa,KAAK,cAAc,CAAC;AAG7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC5C,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;QAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;IACF,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;QACjD,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KAC1C,CAAC;IACF,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED,mFAAmF;AACnF,eAAO,MAAM,OAAO,EAA0D,KAAK,KAAK,EAAE,YAAY,KAAK,aAAa,CAAC;AAEzH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}

package/dist/plugin.d.ts

@@ -2,7 +2,7 @@ import type { LexiconPlugin } from "@intentius/chant/lexicon";
 /**
  * OpenTelemetry Collector lexicon plugin.
  *
- * Typed receivers, processors, exporters and extensions, pipelines and the
+ * Typed receivers, processors, exporters, connectors and extensions, pipelines and the
  * service block, serialized to one collector config file. A component chant
  * doesn't ship comes in through `defineComponent`, and is serialized and
  * checked the same way as the built-ins.

package/dist/rules/otel-helpers.ts

@@ -52,7 +52,7 @@ function toDiagnostic(issue: CollectorIssue, source?: string): PostSynthDiagnost
   };
 }
 
-/** 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 function configDiagnostics(ctx: PostSynthContext, code: CollectorIssueCode): PostSynthDiagnostic[] {
   return collectorConfigs(ctx).flatMap(({ source, config }) =>
     validateCollectorConfig(config)

package/dist/rules/otel101.ts

@@ -1,7 +1,7 @@
 /**
  * OTEL101: A pipeline uses a receiver, processor or exporter that is not declared
  *
- * The collector refuses to start on this. Typed entity references cannot go wrong this way, so it mostly catches id strings (`"otlp/backend"`) and hand-edited or parsed configs. A connector id is accepted in receivers and exporters.
+ * The collector refuses to start on this. Typed entity references cannot go wrong this way, so it mostly catches id strings (`"otlp/backend"`) and hand-edited or parsed configs. A connector id is accepted in receivers and exporters, but a connector counts as used only when one pipeline lists it as an exporter and another lists it as a receiver; listed on one side only, it fails this check.
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";

package/dist/rules/otel103.ts

@@ -1,7 +1,7 @@
 /**
  * OTEL103: A declared component is never used
  *
- * A receiver, processor or exporter no pipeline lists, or an extension missing from service.extensions, is ignored by the collector. Usually it means a pipeline was meant to list it. A warning, since the config still runs.
+ * A receiver, processor, exporter or connector no pipeline lists, or an extension missing from service.extensions, is ignored by the collector. Usually it means a pipeline was meant to list it. A warning, since the config still runs.
  */
 
 import type { PostSynthCheck, PostSynthContext, PostSynthDiagnostic } from "@intentius/chant/lint/post-synth";