@intentius/chant-lexicon-prometheus 0.100.0 → 0.101.0

package/README.md

@@ -27,6 +27,7 @@ export { api, oncall, fallback, root };
 |---|---|
 | `RuleGroup` | rule file |
 | `Slo` (composite) | rule file: SLI recording rules, error budget and multiwindow burn-rate alerts |
+| `GenAiRules` (composite) | rule file: request, error, latency, token and cost rules and opt-in alerts for the otel GenAI preset |
 | `Route`, `Receiver` (every Alertmanager integration), `InhibitRule`, `TimeInterval`, `AlertmanagerSettings` | `alertmanager.yml` |
 
 Types follow Prometheus `v3.15.0` and Alertmanager `v0.34.1` (`PROMETHEUS_PIN`).
@@ -47,6 +48,7 @@ PromQL is parsed with `@prometheus-io/lezer-promql`, the Prometheus project's ow
 - `validateRuleFile`, `validateAlertmanagerConfig`, `validateSeverityRouting` run the checks without a build.
 - `checkPromql`, `parseMatchers`, `isValidDuration` are the pieces underneath.
 - `sloMetrics(slo)` names the series an `Slo` records and its burn-rate thresholds, for dashboards.
+- `genAiRuleMetrics(rules)` names the series a `GenAiRules` records and the alerts it builds.
 
 ## Project structure
 
@@ -54,10 +56,11 @@ PromQL is parsed with `@prometheus-io/lezer-promql`, the Prometheus project's ow
 - `src/rules.ts`: `RuleGroup`
 - `src/alertmanager.ts`: the Alertmanager entities
 - `src/composites/slo.ts`: `Slo` and `sloMetrics`
+- `src/composites/genai.ts`: `GenAiRules` and `genAiRuleMetrics`
 - `src/build.ts`: entities to config to YAML
 - `src/promql.ts`, `src/matchers.ts`, `src/duration.ts`: parsing
 - `src/validate-config.ts`, `src/lint/`: checks
 - `src/tools.ts`: promtool and amtool
 - `src/import/`: `chant import` for rule files and `alertmanager.yml` (parser, generator, `Slo` recognition, round-trip tests and fixtures)
-- `src/rule-eval.ts`: a small rule evaluator the SLO tests run over synthetic series
+- `src/rule-eval.ts`: a small rule evaluator the SLO and GenAI tests run over synthetic series
 - `examples/`: getting-started, alerting, rules-from-data, slo, k3d-stack

package/dist/codegen/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgFH,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB9E"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqFH,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB9E"}

package/dist/composites/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/composites/catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,eAAO,MAAM,gBAAgB,EAAE,cAAc,EA2D5C,CAAC"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/composites/catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAiI5C,CAAC"}

package/dist/composites/genai.d.ts

