@evalops/maestro 0.10.8 → 0.10.11

package/dist/services/traces/service.js

@@ -0,0 +1,197 @@
+import { eq, sql } from "drizzle-orm";
+import { getDb, isDatabaseConfigured } from "../../db/client.js";
+import { executionTraces } from "../../db/schema.js";
+import { createLogger } from "../../utils/logger.js";
+import { countTraceSpans, normalizeExecutionTraceInput, parseTraceStatus, } from "./normalize.js";
+const logger = createLogger("traces");
+export class TracesUnavailableError extends Error {
+    constructor() {
+        super("Traces database is not configured.");
+        this.name = "TracesUnavailableError";
+    }
+}
+function readNumber(row, key) {
+    const value = row[key];
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "bigint")
+        return Number(value);
+    if (typeof value === "string") {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return 0;
+}
+function readString(row, key) {
+    const value = row[key];
+    return typeof value === "string" ? value : "";
+}
+function readDateIso(row, key) {
+    const value = row[key];
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === "string")
+        return new Date(value).toISOString();
+    return new Date(0).toISOString();
+}
+function normalizeStoredSpans(spans) {
+    if (!Array.isArray(spans))
+        return [];
+    return spans;
+}
+function traceFromRow(row) {
+    return {
+        traceId: row.traceId,
+        workspaceId: row.workspaceId,
+        agentId: row.agentId,
+        spans: normalizeStoredSpans(row.spans),
+        durationMs: row.durationMs,
+        status: parseTraceStatus(row.status),
+        createdAt: row.createdAt.toISOString(),
+    };
+}
+function buildFilters(query) {
+    const filters = [];
+    if (query.workspaceId) {
+        filters.push(sql `workspace_id = ${query.workspaceId}`);
+    }
+    if (query.agentId) {
+        filters.push(sql `agent_id = ${query.agentId}`);
+    }
+    if (query.status) {
+        filters.push(sql `status = ${query.status}`);
+    }
+    return filters;
+}
+function summaryFromRow(row) {
+    const spans = normalizeStoredSpans(row.spans);
+    return {
+        traceId: readString(row, "trace_id"),
+        workspaceId: readString(row, "workspace_id"),
+        agentId: readString(row, "agent_id"),
+        durationMs: readNumber(row, "duration_ms"),
+        status: parseTraceStatus(readString(row, "status")),
+        spanCount: spans.length > 0 ? countTraceSpans(spans) : readNumber(row, "span_count"),
+        createdAt: readDateIso(row, "created_at"),
+    };
+}
+export class TracesService {
+    constructor(getDatabase = getDb, databaseConfigured = isDatabaseConfigured) {
+        this.getDatabase = getDatabase;
+        this.databaseConfigured = databaseConfigured;
+    }
+    async recordTrace(input) {
+        if (!this.databaseConfigured()) {
+            throw new TracesUnavailableError();
+        }
+        const trace = normalizeExecutionTraceInput(input);
+        const db = this.getDatabase();
+        const createdAt = new Date(trace.createdAt);
+        try {
+            const [row] = await db
+                .insert(executionTraces)
+                .values({
+                traceId: trace.traceId,
+                workspaceId: trace.workspaceId,
+                agentId: trace.agentId,
+                spans: trace.spans,
+                durationMs: trace.durationMs,
+                status: trace.status,
+                createdAt,
+            })
+                .onConflictDoUpdate({
+                target: executionTraces.traceId,
+                set: {
+                    workspaceId: trace.workspaceId,
+                    agentId: trace.agentId,
+                    spans: trace.spans,
+                    durationMs: trace.durationMs,
+                    status: trace.status,
+                    createdAt: sql `LEAST(${executionTraces.createdAt}, ${createdAt})`,
+                },
+            })
+                .returning();
+            return row ? traceFromRow(row) : trace;
+        }
+        catch (error) {
+            logger.warn("Failed to record execution trace", {
+                error: error instanceof Error ? error.message : String(error),
+                traceId: trace.traceId,
+                workspaceId: trace.workspaceId,
+                agentId: trace.agentId,
+            });
+            throw error;
+        }
+    }
+    async getTrace(traceId) {
+        if (!this.databaseConfigured()) {
+            throw new TracesUnavailableError();
+        }
+        const normalizedTraceId = traceId.trim();
+        if (!normalizedTraceId)
+            return null;
+        const db = this.getDatabase();
+        const [row] = await db
+            .select()
+            .from(executionTraces)
+            .where(eq(executionTraces.traceId, normalizedTraceId))
+            .limit(1);
+        return row ? traceFromRow(row) : null;
+    }
+    async listTraces(query) {
+        if (!this.databaseConfigured()) {
+            throw new TracesUnavailableError();
+        }
+        const filters = buildFilters(query);
+        const where = filters.length > 0 ? sql `WHERE ${sql.join(filters, sql ` AND `)}` : sql ``;
+        const db = this.getDatabase();
+        const result = await db.execute(sql `
+			SELECT
+				trace_id,
+				workspace_id,
+				agent_id,
+				duration_ms,
+				status,
+				spans,
+				created_at
+			FROM execution_traces
+			${where}
+			ORDER BY created_at DESC, trace_id ASC
+			LIMIT ${query.limit + 1}
+			OFFSET ${query.offset}
+		`);
+        const rows = Array.from(result);
+        const hasMore = rows.length > query.limit;
+        const visibleRows = hasMore ? rows.slice(0, query.limit) : rows;
+        return {
+            traces: visibleRows.map(summaryFromRow),
+            pagination: {
+                limit: query.limit,
+                offset: query.offset,
+                hasMore,
+                ...(hasMore ? { nextOffset: query.offset + query.limit } : {}),
+            },
+        };
+    }
+    summarizeTrace(trace) {
+        return {
+            traceId: trace.traceId,
+            workspaceId: trace.workspaceId,
+            agentId: trace.agentId,
+            durationMs: trace.durationMs,
+            status: trace.status,
+            spanCount: countTraceSpans(trace.spans),
+            createdAt: trace.createdAt,
+        };
+    }
+}
+let defaultTracesService = null;
+export function getTracesService() {
+    defaultTracesService ??= new TracesService();
+    return defaultTracesService;
+}
+export function setTracesServiceForTest(service) {
+    defaultTracesService = service;
+}
+//# sourceMappingURL=service.js.map

