@intentius/chant-lexicon-otel 0.106.4 → 0.108.0

package/dist/op/builders.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Typed step builders for this lexicon's Op activities (#3369), following
+ * the helm and fly builders: each one's options ARE the activity's own
+ * `*Args` interface (minus its `_`-prefixed test seams), so the builder and
+ * the implementation cannot drift, and every field also takes a
+ * `StepOutputRef`. `profile` and `id` go to the step, never into args, so
+ * `.out` works once an id is given.
+ */
+import { type ActivityStep, type NamedActivityStep, type WithStepRefs } from "@intentius/chant/op";
+import type { OtelcolValidateArgs, OtelcolComponentsArgs } from "./activities/otelcol.js";
+import type { CollectorHealthObserveArgs } from "./activities/collector-health.js";
+import type { CollectorAuditArgs } from "./activities/collector-audit.js";
+type StepOpts = {
+    profile?: ActivityStep["profile"];
+    id?: string;
+};
+/** An activity's args as an author writes them: without the test seams. */
+type Authored<T> = Omit<T, `_${string}`>;
+/**
+ * Run `otelcol validate` over a collector config file. Refuses when the
+ * binary is not `COLLECTOR_PIN`'s version, unless `version` names the one it
+ * must be. Defaults to the `fastIdempotent` profile.
+ */
+export declare const otelcolValidate: (args: WithStepRefs<Authored<OtelcolValidateArgs>> & StepOpts) => NamedActivityStep;
+/**
+ * Check a collector config uses only components the binary was built with,
+ * from `otelcol components`. Defaults to the `fastIdempotent` profile.
+ */
+export declare const otelcolComponents: (args: WithStepRefs<Authored<OtelcolComponentsArgs>> & StepOpts) => NamedActivityStep;
+/**
+ * Observe running collectors for a `ConvergeOp({ observe })`: one resource
+ * per collector, from the health_check, zpages and internal-telemetry
+ * endpoints its config declares. No `health_check` in `service.extensions`
+ * is `unknown`. Defaults to the `fastIdempotent` profile.
+ */
+export declare const collectorHealthObserve: (args: WithStepRefs<Authored<CollectorHealthObserveArgs>> & StepOpts) => NamedActivityStep;
+/**
+ * Audit the lexicon's pins against upstream releases (the step of
+ * `CollectorAuditOp`). Defaults to the `fastIdempotent` profile.
+ */
+export declare const collectorAudit: (args?: WithStepRefs<Authored<CollectorAuditArgs>> & StepOpts) => NamedActivityStep;
+export {};
+//# sourceMappingURL=builders.d.ts.map

package/dist/op/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/op/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA8B,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/H,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,KAAK,QAAQ,GAAG;IAAE,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACnE,2EAA2E;AAC3E,KAAK,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC,CAAC;AASzC;;;;GAIG;AACH,eAAO,MAAM,eAAe,oEAX8B,iBAWmC,CAAC;AAE9F;;;GAGG;AACH,eAAO,MAAM,iBAAiB,sEAjB4B,iBAiByC,CAAC;AAEpG;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,2EAzBuB,iBAyBwD,CAAC;AAEnH;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAU,YAAY,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,GAAG,QAAQ,KAAQ,iBAC9B,CAAC"}

package/dist/platform.d.ts

@@ -10,6 +10,7 @@
  */
 import type { Declarable } from "@intentius/chant/declarable";
 import { type OTelComponent } from "./define.js";
+import { type PipelineEntity } from "./pipeline.js";
 import { type CollectorConfig, type Signal } from "./model.js";
 /** The contrib collector image at the version the built-in components are typed against. */
 export declare const COLLECTOR_IMAGE: string;
@@ -23,6 +24,19 @@ export interface OtlpCollectorOptions {
     /** Serve `health_check` on 0.0.0.0:13133. Default: true. */
     healthCheck?: boolean;
 }
