observability-toolkit 2.0.0 → 2.1.1

package/dist/lib/validation/api-schemas.d.ts

@@ -0,0 +1,705 @@
+/**
+ * Zod schemas for API service boundaries.
+ *
+ * Provides runtime validation for:
+ * - api-provisioning-receiver: InboxPayload request bodies
+ * - obtool-api: R2 NDJSON lines (traces, metrics, logs)
+ * - obtool-ingest: OTLP ResourceSpan/ResourceMetric/ResourceLog lines
+ */
+import { z } from 'zod';
+export declare const domainSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+export type Domain = z.infer<typeof domainSchema>;
+export declare const emailDomainSchema: z.ZodPipe<z.ZodString, z.ZodTransform<{
+    email: string;
+    domain: string;
+    registrableDomain: string | null;
+}, string>>;
+export type EmailDomain = z.infer<typeof emailDomainSchema>;
+export declare const emailToRegistrableDomainSchema: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<{
+    email: string;
+    domain: string;
+    registrableDomain: string | null;
+}, string>>, z.ZodTransform<string, {
+    email: string;
+    domain: string;
+    registrableDomain: string | null;
+}>>, z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+/**
+ * Inbox request payload from API provisioning sender.
+ * Generic structure allows extensibility for multiple action types.
+ */
+export declare const apiKeyTierSchema: z.ZodEnum<{
+    starter: "starter";
+    growth: "growth";
+    enterprise: "enterprise";
+}>;
+export declare const auth0UserinfoSchema: z.ZodObject<{
+    sub: z.ZodString;
+    email: z.ZodEmail;
+}, z.core.$strip>;
+export type Auth0Userinfo = z.infer<typeof auth0UserinfoSchema>;
+export declare const apiKeyTokenSchema: z.ZodString;
+export type ApiKeyToken = z.infer<typeof apiKeyTokenSchema>;
+export declare const provisionApiKeyResultSchema: z.ZodObject<{
+    token: z.ZodString;
+    keyId: z.ZodString;
+    prefix: z.ZodString;
+    tier: z.ZodEnum<{
+        starter: "starter";
+        growth: "growth";
+        enterprise: "enterprise";
+    }>;
+}, z.core.$strip>;
+export type ProvisionApiKeyResult = z.infer<typeof provisionApiKeyResultSchema>;
+export type ApiKeyTier = z.infer<typeof apiKeyTierSchema>;
+export declare const routeSchema: z.ZodEnum<{
+    "/health": "/health";
+    "/inbox": "/inbox";
+}>;
+export type Route = z.infer<typeof routeSchema>;
+export declare const actionSchema: z.ZodEnum<{
+    provision_api_key: "provision_api_key";
+    sign_in: "sign_in";
+}>;
+export type Action = z.infer<typeof actionSchema>;
+export declare const provisionApiKeyPayloadSchema: z.ZodObject<{
+    action: z.ZodLiteral<"provision_api_key">;
+    jwt: z.ZodString;
+    name: z.ZodString;
+    tier: z.ZodDefault<z.ZodEnum<{
+        starter: "starter";
+        growth: "growth";
+        enterprise: "enterprise";
+    }>>;
+    email: z.ZodEmail;
+    org_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const signInPayloadSchema: z.ZodObject<{
+    action: z.ZodLiteral<"sign_in">;
+    email: z.ZodEmail;
+}, z.core.$strip>;
+export declare const inboxPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"provision_api_key">;
+    jwt: z.ZodString;
+    name: z.ZodString;
+    tier: z.ZodDefault<z.ZodEnum<{
+        starter: "starter";
+        growth: "growth";
+        enterprise: "enterprise";
+    }>>;
+    email: z.ZodEmail;
+    org_name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"sign_in">;
+    email: z.ZodEmail;
+}, z.core.$strip>], "action">;
+export type InboxPayload = z.infer<typeof inboxPayloadSchema>;
+/**
+ * Generic NDJSON line as read from R2.
+ * Individual lines may be validated by signal-specific handlers downstream.
+ */
+export declare const ndjsonLineSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type NdjsonLine = z.infer<typeof ndjsonLineSchema>;
+/**
+ * OTel attribute from protobuf serialization.
+ */
+export declare const otlpAttributeSchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodOptional<z.ZodObject<{
+        stringValue: z.ZodOptional<z.ZodString>;
+        intValue: z.ZodOptional<z.ZodString>;
+        doubleValue: z.ZodOptional<z.ZodNumber>;
+        boolValue: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type OtlpAttribute = z.infer<typeof otlpAttributeSchema>;
+/**
+ * OTel span from OTLP protobuf JSON.
+ */
+export declare const otlpSpanSchema: z.ZodObject<{
+    traceId: z.ZodOptional<z.ZodString>;
+    spanId: z.ZodOptional<z.ZodString>;
+    parentSpanId: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodNumber>;
+    startTimeUnixNano: z.ZodOptional<z.ZodString>;
+    endTimeUnixNano: z.ZodOptional<z.ZodString>;
+    attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodOptional<z.ZodObject<{
+            stringValue: z.ZodOptional<z.ZodString>;
+            intValue: z.ZodOptional<z.ZodString>;
+            doubleValue: z.ZodOptional<z.ZodNumber>;
+            boolValue: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    status: z.ZodOptional<z.ZodObject<{
+        code: z.ZodOptional<z.ZodNumber>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * OTel metric data point.
+ */
+export declare const otlpDataPointSchema: z.ZodObject<{
+    attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodOptional<z.ZodObject<{
+            stringValue: z.ZodOptional<z.ZodString>;
+            intValue: z.ZodOptional<z.ZodString>;
+            doubleValue: z.ZodOptional<z.ZodNumber>;
+            boolValue: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    timeUnixNano: z.ZodOptional<z.ZodString>;
+    asInt: z.ZodOptional<z.ZodString>;
+    asDouble: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type OtlpDataPoint = z.infer<typeof otlpDataPointSchema>;
+/**
+ * OTel metric from OTLP protobuf JSON.
+ */
+export declare const otlpMetricSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodString>;
+    gauge: z.ZodOptional<z.ZodObject<{
+        dataPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                value: z.ZodOptional<z.ZodObject<{
+                    stringValue: z.ZodOptional<z.ZodString>;
+                    intValue: z.ZodOptional<z.ZodString>;
+                    doubleValue: z.ZodOptional<z.ZodNumber>;
+                    boolValue: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            timeUnixNano: z.ZodOptional<z.ZodString>;
+            asInt: z.ZodOptional<z.ZodString>;
+            asDouble: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>>;
+    }, z.core.$strip>>;
+    sum: z.ZodOptional<z.ZodObject<{
+        dataPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                value: z.ZodOptional<z.ZodObject<{
+                    stringValue: z.ZodOptional<z.ZodString>;
+                    intValue: z.ZodOptional<z.ZodString>;
+                    doubleValue: z.ZodOptional<z.ZodNumber>;
+                    boolValue: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            timeUnixNano: z.ZodOptional<z.ZodString>;
+            asInt: z.ZodOptional<z.ZodString>;
+            asDouble: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>>;
+        aggregationTemporality: z.ZodOptional<z.ZodNumber>;
+        isMonotonic: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    histogram: z.ZodOptional<z.ZodObject<{
+        dataPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                value: z.ZodOptional<z.ZodObject<{
+                    stringValue: z.ZodOptional<z.ZodString>;
+                    intValue: z.ZodOptional<z.ZodString>;
+                    doubleValue: z.ZodOptional<z.ZodNumber>;
+                    boolValue: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            timeUnixNano: z.ZodOptional<z.ZodString>;
+            count: z.ZodOptional<z.ZodString>;
+            sum: z.ZodOptional<z.ZodNumber>;
+            bucketCounts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            explicitBounds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>>;
+        aggregationTemporality: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+export type OtlpMetric = z.infer<typeof otlpMetricSchema>;
+/**
+ * OTel log record from OTLP protobuf JSON.
+ */
+export declare const otlpLogRecordSchema: z.ZodObject<{
+    timeUnixNano: z.ZodOptional<z.ZodString>;
+    severityNumber: z.ZodOptional<z.ZodNumber>;
+    severityText: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodObject<{
+        stringValue: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodOptional<z.ZodObject<{
+            stringValue: z.ZodOptional<z.ZodString>;
+            intValue: z.ZodOptional<z.ZodString>;
+            doubleValue: z.ZodOptional<z.ZodNumber>;
+            boolValue: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    traceId: z.ZodOptional<z.ZodString>;
+    spanId: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/**
+ * OTel resource object with attributes.
+ */
+export declare const otlpResourceSchema: z.ZodObject<{
+    attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodOptional<z.ZodObject<{
+            stringValue: z.ZodOptional<z.ZodString>;
+            intValue: z.ZodOptional<z.ZodString>;
+            doubleValue: z.ZodOptional<z.ZodNumber>;
+            boolValue: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$loose>;
+/**
+ * Scope spans/metrics/logs container.
+ */
+export declare const otlpScopeSchema: z.ZodObject<{
+    scope: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    spans: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        traceId: z.ZodOptional<z.ZodString>;
+        spanId: z.ZodOptional<z.ZodString>;
+        parentSpanId: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodNumber>;
+        startTimeUnixNano: z.ZodOptional<z.ZodString>;
+        endTimeUnixNano: z.ZodOptional<z.ZodString>;
+        attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodOptional<z.ZodObject<{
+                stringValue: z.ZodOptional<z.ZodString>;
+                intValue: z.ZodOptional<z.ZodString>;
+                doubleValue: z.ZodOptional<z.ZodNumber>;
+                boolValue: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        status: z.ZodOptional<z.ZodObject<{
+            code: z.ZodOptional<z.ZodNumber>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    metrics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        unit: z.ZodOptional<z.ZodString>;
+        gauge: z.ZodOptional<z.ZodObject<{
+            dataPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    key: z.ZodString;
+                    value: z.ZodOptional<z.ZodObject<{
+                        stringValue: z.ZodOptional<z.ZodString>;
+                        intValue: z.ZodOptional<z.ZodString>;
+                        doubleValue: z.ZodOptional<z.ZodNumber>;
+                        boolValue: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>>;
+                timeUnixNano: z.ZodOptional<z.ZodString>;
+                asInt: z.ZodOptional<z.ZodString>;
+                asDouble: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>>;
+        }, z.core.$strip>>;
+        sum: z.ZodOptional<z.ZodObject<{
+            dataPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    key: z.ZodString;
+                    value: z.ZodOptional<z.ZodObject<{
+                        stringValue: z.ZodOptional<z.ZodString>;
+                        intValue: z.ZodOptional<z.ZodString>;
+                        doubleValue: z.ZodOptional<z.ZodNumber>;
+                        boolValue: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>>;
+                timeUnixNano: z.ZodOptional<z.ZodString>;
+                asInt: z.ZodOptional<z.ZodString>;
+                asDouble: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>>;
+            aggregationTemporality: z.ZodOptional<z.ZodNumber>;
+            isMonotonic: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        histogram: z.ZodOptional<z.ZodObject<{
+            dataPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    key: z.ZodString;
+                    value: z.ZodOptional<z.ZodObject<{
+                        stringValue: z.ZodOptional<z.ZodString>;
+                        intValue: z.ZodOptional<z.ZodString>;
+                        doubleValue: z.ZodOptional<z.ZodNumber>;
+                        boolValue: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>>;
+                timeUnixNano: z.ZodOptional<z.ZodString>;
+                count: z.ZodOptional<z.ZodString>;
+                sum: z.ZodOptional<z.ZodNumber>;
+                bucketCounts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                explicitBounds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$loose>>>;
+            aggregationTemporality: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$loose>>>;
+    logRecords: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        timeUnixNano: z.ZodOptional<z.ZodString>;
+        severityNumber: z.ZodOptional<z.ZodNumber>;
+        severityText: z.ZodOptional<z.ZodString>;
+        body: z.ZodOptional<z.ZodObject<{
+            stringValue: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodOptional<z.ZodObject<{
+                stringValue: z.ZodOptional<z.ZodString>;
+                intValue: z.ZodOptional<z.ZodString>;
+                doubleValue: z.ZodOptional<z.ZodNumber>;
+                boolValue: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        traceId: z.ZodOptional<z.ZodString>;
+        spanId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+/**
+ * NDJSON line: single resource span (traces signal).
+ */
+export declare const resourceSpanLineSchema: z.ZodObject<{
+    resource: z.ZodOptional<z.ZodObject<{
+        attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodOptional<z.ZodObject<{
+                stringValue: z.ZodOptional<z.ZodString>;
+                intValue: z.ZodOptional<z.ZodString>;
+                doubleValue: z.ZodOptional<z.ZodNumber>;
+                boolValue: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+    scopeSpans: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        spans: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            traceId: z.ZodOptional<z.ZodString>;
+            spanId: z.ZodOptional<z.ZodString>;
+            parentSpanId: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            kind: z.ZodOptional<z.ZodNumber>;
+            startTimeUnixNano: z.ZodOptional<z.ZodString>;
+            endTimeUnixNano: z.ZodOptional<z.ZodString>;
+            attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                value: z.ZodOptional<z.ZodObject<{
+                    stringValue: z.ZodOptional<z.ZodString>;
+                    intValue: z.ZodOptional<z.ZodString>;
+                    doubleValue: z.ZodOptional<z.ZodNumber>;
+                    boolValue: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            status: z.ZodOptional<z.ZodObject<{
+                code: z.ZodOptional<z.ZodNumber>;
+                message: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+export type ResourceSpanLine = z.infer<typeof resourceSpanLineSchema>;
+/**
+ * NDJSON line: single resource metric (metrics signal).
+ */
+export declare const resourceMetricLineSchema: z.ZodObject<{
+    resource: z.ZodOptional<z.ZodObject<{
+        attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodOptional<z.ZodObject<{
+                stringValue: z.ZodOptional<z.ZodString>;
+                intValue: z.ZodOptional<z.ZodString>;
+                doubleValue: z.ZodOptional<z.ZodNumber>;
+                boolValue: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+    scopeMetrics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        metrics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            unit: z.ZodOptional<z.ZodString>;
+            gauge: z.ZodOptional<z.ZodObject<{
+                dataPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        key: z.ZodString;
+                        value: z.ZodOptional<z.ZodObject<{
+                            stringValue: z.ZodOptional<z.ZodString>;
+                            intValue: z.ZodOptional<z.ZodString>;
+                            doubleValue: z.ZodOptional<z.ZodNumber>;
+                            boolValue: z.ZodOptional<z.ZodBoolean>;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                    timeUnixNano: z.ZodOptional<z.ZodString>;
+                    asInt: z.ZodOptional<z.ZodString>;
+                    asDouble: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>>;
+            }, z.core.$strip>>;
+            sum: z.ZodOptional<z.ZodObject<{
+                dataPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        key: z.ZodString;
+                        value: z.ZodOptional<z.ZodObject<{
+                            stringValue: z.ZodOptional<z.ZodString>;
+                            intValue: z.ZodOptional<z.ZodString>;
+                            doubleValue: z.ZodOptional<z.ZodNumber>;
+                            boolValue: z.ZodOptional<z.ZodBoolean>;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                    timeUnixNano: z.ZodOptional<z.ZodString>;
+                    asInt: z.ZodOptional<z.ZodString>;
+                    asDouble: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>>;
+                aggregationTemporality: z.ZodOptional<z.ZodNumber>;
+                isMonotonic: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            histogram: z.ZodOptional<z.ZodObject<{
+                dataPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        key: z.ZodString;
+                        value: z.ZodOptional<z.ZodObject<{
+                            stringValue: z.ZodOptional<z.ZodString>;
+                            intValue: z.ZodOptional<z.ZodString>;
+                            doubleValue: z.ZodOptional<z.ZodNumber>;
+                            boolValue: z.ZodOptional<z.ZodBoolean>;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                    timeUnixNano: z.ZodOptional<z.ZodString>;
+                    count: z.ZodOptional<z.ZodString>;
+                    sum: z.ZodOptional<z.ZodNumber>;
+                    bucketCounts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    explicitBounds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                    min: z.ZodOptional<z.ZodNumber>;
+                    max: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$loose>>>;
+                aggregationTemporality: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+export type ResourceMetricLine = z.infer<typeof resourceMetricLineSchema>;
+/**
+ * NDJSON line: single resource log (logs signal).
+ */
+export declare const resourceLogLineSchema: z.ZodObject<{
+    resource: z.ZodOptional<z.ZodObject<{
+        attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            value: z.ZodOptional<z.ZodObject<{
+                stringValue: z.ZodOptional<z.ZodString>;
+                intValue: z.ZodOptional<z.ZodString>;
+                doubleValue: z.ZodOptional<z.ZodNumber>;
+                boolValue: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+    scopeLogs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        logRecords: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            timeUnixNano: z.ZodOptional<z.ZodString>;
+            severityNumber: z.ZodOptional<z.ZodNumber>;
+            severityText: z.ZodOptional<z.ZodString>;
+            body: z.ZodOptional<z.ZodObject<{
+                stringValue: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                value: z.ZodOptional<z.ZodObject<{
+                    stringValue: z.ZodOptional<z.ZodString>;
+                    intValue: z.ZodOptional<z.ZodString>;
+                    doubleValue: z.ZodOptional<z.ZodNumber>;
+                    boolValue: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            traceId: z.ZodOptional<z.ZodString>;
+            spanId: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+export type ResourceLogLine = z.infer<typeof resourceLogLineSchema>;
+/**
+ * Dataset metadata record (one dataset version per line).
+ */
+export declare const datasetRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    frozen: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>;
+    traceCount: z.ZodNumber;
+    evaluationNames: z.ZodArray<z.ZodString>;
+    version: z.ZodOptional<z.ZodNumber>;
+    parentVersion: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    versionCreatedAt: z.ZodOptional<z.ZodISODateTime>;
+    versionReason: z.ZodOptional<z.ZodEnum<{
+        created: "created";
+        traces_added: "traces_added";
+        traces_removed: "traces_removed";
+        metadata_updated: "metadata_updated";
+    }>>;
+    fieldMapping: z.ZodOptional<z.ZodObject<{
+        input: z.ZodString;
+        expectedOutput: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    traceSnapshot: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dateRangeStart: z.ZodNullable<z.ZodString>;
+    dateRangeEnd: z.ZodNullable<z.ZodString>;
+    selectionCriteria: z.ZodDefault<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type DatasetRecord = z.infer<typeof datasetRecordSchema>;
+/**
+ * Dataset-trace association record (one per line).
+ */
+export declare const datasetTraceRecordSchema: z.ZodObject<{
+    datasetId: z.ZodString;
+    traceId: z.ZodString;
+    addedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type DatasetTraceRecord = z.infer<typeof datasetTraceRecordSchema>;
+/**
+ * Dataset run record (one per line).
+ */
+export declare const datasetRunRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    datasetId: z.ZodString;
+    datasetVersion: z.ZodNumber;
+    runAt: z.ZodISODateTime;
+    evaluationNames: z.ZodArray<z.ZodString>;
+    resultCount: z.ZodNumber;
+    evaluator: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DatasetRunRecord = z.infer<typeof datasetRunRecordSchema>;
+/**
+ * Token usage from LLM API response (session transcript parsing).
+ *
+ * Intentionally distinct from `tokenUsageSchema` in `src/lib/cost/cost-estimation.ts`:
+ * - This schema uses snake_case fields, all optional, `z.number()` (floats allowed), unbounded.
+ * - The cost-estimation schema uses camelCase fields, required, `z.int()`, bounded by MAX_SAFE_TOKENS.
+ * Do not consolidate — they serve different parsing contexts.
+ */
+export declare const tokenUsageSchema: z.ZodObject<{
+    input_tokens: z.ZodOptional<z.ZodNumber>;
+    output_tokens: z.ZodOptional<z.ZodNumber>;
+    cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+    cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type TokenUsage = z.infer<typeof tokenUsageSchema>;
+/**
+ * Session transcript entry (one per JSONL line).
+ * Can be user, assistant, progress, file-history-snapshot, or system message.
+ */
+export declare const sessionLogEntrySchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+        progress: "progress";
+        "file-history-snapshot": "file-history-snapshot";
+        system: "system";
+    }>;
+    message: z.ZodOptional<z.ZodObject<{
+        role: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodUnknown>;
+        model: z.ZodOptional<z.ZodString>;
+        usage: z.ZodOptional<z.ZodObject<{
+            input_tokens: z.ZodOptional<z.ZodNumber>;
+            output_tokens: z.ZodOptional<z.ZodNumber>;
+            cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+            cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    timestamp: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$loose>;
+export type SessionLogEntry = z.infer<typeof sessionLogEntrySchema>;
+export { evaluatorTypeSchema, type EvaluatorType } from '../core/shared-schemas.js';
+/** Normalizes raw evaluator type strings (trim + lowercase) before enum validation. */
+export declare const rawEvaluatorTypeSchema: z.ZodPipe<z.ZodString, z.ZodEnum<{
+    llm: "llm";
+    human: "human";
+    rule: "rule";
+    classifier: "classifier";
+    seed: "seed";
+    canary: "canary";
+}>>;
+/**
+ * Per-step evaluation breakdown for agent trajectory evaluation.
+ *
+ * API-layer variant of `stepScoreSchema` from `src/backends/backend-schemas.ts`.
+ * Intentionally kept separate: adds richer `.describe()` annotations for API documentation
+ * context (e.g., "zero-based index" guidance). `inject-evaluations.ts` uses the canonical
+ * backend-schemas version directly.
+ */
+export declare const stepScoreSchema: z.ZodObject<{
+    step: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    score: z.ZodNumber;
+    evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+    explanation: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StepScore = z.infer<typeof stepScoreSchema>;
+/**
+ * Tool call verification result for agent evaluation.
+ *
+ * API-layer variant of `toolVerificationSchema` from `src/backends/backend-schemas.ts`.
+ * Both enforce `toolName.min(1)`. Kept separate: accepts broader evidence types
+ * (union of record/string/number/boolean/null) vs canonical's `evidenceSchema`.
+ */
+export declare const toolVerificationSchema: z.ZodObject<{
+    toolName: z.ZodString;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    toolCorrect: z.ZodBoolean;
+    argsCorrect: z.ZodBoolean;
+    resultCorrect: z.ZodOptional<z.ZodBoolean>;
+    score: z.ZodNumber;
+    expectedTool: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+}, z.core.$strip>;
+export type ToolVerification = z.infer<typeof toolVerificationSchema>;
+/**
+ * Normalized evaluation result from gen_ai.evaluation events.
+ */
+export declare const evaluationResultSchema: z.ZodObject<{
+    spanId: z.ZodOptional<z.ZodString>;
+    agentName: z.ZodOptional<z.ZodString>;
+    stepScores: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        step: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        score: z.ZodNumber;
+        evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+        explanation: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    toolVerifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        toolName: z.ZodString;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        toolCorrect: z.ZodBoolean;
+        argsCorrect: z.ZodBoolean;
+        resultCorrect: z.ZodOptional<z.ZodBoolean>;
+        score: z.ZodNumber;
+        expectedTool: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+    }, z.core.$strip>>>;
+    trajectoryLength: z.ZodOptional<z.ZodInt>;
+    responseId: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodISODateTime;
+    evaluationName: z.ZodString;
+    scoreValue: z.ZodOptional<z.ZodNumber>;
+    scoreLabel: z.ZodOptional<z.ZodString>;
+    scoreUnit: z.ZodOptional<z.ZodString>;
+    explanation: z.ZodOptional<z.ZodString>;
+    evaluator: z.ZodOptional<z.ZodString>;
+    evaluatorType: z.ZodOptional<z.ZodEnum<{
+        llm: "llm";
+        human: "human";
+        rule: "rule";
+        classifier: "classifier";
+        seed: "seed";
+        canary: "canary";
+    }>>;
+}, z.core.$strip>;
+export type EvaluationResult = z.infer<typeof evaluationResultSchema>;
+//# sourceMappingURL=api-schemas.d.ts.map