@intentius/chant-lexicon-otel 0.106.4 → 0.108.0

package/dist/metric-names.d.ts

@@ -146,5 +146,73 @@ export interface ServiceGraphNames {
 export declare function serviceGraphNames(connector: ServiceGraphNamingConfig | Declared, exporter?: PrometheusNaming | {
     props?: PrometheusNaming;
 }): ServiceGraphNames;
+/** A label matcher: `[label, op, value]`. */
+export type PromMatcher = [label: string, op: "=" | "!=" | "=~" | "!~", value: string];
+/** `metric{a="x", b=~"y"}`; just `metric` with no matchers. */
+export declare function promSelector(metric: string, matchers: PromMatcher[]): string;
+/** `sum by (labels) (rate(sel[range]))`, or `sum (...)` with no labels. */
+export declare function promSumRate(sel: string, by: string[], range: string): string;
+/**
+ * `errors / all` as rates summed by `by`, with the numerator padded to zero:
+ * `(errors or all * 0) / all`. A group with calls but no error series gets 0
+ * instead of dropping out of the result.
+ */
+export declare function promErrorRatio(errorSel: string, allSel: string, by: string[], range: string): string;
+/** A number as PromQL writes it, without float noise. */
+export declare function promNumber(n: number): string;
+/** `histogram_quantile(q, sum by (le, labels) (rate(bucket[range])))`. */
+export declare function promQuantile(q: number, bucketSel: string, by: string[], range: string): string;
+/** The `span_kind` label values the spanmetrics connector writes. */
+export type SpanMetricsKind = "SPAN_KIND_UNSPECIFIED" | "SPAN_KIND_INTERNAL" | "SPAN_KIND_SERVER" | "SPAN_KIND_CLIENT" | "SPAN_KIND_PRODUCER" | "SPAN_KIND_CONSUMER";
+/** Every `span_kind` value, in the order the spec lists them. */
+export declare const SPAN_METRICS_KINDS: readonly SpanMetricsKind[];
+/** The kinds RED queries count unless told otherwise: the spans that serve a request or consume a message. */
+export declare const RED_DEFAULT_SPAN_KINDS: readonly SpanMetricsKind[];
+/** What `spanMetricsRedQueries` takes besides the names. */
+export interface RedQueryOptions {
+    /** The range every `rate` reads: `$__rate_interval` on a dashboard, `5m` in a rule. */
+    range: string;
+    /** Duration quantiles, one expression each (default p50, p95 and p99). */
+    quantiles?: number[];
+    /** A regex the service label must match, e.g. `$service`. Unset: no service matcher. */
+    serviceMatch?: string;
+    /**
+     * The span kinds counted (default server and consumer spans). `[]` counts
+     * every kind. With the default, a connector that excludes `span.kind`
+     * gets no kind filter; naming kinds for such a connector is an error.
+     */
+    spanKinds?: readonly SpanMetricsKind[];
+    /** Labels the results are split by besides the service label. */
+    by?: string[];
+    /** The name errors are reported under, e.g. `RedDashboard`. */
+    owner?: string;
+}
+/** The RED expressions for one spanmetrics connector. */
+export interface RedQueries {
+    /** The service label the results are split by. */
+    service: string;
+    /** The span-kind matcher, or none. */
+    kindMatchers: PromMatcher[];
+    /** Counted spans per second. */
+    rate: string;
+    /** Errors over counted spans, 0 for a service with none. */
+    errorRatio: string;
+    /** One expression per quantile, in the histogram's unit. Empty when the connector has no histogram. */
+    duration: Array<{
+        quantile: number;
+        expr: string;
+    }>;
+}
+/**
+ * The span-kind matcher for `kinds`, or none: none for `[]`, and none for
+ * the default kinds when the connector excludes `span.kind`.
+ */
+export declare function spanKindMatchers(names: SpanMetricsNames, kinds: readonly SpanMetricsKind[] | undefined, owner?: string): PromMatcher[];
+/**
+ * Rate, error ratio and duration quantiles per service, from a spanmetrics
+ * connector's names. The grafana lexicon's `RedDashboard` and the prometheus
+ * lexicon's `RedAlerts` both build their queries here.
+ */
+export declare function spanMetricsRedQueries(names: SpanMetricsNames, options: RedQueryOptions): RedQueries;
 export {};
 //# sourceMappingURL=metric-names.d.ts.map

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

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

package/dist/op/activities/collector-audit.d.ts

@@ -0,0 +1,95 @@
+/**
+ * `collectorAudit`: the otel lexicon's pins against what upstream has
+ * released since (#3369), the activity behind `CollectorAuditOp`.
+ *
+ * Three readings, each against a moving upstream:
+ *
+ * - the contrib release list against `COLLECTOR_PIN`: how many releases
+ *   the pin is behind, and the newest one.
+ * - component stability from each built-in component's `metadata.yaml`, at
+ *   the pin and at the newest release: a signal whose stability level
+ *   changed between the two, and any signal that is `deprecated` or
+ *   `unmaintained` at the newest release. A component's file is looked up
+ *   in contrib, then in core, at `<kind>/<type><kind>/metadata.yaml`; one
+ *   found in neither is listed as unchecked, never as a finding.
+ * - `GENAI_SEMCONV_PIN` against the semantic-conventions releases.
+ *
+ * `mode` says what to do with the findings: `report` returns them;
+ * `issue` keeps one open issue current; `pull-request` also bumps the pins
+ * in the lexicon's `src/define.ts` on a proposal branch and opens (or
+ * edits) a pull request with the findings as its body. Only the pin values
+ * change: the config types written against the old pin are the reviewer's
+ * to move, which the body says.
+ */
+import type { ComponentKind } from "../../model.js";
+import { type CommandRunner } from "./github.js";
+export type CollectorAuditMode = "report" | "issue" | "pull-request";
+export declare const CONTRIB_REPO = "open-telemetry/opentelemetry-collector-contrib";
+export declare const CORE_REPO = "open-telemetry/opentelemetry-collector";
+export declare const SEMCONV_REPO = "open-telemetry/semantic-conventions";
+export interface CollectorAuditArgs {
+    mode?: CollectorAuditMode;
+    /**
+     * The otel lexicon's directory, whose `src/define.ts` a pull request
+     * edits. Default `<cwd>/lexicons/otel`.
+     */
+    lexiconDir?: string;
+    /** Check component stability. Default true. */
+    stability?: boolean;
+    /** At most this many `metadata.yaml` reads. Default 200. */
+    stabilityBudget?: number;
+    /** The proposal branch. Default `chant/otel-pins`. */
+    branch?: string;
+    /** Replaces fetch. For tests. */
+    _fetch?: typeof fetch;
+    /** Replaces git and gh. For tests. */
+    _run?: CommandRunner;
+}
+export type CollectorAuditFindingKind = "collector-pin-behind" | "semconv-pin-behind" | "stability-changed" | "deprecated";
+export interface CollectorAuditFinding {
+    kind: CollectorAuditFindingKind;
+    /** The pin or the component (`receiver/otlp`) the finding is about. */
+    subject: string;
+    detail: string;
+}
+export interface CollectorAuditResult {
+    mode: CollectorAuditMode;
+    collector: {
+        pin: string;
+        latest: string | null;
+        behind: number;
+    };
+    semconv: {
+        pin: string;
+        latest: string | null;
+        behind: number;
+    };
+    findings: CollectorAuditFinding[];
+    /** Components whose metadata.yaml was in neither repository, or past the budget. */
+    unchecked: string[];
+    summary: string;
+    issueUrl?: string;
+    prUrl?: string;
+}
+/** A built-in component's kind and collector type. */
+export interface BuiltinComponent {
+    kind: ComponentKind;
+    type: string;
+}
+export declare function builtinComponents(): BuiltinComponent[];
+/** The directory a component lives in upstream: `receiver/k8s_cluster` is `receiver/k8sclusterreceiver`. */
+export declare function componentDir(c: BuiltinComponent): string;
+/** Stability level by signal, from a `metadata.yaml`'s `status.stability`. */
+export type Stability = Record<string, string>;
+export declare function parseStability(text: string): Stability | undefined;
+/** Findings for one component, from its stability at the pin and at the newest release. */
+export declare function stabilityFindings(c: BuiltinComponent, atPin: Stability | undefined, atLatest: Stability, pin: string, latest: string): CollectorAuditFinding[];
+/** `src/define.ts` with `COLLECTOR_PIN` and `GENAI_SEMCONV_PIN` moved to the given versions. */
+export declare function bumpPins(text: string, to: {
+    collector?: string;
+    genai?: string;
+}): string;
+export declare function renderCollectorAuditSummary(r: Omit<CollectorAuditResult, "summary" | "mode">): string;
+/** Audit the otel lexicon's pins and its built-in components against upstream releases. */
+export declare function collectorAudit(args?: CollectorAuditArgs): Promise<CollectorAuditResult>;
+//# sourceMappingURL=collector-audit.d.ts.map

package/dist/op/activities/collector-audit.d.ts.map

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

package/dist/op/activities/collector-health.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Running collectors as resources a `ConvergeOp` observes (#3369).
+ *
+ * `collectorHealthObserve` returns one resource per collector, from the
+ * endpoints its config declares:
+ *
+ * - the `health_check` extension (`service.extensions`), at its `endpoint`
+ *   and `path`. At v0.130.0 it answers on `localhost:13133` at `/` by
+ *   default, 200 while the collector runs, and reports no per-component
+ *   status, so a 200 is all it says.
+ * - the `zpages` extension, when the service enables it: `/debug/servicez`
+ *   on its endpoint (default `localhost:55679`).
+ * - the collector's own metrics, when `service.telemetry.metrics` declares
+ *   where they are served: a `pull` reader's prometheus exporter
+ *   (`host`/`port`), or the older `address`. `/metrics` on it.
+ *
+ * A collector whose service enables no `health_check` is `unknown`, never
+ * `drifted`: nothing it declares says whether it is healthy. One that does
+ * is `in-sync` when every declared endpoint answers 200, and `drifted`
+ * otherwise, with each endpoint that did not in the detail.
+ *
+ * The config's hosts are where the collector listens, which is often
+ * `0.0.0.0` or a pod address. `host` replaces the host of every endpoint (a
+ * port-forward, a container's published ports), and `endpoints` replaces
+ * whole URLs.
+ */
+export type CollectorEndpointKind = "healthCheck" | "zpages" | "telemetry";
+export interface ObservedCollector {
+    /** The resource name. */
+    name: string;
+    /** The collector config file, relative to the working directory, read on each tick. */
+    config?: string;
+    /** The config itself, in place of `config`. */
+    configObject?: Record<string, unknown>;
+    /** Where the collector is reached, replacing every endpoint's host. Default: the config's host, with 0.0.0.0 and empty read as localhost. */
+    host?: string;
+    /** Whole URLs, replacing the ones read from the config. */
+    endpoints?: Partial<Record<CollectorEndpointKind, string>>;
+}
+export interface CollectorHealthObserveArgs {
+    collectors: ObservedCollector[];
+    /** Per-request timeout, ms. Default 5000. */
+    timeoutMs?: number;
+    /** Probes of a failing endpoint before it counts as down. Default 2. */
+    probes?: number;
+    /** Time between probes, ms. Default 1000. */
+    probeIntervalMs?: number;
+    /** Replaces fetch. For tests. */
+    _fetch?: typeof fetch;
+}
+export interface CollectorHealthObserveResult {
+    resources: {
+        name: string;
+        status: "in-sync" | "drifted" | "unknown";
+        detail: string;
+    }[];
+}
+export interface DeclaredEndpoint {
+    kind: CollectorEndpointKind;
+    url: string;
+}
+/** `host:port`, `:port` or a URL, as host and port. A `${env:...}` host reads as unknown (empty). */
+export declare function splitEndpoint(endpoint: string): {
+    host: string;
+    port: string;
+} | undefined;
+/**
+ * The endpoints a collector config declares, as URLs. `healthCheck` is
+ * present only when the service enables a `health_check` extension.
+ */
+export declare function declaredEndpoints(config: Record<string, unknown>, host?: string, overrides?: Partial<Record<CollectorEndpointKind, string>>): DeclaredEndpoint[];
+/** Observe each collector through the endpoints its config declares: one resource per collector. */
+export declare function collectorHealthObserve(args: CollectorHealthObserveArgs): Promise<CollectorHealthObserveResult>;
+//# sourceMappingURL=collector-health.d.ts.map

package/dist/op/activities/collector-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector-health.d.ts","sourceRoot":"","sources":["../../../src/op/activities/collector-health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE3E,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,6IAA6I;IAC7I,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,KAAK,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1F;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,qBAAqB,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AASD,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAO1F;AAyCD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAM,GAAG,gBAAgB,EAAE,CAoBpK;AAyBD,oGAAoG;AACpG,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAoCpH"}

package/dist/op/activities/exec.d.ts

@@ -0,0 +1,19 @@
+/**
+ * How the otel activities run a binary: a child process whose exit code,
+ * stdout and stderr are returned rather than thrown, so the caller decides
+ * what a non-zero exit means. Tests pass their own runner.
+ */
+export interface ExecResult {
+    /** The exit code, or null when the binary could not be started. */
+    code: number | null;
+    stdout: string;
+    stderr: string;
+    /** Why the binary could not be started (ENOENT and the like). */
+    error?: string;
+}
+export type ExecRunner = (bin: string, args: string[], opts?: {
+    cwd?: string;
+    timeoutMs?: number;
+}) => Promise<ExecResult>;
+export declare const defaultExec: ExecRunner;
+//# sourceMappingURL=exec.d.ts.map

package/dist/op/activities/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../../src/op/activities/exec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3H,eAAO,MAAM,WAAW,EAAE,UAatB,CAAC"}

package/dist/op/activities/github.d.ts

@@ -0,0 +1,55 @@
+/**
+ * What the audit activities read from GitHub and write back to it: release
+ * lists over the REST API, and a sticky issue or a proposal pull request
+ * through `git` and `gh`. The prometheus lexicon's rule audit uses the issue
+ * half too.
+ */
+/** Runs `git` or `gh`, returning stdout. Rejects on a non-zero exit. */
+export type CommandRunner = (bin: "git" | "gh", args: string[], cwd: string) => Promise<string>;
+export declare const defaultRunner: CommandRunner;
+export interface Release {
+    tag: string;
+    publishedAt?: string;
+}
+/** `v1.2.3` as numbers, or undefined when the tag is not a plain semver. */
+export declare function semverOf(tag: string): [number, number, number] | undefined;
+export declare function compareSemver(a: string, b: string): number;
+/**
+ * The published, non-prerelease releases of `repo` (`owner/name`) with a
+ * plain semver tag, newest first. Reads one page of 100, which covers
+ * months of collector releases.
+ */
+export declare function fetchReleases(repo: string, f?: typeof fetch, token?: string | undefined): Promise<Release[]>;
+/**
+ * Open an issue titled `title`, or edit the body of the open one that
+ * already has that title, so a scheduled audit keeps one issue current
+ * instead of opening one per run. Returns its URL.
+ */
+export declare function stickyIssue(run: CommandRunner, cwd: string, title: string, body: string, labels?: string[]): Promise<string>;
+export interface ProposalFile {
+    /** Path relative to the repository root. */
+    path: string;
+    content: string;
+}
+export interface ProposeOptions {
+    /** The repository root. */
+    root: string;
+    branch: string;
+    title: string;
+    body: string;
+    files: ProposalFile[];
+    commitMessage: string;
+    remote?: string;
+    /** The branch the pull request targets. Default: the remote's default branch. */
+    base?: string;
+    /** A directory for the worktree the commit is made in. */
+    worktreeDir: string;
+}
+/**
+ * Commit `files` on `branch`, from the remote's default branch, in a
+ * worktree of its own (the checked-out branch and working tree are never
+ * touched), push it, and open a pull request, or edit the open one for that
+ * branch. Returns the pull request's URL.
+ */
+export declare function proposePullRequest(run: CommandRunner, o: ProposeOptions): Promise<string>;
+//# sourceMappingURL=github.d.ts.map

package/dist/op/activities/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../src/op/activities/github.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEhG,eAAO,MAAM,aAAa,EAAE,aAMxB,CAAC;AAEL,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAG1E;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,GAAE,OAAO,KAAa,EAAE,KAAK,qBAA2B,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAU/H;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAUtI;AAED,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA0B/F"}

package/dist/op/activities/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * otel Op activities (#3369), resolved by the core activity registry when a
+ * project's `chant.config.ts` lists the `otel` lexicon. Every function this
+ * module exports is an activity, bound by its export name, so the helpers
+ * behind them stay in their own files.
+ *
+ * - `otelcolValidate`, `otelcolComponents`: the collector binary's own
+ *   checks over a config file.
+ * - `collectorHealthObserve`: running collectors as the resources of a
+ *   `ConvergeOp({ observe })`.
+ * - `collectorAudit`: the lexicon's pins against upstream releases, the
+ *   step of `CollectorAuditOp`.
+ */
+export { otelcolValidate, otelcolComponents } from "./otelcol.js";
+export type { OtelcolValidateArgs, OtelcolValidateResult, OtelcolComponentsArgs, OtelcolComponentsResult, MissingComponent } from "./otelcol.js";
+export { collectorHealthObserve } from "./collector-health.js";
+export type { CollectorHealthObserveArgs, CollectorHealthObserveResult, ObservedCollector, CollectorEndpointKind } from "./collector-health.js";
+export { collectorAudit } from "./collector-audit.js";
+export type { CollectorAuditArgs, CollectorAuditResult, CollectorAuditFinding, CollectorAuditFindingKind, CollectorAuditMode } from "./collector-audit.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/op/activities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/op/activities/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9I,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC7I,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/op/activities/otelcol.d.ts

@@ -0,0 +1,96 @@
+/**
+ * `otelcol validate` and `otelcol components` as Op steps (#3369).
+ *
+ * - `otelcolValidate` runs the collector binary's own `validate` over a
+ *   config file. Before it does, it reads the binary's version and refuses
+ *   when that is not the version chant's config types follow
+ *   (`COLLECTOR_PIN`): a different collector accepts and rejects different
+ *   fields, so its verdict is not about the config chant built. A step that
+ *   names a `version` checks the binary against that version instead.
+ * - `otelcolComponents` reads the binary's component list and refuses a
+ *   config that uses a receiver, processor, exporter, connector or
+ *   extension the binary was not built with: the failure a custom or core
+ *   distribution gives at start, found before it starts.
+ *
+ * The binary is `bin`, else `$OTELCOL_BIN`, else `otelcol-contrib` on PATH.
+ */
+import { type ComponentKind } from "../../model.js";
+import { type ExecRunner } from "./exec.js";
+export interface OtelcolValidateArgs {
+    /** The collector config file, relative to the working directory. */
+    config: string;
+    /** The collector binary. Default `$OTELCOL_BIN`, else `otelcol-contrib`. */
+    bin?: string;
+    /**
+     * The collector version the binary must be, e.g. `v0.131.0`. Default
+     * `COLLECTOR_PIN`'s version: the one chant's config types follow.
+     */
+    version?: string;
+    /** Replaces the child process. For tests. */
+    _exec?: ExecRunner;
+}
+export interface OtelcolValidateResult {
+    config: string;
+    bin: string;
+    /** The binary's version, `v`-prefixed. */
+    version: string;
+    /** Always true: a config the binary rejects fails the step. */
+    ok: boolean;
+    output: string;
+}
+export interface OtelcolComponentsArgs {
+    /** The collector config file, relative to the working directory. */
+    config: string;
+    /** The collector binary. Default `$OTELCOL_BIN`, else `otelcol-contrib`. */
+    bin?: string;
+    /** Replaces the child process. For tests. */
+    _exec?: ExecRunner;
+}
+export interface MissingComponent {
+    kind: ComponentKind;
+    /** The component id as the config writes it, e.g. `spanmetrics/genai`. */
+    id: string;
+    type: string;
+}
+export interface OtelcolComponentsResult {
+    config: string;
+    bin: string;
+    /** The binary's version from its build info, when it prints one. */
+    version?: string;
+    /** Components the config declares, by kind. */
+    used: Record<ComponentKind, string[]>;
+    /** Always empty: a config that uses a missing component fails the step. */
+    missing: MissingComponent[];
+}
+/** The binary a step runs. */
+export declare function otelcolBin(explicit?: string, env?: NodeJS.ProcessEnv): string;
+/**
+ * The version `otelcol --version` prints: `otelcol-contrib version 0.130.0`.
+ * Undefined when the output names none.
+ */
+export declare function parseOtelcolVersion(output: string): string | undefined;
+/** Run `otelcol validate` over `config`, after checking the binary is the pinned (or the given) version. */
+export declare function otelcolValidate(args: OtelcolValidateArgs): Promise<OtelcolValidateResult>;
+/** What `otelcol components` lists, by kind: component type names. */
+export interface OtelcolComponentList {
+    version?: string;
+    components: Record<ComponentKind, Set<string>>;
+}
+/**
+ * Read `otelcol components` output. The format is YAML and marked unstable
+ * upstream, so this reads what it can: each section may be a list of
+ * objects with a `name` (v0.130.0), a list of plain names (older builds),
+ * or a mapping keyed by name. Unknown top-level keys are ignored.
+ */
+export declare function parseComponentsOutput(text: string): OtelcolComponentList;
+/** The component ids a config declares, by kind. */
+export declare function configComponents(config: Record<string, unknown>): Record<ComponentKind, string[]>;
+/**
+ * The components `used` names that `list` lacks. A renamed built-in counts
+ * under either name: a binary that lists `otlp_grpc` runs a config that says
+ * `otlp`, and the other way round.
+ */
+export declare function missingComponents(used: Record<ComponentKind, string[]>, list: OtelcolComponentList): MissingComponent[];
+/** Check `config` uses only components the binary was built with, from `otelcol components`. */
+export declare function otelcolComponents(args: OtelcolComponentsArgs): Promise<OtelcolComponentsResult>;
+//# sourceMappingURL=otelcol.d.ts.map

package/dist/op/activities/otelcol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otelcol.d.ts","sourceRoot":"","sources":["../../../src/op/activities/otelcol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,EAAyE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACxH,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,2EAA2E;IAC3E,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,8BAA8B;AAC9B,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE1F;AAQD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtE;AAmBD,4GAA4G;AAC5G,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAmB/F;AAUD,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,CA0BxE;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAQjG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,CAYvH;AAED,gGAAgG;AAChG,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAkBrG"}

package/dist/op/activity-contracts.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Activity contracts for this lexicon's `op/activities` (#3369).
+ *
+ * Resolved by convention at `@intentius/chant-lexicon-otel/op/activity-contracts`:
+ * `loadActivityContracts` merges them into the map OPS012 checks each step's
+ * args against and OPS013 checks each step-output reference against. Every
+ * activity here has one. `collectorHealthObserve` needs its return schema
+ * most: it is the observer of a `ConvergeOp({ observe })`, whose Converge
+ * step reads the observer's whole output.
+ *
+ * Each `args` schema mirrors the `*Args` interface in `./activities/`,
+ * without the `_`-prefixed test seams, and is a `z.strictObject`, so a
+ * misspelled key fails the build.
+ */
+export declare const otelcolValidateContract: import("@intentius/chant/op").ActivityContract<{
+    config: string;
+    bin?: string | undefined;
+    version?: string | undefined;
+}, {
+    config: string;
+    bin: string;
+    version: string;
+    ok: boolean;
+    output: string;
+}>;
+export declare const otelcolComponentsContract: import("@intentius/chant/op").ActivityContract<{
+    config: string;
+    bin?: string | undefined;
+}, {
+    config: string;
+    bin: string;
+    version?: string | undefined;
+    used: {
+        receiver: string[];
+        processor: string[];
+        exporter: string[];
+        connector: string[];
+        extension: string[];
+    };
+    missing: {
+        kind: "connector" | "exporter" | "extension" | "processor" | "receiver";
+        id: string;
+        type: string;
+    }[];
+}>;
+export declare const collectorHealthObserveContract: import("@intentius/chant/op").ActivityContract<{
+    collectors: {
+        name: string;
+        config?: string | undefined;
+        configObject?: Record<string, unknown> | undefined;
+        host?: string | undefined;
+        endpoints?: {
+            healthCheck?: string | undefined;
+            zpages?: string | undefined;
+            telemetry?: string | undefined;
+        } | undefined;
+    }[];
+    timeoutMs?: number | undefined;
+    probes?: number | undefined;
+    probeIntervalMs?: number | undefined;
+}, {
+    resources: {
+        name: string;
+        status: "drifted" | "in-sync" | "unknown";
+        detail: string;
+    }[];
+}>;
+export declare const collectorAuditContract: import("@intentius/chant/op").ActivityContract<{
+    mode?: "issue" | "pull-request" | "report" | undefined;
+    lexiconDir?: string | undefined;
+    stability?: boolean | undefined;
+    stabilityBudget?: number | undefined;
+    branch?: string | undefined;
+}, {
+    mode: "issue" | "pull-request" | "report";
+    collector: {
+        pin: string;
+        latest: string | null;
+        behind: number;
+    };
+    semconv: {
+        pin: string;
+        latest: string | null;
+        behind: number;
+    };
+    findings: {
+        kind: "collector-pin-behind" | "deprecated" | "semconv-pin-behind" | "stability-changed";
+        subject: string;
+        detail: string;
+    }[];
+    unchecked: string[];
+    summary: string;
+    issueUrl?: string | undefined;
+    prUrl?: string | undefined;
+}>;
+//# sourceMappingURL=activity-contracts.d.ts.map

package/dist/op/activity-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-contracts.d.ts","sourceRoot":"","sources":["../../src/op/activity-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAcH,eAAO,MAAM,uBAAuB;;;;;;;;;;EAInC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;EAUrC,CAAC;AAIF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;EAmB1C,CAAC;AAIF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBlC,CAAC"}

package/dist/op/audit-op.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `CollectorAuditOp`: the otel lexicon's pins against upstream, as an Op
+ * with an optional schedule (#3369). It sits at observe, like
+ * `WorkflowAuditOp`: one `collectorAudit` step reads the contrib release
+ * list against `COLLECTOR_PIN`, each built-in component's stability from its
+ * `metadata.yaml`, and `GENAI_SEMCONV_PIN` against the semantic-conventions
+ * releases. `onFinding` says what happens with findings: `report` (the
+ * default), `issue`, or `pull-request`, which bumps the pins on a proposal
+ * branch and opens a pull request. Review and merge of that pull request
+ * are the approval.
+ *
+ * @example
+ * ```typescript
+ * export const { op } = CollectorAuditOp({ name: "collector-audit", schedule: "0 6 * * 1", onFinding: "pull-request" });
+ * ```
+ */
+import { type OpResource } from "@intentius/chant/op";
+import type { CollectorAuditMode } from "./activities/collector-audit.js";
+export interface CollectorAuditOpConfig {
+    /** Op name (kebab-case). */
+    name: string;
+    /** Cron expression; omit for one-shot `chant run`. */
+    schedule?: string;
+    /** @default "report" */
+    onFinding?: CollectorAuditMode;
+    /** The otel lexicon's directory a pull request edits. Default `lexicons/otel`. */
+    lexiconDir?: string;
+    /** At most this many `metadata.yaml` reads. Default 200. */
+    stabilityBudget?: number;
+}
+export interface CollectorAuditOpResources {
+    op: InstanceType<typeof OpResource>;
+}
+export declare function CollectorAuditOp(config: CollectorAuditOpConfig): CollectorAuditOpResources;
+//# sourceMappingURL=audit-op.d.ts.map

package/dist/op/audit-op.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-op.d.ts","sourceRoot":"","sources":["../../src/op/audit-op.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;CACrC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,yBAAyB,CAc1F"}