@llmops/sdk 1.0.0-beta.1 → 1.0.0-beta.10

package/dist/agents.d.cts

@@ -1,2 +1,2 @@
-import { a as AgentsTracingExporter, i as AgentsTrace, n as AgentsSpanData, o as LLMOpsAgentsExporterConfig, r as AgentsSpanError, s as createLLMOpsAgentsExporter, t as AgentsSpan } from "./agents-exporter-B-ADoC7t.cjs";
+import { a as AgentsTracingExporter, i as AgentsTrace, n as AgentsSpanData, o as LLMOpsAgentsExporterConfig, r as AgentsSpanError, s as createLLMOpsAgentsExporter, t as AgentsSpan } from "./agents-exporter-vuQine9v.cjs";
 export { AgentsSpan, AgentsSpanData, AgentsSpanError, AgentsTrace, AgentsTracingExporter, LLMOpsAgentsExporterConfig, createLLMOpsAgentsExporter };

package/dist/agents.d.mts

@@ -1,2 +1,2 @@
-import { a as AgentsTracingExporter, i as AgentsTrace, n as AgentsSpanData, o as LLMOpsAgentsExporterConfig, r as AgentsSpanError, s as createLLMOpsAgentsExporter, t as AgentsSpan } from "./agents-exporter-BZjfVkaH.mjs";
+import { a as AgentsTracingExporter, i as AgentsTrace, n as AgentsSpanData, o as LLMOpsAgentsExporterConfig, r as AgentsSpanError, s as createLLMOpsAgentsExporter, t as AgentsSpan } from "./agents-exporter-Bn3NtzMO.mjs";
 export { AgentsSpan, AgentsSpanData, AgentsSpanError, AgentsTrace, AgentsTracingExporter, LLMOpsAgentsExporterConfig, createLLMOpsAgentsExporter };

package/dist/agents.mjs

@@ -1,3 +1,3 @@
-import { t as createLLMOpsAgentsExporter } from "./agents-exporter-CxbWY6xN.mjs";
+import { t as createLLMOpsAgentsExporter } from "./agents-exporter-DYmMvLPS.mjs";
 
 export { createLLMOpsAgentsExporter };

package/dist/constants-BrB5eRjw.cjs

@@ -0,0 +1,18 @@
+
+//#region src/telemetry/constants.ts
+const COST_SUMMARY_GROUP_BY = [
+	"day",
+	"hour",
+	"model",
+	"provider",
+	"endpoint",
+	"tags"
+];
+
+//#endregion
+Object.defineProperty(exports, 'COST_SUMMARY_GROUP_BY', {
+  enumerable: true,
+  get: function () {
+    return COST_SUMMARY_GROUP_BY;
+  }
+});

package/dist/constants-sHtPfi36.mjs

@@ -0,0 +1,12 @@
+//#region src/telemetry/constants.ts
+const COST_SUMMARY_GROUP_BY = [
+	"day",
+	"hour",
+	"model",
+	"provider",
+	"endpoint",
+	"tags"
+];
+
+//#endregion
+export { COST_SUMMARY_GROUP_BY as t };

package/dist/express.d.cts

@@ -1,4 +1,4 @@
-import "./agents-exporter-B-ADoC7t.cjs";
-import "./index-C7J-9Jvp.cjs";
-import { t as createLLMOpsMiddleware } from "./index-1uemrw2P.cjs";
+import "./agents-exporter-vuQine9v.cjs";
+import "./index-sjRozlIk.cjs";
+import { t as createLLMOpsMiddleware } from "./index-BHO7MEJx.cjs";
 export { createLLMOpsMiddleware };

package/dist/express.d.mts

@@ -1,4 +1,4 @@
-import "./agents-exporter-BZjfVkaH.mjs";
-import "./index-D0LVaLA4.mjs";
-import { t as createLLMOpsMiddleware } from "./index-BeDbCYjz.mjs";
+import "./agents-exporter-Bn3NtzMO.mjs";
+import "./index-C0CDqR9v.mjs";
+import { t as createLLMOpsMiddleware } from "./index-DVkfeg2W.mjs";
 export { createLLMOpsMiddleware };