@@ -0,0 +1,224 @@
+/**
+ * `GenAiRules`: recording rules and opt-in alerts for the otel lexicon's
+ * GenAI collector preset, and spend from a price table the project declares.
+ *
+ * Every metric and label name comes from the `GenAiMetrics` the collector was
+ * built with (`genAiMetrics(options)` or `genAiComponents(options).metrics`)
+ * and from the otel lexicon's attribute keys, so a collector with another
+ * namespace, or with the conventions' client metrics switched on, moves every
+ * expression here with it.
+ *
+ * Two sources describe model calls:
+ *
+ * - `client`: the conventions' `gen_ai.client.operation.duration` and
+ *   `gen_ai.client.token.usage` (#3041). Requests are the duration
+ *   histogram's `_count`, errors the ones with an `error.type`, tokens the
+ *   token histogram's `_sum` split by `gen_ai.token.type`.
+ * - `spans`: the preset's own `genai.calls`, `genai.duration` and token sums.
+ *   Errors are spans with `status.code` `STATUS_CODE_ERROR`. The token sums
+ *   carry the model only, so cost series take the provider from the price
+ *   table.
+ *
+ * The default is `client` when the metrics have it. Per-tool rules always
+ * read the span metrics: the conventions' client metrics carry no tool name.
+ *
+ * Everything is in one group, recording rules first, because Prometheus
+ * evaluates a group's rules in order and the later rules and the alerts read
+ * the series the earlier ones record in the same evaluation.
+ *
+ * Cost is a rate in the price's currency per second, one series per priced
+ * model and token type, labelled with the currency. A model the table does
+ * not price gets no cost series, never a cost of zero. The lexicon ships no
+ * prices. `currency` and `source` are required on every price, the same two
+ * fields a workspace run's cost record carries (#3033), so the two can be
+ * compared; chant converts no currency.
+ */
+import { type CompositeInstance } from "@intentius/chant/composite";
+import { type GenAiMetrics } from "@intentius/chant-lexicon-otel/genai";
+import { type RuleGroupEntity } from "../rules.js";
+import type { LabelSet } from "../model.js";
+/** One model's price, as the provider publishes it, per million tokens. */
+export interface GenAiPrice {
+    /** The `gen_ai.provider.name` value, e.g. `anthropic` or `openai`. */
+    provider: string;
+    /** The `gen_ai.request.model` value the price applies to, exactly as spans report it. */
+    model: string;
+    /** Price of one million input tokens. */
+    inputPerMTok: number;
+    /** Price of one million output tokens. */
+    outputPerMTok: number;
+    /** The currency the prices are in, e.g. `USD`. Required: chant converts nothing. */
+    currency: string;
+    /** Where the prices come from, e.g. the provider's pricing page URL. Required. */
+    source: string;
+    /** The date the prices were read, `YYYY-MM-DD`. */
+    asOf?: string;
+}
+/** The fields every alert takes. */
+export interface GenAiAlertOptions {
+    /** How long the condition must hold (default `10m`). */
+    for?: string;
+    /** The `severity` label, which Alertmanager routes on (default `warning`). */
+    severity?: string;
+    /** More labels on the alert. */
+    labels?: LabelSet;
+    /** More annotations on the alert, e.g. `runbook_url`. */
+    annotations?: LabelSet;
+}
+export interface GenAiRatioAlert extends GenAiAlertOptions {
+    /** The error ratio the alert fires above, between 0 and 1. */
+    threshold?: number;
+}
+export interface GenAiLatencyAlert extends GenAiAlertOptions {
+    /** The p95 operation latency, in seconds, the alert fires above (default 30). */
+    thresholdSeconds?: number;
+}
+/** A spending limit over the last hour or day, in one currency. */
+export interface GenAiBudget extends GenAiAlertOptions {
+    /** The most the window may cost, e.g. `50`. */
+    amount: number;
+    /** The currency of `amount`; it must be the currency of at least one price. */
+    currency: string;
+    /** `hour` (spend over the last hour) or `day` (the last 24 hours). */
+    per: "hour" | "day";
+}
+/** Opt-in alerts. None is built unless it is set here. */
+export interface GenAiAlerting {
+    /** Error ratio per provider, model and operation (default threshold 0.05). */
+    errorRatio?: true | GenAiRatioAlert;
+    /** p95 operation latency per provider, model and operation (default 30s). */
+    latency?: true | GenAiLatencyAlert;
+    /** Error ratio per tool, from the span metrics (default threshold 0.1). */
+    toolErrorRatio?: true | GenAiRatioAlert;
+    /** Spend over a budget per hour or per day, from the cost rules. Needs `prices`. */
+    budgets?: GenAiBudget[];
+}
+export interface GenAiRulesProps {
+    /** The preset's metrics: `genAiMetrics(options)` with the options the collector was built with, or `genAiComponents(options)`. */
+    genAi: GenAiMetrics | {
+        metrics: GenAiMetrics;
+    };
+    /** Which metrics the model rules read (default `client` when the metrics include the conventions' client metrics, else `spans`). */
+    source?: "client" | "spans";
+    /** Prices per provider and model. A model missing here gets no cost series. */
+    prices?: GenAiPrice[];
+    /** Opt-in alerts (default: none). */
+    alerts?: GenAiAlerting;
+    /** The rule group's name (default `genai`). */
+    name?: string;
+    /** The first part of every recorded series name (default `gen_ai`). */
+    prefix?: string;
+    /** The range every `rate` reads (default `5m`). */
+    rateWindow?: string;
+    /** More Prometheus labels every rule keeps, e.g. `job` or `service_name`. */
+    groupBy?: string[];
+    /** Labels added to every rule, e.g. `team`. */
+    labels?: LabelSet;
+    /** Evaluation interval of the group (default: Prometheus's `evaluation_interval`). */
+    interval?: string;
+}
+export type GenAiRulesMembers = {
+    /** The recording rules, then the alerts. */
+    rules: RuleGroupEntity;
+};
+/** What `GenAiRules(...)` returns: its rule group, as `rules`. */
+export type GenAiRulesInstance = CompositeInstance<GenAiRulesMembers> & GenAiRulesMembers;
+/** A recorded latency series and the quantiles it holds, one per `quantile` label value. */
+export interface GenAiQuantileSeries {
+    record: string;
+    /** The values of the `quantile` label, e.g. `0.95`. */
+    quantiles: string[];
+}
+/** One alert as built. */
+export interface GenAiAlertInfo {
+    alert: string;
+    kind: "errorRatio" | "latency" | "toolErrorRatio" | "budget";
+    severity: string;
+    /** The value the alert fires above: a ratio, seconds, or an amount of money. */
+    threshold: number;
+    /** For a budget: its currency and window. */
+    currency?: string;
+    per?: "hour" | "day";
+}
+/** The series a `GenAiRules` records, read by dashboards instead of repeating names. */
+export interface GenAiRuleMetrics {
+    /** The rule group's name. */
+    group: string;
+    /** Which metrics the model rules read. */
+    source: "client" | "spans";
+    rateWindow: string;
+    /** Prometheus label names the series are split by. */
+    labels: {
+        /** Absent when the source metrics have no provider (span metrics without `providerDimensions`). */
+        provider?: string;
+        model: string;
+        operation: string;
+        errorType: string;
+        tokenType: string;
+        /** Absent when the span metrics have no tool dimension. */
+        tool?: string;
+        currency: string;
+        quantile: string;
+    };
+    /** The labels the model series (requests, errors, latency) are split by, `groupBy` last. */
+    modelLabels: string[];
+    /** The labels token and cost series are split by, besides the token type (and currency on cost). */
+    tokenLabels: string[];
+    /** Requests per second. */
+    requests: string;
+    /** Errors per second, also by `error.type`. */
+    errors: string;
+    /** Errors over requests, 0 when there are none. */
+    errorRatio: string;
+    /** Errors of each `error.type` over all requests. */
+    errorRatioByType: string;
+    /** Operation latency in seconds, at p50, p95 and p99. */
+    latency: GenAiQuantileSeries;
+    /** Tokens per second, by `gen_ai.token.type` (`input`, `output`). */
+    tokens: string;
+    /** Spend per second in each price's currency, by token type. Absent without prices. */
+    cost?: string;
+    /** Per-tool series, from the span metrics. Absent when they carry no tool name. */
+    tool?: {
+        calls: string;
+        errors: string;
+        errorRatio: string;
+        latency: GenAiQuantileSeries;
+    };
+    /** The price table as declared, without the prices. */
+    prices: Array<{
+        provider: string;
+        model: string;
+        currency: string;
+        source: string;
+        asOf?: string;
+    }>;
+    /** Every currency in the price table. */
+    currencies: string[];
+    /** The alerts built, in rule order. Empty unless asked for. */
+    alerts: GenAiAlertInfo[];
+}
+/**
+ * Recording rules and opt-in alerts for GenAI calls, from the otel preset's metrics.
+ *
+ * @example
+ * ```ts
+ * import { genAiMetrics } from "@intentius/chant-lexicon-otel";
+ * import { GenAiRules } from "@intentius/chant-lexicon-prometheus";
+ *
+ * export const genai = GenAiRules({
+ *   genAi: genAiMetrics({ clientMetrics: "derive" }),
+ *   prices: [{ provider: "anthropic", model: "claude-x", inputPerMTok: 3, outputPerMTok: 15, currency: "USD", source: "https://example.com/pricing", asOf: "2026-09-29" }],
+ *   alerts: { errorRatio: true, budgets: [{ amount: 50, currency: "USD", per: "day" }] },
+ * });
+ * // genai.rules is a RuleGroup; genAiRuleMetrics(genai) names its series.
+ * ```
+ */
+export declare const GenAiRules: import("@intentius/chant/composite").CompositeDefinition<GenAiRulesProps, GenAiRulesMembers>;
+/**
+ * The series a `GenAiRules` records and the alerts it builds. Pass the
+ * `GenAiRules(...)` result, its rule group, or the props it was built from;
+ * a dashboard reads names from here instead of repeating them.
+ */
+export declare function genAiRuleMetrics(rules: GenAiRulesInstance | RuleGroupEntity | GenAiRulesProps): GenAiRuleMetrics;
+//# sourceMappingURL=genai.d.ts.map