package/dist/services/traces/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/services/traces/service.ts"],"names":[],"mappings":"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","sourcesContent":["import { type SQL, eq, sql } from \"drizzle-orm\";\nimport { type DbClient, getDb, isDatabaseConfigured } from \"../../db/client.js\";\nimport { executionTraces } from \"../../db/schema.js\";\nimport { createLogger } from \"../../utils/logger.js\";\nimport {\n\tcountTraceSpans,\n\tnormalizeExecutionTraceInput,\n\tparseTraceStatus,\n} from \"./normalize.js\";\nimport type {\n\tExecutionTrace,\n\tExecutionTraceInput,\n\tExecutionTraceSpan,\n\tExecutionTraceSummary,\n\tTraceListQuery,\n\tTraceListResult,\n} from \"./types.js\";\n\nconst logger = createLogger(\"traces\");\n\ntype ExecutionTraceRow = typeof executionTraces.$inferSelect;\n\nexport class TracesUnavailableError extends Error {\n\tconstructor() {\n\t\tsuper(\"Traces database is not configured.\");\n\t\tthis.name = \"TracesUnavailableError\";\n\t}\n}\n\nfunction readNumber(row: Record<string, unknown>, key: string): number {\n\tconst value = row[key];\n\tif (typeof value === \"number\" && Number.isFinite(value)) return value;\n\tif (typeof value === \"bigint\") return Number(value);\n\tif (typeof value === \"string\") {\n\t\tconst parsed = Number(value);\n\t\tif (Number.isFinite(parsed)) return parsed;\n\t}\n\treturn 0;\n}\n\nfunction readString(row: Record<string, unknown>, key: string): string {\n\tconst value = row[key];\n\treturn typeof value === \"string\" ? value : \"\";\n}\n\nfunction readDateIso(row: Record<string, unknown>, key: string): string {\n\tconst value = row[key];\n\tif (value instanceof Date) return value.toISOString();\n\tif (typeof value === \"string\") return new Date(value).toISOString();\n\treturn new Date(0).toISOString();\n}\n\nfunction normalizeStoredSpans(spans: unknown): ExecutionTraceSpan[] {\n\tif (!Array.isArray(spans)) return [];\n\treturn spans as ExecutionTraceSpan[];\n}\n\nfunction traceFromRow(row: ExecutionTraceRow): ExecutionTrace {\n\treturn {\n\t\ttraceId: row.traceId,\n\t\tworkspaceId: row.workspaceId,\n\t\tagentId: row.agentId,\n\t\tspans: normalizeStoredSpans(row.spans),\n\t\tdurationMs: row.durationMs,\n\t\tstatus: parseTraceStatus(row.status),\n\t\tcreatedAt: row.createdAt.toISOString(),\n\t};\n}\n\nfunction buildFilters(query: TraceListQuery): SQL[] {\n\tconst filters: SQL[] = [];\n\tif (query.workspaceId) {\n\t\tfilters.push(sql`workspace_id = ${query.workspaceId}`);\n\t}\n\tif (query.agentId) {\n\t\tfilters.push(sql`agent_id = ${query.agentId}`);\n\t}\n\tif (query.status) {\n\t\tfilters.push(sql`status = ${query.status}`);\n\t}\n\treturn filters;\n}\n\nfunction summaryFromRow(row: Record<string, unknown>): ExecutionTraceSummary {\n\tconst spans = normalizeStoredSpans(row.spans);\n\treturn {\n\t\ttraceId: readString(row, \"trace_id\"),\n\t\tworkspaceId: readString(row, \"workspace_id\"),\n\t\tagentId: readString(row, \"agent_id\"),\n\t\tdurationMs: readNumber(row, \"duration_ms\"),\n\t\tstatus: parseTraceStatus(readString(row, \"status\")),\n\t\tspanCount:\n\t\t\tspans.length > 0 ? countTraceSpans(spans) : readNumber(row, \"span_count\"),\n\t\tcreatedAt: readDateIso(row, \"created_at\"),\n\t};\n}\n\nexport class TracesService {\n\tconstructor(\n\t\tprivate readonly getDatabase: () => DbClient = getDb,\n\t\tprivate readonly databaseConfigured: () => boolean = isDatabaseConfigured,\n\t) {}\n\n\tasync recordTrace(input: ExecutionTraceInput): Promise<ExecutionTrace> {\n\t\tif (!this.databaseConfigured()) {\n\t\t\tthrow new TracesUnavailableError();\n\t\t}\n\n\t\tconst trace = normalizeExecutionTraceInput(input);\n\t\tconst db = this.getDatabase();\n\t\tconst createdAt = new Date(trace.createdAt);\n\n\t\ttry {\n\t\t\tconst [row] = await db\n\t\t\t\t.insert(executionTraces)\n\t\t\t\t.values({\n\t\t\t\t\ttraceId: trace.traceId,\n\t\t\t\t\tworkspaceId: trace.workspaceId,\n\t\t\t\t\tagentId: trace.agentId,\n\t\t\t\t\tspans: trace.spans,\n\t\t\t\t\tdurationMs: trace.durationMs,\n\t\t\t\t\tstatus: trace.status,\n\t\t\t\t\tcreatedAt,\n\t\t\t\t})\n\t\t\t\t.onConflictDoUpdate({\n\t\t\t\t\ttarget: executionTraces.traceId,\n\t\t\t\t\tset: {\n\t\t\t\t\t\tworkspaceId: trace.workspaceId,\n\t\t\t\t\t\tagentId: trace.agentId,\n\t\t\t\t\t\tspans: trace.spans,\n\t\t\t\t\t\tdurationMs: trace.durationMs,\n\t\t\t\t\t\tstatus: trace.status,\n\t\t\t\t\t\tcreatedAt: sql`LEAST(${executionTraces.createdAt}, ${createdAt})`,\n\t\t\t\t\t},\n\t\t\t\t})\n\t\t\t\t.returning();\n\n\t\t\treturn row ? traceFromRow(row) : trace;\n\t\t} catch (error) {\n\t\t\tlogger.warn(\"Failed to record execution trace\", {\n\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\ttraceId: trace.traceId,\n\t\t\t\tworkspaceId: trace.workspaceId,\n\t\t\t\tagentId: trace.agentId,\n\t\t\t});\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync getTrace(traceId: string): Promise<ExecutionTrace | null> {\n\t\tif (!this.databaseConfigured()) {\n\t\t\tthrow new TracesUnavailableError();\n\t\t}\n\t\tconst normalizedTraceId = traceId.trim();\n\t\tif (!normalizedTraceId) return null;\n\n\t\tconst db = this.getDatabase();\n\t\tconst [row] = await db\n\t\t\t.select()\n\t\t\t.from(executionTraces)\n\t\t\t.where(eq(executionTraces.traceId, normalizedTraceId))\n\t\t\t.limit(1);\n\n\t\treturn row ? traceFromRow(row) : null;\n\t}\n\n\tasync listTraces(query: TraceListQuery): Promise<TraceListResult> {\n\t\tif (!this.databaseConfigured()) {\n\t\t\tthrow new TracesUnavailableError();\n\t\t}\n\n\t\tconst filters = buildFilters(query);\n\t\tconst where =\n\t\t\tfilters.length > 0 ? sql`WHERE ${sql.join(filters, sql` AND `)}` : sql``;\n\t\tconst db = this.getDatabase();\n\t\tconst result = await db.execute(sql`\n\t\t\tSELECT\n\t\t\t\ttrace_id,\n\t\t\t\tworkspace_id,\n\t\t\t\tagent_id,\n\t\t\t\tduration_ms,\n\t\t\t\tstatus,\n\t\t\t\tspans,\n\t\t\t\tcreated_at\n\t\t\tFROM execution_traces\n\t\t\t${where}\n\t\t\tORDER BY created_at DESC, trace_id ASC\n\t\t\tLIMIT ${query.limit + 1}\n\t\t\tOFFSET ${query.offset}\n\t\t`);\n\n\t\tconst rows = Array.from(result) as Array<Record<string, unknown>>;\n\t\tconst hasMore = rows.length > query.limit;\n\t\tconst visibleRows = hasMore ? rows.slice(0, query.limit) : rows;\n\t\treturn {\n\t\t\ttraces: visibleRows.map(summaryFromRow),\n\t\t\tpagination: {\n\t\t\t\tlimit: query.limit,\n\t\t\t\toffset: query.offset,\n\t\t\t\thasMore,\n\t\t\t\t...(hasMore ? { nextOffset: query.offset + query.limit } : {}),\n\t\t\t},\n\t\t};\n\t}\n\n\tsummarizeTrace(trace: ExecutionTrace): ExecutionTraceSummary {\n\t\treturn {\n\t\t\ttraceId: trace.traceId,\n\t\t\tworkspaceId: trace.workspaceId,\n\t\t\tagentId: trace.agentId,\n\t\t\tdurationMs: trace.durationMs,\n\t\t\tstatus: trace.status,\n\t\t\tspanCount: countTraceSpans(trace.spans),\n\t\t\tcreatedAt: trace.createdAt,\n\t\t};\n\t}\n}\n\nlet defaultTracesService: TracesService | null = null;\n\nexport function getTracesService(): TracesService {\n\tdefaultTracesService ??= new TracesService();\n\treturn defaultTracesService;\n}\n\nexport function setTracesServiceForTest(service: TracesService | null): void {\n\tdefaultTracesService = service;\n}\n"]}