package/dist/express.mjs

@@ -1,3 +1,3 @@
-import { t as createLLMOpsMiddleware } from "./express-ClEIbLM9.mjs";
+import { t as createLLMOpsMiddleware } from "./express-Vt9JurUM.mjs";
 
 export { createLLMOpsMiddleware };

package/dist/hono.d.cts

@@ -1,5 +1,5 @@
-import "./agents-exporter-B-ADoC7t.cjs";
-import { t as LLMOpsClient } from "./index-C7J-9Jvp.cjs";
+import "./agents-exporter-vuQine9v.cjs";
+import { t as LLMOpsClient } from "./index-sjRozlIk.cjs";
 import { MiddlewareHandler } from "hono";
 
 //#region src/lib/hono/index.d.ts

package/dist/hono.d.mts

@@ -1,5 +1,5 @@
-import "./agents-exporter-BZjfVkaH.mjs";
-import { t as LLMOpsClient } from "./index-D0LVaLA4.mjs";
+import "./agents-exporter-Bn3NtzMO.mjs";
+import { t as LLMOpsClient } from "./index-C0CDqR9v.mjs";
 import { MiddlewareHandler } from "hono";
 
 //#region src/lib/hono/index.d.ts

package/dist/{index-1uemrw2P.d.cts → index-BHO7MEJx.d.cts}

@@ -1,4 +1,4 @@
-import { t as LLMOpsClient } from "./index-C7J-9Jvp.cjs";
+import { t as LLMOpsClient } from "./index-sjRozlIk.cjs";
 import { NextFunction, Request, Response } from "express";
 
 //#region src/lib/express/index.d.ts

package/dist/{index-C7J-9Jvp.d.cts → index-C0CDqR9v.d.mts}

@@ -1,4 +1,4 @@
-import { a as AgentsTracingExporter } from "./agents-exporter-B-ADoC7t.cjs";
+import { a as AgentsTracingExporter } from "./agents-exporter-Bn3NtzMO.mjs";
 import { LLMOpsConfig, ValidatedLLMOpsConfig } from "@llmops/core";
 
 //#region src/telemetry/langchain-client.d.ts

package/dist/{index-BeDbCYjz.d.mts → index-DVkfeg2W.d.mts}

@@ -1,4 +1,4 @@
-import { t as LLMOpsClient } from "./index-D0LVaLA4.mjs";
+import { t as LLMOpsClient } from "./index-C0CDqR9v.mjs";
 import { NextFunction, Request, Response } from "express";
 
 //#region src/lib/express/index.d.ts

package/dist/{index-D0LVaLA4.d.mts → index-sjRozlIk.d.cts}

@@ -1,4 +1,4 @@
-import { a as AgentsTracingExporter } from "./agents-exporter-BZjfVkaH.mjs";
+import { a as AgentsTracingExporter } from "./agents-exporter-vuQine9v.cjs";
 import { LLMOpsConfig, ValidatedLLMOpsConfig } from "@llmops/core";
 
 //#region src/telemetry/langchain-client.d.ts

package/dist/index.cjs

@@ -1,5 +1,6 @@
 const require_express = require('./express-B-wbCza5.cjs');
 const require_agents_exporter = require('./agents-exporter-BuTq2n2y.cjs');
+const require_constants = require('./constants-BrB5eRjw.cjs');
 let __llmops_core = require("@llmops/core");
 let __llmops_app = require("@llmops/app");
 
@@ -229,14 +230,9 @@ function createLLMOpsSpanExporter(config) {
 }
 
 //#endregion