package/dist/composites/genai.d.ts.map

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

package/dist/composites/index.d.ts

@@ -3,4 +3,6 @@
  */
 export { Slo, sloMetrics, sloPropsProblem, sliExprProblem, DEFAULT_BURN_RATES, SLO_WINDOW_PLACEHOLDER, } from "./slo.js";
 export type { SloProps, SloSli, SloAlerting, SloAlertTier, BurnRateWindow, SloMembers, SloInstance, SloMetrics, SloBurnRate, } from "./slo.js";
+export { GenAiRules, genAiRuleMetrics } from "./genai.js";
+export type { GenAiRulesProps, GenAiRulesMembers, GenAiRulesInstance, GenAiRuleMetrics, GenAiPrice, GenAiAlerting, GenAiAlertOptions, GenAiRatioAlert, GenAiLatencyAlert, GenAiBudget, GenAiAlertInfo, GenAiQuantileSeries, } from "./genai.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/composites/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composites/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,GAAG,EACH,UAAU,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AACf,YAAY,EACV,QAAQ,EACR,MAAM,EACN,WAAW,EACX,YAAY,EACZ,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composites/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,GAAG,EACH,UAAU,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,OAAO,CAAC;AACf,YAAY,EACV,QAAQ,EACR,MAAM,EACN,WAAW,EACX,YAAY,EACZ,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,GACZ,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACvD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/index.d.ts