package/dist/services/traces/types.d.ts

@@ -0,0 +1,130 @@
+export declare const TRACE_STATUSES: readonly ["running", "completed", "failed", "timeout"];
+export type TraceStatus = (typeof TRACE_STATUSES)[number];
+export declare const TRACE_SPAN_STATUSES: readonly ["unset", "ok", "error"];
+export type TraceSpanStatus = (typeof TRACE_SPAN_STATUSES)[number];
+export type TraceJsonValue = string | number | boolean | null | TraceJsonValue[] | {
+    [key: string]: TraceJsonValue;
+};
+export interface TraceSpanInput {
+    spanId?: string;
+    parentSpanId?: string | null;
+    name: string;
+    kind?: string;
+    status?: TraceSpanStatus;
+    startTime?: Date | string;
+    endTime?: Date | string;
+    durationMs?: number;
+    attributes?: Record<string, unknown>;
+    input?: unknown;
+    output?: unknown;
+    error?: string;
+    children?: TraceSpanInput[];
+}
+export interface ExecutionTraceInput {
+    traceId?: string;
+    workspaceId: string;
+    agentId: string;
+    spans: TraceSpanInput[];
+    durationMs?: number;
+    status?: TraceStatus;
+    createdAt?: Date | string;
+}
+export interface ExecutionTraceSpan {
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: string;
+    status: TraceSpanStatus;
+    startTime?: string;
+    endTime?: string;
+    durationMs?: number;
+    attributes: Record<string, TraceJsonValue>;
+    input?: TraceJsonValue;
+    output?: TraceJsonValue;
+    error?: string;
+    children?: ExecutionTraceSpan[];
+}
+export interface ExecutionTrace {
+    traceId: string;
+    workspaceId: string;
+    agentId: string;
+    spans: ExecutionTraceSpan[];
+    durationMs: number;
+    status: TraceStatus;
+    createdAt: string;
+}
+export interface ExecutionTraceSummary {
+    traceId: string;
+    workspaceId: string;
+    agentId: string;
+    durationMs: number;
+    status: TraceStatus;
+    spanCount: number;
+    createdAt: string;
+}
+export interface TraceListQuery {
+    workspaceId?: string;
+    agentId?: string;
+    status?: TraceStatus;
+    limit: number;
+    offset: number;
+}
+export interface TraceListResult {
+    traces: ExecutionTraceSummary[];
+    pagination: {
+        limit: number;
+        offset: number;
+        nextOffset?: number;
+        hasMore: boolean;
+    };
+}
+export interface OpenTelemetryAnyValue {
+    stringValue?: string;
+    boolValue?: boolean;
+    intValue?: string;
+    doubleValue?: number;
+    arrayValue?: {
+        values: OpenTelemetryAnyValue[];
+    };
+    kvlistValue?: {
+        values: OpenTelemetryKeyValue[];
+    };
+}
+export interface OpenTelemetryKeyValue {
+    key: string;
+    value: OpenTelemetryAnyValue;
+}
+export interface OpenTelemetrySpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: string;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: OpenTelemetryKeyValue[];
+    status: {
+        code: "STATUS_CODE_UNSET" | "STATUS_CODE_OK" | "STATUS_CODE_ERROR";
+        message?: string;
+    };
+    events?: Array<{
+        name: string;
+        timeUnixNano: string;
+        attributes: OpenTelemetryKeyValue[];
+    }>;
+}
+export interface OpenTelemetryTraceExport {
+    resourceSpans: Array<{
+        resource: {
+            attributes: OpenTelemetryKeyValue[];
+        };
+        scopeSpans: Array<{
+            scope: {
+                name: string;
+                version: string;
+            };
+            spans: OpenTelemetrySpan[];
+        }>;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/traces/types.d.ts.map

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

package/dist/services/traces/types.js

@@ -0,0 +1,8 @@
+export const TRACE_STATUSES = [
+    "running",
+    "completed",
+    "failed",
+    "timeout",
+];
+export const TRACE_SPAN_STATUSES = ["unset", "ok", "error"];
+//# sourceMappingURL=types.js.map

package/dist/services/traces/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/traces/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC7B,SAAS;IACT,WAAW;IACX,QAAQ;IACR,SAAS;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAU,CAAC","sourcesContent":["export const TRACE_STATUSES = [\n\t\"running\",\n\t\"completed\",\n\t\"failed\",\n\t\"timeout\",\n] as const;\n\nexport type TraceStatus = (typeof TRACE_STATUSES)[number];\n\nexport const TRACE_SPAN_STATUSES = [\"unset\", \"ok\", \"error\"] as const;\n\nexport type TraceSpanStatus = (typeof TRACE_SPAN_STATUSES)[number];\n\nexport type TraceJsonValue =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| TraceJsonValue[]\n\t| { [key: string]: TraceJsonValue };\n\nexport interface TraceSpanInput {\n\tspanId?: string;\n\tparentSpanId?: string | null;\n\tname: string;\n\tkind?: string;\n\tstatus?: TraceSpanStatus;\n\tstartTime?: Date | string;\n\tendTime?: Date | string;\n\tdurationMs?: number;\n\tattributes?: Record<string, unknown>;\n\tinput?: unknown;\n\toutput?: unknown;\n\terror?: string;\n\tchildren?: TraceSpanInput[];\n}\n\nexport interface ExecutionTraceInput {\n\ttraceId?: string;\n\tworkspaceId: string;\n\tagentId: string;\n\tspans: TraceSpanInput[];\n\tdurationMs?: number;\n\tstatus?: TraceStatus;\n\tcreatedAt?: Date | string;\n}\n\nexport interface ExecutionTraceSpan {\n\tspanId: string;\n\tparentSpanId?: string;\n\tname: string;\n\tkind: string;\n\tstatus: TraceSpanStatus;\n\tstartTime?: string;\n\tendTime?: string;\n\tdurationMs?: number;\n\tattributes: Record<string, TraceJsonValue>;\n\tinput?: TraceJsonValue;\n\toutput?: TraceJsonValue;\n\terror?: string;\n\tchildren?: ExecutionTraceSpan[];\n}\n\nexport interface ExecutionTrace {\n\ttraceId: string;\n\tworkspaceId: string;\n\tagentId: string;\n\tspans: ExecutionTraceSpan[];\n\tdurationMs: number;\n\tstatus: TraceStatus;\n\tcreatedAt: string;\n}\n\nexport interface ExecutionTraceSummary {\n\ttraceId: string;\n\tworkspaceId: string;\n\tagentId: string;\n\tdurationMs: number;\n\tstatus: TraceStatus;\n\tspanCount: number;\n\tcreatedAt: string;\n}\n\nexport interface TraceListQuery {\n\tworkspaceId?: string;\n\tagentId?: string;\n\tstatus?: TraceStatus;\n\tlimit: number;\n\toffset: number;\n}\n\nexport interface TraceListResult {\n\ttraces: ExecutionTraceSummary[];\n\tpagination: {\n\t\tlimit: number;\n\t\toffset: number;\n\t\tnextOffset?: number;\n\t\thasMore: boolean;\n\t};\n}\n\nexport interface OpenTelemetryAnyValue {\n\tstringValue?: string;\n\tboolValue?: boolean;\n\tintValue?: string;\n\tdoubleValue?: number;\n\tarrayValue?: { values: OpenTelemetryAnyValue[] };\n\tkvlistValue?: { values: OpenTelemetryKeyValue[] };\n}\n\nexport interface OpenTelemetryKeyValue {\n\tkey: string;\n\tvalue: OpenTelemetryAnyValue;\n}\n\nexport interface OpenTelemetrySpan {\n\ttraceId: string;\n\tspanId: string;\n\tparentSpanId?: string;\n\tname: string;\n\tkind: string;\n\tstartTimeUnixNano: string;\n\tendTimeUnixNano: string;\n\tattributes: OpenTelemetryKeyValue[];\n\tstatus: {\n\t\tcode: \"STATUS_CODE_UNSET\" | \"STATUS_CODE_OK\" | \"STATUS_CODE_ERROR\";\n\t\tmessage?: string;\n\t};\n\tevents?: Array<{\n\t\tname: string;\n\t\ttimeUnixNano: string;\n\t\tattributes: OpenTelemetryKeyValue[];\n\t}>;\n}\n\nexport interface OpenTelemetryTraceExport {\n\tresourceSpans: Array<{\n\t\tresource: {\n\t\t\tattributes: OpenTelemetryKeyValue[];\n\t\t};\n\t\tscopeSpans: Array<{\n\t\t\tscope: {\n\t\t\t\tname: string;\n\t\t\t\tversion: string;\n\t\t\t};\n\t\t\tspans: OpenTelemetrySpan[];\n\t\t}>;\n\t}>;\n}\n"]}

package/dist/services/usage-analytics/aggregation.d.ts

@@ -0,0 +1,18 @@
+import { type NormalizedUsageMetric, type UsageAnalyticsBucket, type UsageAnalyticsPeriod, type UsageAnalyticsReport, type UsageAnalyticsTotals, type UsageMetricInput } from "./types.js";
+export declare class UsageAnalyticsValidationError extends Error {
+    constructor(message: string);
+}
+export declare function isUsageAnalyticsPeriod(value: string): value is UsageAnalyticsPeriod;
+export declare function parseUsageAnalyticsPeriod(value: string | null | undefined): UsageAnalyticsPeriod;
+export declare function parseOptionalDate(value: string | null | undefined, label: string): Date | undefined;
+export declare function startOfDay(date: Date): Date;
+export declare function bucketStartForPeriod(date: Date, period: UsageAnalyticsPeriod): Date;
+export declare function normalizeUsageMetricInput(input: UsageMetricInput): NormalizedUsageMetric;
+export declare function emptyUsageTotals(): UsageAnalyticsTotals;
+export declare function summarizeUsageBuckets(buckets: UsageAnalyticsBucket[]): UsageAnalyticsTotals;
+export declare function createUsageAnalyticsReport(params: {
+    period: UsageAnalyticsPeriod;
+    filters: UsageAnalyticsReport["filters"];
+    buckets: UsageAnalyticsBucket[];
+}): UsageAnalyticsReport;
+//# sourceMappingURL=aggregation.d.ts.map

package/dist/services/usage-analytics/aggregation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation.d.ts","sourceRoot":"","sources":["../../../src/services/usage-analytics/aggregation.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,qBAAqB,EAE1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,MAAM,YAAY,CAAC;AAEpB,qBAAa,6BAA8B,SAAQ,KAAK;gBAC3C,OAAO,EAAE,MAAM;CAI3B;AAED,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,MAAM,GACX,KAAK,IAAI,oBAAoB,CAE/B;AAED,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,oBAAoB,CAQtB;AAED,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,GACX,IAAI,GAAG,SAAS,CAOlB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAY3C;AAcD,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,oBAAoB,GAC1B,IAAI,CAIN;AAqBD,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,gBAAgB,GACrB,qBAAqB,CAiCvB;AAED,wBAAgB,gBAAgB,IAAI,oBAAoB,CAYvD;AAED,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,oBAAoB,EAAE,GAC7B,oBAAoB,CAYtB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IAClD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,EAAE,oBAAoB,EAAE,CAAC;CAChC,GAAG,oBAAoB,CAOvB"}

package/dist/services/usage-analytics/aggregation.js

@@ -0,0 +1,130 @@
+import { USAGE_ANALYTICS_PERIODS, } from "./types.js";
+export class UsageAnalyticsValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UsageAnalyticsValidationError";
+    }
+}
+export function isUsageAnalyticsPeriod(value) {
+    return USAGE_ANALYTICS_PERIODS.includes(value);
+}
+export function parseUsageAnalyticsPeriod(value) {
+    const normalized = value?.trim().toLowerCase() || "daily";
+    if (isUsageAnalyticsPeriod(normalized)) {
+        return normalized;
+    }
+    throw new UsageAnalyticsValidationError("Invalid usage analytics period. Use daily, weekly, or monthly.");
+}
+export function parseOptionalDate(value, label) {
+    if (!value)
+        return undefined;
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime())) {
+        throw new UsageAnalyticsValidationError(`Invalid ${label} date.`);
+    }
+    return parsed;
+}
+export function startOfDay(date) {
+    return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), 0, 0, 0, 0));
+}
+function startOfWeek(date) {
+    const dayStart = startOfDay(date);
+    const day = dayStart.getUTCDay();
+    const daysSinceMonday = (day + 6) % 7;
+    dayStart.setUTCDate(dayStart.getUTCDate() - daysSinceMonday);
+    return dayStart;
+}
+function startOfMonth(date) {
+    return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), 1));
+}
+export function bucketStartForPeriod(date, period) {
+    if (period === "weekly")
+        return startOfWeek(date);
+    if (period === "monthly")
+        return startOfMonth(date);
+    return startOfDay(date);
+}
+function cleanRequiredString(value, label) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new UsageAnalyticsValidationError(`${label} is required.`);
+    }
+    return trimmed;
+}
+function cleanOptionalString(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function nonNegativeInteger(value) {
+    if (value === undefined)
+        return 0;
+    if (!Number.isFinite(value) || value <= 0)
+        return 0;
+    return Math.floor(value);
+}
+export function normalizeUsageMetricInput(input) {
+    const occurredAt = input.occurredAt ?? new Date();
+    if (Number.isNaN(occurredAt.getTime())) {
+        throw new UsageAnalyticsValidationError("occurredAt must be a valid date.");
+    }
+    const inputTokens = nonNegativeInteger(input.inputTokens);
+    const outputTokens = nonNegativeInteger(input.outputTokens);
+    const cacheReadTokens = nonNegativeInteger(input.cacheReadTokens);
+    const cacheWriteTokens = nonNegativeInteger(input.cacheWriteTokens);
+    const totalTokens = inputTokens + outputTokens;
+    const costUsd = input.costUsd;
+    const costUsdMicros = costUsd && Number.isFinite(costUsd) && costUsd > 0
+        ? Math.round(costUsd * 1_000_000)
+        : 0;
+    return {
+        workspaceId: cleanRequiredString(input.workspaceId, "workspaceId"),
+        agentId: cleanRequiredString(input.agentId, "agentId"),
+        sessionId: cleanOptionalString(input.sessionId),
+        provider: cleanRequiredString(input.provider, "provider"),
+        model: cleanRequiredString(input.model, "model"),
+        bucketStart: startOfDay(occurredAt),
+        occurredAt,
+        callCount: 1,
+        inputTokens,
+        outputTokens,
+        cacheReadTokens,
+        cacheWriteTokens,
+        totalTokens,
+        costUsdMicros,
+    };
+}
+export function emptyUsageTotals() {
+    return {
+        calls: 0,
+        tokens: {
+            input: 0,
+            output: 0,
+            cacheRead: 0,
+            cacheWrite: 0,
+            total: 0,
+        },
+        costUsd: 0,
+    };
+}
+export function summarizeUsageBuckets(buckets) {
+    const totals = emptyUsageTotals();
+    for (const bucket of buckets) {
+        totals.calls += bucket.calls;
+        totals.tokens.input += bucket.tokens.input;
+        totals.tokens.output += bucket.tokens.output;
+        totals.tokens.cacheRead += bucket.tokens.cacheRead;
+        totals.tokens.cacheWrite += bucket.tokens.cacheWrite;
+        totals.tokens.total += bucket.tokens.total;
+        totals.costUsd += bucket.costUsd;
+    }
+    return totals;
+}
+export function createUsageAnalyticsReport(params) {
+    return {
+        period: params.period,
+        filters: params.filters,
+        totals: summarizeUsageBuckets(params.buckets),
+        buckets: params.buckets,
+    };
+}
+//# sourceMappingURL=aggregation.js.map

package/dist/services/usage-analytics/aggregation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation.js","sourceRoot":"","sources":["../../../src/services/usage-analytics/aggregation.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,uBAAuB,GAMvB,MAAM,YAAY,CAAC;AAEpB,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IACvD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC7C,CAAC;CACD;AAED,MAAM,UAAU,sBAAsB,CACrC,KAAa;IAEb,OAAO,uBAAuB,CAAC,QAAQ,CAAC,KAA6B,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,yBAAyB,CACxC,KAAgC;IAEhC,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC;IAC1D,IAAI,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,6BAA6B,CACtC,gEAAgE,CAChE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,KAAgC,EAChC,KAAa;IAEb,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,6BAA6B,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAU;IACpC,OAAO,IAAI,IAAI,CACd,IAAI,CAAC,GAAG,CACP,IAAI,CAAC,cAAc,EAAE,EACrB,IAAI,CAAC,WAAW,EAAE,EAClB,IAAI,CAAC,UAAU,EAAE,EACjB,CAAC,EACD,CAAC,EACD,CAAC,EACD,CAAC,CACD,CACD,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAU;IAC9B,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;IACjC,MAAM,eAAe,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,eAAe,CAAC,CAAC;IAC7D,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,IAAU;IAC/B,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,oBAAoB,CACnC,IAAU,EACV,MAA4B;IAE5B,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa,EAAE,KAAa;IACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,6BAA6B,CAAC,GAAG,KAAK,eAAe,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAyB;IACrD,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAyB;IACpD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,yBAAyB,CACxC,KAAuB;IAEvB,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;IAClD,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,6BAA6B,CAAC,kCAAkC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC5D,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAClE,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,MAAM,aAAa,GAClB,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QACjD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC;QACjC,CAAC,CAAC,CAAC,CAAC;IAEN,OAAO;QACN,WAAW,EAAE,mBAAmB,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC;QAClE,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC;QACtD,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC;QAC/C,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC;QACzD,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC;QAChD,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC;QACnC,UAAU;QACV,SAAS,EAAE,CAAC;QACZ,WAAW;QACX,YAAY;QACZ,eAAe;QACf,gBAAgB;QAChB,WAAW;QACX,aAAa;KACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC/B,OAAO;QACN,KAAK,EAAE,CAAC;QACR,MAAM,EAAE;YACP,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,CAAC;YACb,KAAK,EAAE,CAAC;SACR;QACD,OAAO,EAAE,CAAC;KACV,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACpC,OAA+B;IAE/B,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3C,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAI1C;IACA,OAAO;QACN,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC,OAAO;KACvB,CAAC;AACH,CAAC","sourcesContent":["import {\n\ttype NormalizedUsageMetric,\n\tUSAGE_ANALYTICS_PERIODS,\n\ttype UsageAnalyticsBucket,\n\ttype UsageAnalyticsPeriod,\n\ttype UsageAnalyticsReport,\n\ttype UsageAnalyticsTotals,\n\ttype UsageMetricInput,\n} from \"./types.js\";\n\nexport class UsageAnalyticsValidationError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"UsageAnalyticsValidationError\";\n\t}\n}\n\nexport function isUsageAnalyticsPeriod(\n\tvalue: string,\n): value is UsageAnalyticsPeriod {\n\treturn USAGE_ANALYTICS_PERIODS.includes(value as UsageAnalyticsPeriod);\n}\n\nexport function parseUsageAnalyticsPeriod(\n\tvalue: string | null | undefined,\n): UsageAnalyticsPeriod {\n\tconst normalized = value?.trim().toLowerCase() || \"daily\";\n\tif (isUsageAnalyticsPeriod(normalized)) {\n\t\treturn normalized;\n\t}\n\tthrow new UsageAnalyticsValidationError(\n\t\t\"Invalid usage analytics period. Use daily, weekly, or monthly.\",\n\t);\n}\n\nexport function parseOptionalDate(\n\tvalue: string | null | undefined,\n\tlabel: string,\n): Date | undefined {\n\tif (!value) return undefined;\n\tconst parsed = new Date(value);\n\tif (Number.isNaN(parsed.getTime())) {\n\t\tthrow new UsageAnalyticsValidationError(`Invalid ${label} date.`);\n\t}\n\treturn parsed;\n}\n\nexport function startOfDay(date: Date): Date {\n\treturn new Date(\n\t\tDate.UTC(\n\t\t\tdate.getUTCFullYear(),\n\t\t\tdate.getUTCMonth(),\n\t\t\tdate.getUTCDate(),\n\t\t\t0,\n\t\t\t0,\n\t\t\t0,\n\t\t\t0,\n\t\t),\n\t);\n}\n\nfunction startOfWeek(date: Date): Date {\n\tconst dayStart = startOfDay(date);\n\tconst day = dayStart.getUTCDay();\n\tconst daysSinceMonday = (day + 6) % 7;\n\tdayStart.setUTCDate(dayStart.getUTCDate() - daysSinceMonday);\n\treturn dayStart;\n}\n\nfunction startOfMonth(date: Date): Date {\n\treturn new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), 1));\n}\n\nexport function bucketStartForPeriod(\n\tdate: Date,\n\tperiod: UsageAnalyticsPeriod,\n): Date {\n\tif (period === \"weekly\") return startOfWeek(date);\n\tif (period === \"monthly\") return startOfMonth(date);\n\treturn startOfDay(date);\n}\n\nfunction cleanRequiredString(value: string, label: string): string {\n\tconst trimmed = value.trim();\n\tif (!trimmed) {\n\t\tthrow new UsageAnalyticsValidationError(`${label} is required.`);\n\t}\n\treturn trimmed;\n}\n\nfunction cleanOptionalString(value: string | undefined): string | undefined {\n\tconst trimmed = value?.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nfunction nonNegativeInteger(value: number | undefined): number {\n\tif (value === undefined) return 0;\n\tif (!Number.isFinite(value) || value <= 0) return 0;\n\treturn Math.floor(value);\n}\n\nexport function normalizeUsageMetricInput(\n\tinput: UsageMetricInput,\n): NormalizedUsageMetric {\n\tconst occurredAt = input.occurredAt ?? new Date();\n\tif (Number.isNaN(occurredAt.getTime())) {\n\t\tthrow new UsageAnalyticsValidationError(\"occurredAt must be a valid date.\");\n\t}\n\n\tconst inputTokens = nonNegativeInteger(input.inputTokens);\n\tconst outputTokens = nonNegativeInteger(input.outputTokens);\n\tconst cacheReadTokens = nonNegativeInteger(input.cacheReadTokens);\n\tconst cacheWriteTokens = nonNegativeInteger(input.cacheWriteTokens);\n\tconst totalTokens = inputTokens + outputTokens;\n\tconst costUsd = input.costUsd;\n\tconst costUsdMicros =\n\t\tcostUsd && Number.isFinite(costUsd) && costUsd > 0\n\t\t\t? Math.round(costUsd * 1_000_000)\n\t\t\t: 0;\n\n\treturn {\n\t\tworkspaceId: cleanRequiredString(input.workspaceId, \"workspaceId\"),\n\t\tagentId: cleanRequiredString(input.agentId, \"agentId\"),\n\t\tsessionId: cleanOptionalString(input.sessionId),\n\t\tprovider: cleanRequiredString(input.provider, \"provider\"),\n\t\tmodel: cleanRequiredString(input.model, \"model\"),\n\t\tbucketStart: startOfDay(occurredAt),\n\t\toccurredAt,\n\t\tcallCount: 1,\n\t\tinputTokens,\n\t\toutputTokens,\n\t\tcacheReadTokens,\n\t\tcacheWriteTokens,\n\t\ttotalTokens,\n\t\tcostUsdMicros,\n\t};\n}\n\nexport function emptyUsageTotals(): UsageAnalyticsTotals {\n\treturn {\n\t\tcalls: 0,\n\t\ttokens: {\n\t\t\tinput: 0,\n\t\t\toutput: 0,\n\t\t\tcacheRead: 0,\n\t\t\tcacheWrite: 0,\n\t\t\ttotal: 0,\n\t\t},\n\t\tcostUsd: 0,\n\t};\n}\n\nexport function summarizeUsageBuckets(\n\tbuckets: UsageAnalyticsBucket[],\n): UsageAnalyticsTotals {\n\tconst totals = emptyUsageTotals();\n\tfor (const bucket of buckets) {\n\t\ttotals.calls += bucket.calls;\n\t\ttotals.tokens.input += bucket.tokens.input;\n\t\ttotals.tokens.output += bucket.tokens.output;\n\t\ttotals.tokens.cacheRead += bucket.tokens.cacheRead;\n\t\ttotals.tokens.cacheWrite += bucket.tokens.cacheWrite;\n\t\ttotals.tokens.total += bucket.tokens.total;\n\t\ttotals.costUsd += bucket.costUsd;\n\t}\n\treturn totals;\n}\n\nexport function createUsageAnalyticsReport(params: {\n\tperiod: UsageAnalyticsPeriod;\n\tfilters: UsageAnalyticsReport[\"filters\"];\n\tbuckets: UsageAnalyticsBucket[];\n}): UsageAnalyticsReport {\n\treturn {\n\t\tperiod: params.period,\n\t\tfilters: params.filters,\n\t\ttotals: summarizeUsageBuckets(params.buckets),\n\t\tbuckets: params.buckets,\n\t};\n}\n"]}