+/** The parts of `otlpCollector()`'s config, by name. */
+export interface OtlpCollectorParts {
+    otlp: OTelComponent<"receiver", "otlp", object>;
+    memoryLimiter: OTelComponent<"processor", "memory_limiter", object>;
+    batch: OTelComponent<"processor", "batch", object>;
+    exporters: OTelComponent<"exporter", string, any>[];
+    /** Absent with `healthCheck: false`. */
+    health?: OTelComponent<"extension", "health_check", object>;
+    /** One pipeline per signal asked for. */
+    pipelines: Partial<Record<Signal, PipelineEntity>>;
+}
+/** `otlpCollector()`'s config by part, for the `OtlpCollector` composite. A signal listed twice gets one pipeline. */
+export declare function otlpCollectorParts(options?: OtlpCollectorOptions): OtlpCollectorParts;
 /**
  * The entities of a small OTLP collector: an `otlp` receiver on 4317 (gRPC)
  * and 4318 (HTTP), `memory_limiter` then `batch`, the given exporters, and a

package/dist/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAM7D,OAAO,EAA6B,KAAK,eAAe,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAGvF,4FAA4F;AAC5F,eAAO,MAAM,eAAe,QAAoF,CAAC;AAEjH,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,SAAS,CAAC,EAAE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IACrD,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,UAAU,EAAE,CAoB9E;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,4GAA4G;IAC5G,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AA+BD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAiC9E"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAK7D,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAA6B,KAAK,eAAe,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAGvF,4FAA4F;AAC5F,eAAO,MAAM,eAAe,QAAoF,CAAC;AAEjH,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,SAAS,CAAC,EAAE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IACrD,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,aAAa,EAAE,aAAa,CAAC,WAAW,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACpE,KAAK,EAAE,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEnD,SAAS,EAAE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IACpD,wCAAwC;IACxC,MAAM,CAAC,EAAE,aAAa,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAC5D,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CACpD;AAmBD,sHAAsH;AACtH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,kBAAkB,CAezF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,UAAU,EAAE,CAS9E;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,4GAA4G;IAC5G,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;;;;OAIG;IACH,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AA+BD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAiC9E"}

package/dist/rules/otel-helpers.ts

@@ -8,7 +8,7 @@ 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 { configMapCollectorConfigs, describeConfigMapConfig, describeOperatorCollectorConfig, operatorCollectorConfig } from "../../configmap";
 import { validateCollectorConfig, validateCollectorEntities, type CollectorIssueCode, type CollectorIssue } from "../../validate-config";
 import { attributionIssues } from "../../attribution";
 
@@ -19,13 +19,16 @@ export interface FoundCollectorConfig {
   config: CollectorConfig;
   /** Set when the config is a value in a Kubernetes ConfigMap (chant #2930). */
   configMap?: { namespace: string; name: string; key: string };
+  /** Set when the config is the `spec.config` of an OpenTelemetry Operator `OpenTelemetryCollector` (chant #3367). */
+  operator?: { namespace: string; name: 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
+ * theirs), and the `spec.config` of an OpenTelemetry Operator
+ * `OpenTelemetryCollector` (chant #3367). 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.
  *
@@ -57,6 +60,8 @@ export function collectorConfigs(ctx: PostSynthContext): FoundCollectorConfig[]
         for (const { config, ...configMap } of configMapCollectorConfigs(doc)) {
           out.push({ source, config, configMap });
         }
+        const cr = operatorCollectorConfig(doc);
+        if (cr) out.push({ source, config: cr.config, operator: { namespace: cr.namespace, name: cr.name } });
       }
     }
   }