@@ -10,5 +10,5 @@ export { checkPromql, PROMQL_GRAMMAR, type PromqlCheck } from "./promql.js";
 export { validateRuleFile, validateAlertmanagerConfig, validateSeverityRouting, alertSeverities, type PrometheusIssue, type PrometheusIssueCode, } from "./validate-config.js";
 export { PROMETHEUS_PIN } from "./pin.js";
 export { promtoolCheckRules, promtoolTestRules, amtoolCheckConfig, hasTool, type ToolResult } from "./tools.js";
-export { Slo, sloMetrics, sloPropsProblem, sliExprProblem, DEFAULT_BURN_RATES, SLO_WINDOW_PLACEHOLDER, type SloProps, type SloSli, type SloAlerting, type SloAlertTier, type BurnRateWindow, type SloMembers, type SloInstance, type SloMetrics, type SloBurnRate, } from "./composites/index.js";
+export { Slo, sloMetrics, sloPropsProblem, sliExprProblem, DEFAULT_BURN_RATES, SLO_WINDOW_PLACEHOLDER, type SloProps, type SloSli, type SloAlerting, type SloAlertTier, type BurnRateWindow, type SloMembers, type SloInstance, type SloMetrics, type SloBurnRate, GenAiRules, genAiRuleMetrics, type GenAiRulesProps, type GenAiRulesMembers, type GenAiRulesInstance, type GenAiRuleMetrics, type GenAiPrice, type GenAiAlerting, type GenAiAlertOptions, type GenAiRatioAlert, type GenAiLatencyAlert, type GenAiBudget, type GenAiAlertInfo, type GenAiQuantileSeries, } from "./composites/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGvE,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,eAAe,EACf,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,KAAK,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,OAAO,EACP,UAAU,EACV,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,GAChC,MAAM,gBAAgB,CAAC;AAGxB,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACrH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,uBAAuB,EACvB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAG7G,OAAO,EACL,GAAG,EACH,UAAU,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGvE,OAAO,EACL,SAAS,EACT,eAAe,EACf,WAAW,EACX,eAAe,EACf,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,KAAK,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,OAAO,EACP,UAAU,EACV,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,GAChC,MAAM,gBAAgB,CAAC;AAGxB,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACrH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,uBAAuB,EACvB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAG7G,OAAO,EACL,GAAG,EACH,UAAU,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,UAAU,EACV,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC"}