package/dist/services/usage-analytics/index.d.ts

@@ -0,0 +1,5 @@
+export { UsageAnalyticsValidationError, bucketStartForPeriod, createUsageAnalyticsReport, emptyUsageTotals, isUsageAnalyticsPeriod, normalizeUsageMetricInput, parseOptionalDate, parseUsageAnalyticsPeriod, startOfDay, summarizeUsageBuckets, } from "./aggregation.js";
+export { recordAssistantUsageMetric, resetUsageAnalyticsRecorderForTest, resolveUsageAgentId, resolveUsageWorkspaceId, } from "./recorder.js";
+export { UsageAnalyticsService, UsageAnalyticsUnavailableError, getUsageAnalyticsService, setUsageAnalyticsServiceForTest, } from "./service.js";
+export type { NormalizedUsageMetric, UsageAnalyticsBucket, UsageAnalyticsPeriod, UsageAnalyticsQuery, UsageAnalyticsRecordResult, UsageAnalyticsReport, UsageAnalyticsTotals, UsageMetricInput, UsageTokenTotals, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/usage-analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/usage-analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,UAAU,EACV,qBAAqB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,0BAA0B,EAC1B,kCAAkC,EAClC,mBAAmB,EACnB,uBAAuB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,qBAAqB,EACrB,8BAA8B,EAC9B,wBAAwB,EACxB,+BAA+B,GAC/B,MAAM,cAAc,CAAC;AACtB,YAAY,EACX,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,YAAY,CAAC"}

package/dist/services/usage-analytics/index.js

@@ -0,0 +1,4 @@
+export { UsageAnalyticsValidationError, bucketStartForPeriod, createUsageAnalyticsReport, emptyUsageTotals, isUsageAnalyticsPeriod, normalizeUsageMetricInput, parseOptionalDate, parseUsageAnalyticsPeriod, startOfDay, summarizeUsageBuckets, } from "./aggregation.js";
+export { recordAssistantUsageMetric, resetUsageAnalyticsRecorderForTest, resolveUsageAgentId, resolveUsageWorkspaceId, } from "./recorder.js";
+export { UsageAnalyticsService, UsageAnalyticsUnavailableError, getUsageAnalyticsService, setUsageAnalyticsServiceForTest, } from "./service.js";
+//# sourceMappingURL=index.js.map

package/dist/services/usage-analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/usage-analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,UAAU,EACV,qBAAqB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,0BAA0B,EAC1B,kCAAkC,EAClC,mBAAmB,EACnB,uBAAuB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,qBAAqB,EACrB,8BAA8B,EAC9B,wBAAwB,EACxB,+BAA+B,GAC/B,MAAM,cAAc,CAAC","sourcesContent":["export {\n\tUsageAnalyticsValidationError,\n\tbucketStartForPeriod,\n\tcreateUsageAnalyticsReport,\n\temptyUsageTotals,\n\tisUsageAnalyticsPeriod,\n\tnormalizeUsageMetricInput,\n\tparseOptionalDate,\n\tparseUsageAnalyticsPeriod,\n\tstartOfDay,\n\tsummarizeUsageBuckets,\n} from \"./aggregation.js\";\nexport {\n\trecordAssistantUsageMetric,\n\tresetUsageAnalyticsRecorderForTest,\n\tresolveUsageAgentId,\n\tresolveUsageWorkspaceId,\n} from \"./recorder.js\";\nexport {\n\tUsageAnalyticsService,\n\tUsageAnalyticsUnavailableError,\n\tgetUsageAnalyticsService,\n\tsetUsageAnalyticsServiceForTest,\n} from \"./service.js\";\nexport type {\n\tNormalizedUsageMetric,\n\tUsageAnalyticsBucket,\n\tUsageAnalyticsPeriod,\n\tUsageAnalyticsQuery,\n\tUsageAnalyticsRecordResult,\n\tUsageAnalyticsReport,\n\tUsageAnalyticsTotals,\n\tUsageMetricInput,\n\tUsageTokenTotals,\n} from \"./types.js\";\n"]}

package/dist/services/usage-analytics/recorder.d.ts

@@ -0,0 +1,16 @@
+import type { IncomingMessage } from "node:http";
+import type { AssistantMessage } from "../../agent/types.js";
+export declare function resolveUsageWorkspaceId(req: IncomingMessage): string;
+export declare function resolveUsageAgentId(params: {
+    req: IncomingMessage;
+    sessionId?: string;
+    subject?: string;
+}): string;
+export declare function recordAssistantUsageMetric(params: {
+    req: IncomingMessage;
+    message: AssistantMessage;
+    sessionId?: string;
+    subject?: string;
+}): void;
+export declare function resetUsageAnalyticsRecorderForTest(): void;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/services/usage-analytics/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../../src/services/usage-analytics/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA0E7D,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CASpE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC3C,GAAG,EAAE,eAAe,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAOT;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IAClD,GAAG,EAAE,eAAe,CAAC;IACrB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAuDP;AAED,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}