+exports.COST_SUMMARY_GROUP_BY = require_constants.COST_SUMMARY_GROUP_BY;
 exports.createLLMOpsAgentsExporter = require_agents_exporter.createLLMOpsAgentsExporter;
 exports.createLLMOpsLangChainClient = createLLMOpsLangChainClient;
 exports.createLLMOpsMiddleware = require_express.createLLMOpsMiddleware;
 exports.createLLMOpsSpanExporter = createLLMOpsSpanExporter;
-exports.llmops = createLLMOps;
-Object.defineProperty(exports, 'pgStore', {
-  enumerable: true,
-  get: function () {
-    return __llmops_core.createPgStore;
-  }
-});
+exports.llmops = createLLMOps;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { a as AgentsTracingExporter, o as LLMOpsAgentsExporterConfig, s as createLLMOpsAgentsExporter } from "./agents-exporter-B-ADoC7t.cjs";
-import { a as LLMOpsLangChainClientConfig, i as createLLMOps, n as ProviderOptions, o as LangChainTracingClient, r as TraceContext, s as createLLMOpsLangChainClient, t as LLMOpsClient } from "./index-C7J-9Jvp.cjs";
-import { t as createLLMOpsMiddleware } from "./index-1uemrw2P.cjs";
-import { TelemetryStore, createPgStore as pgStore } from "@llmops/core";
+import { a as AgentsTracingExporter, o as LLMOpsAgentsExporterConfig, s as createLLMOpsAgentsExporter } from "./agents-exporter-vuQine9v.cjs";
+import { a as LLMOpsLangChainClientConfig, i as createLLMOps, n as ProviderOptions, o as LangChainTracingClient, r as TraceContext, s as createLLMOpsLangChainClient, t as LLMOpsClient } from "./index-sjRozlIk.cjs";
+import { t as createLLMOpsMiddleware } from "./index-BHO7MEJx.cjs";
+import { a as TraceUpsert, i as SpanInsert, n as LLMRequestInsert, o as COST_SUMMARY_GROUP_BY, r as SpanEventInsert, s as CostSummaryGroupBy, t as TelemetryStore } from "./interface-BbAwy96d.cjs";
 
 //#region src/telemetry/exporter.d.ts
 