package/dist/init-templates.d.ts

@@ -6,8 +6,17 @@
  * - `rules`: rule groups only, for a setup whose Alertmanager config lives
  *   elsewhere.
  * - `slo-style`: a recording rule per window and alerts on two severities,
- *   the shape SLO burn-rate rules take.
+ *   the shape SLO burn-rate rules take, written out as plain rules.
+ * - `slo`: an SLO declared with the `Slo` composite, which builds its error
+ *   ratios, error budget and multiwindow burn-rate alerts, and the
+ *   Alertmanager routing for the page and ticket severities those alerts
+ *   carry, with a page muting the same SLO's ticket.
  */
 import type { InitTemplateSet } from "@intentius/chant/lexicon";
-export declare function initTemplates(template?: string): InitTemplateSet;
+export declare const DEFAULT_TEMPLATE: InitTemplateSet;
+export declare const RULES_TEMPLATE: InitTemplateSet;
+export declare const SLO_STYLE_TEMPLATE: InitTemplateSet;
+export declare const SLO_TEMPLATE: InitTemplateSet;
+/** The template names `chant init --lexicon prometheus --template <name>` takes, besides the default. */
+export declare const TEMPLATE_NAMES: readonly ["rules", "slo-style", "slo"];
 //# sourceMappingURL=init-templates.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../src/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AA6DhE,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CAIhE"}
+{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../src/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAyHhE,eAAO,MAAM,gBAAgB,EAAE,eAAiF,CAAC;AAEjH,eAAO,MAAM,cAAc,EAAE,eAAgD,CAAC;AAE9E,eAAO,MAAM,kBAAkB,EAAE,eAAoD,CAAC;AAEtF,eAAO,MAAM,YAAY,EAAE,eAA6F,CAAC;AAEzH,yGAAyG;AACzG,eAAO,MAAM,cAAc,wCAAyC,CAAC"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "607fbd5b053611a815fca194bdab69232a771ac4757afcf198cd132915600b19",
+    "manifest.json": "65f130bfb1121c22b92f960f4f742b25b7fecc737e4ca2b2f1737cd580d7b65e",
     "meta.json": "6aeeb24f8a09f61582620870021cdb0d781690d4a9d0efebc729d054df3eaebb",
     "types/index.d.ts": "150d72287453a24a40cdeffb8cf3e9dc6e77ab58b342b48d01902dc58fb5f85d",
     "rules/literal-credential.ts": "384c500ab33d9608b545b0743ed4a382c76f645175eda9b1628e00e24b87fbb7",
@@ -25,9 +25,9 @@
     "rules/prom207.ts": "60b9fb8017da191f43d174ac6173c31abfb151d536b9994408f104fc6e25cdb4",
     "rules/prom208.ts": "692b4ae103b762199a51ab9fb64b1d6686dfbc0356676f6cf6afb393a89ef83a",
     "rules/prom209.ts": "5c4fe651e51e1eea7fa5f03a7f6331d98399629c7c7d53f4ea8620982d419bbd",
-    "skills/chant-prometheus.md": "ebbb08a4a14056984490a130a55ceebbee774eb0fb757989b6885d57c743f03a",
+    "skills/chant-prometheus.md": "842db9fa6329b486b95987aa93e1542af52436aa326c02275854e64b51946edb",
     "skills/chant-prometheus-alertmanager.md": "c5e63edb67cf70dc2abfcc4af648e20d495e9226f440327f05c397f3b655f25c",
     "skills/chant-prometheus-kubernetes.md": "cca016857891f4cabf1feb6f9db83c220a2e6ece200cd89e635851079f8070a8"
   },
-  "composite": "382db681a4d7ac95b2c6e720cc1a148b666800aeab6cf78073c491fffdb5e18f"
+  "composite": "9bd4294e4364dd80fb88e37b9c99fee8ff39c64e4e349f1120e9507de9469e7d"
 }

package/dist/manifest.json

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

package/dist/plugin.d.ts.map

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

package/dist/rule-eval.d.ts

@@ -7,10 +7,15 @@
  * The PromQL it understands is the subset the lexicon's generated rules use:
  * number literals, vector and range selectors with `=`, `!=`, `=~` and `!~`
  * matchers, `rate`, `increase`, `avg_over_time`, `sum_over_time`,
