@llmops/sdk 1.0.0-beta.5 → 1.0.0-beta.7

package/dist/agents.cjs

@@ -1,3 +1,3 @@
-const require_agents_exporter = require('./agents-exporter-BuTq2n2y.cjs');
+const require_agents_exporter = require('./agents-exporter-CEbQkds8.cjs');
 
 exports.createLLMOpsAgentsExporter = require_agents_exporter.createLLMOpsAgentsExporter;

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-uzN3bkth.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-BZHCcFSd.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-vcpgCF69.mjs";
+import { t as createLLMOpsAgentsExporter } from "./agents-exporter-CGxTzDeQ.mjs";
 
 export { createLLMOpsAgentsExporter };

package/dist/d1-store-D664VLg0.d.cts

@@ -0,0 +1,52 @@
+import { t as TelemetryStore } from "./interface-DMuF7YgM.cjs";
+
+//#region src/store/d1/types.d.ts
+
+/**
+ * Minimal D1Database type interface.
+ * Avoids depending on @cloudflare/workers-types (10MB+).
+ * Users pass their actual D1 binding which satisfies this structurally.
+ */
+interface D1Database {
+  prepare(query: string): D1PreparedStatement;
+  batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
+}
+interface D1PreparedStatement {
+  bind(...values: unknown[]): D1PreparedStatement;
+  first<T = unknown>(colName?: string): Promise<T | null>;
+  all<T = unknown>(): Promise<D1Result<T>>;
+  run(): Promise<D1Result>;
+}
+interface D1Result<T = unknown> {
+  results: T[];
+  success: boolean;
+  meta: {
+    changes: number;
+    duration: number;
+    last_row_id: number;
+  };
+}
+//#endregion
+//#region src/store/d1/d1-store.d.ts
+type D1Store = TelemetryStore & {
+  _db: D1Database;
+};
+/**
+ * Create a Cloudflare D1-backed telemetry store.
+ *
+ * Usage:
+ * ```ts
+ * import { d1Store } from '@llmops/sdk/store/d1'
+ *
+ * export default {
+ *   async fetch(request, env) {
+ *     const ops = llmops({
+ *       telemetry: d1Store(env.DB),
+ *     })
+ *   }
+ * }
+ * ```
+ */
+declare function createD1Store(db: D1Database): D1Store;
+//#endregion
+export { createD1Store as n, D1Database as r, D1Store as t };

package/dist/d1-store-DBf99oU8.d.mts

@@ -0,0 +1,52 @@
+import { t as TelemetryStore } from "./interface-BrJMazBg.mjs";
+
+//#region src/store/d1/types.d.ts
+
+/**
+ * Minimal D1Database type interface.
+ * Avoids depending on @cloudflare/workers-types (10MB+).
+ * Users pass their actual D1 binding which satisfies this structurally.
+ */
+interface D1Database {
+  prepare(query: string): D1PreparedStatement;
+  batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
+}
+interface D1PreparedStatement {
+  bind(...values: unknown[]): D1PreparedStatement;
+  first<T = unknown>(colName?: string): Promise<T | null>;
+  all<T = unknown>(): Promise<D1Result<T>>;
+  run(): Promise<D1Result>;
+}
+interface D1Result<T = unknown> {
+  results: T[];
+  success: boolean;
+  meta: {
+    changes: number;
+    duration: number;
+    last_row_id: number;
+  };
+}
+//#endregion
+//#region src/store/d1/d1-store.d.ts
+type D1Store = TelemetryStore & {
+  _db: D1Database;
+};
+/**
+ * Create a Cloudflare D1-backed telemetry store.
+ *
+ * Usage:
+ * ```ts
+ * import { d1Store } from '@llmops/sdk/store/d1'
+ *
+ * export default {
+ *   async fetch(request, env) {
+ *     const ops = llmops({
+ *       telemetry: d1Store(env.DB),
+ *     })
+ *   }
+ * }
+ * ```
+ */
+declare function createD1Store(db: D1Database): D1Store;
+//#endregion
+export { createD1Store as n, D1Database as r, D1Store as t };