@@ -93,4 +93,4 @@ interface LLMOpsExporterConfig {
  */
 declare function createLLMOpsSpanExporter(config: LLMOpsExporterConfig): SpanExporter;
 //#endregion
-export { type AgentsTracingExporter, type LLMOpsAgentsExporterConfig, type LLMOpsClient, type LLMOpsExporterConfig, type LLMOpsLangChainClientConfig, type LangChainTracingClient, type ProviderOptions, type SpanExporter, type TelemetryStore, type TraceContext, createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops, pgStore };
+export { type AgentsTracingExporter, COST_SUMMARY_GROUP_BY, type CostSummaryGroupBy, type LLMOpsAgentsExporterConfig, type LLMOpsClient, type LLMOpsExporterConfig, type LLMOpsLangChainClientConfig, type LLMRequestInsert, type LangChainTracingClient, type ProviderOptions, type SpanEventInsert, type SpanExporter, type SpanInsert, type TelemetryStore, type TraceContext, type TraceUpsert, createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { a as AgentsTracingExporter, o as LLMOpsAgentsExporterConfig, s as createLLMOpsAgentsExporter } from "./agents-exporter-BZjfVkaH.mjs";
-import { a as LLMOpsLangChainClientConfig, i as createLLMOps, n as ProviderOptions, o as LangChainTracingClient, r as TraceContext, s as createLLMOpsLangChainClient, t as LLMOpsClient } from "./index-D0LVaLA4.mjs";
-import { t as createLLMOpsMiddleware } from "./index-BeDbCYjz.mjs";
-import { TelemetryStore, createPgStore as pgStore } from "@llmops/core";
+import { a as AgentsTracingExporter, o as LLMOpsAgentsExporterConfig, s as createLLMOpsAgentsExporter } from "./agents-exporter-Bn3NtzMO.mjs";
+import { a as LLMOpsLangChainClientConfig, i as createLLMOps, n as ProviderOptions, o as LangChainTracingClient, r as TraceContext, s as createLLMOpsLangChainClient, t as LLMOpsClient } from "./index-C0CDqR9v.mjs";
+import { t as createLLMOpsMiddleware } from "./index-DVkfeg2W.mjs";
+import { a as TraceUpsert, i as SpanInsert, n as LLMRequestInsert, o as COST_SUMMARY_GROUP_BY, r as SpanEventInsert, s as CostSummaryGroupBy, t as TelemetryStore } from "./interface-Dz7B6QN1.mjs";
 
 //#region src/telemetry/exporter.d.ts
 
@@ -93,4 +93,4 @@ interface LLMOpsExporterConfig {
  */
 declare function createLLMOpsSpanExporter(config: LLMOpsExporterConfig): SpanExporter;
 //#endregion
-export { type AgentsTracingExporter, type LLMOpsAgentsExporterConfig, type LLMOpsClient, type LLMOpsExporterConfig, type LLMOpsLangChainClientConfig, type LangChainTracingClient, type ProviderOptions, type SpanExporter, type TelemetryStore, type TraceContext, createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops, pgStore };
+export { type AgentsTracingExporter, COST_SUMMARY_GROUP_BY, type CostSummaryGroupBy, type LLMOpsAgentsExporterConfig, type LLMOpsClient, type LLMOpsExporterConfig, type LLMOpsLangChainClientConfig, type LLMRequestInsert, type LangChainTracingClient, type ProviderOptions, type SpanEventInsert, type SpanExporter, type SpanInsert, type TelemetryStore, type TraceContext, type TraceUpsert, createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops };

package/dist/index.mjs

@@ -1,6 +1,7 @@
-import { t as createLLMOpsMiddleware } from "./express-ClEIbLM9.mjs";
-import { t as createLLMOpsAgentsExporter } from "./agents-exporter-CxbWY6xN.mjs";
-import { LLMOPS_INTERNAL_HEADER, LLMOPS_SPAN_NAME_HEADER, LLMOPS_TRACE_ID_HEADER, LLMOPS_TRACE_NAME_HEADER, createPgStore as pgStore } from "@llmops/core";
+import { t as createLLMOpsMiddleware } from "./express-Vt9JurUM.mjs";
+import { t as createLLMOpsAgentsExporter } from "./agents-exporter-DYmMvLPS.mjs";
+import { t as COST_SUMMARY_GROUP_BY } from "./constants-sHtPfi36.mjs";
+import { LLMOPS_INTERNAL_HEADER, LLMOPS_SPAN_NAME_HEADER, LLMOPS_TRACE_ID_HEADER, LLMOPS_TRACE_NAME_HEADER } from "@llmops/core";
 import { createApp } from "@llmops/app";
 
 //#region src/telemetry/langchain-client.ts
@@ -229,4 +230,4 @@ function createLLMOpsSpanExporter(config) {
 }
 
 //#endregion
-export { createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops, pgStore };
+export { COST_SUMMARY_GROUP_BY, createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops };

package/dist/interface-BbAwy96d.d.cts

@@ -0,0 +1,223 @@
+import z from "zod";
+
+//#region src/telemetry/constants.d.ts
+declare const COST_SUMMARY_GROUP_BY: readonly ["day", "hour", "model", "provider", "endpoint", "tags"];
+type CostSummaryGroupBy = (typeof COST_SUMMARY_GROUP_BY)[number];
+//#endregion
+//#region src/telemetry/types.d.ts
+
+declare const insertLLMRequestSchema: z.ZodObject<{
+  requestId: z.ZodString;
+  configId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  variantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  environmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  providerConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  provider: z.ZodString;
+  model: z.ZodString;
+  promptTokens: z.ZodDefault<z.ZodNumber>;
+  completionTokens: z.ZodDefault<z.ZodNumber>;
+  totalTokens: z.ZodDefault<z.ZodNumber>;
+  cachedTokens: z.ZodDefault<z.ZodNumber>;
+  cacheCreationTokens: z.ZodDefault<z.ZodNumber>;
+  cost: z.ZodDefault<z.ZodNumber>;
+  cacheSavings: z.ZodDefault<z.ZodNumber>;
+  inputCost: z.ZodDefault<z.ZodNumber>;
+  outputCost: z.ZodDefault<z.ZodNumber>;
+  endpoint: z.ZodString;
+  statusCode: z.ZodNumber;
+  latencyMs: z.ZodDefault<z.ZodNumber>;
+  isStreaming: z.ZodDefault<z.ZodBoolean>;
+  userId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  tags: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  guardrailResults: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+      checkId: z.ZodString;
+      functionId: z.ZodString;
+      hookType: z.ZodEnum<{
+        beforeRequestHook: "beforeRequestHook";
+        afterRequestHook: "afterRequestHook";
+      }>;
+      verdict: z.ZodBoolean;
+      latencyMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    action: z.ZodEnum<{
+      allowed: "allowed";
+      blocked: "blocked";
+      logged: "logged";
+    }>;
+    totalLatencyMs: z.ZodNumber;
+  }, z.core.$strip>>>;
+  traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  parentSpanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type LLMRequestInsert = z.infer<typeof insertLLMRequestSchema>;
+declare const upsertTraceSchema: z.ZodObject<{
+  traceId: z.ZodString;
+  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  userId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  status: z.ZodDefault<z.ZodEnum<{
+    error: "error";
+    unset: "unset";
+    ok: "ok";
+  }>>;
+  startTime: z.ZodDate;
+  endTime: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+  durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  spanCount: z.ZodDefault<z.ZodNumber>;
+  totalInputTokens: z.ZodDefault<z.ZodNumber>;
+  totalOutputTokens: z.ZodDefault<z.ZodNumber>;
+  totalTokens: z.ZodDefault<z.ZodNumber>;
+  totalCost: z.ZodDefault<z.ZodNumber>;
+  tags: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type TraceUpsert = z.infer<typeof upsertTraceSchema>;
+declare const insertSpanSchema: z.ZodObject<{
+  traceId: z.ZodString;
+  spanId: z.ZodString;
+  parentSpanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  name: z.ZodString;
+  kind: z.ZodDefault<z.ZodNumber>;
+  status: z.ZodDefault<z.ZodNumber>;
+  statusMessage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  startTime: z.ZodDate;
+  endTime: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+  durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  promptTokens: z.ZodDefault<z.ZodNumber>;
+  completionTokens: z.ZodDefault<z.ZodNumber>;
+  totalTokens: z.ZodDefault<z.ZodNumber>;
+  cost: z.ZodDefault<z.ZodNumber>;
+  configId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  variantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  environmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  providerConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  requestId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  source: z.ZodDefault<z.ZodEnum<{
+    gateway: "gateway";
+    otlp: "otlp";
+    langsmith: "langsmith";
+  }>>;
+  input: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+  output: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+  attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type SpanInsert = z.infer<typeof insertSpanSchema>;
+declare const insertSpanEventSchema: z.ZodObject<{
+  traceId: z.ZodString;
+  spanId: z.ZodString;
+  name: z.ZodString;
+  timestamp: z.ZodDate;
+  attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type SpanEventInsert = z.infer<typeof insertSpanEventSchema>;
+//#endregion
+//#region src/telemetry/interface.d.ts
+/**
+ * TelemetryStore provides read + write access to telemetry data.
+ * Implemented by pgStore, d1Store, and future store backends.
+ */
+interface TelemetryStore {
+  batchInsertRequests(requests: LLMRequestInsert[]): Promise<{
+    count: number;
+  }>;
+  insertRequest(request: LLMRequestInsert): Promise<unknown>;
+  listRequests(params?: {
+    limit?: number;
+    offset?: number;
+    configId?: string;
+    variantId?: string;
+    environmentId?: string;
+    providerConfigId?: string;
+    provider?: string;
+    model?: string;
+    startDate?: Date;
+    endDate?: Date;
+    tags?: Record<string, string[]>;
+  }): Promise<{
+    data: unknown[];
+    total: number;
+    limit: number;
+    offset: number;
+  }>;
+  getRequestByRequestId(requestId: string): Promise<unknown | undefined>;
+  getTotalCost(params: {
+    startDate: Date;
+    endDate: Date;
+    configId?: string;
+    variantId?: string;
+    environmentId?: string;
+    tags?: Record<string, string[]>;
+  }): Promise<unknown>;
+  getCostByModel(params: {
+    startDate: Date;
+    endDate: Date;
+  }): Promise<unknown[]>;
+  getCostByProvider(params: {
+    startDate: Date;
+    endDate: Date;
+  }): Promise<unknown[]>;
+  getDailyCosts(params: {
+    startDate: Date;
+    endDate: Date;
+  }): Promise<unknown[]>;
+  getCostSummary(params: {
+    startDate: Date;
+    endDate: Date;
+    configId?: string;
+    variantId?: string;
+    environmentId?: string;
+    groupBy?: CostSummaryGroupBy;
+    tags?: Record<string, string[]>;
+    tagKeys?: string[];
+  }): Promise<unknown[]>;
+  getRequestStats(params: {
+    startDate: Date;
+    endDate: Date;
+    configId?: string;
+    variantId?: string;
+    environmentId?: string;
+    tags?: Record<string, string[]>;
+  }): Promise<unknown>;
+  getDistinctTags(): Promise<unknown[]>;
+  upsertTrace(data: TraceUpsert): Promise<void>;
+  batchInsertSpans(spans: SpanInsert[]): Promise<{
+    count: number;
+  }>;
+  batchInsertSpanEvents(events: SpanEventInsert[]): Promise<{
+    count: number;
+  }>;
+  listTraces(params?: {
+    limit?: number;
+    offset?: number;
+    sessionId?: string;
+    userId?: string;
+    status?: string;
+    name?: string;
+    startDate?: Date;
+    endDate?: Date;
+    tags?: Record<string, string[]>;
+  }): Promise<{
+    data: unknown[];
+    total: number;
+    limit: number;
+    offset: number;
+  }>;
+  getTraceWithSpans(traceId: string): Promise<{
+    trace: unknown;
+    spans: unknown[];
+    events: unknown[];
+  } | undefined>;
+  getTraceStats(params: {
+    startDate: Date;
+    endDate: Date;
+    sessionId?: string;
+    userId?: string;
+  }): Promise<unknown>;
+}
+//#endregion
+export { TraceUpsert as a, SpanInsert as i, LLMRequestInsert as n, COST_SUMMARY_GROUP_BY as o, SpanEventInsert as r, CostSummaryGroupBy as s, TelemetryStore as t };

package/dist/interface-Dz7B6QN1.d.mts

@@ -0,0 +1,223 @@
+import z from "zod";
+
+//#region src/telemetry/constants.d.ts
+declare const COST_SUMMARY_GROUP_BY: readonly ["day", "hour", "model", "provider", "endpoint", "tags"];
+type CostSummaryGroupBy = (typeof COST_SUMMARY_GROUP_BY)[number];
+//#endregion
+//#region src/telemetry/types.d.ts
+
+declare const insertLLMRequestSchema: z.ZodObject<{
+  requestId: z.ZodString;
+  configId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  variantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  environmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  providerConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  provider: z.ZodString;
+  model: z.ZodString;
+  promptTokens: z.ZodDefault<z.ZodNumber>;
+  completionTokens: z.ZodDefault<z.ZodNumber>;
+  totalTokens: z.ZodDefault<z.ZodNumber>;
+  cachedTokens: z.ZodDefault<z.ZodNumber>;
+  cacheCreationTokens: z.ZodDefault<z.ZodNumber>;
+  cost: z.ZodDefault<z.ZodNumber>;
+  cacheSavings: z.ZodDefault<z.ZodNumber>;
+  inputCost: z.ZodDefault<z.ZodNumber>;
+  outputCost: z.ZodDefault<z.ZodNumber>;
+  endpoint: z.ZodString;
+  statusCode: z.ZodNumber;
+  latencyMs: z.ZodDefault<z.ZodNumber>;
+  isStreaming: z.ZodDefault<z.ZodBoolean>;
+  userId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  tags: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  guardrailResults: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+      checkId: z.ZodString;
+      functionId: z.ZodString;
+      hookType: z.ZodEnum<{
+        beforeRequestHook: "beforeRequestHook";
+        afterRequestHook: "afterRequestHook";
+      }>;
+      verdict: z.ZodBoolean;
+      latencyMs: z.ZodNumber;
+    }, z.core.$strip>>;
+    action: z.ZodEnum<{
+      allowed: "allowed";
+      blocked: "blocked";
+      logged: "logged";
+    }>;
+    totalLatencyMs: z.ZodNumber;
+  }, z.core.$strip>>>;
+  traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  spanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  parentSpanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type LLMRequestInsert = z.infer<typeof insertLLMRequestSchema>;
+declare const upsertTraceSchema: z.ZodObject<{
+  traceId: z.ZodString;
+  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  userId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  status: z.ZodDefault<z.ZodEnum<{
+    error: "error";
+    unset: "unset";
+    ok: "ok";
+  }>>;
+  startTime: z.ZodDate;
+  endTime: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+  durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  spanCount: z.ZodDefault<z.ZodNumber>;
+  totalInputTokens: z.ZodDefault<z.ZodNumber>;
+  totalOutputTokens: z.ZodDefault<z.ZodNumber>;
+  totalTokens: z.ZodDefault<z.ZodNumber>;
+  totalCost: z.ZodDefault<z.ZodNumber>;
+  tags: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type TraceUpsert = z.infer<typeof upsertTraceSchema>;
+declare const insertSpanSchema: z.ZodObject<{
+  traceId: z.ZodString;
+  spanId: z.ZodString;
+  parentSpanId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  name: z.ZodString;
+  kind: z.ZodDefault<z.ZodNumber>;
+  status: z.ZodDefault<z.ZodNumber>;
+  statusMessage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  startTime: z.ZodDate;
+  endTime: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+  durationMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  promptTokens: z.ZodDefault<z.ZodNumber>;
+  completionTokens: z.ZodDefault<z.ZodNumber>;
+  totalTokens: z.ZodDefault<z.ZodNumber>;
+  cost: z.ZodDefault<z.ZodNumber>;
+  configId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  variantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  environmentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  providerConfigId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  requestId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  source: z.ZodDefault<z.ZodEnum<{
+    gateway: "gateway";
+    otlp: "otlp";
+    langsmith: "langsmith";
+  }>>;
+  input: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+  output: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+  attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type SpanInsert = z.infer<typeof insertSpanSchema>;
+declare const insertSpanEventSchema: z.ZodObject<{
+  traceId: z.ZodString;
+  spanId: z.ZodString;
+  name: z.ZodString;
+  timestamp: z.ZodDate;
+  attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type SpanEventInsert = z.infer<typeof insertSpanEventSchema>;
+//#endregion
+//#region src/telemetry/interface.d.ts
+/**
+ * TelemetryStore provides read + write access to telemetry data.
+ * Implemented by pgStore, d1Store, and future store backends.
+ */
+interface TelemetryStore {
+  batchInsertRequests(requests: LLMRequestInsert[]): Promise<{
+    count: number;
+  }>;
+  insertRequest(request: LLMRequestInsert): Promise<unknown>;
+  listRequests(params?: {
+    limit?: number;
+    offset?: number;
+    configId?: string;
+    variantId?: string;
+    environmentId?: string;
+    providerConfigId?: string;
+    provider?: string;
+    model?: string;
+    startDate?: Date;
+    endDate?: Date;
+    tags?: Record<string, string[]>;
+  }): Promise<{
+    data: unknown[];
+    total: number;
+    limit: number;
+    offset: number;
+  }>;
+  getRequestByRequestId(requestId: string): Promise<unknown | undefined>;
+  getTotalCost(params: {
+    startDate: Date;
+    endDate: Date;
+    configId?: string;
+    variantId?: string;
+    environmentId?: string;
+    tags?: Record<string, string[]>;
+  }): Promise<unknown>;
+  getCostByModel(params: {
+    startDate: Date;
+    endDate: Date;
+  }): Promise<unknown[]>;
+  getCostByProvider(params: {
+    startDate: Date;
+    endDate: Date;
+  }): Promise<unknown[]>;
+  getDailyCosts(params: {
+    startDate: Date;
+    endDate: Date;
+  }): Promise<unknown[]>;
+  getCostSummary(params: {
+    startDate: Date;
+    endDate: Date;
+    configId?: string;
+    variantId?: string;
+    environmentId?: string;
+    groupBy?: CostSummaryGroupBy;
+    tags?: Record<string, string[]>;
+    tagKeys?: string[];
+  }): Promise<unknown[]>;
+  getRequestStats(params: {
+    startDate: Date;
+    endDate: Date;
+    configId?: string;
+    variantId?: string;
+    environmentId?: string;
+    tags?: Record<string, string[]>;
+  }): Promise<unknown>;
+  getDistinctTags(): Promise<unknown[]>;
+  upsertTrace(data: TraceUpsert): Promise<void>;
+  batchInsertSpans(spans: SpanInsert[]): Promise<{
+    count: number;
+  }>;
+  batchInsertSpanEvents(events: SpanEventInsert[]): Promise<{
+    count: number;
+  }>;
+  listTraces(params?: {
+    limit?: number;
+    offset?: number;
+    sessionId?: string;
+    userId?: string;
+    status?: string;
+    name?: string;
+    startDate?: Date;
+    endDate?: Date;
+    tags?: Record<string, string[]>;
+  }): Promise<{
+    data: unknown[];
+    total: number;
+    limit: number;
+    offset: number;
+  }>;
+  getTraceWithSpans(traceId: string): Promise<{
+    trace: unknown;
+    spans: unknown[];
+    events: unknown[];
+  } | undefined>;
+  getTraceStats(params: {
+    startDate: Date;
+    endDate: Date;
+    sessionId?: string;
+    userId?: string;
+  }): Promise<unknown>;
+}
+//#endregion
+export { TraceUpsert as a, SpanInsert as i, LLMRequestInsert as n, COST_SUMMARY_GROUP_BY as o, SpanEventInsert as r, CostSummaryGroupBy as s, TelemetryStore as t };

package/dist/nextjs.d.cts

@@ -1,5 +1,5 @@
-import "./agents-exporter-B-ADoC7t.cjs";
-import { t as LLMOpsClient } from "./index-C7J-9Jvp.cjs";
+import "./agents-exporter-vuQine9v.cjs";
+import { t as LLMOpsClient } from "./index-sjRozlIk.cjs";
 
 //#region src/lib/nextjs/index.d.ts
 declare function toNextJsHandler(client: LLMOpsClient): {

package/dist/nextjs.d.mts

@@ -1,5 +1,5 @@
-import "./agents-exporter-BZjfVkaH.mjs";
-import { t as LLMOpsClient } from "./index-D0LVaLA4.mjs";
+import "./agents-exporter-Bn3NtzMO.mjs";
+import { t as LLMOpsClient } from "./index-C0CDqR9v.mjs";
 
 //#region src/lib/nextjs/index.d.ts
 declare function toNextJsHandler(client: LLMOpsClient): {