@@ -64,7 +69,11 @@ export function collectorConfigs(ctx: PostSynthContext): FoundCollectorConfig[]
 }
 
 function toDiagnostic(issue: CollectorIssue, found?: Omit<FoundCollectorConfig, "config">): PostSynthDiagnostic {
-  const where = found?.configMap ? describeConfigMapConfig(found.configMap) : found && found.source !== "otel" ? found.source : undefined;
+  const where = found?.configMap
+    ? describeConfigMapConfig(found.configMap)
+    : found?.operator
+      ? describeOperatorCollectorConfig(found.operator)
+      : found && found.source !== "otel" ? found.source : undefined;
   return {
     checkId: issue.code,
     severity: issue.severity,
@@ -87,11 +96,15 @@ function configIssues(ctx: PostSynthContext, config: CollectorConfig): Collector
 /**
  * Every config-level diagnostic (OTEL101-OTEL106, OTEL112-OTEL127 and any later
  * config check) over the collector configs in the output. `configMapsOnly`
- * keeps the configs held in ConfigMaps, which is what WK8604 reads.
+ * keeps the configs held in ConfigMaps. `hostedOnly` keeps those and the `spec.config` of an operator `OpenTelemetryCollector`, which is what WK8604 reads.
  */
-export function collectorConfigDiagnostics(ctx: PostSynthContext, opts: { configMapsOnly?: boolean } = {}): PostSynthDiagnostic[] {
+export function collectorConfigDiagnostics(
+  ctx: PostSynthContext,
+  opts: { configMapsOnly?: boolean; hostedOnly?: boolean } = {},
+): PostSynthDiagnostic[] {
   return collectorConfigs(ctx)
     .filter((found) => !opts.configMapsOnly || found.configMap)
+    .filter((found) => !opts.hostedOnly || found.configMap || found.operator)
     .flatMap(({ config, ...found }) => configIssues(ctx, config).map((i) => toDiagnostic(i, found)));
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-otel",
-  "version": "0.106.4",
+  "version": "0.108.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",
@@ -41,6 +41,16 @@
       "types": "./dist/*.d.ts",
       "default": "./src/*.ts"
     },
+    "./op/activities": {
+      "development": "./src/op/activities/index.ts",
+      "types": "./dist/op/activities/index.d.ts",
+      "default": "./src/op/activities/index.ts"
+    },
+    "./op/activity-contracts": {
+      "development": "./src/op/activity-contracts.ts",
+      "types": "./dist/op/activity-contracts.d.ts",
+      "default": "./src/op/activity-contracts.ts"
+    },
     "./lint/post-synth": {
       "development": "./src/lint/post-synth/index.ts",
       "types": "./dist/lint/post-synth/index.d.ts",
@@ -59,7 +69,8 @@
     "build": "../../scripts/tsc7.sh -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && find dist -type f \\( -name \"*.js\" -o -name \"*.js.map\" \\) -delete"
   },
   "dependencies": {
-    "js-yaml": "^4.3.1"
+    "js-yaml": "^4.3.1",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@intentius/chant": "*",
@@ -68,7 +79,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.106.4",
+    "@intentius/chant": "^0.108.0",
     "typescript": "^5.9.3"
   }
 }

package/src/collector.ts

@@ -153,3 +153,12 @@ export function collectorYaml(entities: Iterable<Declarable> | Map<string, Decla
   const built = buildCollectorConfig(entities);
   return emitCollectorYaml(built.config, { header: built.header });
 }
+
+/**
+ * The collector config object for a set of declared entities, for a host that
+ * holds the config as an object rather than as text: the OpenTelemetry
+ * Operator's `OpenTelemetryCollector` `spec.config` (v1beta1).
+ */
+export function collectorConfig(entities: Iterable<Declarable> | Map<string, Declarable>): CollectorConfig {
+  return buildCollectorConfig(entities).config;
+}

package/src/composites/catalog.test.ts

@@ -19,7 +19,7 @@ const catalogued = compositeCatalog.map((entry) => entry.name).sort();
 
 describe("the otel composite catalog", () => {
   test("every exported composite has an entry, and every entry names an exported composite", () => {
-    expect(exported).toEqual(["NodeAgent"]);
+    expect(exported).toEqual(["GenAiPipeline", "NodeAgent", "OtlpCollector", "RedMetrics", "TailSamplingTier"]);
     expect(catalogued, "regenerate with `npm run generate:composite-catalogs -- otel`").toEqual(exported);
   });
 

package/src/composites/catalog.ts

@@ -4,6 +4,131 @@
 import type { CompositeEntry } from "@intentius/chant/lexicon";
 
 export const compositeCatalog: CompositeEntry[] = [
+  {
+    "name": "GenAiPipeline",
+    "lexicon": "otel",
+    "description": "The collector config of an OTLP collector for GenAI workloads, from the GenAI preset.",
+    "bundles": [
+      "BatchProcessor",
+      "DebugExporter",
+      "DeltaToCumulativeProcessor",
+      "FilterProcessor",
+      "ForwardConnector",
+      "HealthCheckExtension",
+      "MemoryLimiterProcessor",
+      "OtlpReceiver",
+      "Pipeline",
+      "RedactionProcessor",
+      "SignalToMetricsConnector",
+      "SpanMetricsConnector",
+      "SumConnector",
+      "TransformProcessor"
+    ],
+    "params": [
+      {
+        "name": "traceExporters",
+        "type": "Exporter[]",
+        "required": false,
+        "description": "Where traces go."
+      },
+      {
+        "name": "metricExporters",
+        "type": "Exporter[]",
+        "required": false,
+        "description": "Where the span and token metrics go, and with `clientMetrics` the SDK's metrics too."
+      },
+      {
+        "name": "logExporters",
+        "type": "Exporter[]",
+        "required": false,
+        "description": "Where logs (and events sent as logs) go."
+      },
+      {
+        "name": "logs",
+        "type": "boolean",
+        "required": false,
+        "description": "Give logs a pipeline, so event-based content is removed too."
+      },
+      {
+        "name": "sampling",
+        "type": "Processor[]",
+        "required": false,
+        "description": "Processors that thin exported traces, such as `tail_sampling`."
+      },
+      {
+        "name": "healthCheck",
+        "type": "boolean",
+        "required": false,
+        "description": "Serve `health_check` on 0.0.0.0:13133."
+      },
+      {
+        "name": "deltaToCumulative",
+        "type": "boolean | \"auto\"",
+        "required": false,
+        "description": "Put a `deltatocumulative/genai` processor in front of `batch` on `metrics/genai`, so the delta token sums of the `sum` connector, and with `clientMetrics."
+      },
+      {
+        "name": "keepContent",
+        "type": "boolean",
+        "required": false,
+        "description": "Keep content attributes and bodies."
+      },
+      {
+        "name": "contentAttributes",
+        "type": "string[]",
+        "required": false,
+        "description": "More attribute keys that hold content, deleted along with the convention ones."
+      },
+      {
+        "name": "maskValues",
+        "type": "string[]",
+        "required": false,
+        "description": "RE2 patterns masked in every attribute value (redaction `blocked_values`), whether content is kept or not."
+      },
+      {
+        "name": "hashFunction",
+        "type": "RedactionProcessorConfig[\"hash_function\"]",
+        "required": false,
+        "description": "Hash masked values with this function instead of writing `****`."
+      },
+      {
+        "name": "buckets",
+        "type": "Duration[]",
+        "required": false,
+        "description": "Duration histogram buckets."
+      },
+      {
+        "name": "metricsFlushInterval",
+        "type": "Duration",
+        "required": false,
+        "description": "How often span and token metrics are flushed."
+      },
+      {
+        "name": "namespace",
+        "type": "string",
+        "required": false,
+        "description": "Prefix of the emitted metric names."
+      },
+      {
+        "name": "dimensions",
+        "type": "SpanMetricsDimension[]",
+        "required": false,
+        "description": "Dimensions added to the span metrics beyond the GenAI ones."
+      },
+      {
+        "name": "providerDimensions",
+        "type": "boolean",
+        "required": false,
+        "description": "Add `gen_ai.provider.name` and `gen_ai.response.model` to `genai.calls` and `genai.duration`."
+      },
+      {
+        "name": "clientMetrics",
+        "type": "GenAiClientMetricsSource",
+        "required": false,
+        "description": "Also produce the conventions' client metrics, `gen_ai.client.operation.duration` and `gen_ai.client.token.usage`."
+      }
+    ]
+  },
   {
     "name": "NodeAgent",
     "lexicon": "otel",
@@ -77,5 +202,172 @@ export const compositeCatalog: CompositeEntry[] = [
         "description": "Serve `health_check` on 0.0.0.0:13133 (default: on)."
       }
     ]
+  },
+  {
+    "name": "OtlpCollector",
+    "lexicon": "otel",
+    "description": "A small OTLP collector config: OTLP in, `memory_limiter` and `batch`, the given exporters out, for each signal.",
+    "bundles": [
+      "BatchProcessor",
+      "DebugExporter",
+      "HealthCheckExtension",
+      "MemoryLimiterProcessor",
+      "OtlpReceiver",
+      "Pipeline"
+    ],
+    "params": [
+      {
+        "name": "exporters",
+        "type": "OTelComponent<\"exporter\", string, any>[]",
+        "required": false,
+        "description": "Where telemetry goes."
+      },
+      {
+        "name": "signals",
+        "type": "Signal[]",
+        "required": false,
+        "description": "Which signals get a pipeline."
+      },
+      {
+        "name": "healthCheck",
+        "type": "boolean",
+        "required": false,
+        "description": "Serve `health_check` on 0.0.0.0:13133."
+      }
+    ]
+  },
+  {
+    "name": "RedMetrics",
+    "lexicon": "otel",
+    "description": "RED metrics from traces: `spanmetrics` and `servicegraph` connectors feeding a `prometheus` exporter.",
+    "bundles": [
+      "BatchProcessor",
+      "MemoryLimiterProcessor",
+      "OtlpReceiver",
+      "Pipeline",
+      "PrometheusExporter",
+      "ServiceGraphConnector",
+      "SpanMetricsConnector"
+    ],
+    "params": [
+      {
+        "name": "receivers",
+        "type": "TraceSource[]",
+        "required": false,
+        "description": "Where spans come from: receivers, or a connector from another traces pipeline."
+      },
+      {
+        "name": "traceExporters",
+        "type": "Exporter[]",
+        "required": false,
+        "description": "Where traces go besides the connectors, e.g. a tracing backend."
+      },
+      {
+        "name": "exporter",
+        "type": "OTelComponent<\"exporter\", \"prometheus\", PrometheusExporterConfig>",
+        "required": false,
+        "description": "The `prometheus` exporter the metrics are served on."
+      },
+      {
+        "name": "spanMetrics",
+        "type": "SpanMetricsConnectorConfig",
+        "required": false,
+        "description": "The `spanmetrics` connector's config: namespace, dimensions, histogram unit and buckets (default: the connector's defaults)."
+      },
+      {
+        "name": "serviceGraph",
+        "type": "boolean | ServiceGraphConnectorConfig",
+        "required": false,
+        "description": "Service-to-service edge metrics from a `servicegraph` connector (default: on)."
+      },
+      {
+        "name": "memoryLimitMib",
+        "type": "number",
+        "required": false,
+        "description": "`memory_limiter`'s hard limit in MiB (default: 80% of the container's memory, with a 20% spike limit)."
+      },
+      {
+        "name": "name",
+        "type": "string",
+        "required": false,
+        "description": "The instance name of the connectors, the exporter and the two pipelines (default `red`)."
+      }
+    ]
+  },
+  {
+    "name": "TailSamplingTier",
+    "lexicon": "otel",
+    "description": "The collector config of a tail sampling tier: whole traces in, the ones a policy keeps out.",
+    "bundles": [
+      "BatchProcessor",
+      "DebugExporter",
+      "HealthCheckExtension",
+      "MemoryLimiterProcessor",
+      "OtlpReceiver",
+      "Pipeline",
+      "TailSamplingProcessor"
+    ],
+    "params": [
+      {
+        "name": "exporters",
+        "type": "Exporter[]",
+        "required": false,
+        "description": "Where the kept traces go."
+      },
+      {
+        "name": "receivers",
+        "type": "TraceSource[]",
+        "required": false,
+        "description": "Where spans come from."
+      },
+      {
+        "name": "decisionWait",
+        "type": "Duration",
+        "required": false,
+        "description": "How long after a trace's first span the decision is made (default `10s`)."
+      },
+      {
+        "name": "errors",
+        "type": "boolean",
+        "required": false,
+        "description": "Keep every trace with a span ended in error (default: on)."
+      },
+      {
+        "name": "slowerThanMs",
+        "type": "number | false",
+        "required": false,
+        "description": "Keep every trace that took at least this many milliseconds (default 1000; `false` for none)."
+      },
+      {
+        "name": "percentage",
+        "type": "number | false",
+        "required": false,
+        "description": "Keep this percentage of all other traces, by trace id hash (default 10; `false` for none)."
+      },
+      {
+        "name": "policies",
+        "type": "TailSamplingPolicy[]",
+        "required": false,
+        "description": "More policies, evaluated after the ones above."
+      },
+      {
+        "name": "numTraces",
+        "type": "number",
+        "required": false,
+        "description": "How many traces to hold in memory at once (default: the collector's 50000)."
+      },
+      {
+        "name": "memoryLimitMib",
+        "type": "number",
+        "required": false,
+        "description": "`memory_limiter`'s hard limit in MiB (default: 80% of the container's memory, with a 20% spike limit)."
+      },
+      {
+        "name": "healthCheck",
+        "type": "boolean",
+        "required": false,
+        "description": "Serve `health_check` on 0.0.0.0:13133 (default: on)."
+      }
+    ]
   }
 ];

package/src/composites/genai-pipeline.test.ts

@@ -0,0 +1,53 @@
+/**
+ * `GenAiPipeline`: the composite declares exactly the config
+ * `genAiPipeline()` returns, with each entity under a member name.
+ */
+import { describe, expect, test } from "vitest";
+import type { Declarable } from "@intentius/chant/declarable";
+import { GenAiPipeline } from "./index";
+import { genAiPipeline, type GenAiPipelineOptions } from "../genai";
+import { PrometheusExporter } from "../components/exporters";
+import { TailSamplingProcessor } from "../components/sampling";
+import { collectorYaml } from "../collector";
+
+const yamlOf = (entities: Declarable[]) => collectorYaml(entities);
+
+describe("GenAiPipeline", () => {
+  const sampling = [new TailSamplingProcessor({ decision_wait: "10s", policies: [{ name: "errors", type: "status_code", status_code: { status_codes: ["ERROR"] } }] })];
+  const cases: Array<[string, GenAiPipelineOptions]> = [
+    ["the defaults", {}],
+    ["client metrics derived to a prometheus exporter", { clientMetrics: "derive", metricExporters: [new PrometheusExporter({ endpoint: "0.0.0.0:8889" })] }],
+    ["sampling, no logs, no health check", { sampling, logs: false, healthCheck: false }],
+  ];
+
+  test.each(cases)("%s: the same config as genAiPipeline()", (_label, options) => {
+    const composite = GenAiPipeline(options);
+    expect(yamlOf(Object.values(composite.members) as Declarable[])).toBe(yamlOf(genAiPipeline(options)));
+    expect(Object.values(composite.members)).toHaveLength(genAiPipeline(options).length);
+  });
+
+  test("the members are named after their parts, and the parts that are off are absent", () => {
+    expect(Object.keys(GenAiPipeline({}).members)).toEqual(["otlp", "traces", "genAiTraces", "genAiMetrics", "logs", "health"]);
+    expect(Object.keys(GenAiPipeline({ clientMetrics: "passthrough" }).members)).toContain("sdkMetrics");
+    expect(Object.keys(GenAiPipeline({ sampling, logs: false, healthCheck: false }).members)).toEqual([
+      "otlp",
+      "traces",
+      "sampled",
+      "genAiTraces",
+      "genAiMetrics",
+    ]);
+  });
+
+  test("genAiPipeline() still returns its entities in the order it always has: receiver, pipelines, extension", () => {
+    const ids = genAiPipeline().map((e) => (e as { pipelineId?: string; componentId?: string }).pipelineId ?? (e as { componentId?: string }).componentId);
+    expect(ids).toEqual(["otlp", "traces", "traces/genai", "metrics/genai", "logs", "health_check"]);
+  });
+
+  test("the pipeline ids are the preset's", () => {
+    const g = GenAiPipeline({ sampling });
+    expect(g.traces.pipelineId).toBe("traces");
+    expect(g.sampled?.pipelineId).toBe("traces/sampled");
+    expect(g.genAiTraces.pipelineId).toBe("traces/genai");
+    expect(g.genAiMetrics.pipelineId).toBe("metrics/genai");
+  });
+});

package/src/composites/genai-pipeline.ts

@@ -0,0 +1,40 @@
+/**
+ * `GenAiPipeline`: `genAiPipeline()` as a composite.
+ *
+ * The same collector config `genAiPipeline(options)` returns as a list (an
+ * `otlp` receiver, content removal on traces and logs, a `traces/genai`
+ * branch that turns GenAI spans into metrics before any sampling, and a
+ * `metrics/genai` pipeline that exports them), with each entity under a
+ * member name, so a project exports one declaration and reads the parts by
+ * name. The options are `genAiPipeline()`'s; every one has its default.
+ *
+ * The prometheus lexicon's `GenAiRules` reads the metric names from
+ * `genAiMetrics(options)` with the same options.
+ */
+
+import { Composite, type CompositeInstance } from "@intentius/chant/composite";
+import { genAiPipelineParts, type GenAiPipelineOptions, type GenAiPipelineParts } from "../genai";
+
+export type GenAiPipelineProps = GenAiPipelineOptions;
+
+/** The members: `otlp`, `traces`, `sampled` (with `sampling`), `genAiTraces`, `genAiMetrics`, `sdkMetrics` (with `clientMetrics`), `logs` and `health` (unless off). */
+export type GenAiPipelineMembers = GenAiPipelineParts;
+
+export type GenAiPipelineInstance = CompositeInstance<GenAiPipelineMembers> & GenAiPipelineMembers;
+
+/**
+ * The collector config of an OTLP collector for GenAI workloads, from the
+ * GenAI preset.
+ *
+ * @example
+ * ```ts
+ * import { GenAiPipeline, PrometheusExporter } from "@intentius/chant-lexicon-otel";
+ *
+ * const scrape = new PrometheusExporter({ endpoint: "0.0.0.0:8889" });
+ * export const genai = GenAiPipeline({ metricExporters: [scrape], clientMetrics: "derive" });
+ * ```
+ */
+export const GenAiPipeline = Composite<GenAiPipelineProps, GenAiPipelineMembers>(
+  (props) => genAiPipelineParts(props ?? {}),
+  "GenAiPipeline",
+);

package/src/composites/index.ts

@@ -4,3 +4,11 @@
 
 export { NodeAgent, nodeAgentPropsProblem } from "./node-agent";
 export type { NodeAgentProps, NodeAgentMembers, NodeAgentInstance } from "./node-agent";
+export { RedMetrics, redMetricsNames, redMetricsPropsProblem } from "./red-metrics";
+export type { RedMetricsProps, RedMetricsMembers, RedMetricsInstance, RedMetricsNames } from "./red-metrics";
+export { GenAiPipeline } from "./genai-pipeline";
+export type { GenAiPipelineProps, GenAiPipelineMembers, GenAiPipelineInstance } from "./genai-pipeline";
+export { OtlpCollector, otlpCollectorPropsProblem } from "./otlp-collector";
+export type { OtlpCollectorProps, OtlpCollectorMembers, OtlpCollectorInstance } from "./otlp-collector";
+export { TailSamplingTier, tailSamplingTierPropsProblem, tailSamplingLoadBalancer } from "./tail-sampling-tier";
+export type { TailSamplingTierProps, TailSamplingTierMembers, TailSamplingTierInstance } from "./tail-sampling-tier";