package/dist/express.cjs

@@ -1,3 +1,3 @@
-const require_express = require('./express-B-wbCza5.cjs');
+const require_express = require('./express-D-Nfc61h.cjs');
 
 exports.createLLMOpsMiddleware = require_express.createLLMOpsMiddleware;

package/dist/express.d.cts

@@ -1,4 +1,4 @@
-import "./agents-exporter-uzN3bkth.cjs";
-import "./index-Beb26ZNG.cjs";
-import { t as createLLMOpsMiddleware } from "./index-DnWGper4.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-BZHCcFSd.mjs";
-import "./index-05byZKeu.mjs";
-import { t as createLLMOpsMiddleware } from "./index-Dvz-L2Hf.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-DMtc0d_Y.mjs";
+import { t as createLLMOpsMiddleware } from "./express-ClNV0OG9.mjs";
 
 export { createLLMOpsMiddleware };

package/dist/hono.d.cts

@@ -1,5 +1,5 @@
-import "./agents-exporter-uzN3bkth.cjs";
-import { t as LLMOpsClient } from "./index-Beb26ZNG.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-BZHCcFSd.mjs";
-import { t as LLMOpsClient } from "./index-05byZKeu.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-DnWGper4.d.cts → index-BHO7MEJx.d.cts}

@@ -1,4 +1,4 @@
-import { t as LLMOpsClient } from "./index-Beb26ZNG.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-05byZKeu.d.mts → index-C0CDqR9v.d.mts}

@@ -1,4 +1,4 @@
-import { a as AgentsTracingExporter } from "./agents-exporter-BZHCcFSd.mjs";
+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-Dvz-L2Hf.d.mts → index-DVkfeg2W.d.mts}

@@ -1,4 +1,4 @@
-import { t as LLMOpsClient } from "./index-05byZKeu.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-Beb26ZNG.d.cts → index-sjRozlIk.d.cts}

@@ -1,4 +1,4 @@
-import { a as AgentsTracingExporter } from "./agents-exporter-uzN3bkth.cjs";
+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_pg_store = require('./pg-store-uawkO2hJ.cjs');
+const require_express = require('./express-D-Nfc61h.cjs');
+const require_agents_exporter = require('./agents-exporter-CEbQkds8.cjs');
 let __llmops_core = require("@llmops/core");
 let __llmops_app = require("@llmops/app");
 
@@ -229,8 +230,10 @@ function createLLMOpsSpanExporter(config) {
 }
 
 //#endregion
+exports.COST_SUMMARY_GROUP_BY = require_pg_store.COST_SUMMARY_GROUP_BY;
 exports.createLLMOpsAgentsExporter = require_agents_exporter.createLLMOpsAgentsExporter;
 exports.createLLMOpsLangChainClient = createLLMOpsLangChainClient;
 exports.createLLMOpsMiddleware = require_express.createLLMOpsMiddleware;
 exports.createLLMOpsSpanExporter = createLLMOpsSpanExporter;
-exports.llmops = createLLMOps;
+exports.llmops = createLLMOps;
+exports.pgStore = require_pg_store.createPgStore;

package/dist/index.d.cts

@@ -1,6 +1,7 @@
-import { a as AgentsTracingExporter, o as LLMOpsAgentsExporterConfig, s as createLLMOpsAgentsExporter } from "./agents-exporter-uzN3bkth.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-Beb26ZNG.cjs";
-import { t as createLLMOpsMiddleware } from "./index-DnWGper4.cjs";
+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 PgStore, c as TraceUpsert, i as LLMRequestInsert, l as createPgStore, n as COST_SUMMARY_GROUP_BY, o as SpanEventInsert, r as CostSummaryGroupBy, s as SpanInsert, t as TelemetryStore } from "./interface-DMuF7YgM.cjs";
 
 //#region src/telemetry/exporter.d.ts
 