- * `count_over_time`, `vector`, `sum` (with `by` or `without`), the
- * arithmetic and comparison operators and `and`, `or` and `unless` (with
- * `on` or `ignoring`). Anything else throws, so a test never passes by
- * silently evaluating something it does not understand.
+ * `count_over_time`, `vector`, `histogram_quantile`, `sum` (with `by` or
+ * `without`), the arithmetic and comparison operators (one-to-one, or
+ * many-to-one with `group_left` and no extra labels) and `and`, `or` and
+ * `unless` (with `on` or `ignoring`). Anything else throws, so a test never
+ * passes by silently evaluating something it does not understand.
+ *
+ * `histogram_quantile` interpolates linearly inside the bucket the rank
+ * falls in, as Prometheus does for classic buckets, and returns the upper
+ * bound of the highest finite bucket when the rank falls in `+Inf`.
  *
  * `rate` is the increase between the first and last sample in the range
  * over the time between them, without Prometheus's extrapolation to the
@@ -61,6 +66,7 @@ export declare class RuleEvaluator {
     private node;
     private args;
     private call;
+    private histogramQuantile;
     private aggregate;
     private binary;
 }

package/dist/rule-eval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule-eval.d.ts","sourceRoot":"","sources":["../src/rule-eval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAA8D,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAI3G,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AACD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AACD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAiCD,8DAA8D;AAC9D,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;gBAErC,MAAM,EAAE,eAAe,EAAE;IAEtD,wEAAwE;IACxE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAU/C,yFAAyF;IACzF,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IA8B9B,yFAAyF;IACzF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAK/C,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,MAAM;IAId,iCAAiC;IACjC,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,IAAI;IAyBZ,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,IAAI;IAuCZ,OAAO,CAAC,SAAS;IA4BjB,OAAO,CAAC,MAAM;CA0Gf"}
+{"version":3,"file":"rule-eval.d.ts","sourceRoot":"","sources":["../src/rule-eval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,EAA8D,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAI3G,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AACD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AACD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAkCD,8DAA8D;AAC9D,qBAAa,aAAa;IAKZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;gBAErC,MAAM,EAAE,eAAe,EAAE;IAEtD,wEAAwE;IACxE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAU/C,yFAAyF;IACzF,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IA8B9B,yFAAyF;IACzF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAK/C,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,MAAM;IAId,iCAAiC;IACjC,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,IAAI;IAyBZ,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,IAAI;IA0CZ,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,SAAS;IA4BjB,OAAO,CAAC,MAAM;CA2Hf"}

package/dist/skills/chant-prometheus.md

@@ -100,3 +100,25 @@ sloMetrics(checkout).errorRatio["1h"]; // "slo:sli_error:ratio_rate1h"
 - Write the objective as a fraction strictly between 0 and 1, and put `{{window}}` where each SLI expression's range goes (PROM003).
 - Alerts carry `severity` `page` or `ticket`; route both (PROM202).
 - Read series names from `sloMetrics()` in dashboards instead of repeating them.
+
+## GenAI rules
+
+`GenAiRules` builds rules for the otel lexicon's GenAI collector preset from the same `genAiMetrics(options)` the collector was built with: request rate, error ratio (also by `error.type`) and p50/p95/p99 latency per provider, model and operation, token rates, spend per second from a price table the project declares, and per-tool call rate, error ratio and p95 latency. Alerts are off unless `alerts` names them.
+
+```ts
+import { genAiMetrics } from "@intentius/chant-lexicon-otel";
+import { GenAiRules, genAiRuleMetrics } from "@intentius/chant-lexicon-prometheus";
+
+export const genai = GenAiRules({
+  genAi: genAiMetrics({ clientMetrics: "derive" }),
+  prices: [{ provider: "anthropic", model: "claude-x", inputPerMTok: 3, outputPerMTok: 15, currency: "USD", source: "https://example.com/pricing", asOf: "2026-09-29" }],
+  alerts: { errorRatio: true, latency: { thresholdSeconds: 20 }, budgets: [{ amount: 50, currency: "USD", per: "day" }] },
+});
+
+genAiRuleMetrics(genai).cost; // "gen_ai:cost:rate5m"
+```
+
+- Pass the collector's own options to `genAiMetrics()`; never write a metric name by hand.
+- Ship no prices in a lexicon or template. The project declares them, with `currency` and `source` on each.
+- A model missing from `prices` gets no cost series, so a sum of the cost series covers priced models only.
+- Read series names from `genAiRuleMetrics()` in dashboards.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-prometheus",
-  "version": "0.100.0",
+  "version": "0.101.0",
   "description": "Prometheus lexicon for chant — typed recording and alerting rule groups and Alertmanager routing, serialized to a rule file and alertmanager.yml",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -59,6 +59,7 @@
     "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && find dist -type f \\( -name \"*.js\" -o -name \"*.js.map\" \\) -delete"
   },
   "dependencies": {
+    "@intentius/chant-lexicon-otel": "*",
     "@lezer/highlight": "^1.2.4",
     "@lezer/lr": "^1.4.10",
     "@prometheus-io/lezer-promql": "0.315.0",
@@ -71,7 +72,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.100.0",
+    "@intentius/chant": "^0.101.0",
     "typescript": "^5.9.3"
   }
 }

package/src/codegen/docs.ts

@@ -42,6 +42,11 @@ The \`Slo\` composite builds a service level objective to a \`RuleGroup\`:
 error ratios per window, the error budget left, and the SRE Workbook's
 multiwindow multi-burn-rate alerts. See [SLOs](./slos/).
 
+The \`GenAiRules\` composite builds recording rules, opt-in alerts and spend
+from a declared price table for the otel lexicon's GenAI collector preset,
+reading every metric name from its \`GenAiMetrics\`. See
+[GenAI Rules](./genai-rules/).
+
 Checks run at build time: PromQL syntax in every \`expr\` (PROM104), unique
 group names (PROM101), valid durations (PROM103), routes that name
 declared receivers (PROM201), and every alert severity routed by some route

package/src/composites/catalog.test.ts

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

package/src/composites/catalog.ts

@@ -4,6 +4,76 @@
 import type { CompositeEntry } from "@intentius/chant/lexicon";
 
 export const compositeCatalog: CompositeEntry[] = [
+  {
+    "name": "GenAiRules",
+    "lexicon": "prometheus",
+    "description": "Recording rules and opt-in alerts for GenAI calls, from the otel preset's metrics.",
+    "bundles": [
+      "RuleGroup"
+    ],
+    "params": [
+      {
+        "name": "genAi",
+        "type": "GenAiMetrics | { metrics: GenAiMetrics }",
+        "required": true,
+        "description": "The preset's metrics: `genAiMetrics(options)` with the options the collector was built with, or `genAiComponents(options)`."
+      },
+      {
+        "name": "source",
+        "type": "\"client\" | \"spans\"",
+        "required": false,
+        "description": "Which metrics the model rules read (default `client` when the metrics include the conventions' client metrics, else `spans`)."
+      },
+      {
+        "name": "prices",
+        "type": "GenAiPrice[]",
+        "required": false,
+        "description": "Prices per provider and model."
+      },
+      {
+        "name": "alerts",
+        "type": "GenAiAlerting",
+        "required": false,
+        "description": "Opt-in alerts (default: none)."
+      },
+      {
+        "name": "name",
+        "type": "string",
+        "required": false,
+        "description": "The rule group's name (default `genai`)."
+      },
+      {
+        "name": "prefix",
+        "type": "string",
+        "required": false,
+        "description": "The first part of every recorded series name (default `gen_ai`)."
+      },
+      {
+        "name": "rateWindow",
+        "type": "string",
+        "required": false,
+        "description": "The range every `rate` reads (default `5m`)."
+      },
+      {
+        "name": "groupBy",
+        "type": "string[]",
+        "required": false,
+        "description": "More Prometheus labels every rule keeps, e.g. `job` or `service_name`."
+      },
+      {
+        "name": "labels",
+        "type": "LabelSet",
+        "required": false,
+        "description": "Labels added to every rule, e.g. `team`."
+      },
+      {
+        "name": "interval",
+        "type": "string",
+        "required": false,
+        "description": "Evaluation interval of the group (default: Prometheus's `evaluation_interval`)."
+      }
+    ]
+  },
   {
     "name": "Slo",
     "lexicon": "prometheus",