@@ -92,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 TraceContext, createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops };
+export { type AgentsTracingExporter, COST_SUMMARY_GROUP_BY, type CostSummaryGroupBy, type LLMOpsAgentsExporterConfig, type LLMOpsClient, type LLMOpsExporterConfig, type LLMOpsLangChainClientConfig, type LLMRequestInsert, type LangChainTracingClient, type PgStore, type ProviderOptions, type SpanEventInsert, type SpanExporter, type SpanInsert, type TelemetryStore, type TraceContext, type TraceUpsert, createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops, createPgStore as pgStore };

package/dist/index.d.mts

@@ -1,6 +1,7 @@
-import { a as AgentsTracingExporter, o as LLMOpsAgentsExporterConfig, s as createLLMOpsAgentsExporter } from "./agents-exporter-BZHCcFSd.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-05byZKeu.mjs";
-import { t as createLLMOpsMiddleware } from "./index-Dvz-L2Hf.mjs";
+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 PgStore, c as TraceUpsert, i as LLMRequestInsert, l as createPgStore, n as COST_SUMMARY_GROUP_BY, o as SpanEventInsert, r as CostSummaryGroupBy, s as SpanInsert, t as TelemetryStore } from "./interface-BrJMazBg.mjs";
 
 //#region src/telemetry/exporter.d.ts
 
@@ -92,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 TraceContext, createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops };
+export { type AgentsTracingExporter, COST_SUMMARY_GROUP_BY, type CostSummaryGroupBy, type LLMOpsAgentsExporterConfig, type LLMOpsClient, type LLMOpsExporterConfig, type LLMOpsLangChainClientConfig, type LLMRequestInsert, type LangChainTracingClient, type PgStore, type ProviderOptions, type SpanEventInsert, type SpanExporter, type SpanInsert, type TelemetryStore, type TraceContext, type TraceUpsert, createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops, createPgStore as pgStore };

package/dist/index.mjs

@@ -1,5 +1,6 @@
-import { t as createLLMOpsMiddleware } from "./express-DMtc0d_Y.mjs";
-import { t as createLLMOpsAgentsExporter } from "./agents-exporter-vcpgCF69.mjs";
+import { n as createPgStore, t as COST_SUMMARY_GROUP_BY } from "./pg-store-sIMdF_Pc.mjs";
+import { t as createLLMOpsMiddleware } from "./express-ClNV0OG9.mjs";
+import { t as createLLMOpsAgentsExporter } from "./agents-exporter-CGxTzDeQ.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";
 
@@ -229,4 +230,4 @@ function createLLMOpsSpanExporter(config) {
 }
 
 //#endregion
-export { createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops };
+export { COST_SUMMARY_GROUP_BY, createLLMOpsAgentsExporter, createLLMOpsLangChainClient, createLLMOpsMiddleware, createLLMOpsSpanExporter, createLLMOps as llmops, createPgStore as pgStore };

package/dist/interface-BrJMazBg.d.mts

@@ -0,0 +1,240 @@
+import z from "zod";
+
+//#region src/telemetry/pg-store.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 COST_SUMMARY_GROUP_BY: readonly ["day", "hour", "model", "provider", "endpoint", "tags"];
+type CostSummaryGroupBy = (typeof COST_SUMMARY_GROUP_BY)[number];
+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>;
+type PgStore = TelemetryStore & {
+  _pool: unknown;
+  _schema: string;
+};
+/**
+ * Create a PostgreSQL-backed telemetry store.
+ *
+ * Usage:
+ * ```ts
+ * import { llmops } from '@llmops/sdk'
+ * import { pgStore } from '@llmops/sdk/store/pg'
+ *
+ * const ops = llmops({
+ *   telemetry: pgStore(process.env.DATABASE_URL),
+ * })
+ * ```
+ */
+declare function createPgStore(connectionString: string, options?: {
+  schema?: string;
+}): PgStore;
+//#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 { PgStore as a, TraceUpsert as c, LLMRequestInsert as i, createPgStore as l, COST_SUMMARY_GROUP_BY as n, SpanEventInsert as o, CostSummaryGroupBy as r, SpanInsert as s, TelemetryStore as t };