@evalops/maestro 0.10.8 → 0.10.11

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

@@ -0,0 +1,20 @@
+import { type ExecutionTrace, type ExecutionTraceInput, type ExecutionTraceSpan, type TraceListQuery, type TraceStatus } from "./types.js";
+export declare class TracesValidationError extends Error {
+    constructor(message: string);
+}
+export declare function normalizeTraceSpanName(value: unknown): string;
+export declare function generateTraceId(): string;
+export declare function generateSpanId(): string;
+export declare function parseTraceStatus(value: unknown): TraceStatus;
+export declare function countTraceSpans(spans: ExecutionTraceSpan[]): number;
+export declare function normalizeExecutionTraceInput(input: ExecutionTraceInput): ExecutionTrace;
+export declare function parseTraceLimit(value: string | null | undefined): number;
+export declare function parseTraceOffset(value: string | null | undefined): number;
+export declare function normalizeTraceListQuery(params: {
+    workspaceId?: string;
+    agentId?: string;
+    status?: string;
+    limit?: string | null;
+    offset?: string | null;
+}): TraceListQuery;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/services/traces/normalize.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAIvB,KAAK,cAAc,EAGnB,KAAK,WAAW,EAChB,MAAM,YAAY,CAAC;AAMpB,qBAAa,qBAAsB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI3B;AAiBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAS7D;AAQD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAS5D;AAsKD,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,MAAM,CASnE;AAED,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,mBAAmB,GACxB,cAAc,CAsBhB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAOxE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAOzE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GAAG,cAAc,CAYjB"}

package/dist/services/traces/normalize.js

@@ -0,0 +1,261 @@
+import { randomBytes } from "node:crypto";
+import { TRACE_SPAN_STATUSES, TRACE_STATUSES, } from "./types.js";
+const MAX_TRACE_ID_LENGTH = 64;
+const DEFAULT_TRACE_LIST_LIMIT = 50;
+const MAX_TRACE_LIST_LIMIT = 100;
+export class TracesValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TracesValidationError";
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cleanRequiredString(value, label) {
+    if (typeof value !== "string") {
+        throw new TracesValidationError(`${label} is required.`);
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new TracesValidationError(`${label} is required.`);
+    }
+    return trimmed;
+}
+export function normalizeTraceSpanName(value) {
+    const normalized = cleanRequiredString(value, "span.name")
+        .replace(/[\\/\s]+/gu, ".")
+        .replace(/\.+/gu, ".")
+        .replace(/^\.+|\.+$/gu, "");
+    if (!normalized) {
+        throw new TracesValidationError("span.name is required.");
+    }
+    return normalized;
+}
+function cleanOptionalString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+export function generateTraceId() {
+    return randomBytes(16).toString("hex");
+}
+export function generateSpanId() {
+    return randomBytes(8).toString("hex");
+}
+export function parseTraceStatus(value) {
+    const normalized = typeof value === "string" ? value.trim().toLowerCase() : "completed";
+    if (TRACE_STATUSES.includes(normalized)) {
+        return normalized;
+    }
+    throw new TracesValidationError("Invalid trace status. Use running, completed, failed, or timeout.");
+}
+function parseTraceSpanStatus(value, hasError) {
+    const normalized = typeof value === "string"
+        ? value.trim().toLowerCase()
+        : hasError
+            ? "error"
+            : "ok";
+    if (TRACE_SPAN_STATUSES.includes(normalized)) {
+        return normalized;
+    }
+    throw new TracesValidationError("Invalid span status. Use unset, ok, or error.");
+}
+function normalizeTraceId(value) {
+    const traceId = cleanOptionalString(value) ?? generateTraceId();
+    if (traceId.length > MAX_TRACE_ID_LENGTH) {
+        throw new TracesValidationError(`traceId must be ${MAX_TRACE_ID_LENGTH} characters or fewer.`);
+    }
+    return traceId;
+}
+function parseDate(value, label) {
+    if (value === undefined)
+        return undefined;
+    if (value === null) {
+        throw new TracesValidationError(`${label} must be a valid date.`);
+    }
+    const parsed = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(parsed.getTime())) {
+        throw new TracesValidationError(`${label} must be a valid date.`);
+    }
+    return parsed;
+}
+function normalizeNonNegativeInteger(value, label) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new TracesValidationError(`${label} must be a finite number.`);
+    }
+    if (value < 0) {
+        throw new TracesValidationError(`${label} must be non-negative.`);
+    }
+    return Math.floor(value);
+}
+function sanitizeJsonValue(value, depth = 0) {
+    if (depth > 12)
+        return String(value);
+    if (value === null)
+        return null;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? value : undefined;
+    }
+    if (Array.isArray(value)) {
+        return value
+            .map((item) => sanitizeJsonValue(item, depth + 1))
+            .filter((item) => item !== undefined);
+    }
+    if (isRecord(value)) {
+        const result = {};
+        for (const [key, nestedValue] of Object.entries(value)) {
+            const sanitized = sanitizeJsonValue(nestedValue, depth + 1);
+            if (sanitized !== undefined) {
+                result[key] = sanitized;
+            }
+        }
+        return result;
+    }
+    return undefined;
+}
+function normalizeAttributes(value) {
+    if (!value)
+        return {};
+    const attributes = {};
+    for (const [key, attributeValue] of Object.entries(value)) {
+        const sanitized = sanitizeJsonValue(attributeValue);
+        if (sanitized !== undefined) {
+            attributes[key] = sanitized;
+        }
+    }
+    return attributes;
+}
+function inferDurationMs(startTime, endTime) {
+    if (!startTime || !endTime)
+        return undefined;
+    const duration = endTime.getTime() - startTime.getTime();
+    return duration >= 0 ? duration : undefined;
+}
+function normalizeSpan(input, parentSpanId) {
+    if (!isRecord(input)) {
+        throw new TracesValidationError("Each span must be an object.");
+    }
+    const error = cleanOptionalString(input.error);
+    const spanId = cleanOptionalString(input.spanId) ?? generateSpanId();
+    const startTime = parseDate(input.startTime, "span.startTime");
+    const endTime = parseDate(input.endTime, "span.endTime");
+    const durationMs = normalizeNonNegativeInteger(input.durationMs, "span.durationMs") ??
+        inferDurationMs(startTime, endTime);
+    const children = Array.isArray(input.children)
+        ? input.children.map((child) => normalizeSpan(child, spanId))
+        : undefined;
+    const normalized = {
+        spanId,
+        name: normalizeTraceSpanName(input.name),
+        kind: cleanOptionalString(input.kind) ?? "internal",
+        status: parseTraceSpanStatus(input.status, Boolean(error)),
+        attributes: normalizeAttributes(input.attributes),
+    };
+    const resolvedParentSpanId = cleanOptionalString(input.parentSpanId) ?? parentSpanId;
+    if (resolvedParentSpanId)
+        normalized.parentSpanId = resolvedParentSpanId;
+    if (startTime)
+        normalized.startTime = startTime.toISOString();
+    if (endTime)
+        normalized.endTime = endTime.toISOString();
+    if (durationMs !== undefined)
+        normalized.durationMs = durationMs;
+    if (input.input !== undefined) {
+        const sanitizedInput = sanitizeJsonValue(input.input);
+        if (sanitizedInput !== undefined)
+            normalized.input = sanitizedInput;
+    }
+    if (input.output !== undefined) {
+        const sanitizedOutput = sanitizeJsonValue(input.output);
+        if (sanitizedOutput !== undefined)
+            normalized.output = sanitizedOutput;
+    }
+    if (error)
+        normalized.error = error;
+    if (children && children.length > 0)
+        normalized.children = children;
+    return normalized;
+}
+function maxSpanDurationMs(spans) {
+    let max = 0;
+    for (const span of spans) {
+        if (typeof span.durationMs === "number" && span.durationMs > max) {
+            max = span.durationMs;
+        }
+        if (span.children) {
+            max = Math.max(max, maxSpanDurationMs(span.children));
+        }
+    }
+    return max;
+}
+export function countTraceSpans(spans) {
+    let count = 0;
+    for (const span of spans) {
+        count += 1;
+        if (span.children) {
+            count += countTraceSpans(span.children);
+        }
+    }
+    return count;
+}
+export function normalizeExecutionTraceInput(input) {
+    if (!isRecord(input)) {
+        throw new TracesValidationError("Trace payload must be an object.");
+    }
+    if (!Array.isArray(input.spans)) {
+        throw new TracesValidationError("spans must be an array.");
+    }
+    const spans = input.spans.map((span) => normalizeSpan(span));
+    const createdAt = parseDate(input.createdAt, "createdAt") ?? new Date();
+    const durationMs = normalizeNonNegativeInteger(input.durationMs, "durationMs") ??
+        maxSpanDurationMs(spans);
+    return {
+        traceId: normalizeTraceId(input.traceId),
+        workspaceId: cleanRequiredString(input.workspaceId, "workspaceId"),
+        agentId: cleanRequiredString(input.agentId, "agentId"),
+        spans,
+        durationMs,
+        status: parseTraceStatus(input.status),
+        createdAt: createdAt.toISOString(),
+    };
+}
+export function parseTraceLimit(value) {
+    if (!value)
+        return DEFAULT_TRACE_LIST_LIMIT;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new TracesValidationError("limit must be a positive integer.");
+    }
+    return Math.min(parsed, MAX_TRACE_LIST_LIMIT);
+}
+export function parseTraceOffset(value) {
+    if (!value)
+        return 0;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0) {
+        throw new TracesValidationError("offset must be a non-negative integer.");
+    }
+    return parsed;
+}
+export function normalizeTraceListQuery(params) {
+    return {
+        ...(params.workspaceId
+            ? { workspaceId: cleanRequiredString(params.workspaceId, "workspaceId") }
+            : {}),
+        ...(params.agentId
+            ? { agentId: cleanRequiredString(params.agentId, "agentId") }
+            : {}),
+        ...(params.status ? { status: parseTraceStatus(params.status) } : {}),
+        limit: parseTraceLimit(params.limit),
+        offset: parseTraceOffset(params.offset),
+    };
+}
+//# sourceMappingURL=normalize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/services/traces/normalize.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomBytes } from \"node:crypto\";\nimport {\n\ttype ExecutionTrace,\n\ttype ExecutionTraceInput,\n\ttype ExecutionTraceSpan,\n\tTRACE_SPAN_STATUSES,\n\tTRACE_STATUSES,\n\ttype TraceJsonValue,\n\ttype TraceListQuery,\n\ttype TraceSpanInput,\n\ttype TraceSpanStatus,\n\ttype TraceStatus,\n} from \"./types.js\";\n\nconst MAX_TRACE_ID_LENGTH = 64;\nconst DEFAULT_TRACE_LIST_LIMIT = 50;\nconst MAX_TRACE_LIST_LIMIT = 100;\n\nexport class TracesValidationError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"TracesValidationError\";\n\t}\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction cleanRequiredString(value: unknown, label: string): string {\n\tif (typeof value !== \"string\") {\n\t\tthrow new TracesValidationError(`${label} is required.`);\n\t}\n\tconst trimmed = value.trim();\n\tif (!trimmed) {\n\t\tthrow new TracesValidationError(`${label} is required.`);\n\t}\n\treturn trimmed;\n}\n\nexport function normalizeTraceSpanName(value: unknown): string {\n\tconst normalized = cleanRequiredString(value, \"span.name\")\n\t\t.replace(/[\\\\/\\s]+/gu, \".\")\n\t\t.replace(/\\.+/gu, \".\")\n\t\t.replace(/^\\.+|\\.+$/gu, \"\");\n\tif (!normalized) {\n\t\tthrow new TracesValidationError(\"span.name is required.\");\n\t}\n\treturn normalized;\n}\n\nfunction cleanOptionalString(value: unknown): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tconst trimmed = value.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nexport function generateTraceId(): string {\n\treturn randomBytes(16).toString(\"hex\");\n}\n\nexport function generateSpanId(): string {\n\treturn randomBytes(8).toString(\"hex\");\n}\n\nexport function parseTraceStatus(value: unknown): TraceStatus {\n\tconst normalized =\n\t\ttypeof value === \"string\" ? value.trim().toLowerCase() : \"completed\";\n\tif (TRACE_STATUSES.includes(normalized as TraceStatus)) {\n\t\treturn normalized as TraceStatus;\n\t}\n\tthrow new TracesValidationError(\n\t\t\"Invalid trace status. Use running, completed, failed, or timeout.\",\n\t);\n}\n\nfunction parseTraceSpanStatus(\n\tvalue: unknown,\n\thasError: boolean,\n): TraceSpanStatus {\n\tconst normalized =\n\t\ttypeof value === \"string\"\n\t\t\t? value.trim().toLowerCase()\n\t\t\t: hasError\n\t\t\t\t? \"error\"\n\t\t\t\t: \"ok\";\n\tif (TRACE_SPAN_STATUSES.includes(normalized as TraceSpanStatus)) {\n\t\treturn normalized as TraceSpanStatus;\n\t}\n\tthrow new TracesValidationError(\n\t\t\"Invalid span status. Use unset, ok, or error.\",\n\t);\n}\n\nfunction normalizeTraceId(value: unknown): string {\n\tconst traceId = cleanOptionalString(value) ?? generateTraceId();\n\tif (traceId.length > MAX_TRACE_ID_LENGTH) {\n\t\tthrow new TracesValidationError(\n\t\t\t`traceId must be ${MAX_TRACE_ID_LENGTH} characters or fewer.`,\n\t\t);\n\t}\n\treturn traceId;\n}\n\nfunction parseDate(\n\tvalue: Date | string | null | undefined,\n\tlabel: string,\n): Date | undefined {\n\tif (value === undefined) return undefined;\n\tif (value === null) {\n\t\tthrow new TracesValidationError(`${label} must be a valid date.`);\n\t}\n\tconst parsed = value instanceof Date ? value : new Date(value);\n\tif (Number.isNaN(parsed.getTime())) {\n\t\tthrow new TracesValidationError(`${label} must be a valid date.`);\n\t}\n\treturn parsed;\n}\n\nfunction normalizeNonNegativeInteger(\n\tvalue: unknown,\n\tlabel: string,\n): number | undefined {\n\tif (value === undefined || value === null) return undefined;\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\tthrow new TracesValidationError(`${label} must be a finite number.`);\n\t}\n\tif (value < 0) {\n\t\tthrow new TracesValidationError(`${label} must be non-negative.`);\n\t}\n\treturn Math.floor(value);\n}\n\nfunction sanitizeJsonValue(\n\tvalue: unknown,\n\tdepth = 0,\n): TraceJsonValue | undefined {\n\tif (depth > 12) return String(value);\n\tif (value === null) return null;\n\tif (value instanceof Date) return value.toISOString();\n\tif (typeof value === \"string\" || typeof value === \"boolean\") return value;\n\tif (typeof value === \"number\") {\n\t\treturn Number.isFinite(value) ? value : undefined;\n\t}\n\tif (Array.isArray(value)) {\n\t\treturn value\n\t\t\t.map((item) => sanitizeJsonValue(item, depth + 1))\n\t\t\t.filter((item): item is TraceJsonValue => item !== undefined);\n\t}\n\tif (isRecord(value)) {\n\t\tconst result: Record<string, TraceJsonValue> = {};\n\t\tfor (const [key, nestedValue] of Object.entries(value)) {\n\t\t\tconst sanitized = sanitizeJsonValue(nestedValue, depth + 1);\n\t\t\tif (sanitized !== undefined) {\n\t\t\t\tresult[key] = sanitized;\n\t\t\t}\n\t\t}\n\t\treturn result;\n\t}\n\treturn undefined;\n}\n\nfunction normalizeAttributes(\n\tvalue: Record<string, unknown> | undefined,\n): Record<string, TraceJsonValue> {\n\tif (!value) return {};\n\tconst attributes: Record<string, TraceJsonValue> = {};\n\tfor (const [key, attributeValue] of Object.entries(value)) {\n\t\tconst sanitized = sanitizeJsonValue(attributeValue);\n\t\tif (sanitized !== undefined) {\n\t\t\tattributes[key] = sanitized;\n\t\t}\n\t}\n\treturn attributes;\n}\n\nfunction inferDurationMs(startTime?: Date, endTime?: Date): number | undefined {\n\tif (!startTime || !endTime) return undefined;\n\tconst duration = endTime.getTime() - startTime.getTime();\n\treturn duration >= 0 ? duration : undefined;\n}\n\nfunction normalizeSpan(\n\tinput: TraceSpanInput,\n\tparentSpanId?: string,\n): ExecutionTraceSpan {\n\tif (!isRecord(input)) {\n\t\tthrow new TracesValidationError(\"Each span must be an object.\");\n\t}\n\tconst error = cleanOptionalString(input.error);\n\tconst spanId = cleanOptionalString(input.spanId) ?? generateSpanId();\n\tconst startTime = parseDate(input.startTime, \"span.startTime\");\n\tconst endTime = parseDate(input.endTime, \"span.endTime\");\n\tconst durationMs =\n\t\tnormalizeNonNegativeInteger(input.durationMs, \"span.durationMs\") ??\n\t\tinferDurationMs(startTime, endTime);\n\n\tconst children = Array.isArray(input.children)\n\t\t? input.children.map((child) => normalizeSpan(child, spanId))\n\t\t: undefined;\n\n\tconst normalized: ExecutionTraceSpan = {\n\t\tspanId,\n\t\tname: normalizeTraceSpanName(input.name),\n\t\tkind: cleanOptionalString(input.kind) ?? \"internal\",\n\t\tstatus: parseTraceSpanStatus(input.status, Boolean(error)),\n\t\tattributes: normalizeAttributes(input.attributes),\n\t};\n\tconst resolvedParentSpanId =\n\t\tcleanOptionalString(input.parentSpanId) ?? parentSpanId;\n\tif (resolvedParentSpanId) normalized.parentSpanId = resolvedParentSpanId;\n\tif (startTime) normalized.startTime = startTime.toISOString();\n\tif (endTime) normalized.endTime = endTime.toISOString();\n\tif (durationMs !== undefined) normalized.durationMs = durationMs;\n\tif (input.input !== undefined) {\n\t\tconst sanitizedInput = sanitizeJsonValue(input.input);\n\t\tif (sanitizedInput !== undefined) normalized.input = sanitizedInput;\n\t}\n\tif (input.output !== undefined) {\n\t\tconst sanitizedOutput = sanitizeJsonValue(input.output);\n\t\tif (sanitizedOutput !== undefined) normalized.output = sanitizedOutput;\n\t}\n\tif (error) normalized.error = error;\n\tif (children && children.length > 0) normalized.children = children;\n\treturn normalized;\n}\n\nfunction maxSpanDurationMs(spans: ExecutionTraceSpan[]): number {\n\tlet max = 0;\n\tfor (const span of spans) {\n\t\tif (typeof span.durationMs === \"number\" && span.durationMs > max) {\n\t\t\tmax = span.durationMs;\n\t\t}\n\t\tif (span.children) {\n\t\t\tmax = Math.max(max, maxSpanDurationMs(span.children));\n\t\t}\n\t}\n\treturn max;\n}\n\nexport function countTraceSpans(spans: ExecutionTraceSpan[]): number {\n\tlet count = 0;\n\tfor (const span of spans) {\n\t\tcount += 1;\n\t\tif (span.children) {\n\t\t\tcount += countTraceSpans(span.children);\n\t\t}\n\t}\n\treturn count;\n}\n\nexport function normalizeExecutionTraceInput(\n\tinput: ExecutionTraceInput,\n): ExecutionTrace {\n\tif (!isRecord(input)) {\n\t\tthrow new TracesValidationError(\"Trace payload must be an object.\");\n\t}\n\tif (!Array.isArray(input.spans)) {\n\t\tthrow new TracesValidationError(\"spans must be an array.\");\n\t}\n\tconst spans = input.spans.map((span) => normalizeSpan(span));\n\tconst createdAt = parseDate(input.createdAt, \"createdAt\") ?? new Date();\n\tconst durationMs =\n\t\tnormalizeNonNegativeInteger(input.durationMs, \"durationMs\") ??\n\t\tmaxSpanDurationMs(spans);\n\n\treturn {\n\t\ttraceId: normalizeTraceId(input.traceId),\n\t\tworkspaceId: cleanRequiredString(input.workspaceId, \"workspaceId\"),\n\t\tagentId: cleanRequiredString(input.agentId, \"agentId\"),\n\t\tspans,\n\t\tdurationMs,\n\t\tstatus: parseTraceStatus(input.status),\n\t\tcreatedAt: createdAt.toISOString(),\n\t};\n}\n\nexport function parseTraceLimit(value: string | null | undefined): number {\n\tif (!value) return DEFAULT_TRACE_LIST_LIMIT;\n\tconst parsed = Number(value);\n\tif (!Number.isInteger(parsed) || parsed < 1) {\n\t\tthrow new TracesValidationError(\"limit must be a positive integer.\");\n\t}\n\treturn Math.min(parsed, MAX_TRACE_LIST_LIMIT);\n}\n\nexport function parseTraceOffset(value: string | null | undefined): number {\n\tif (!value) return 0;\n\tconst parsed = Number(value);\n\tif (!Number.isInteger(parsed) || parsed < 0) {\n\t\tthrow new TracesValidationError(\"offset must be a non-negative integer.\");\n\t}\n\treturn parsed;\n}\n\nexport function normalizeTraceListQuery(params: {\n\tworkspaceId?: string;\n\tagentId?: string;\n\tstatus?: string;\n\tlimit?: string | null;\n\toffset?: string | null;\n}): TraceListQuery {\n\treturn {\n\t\t...(params.workspaceId\n\t\t\t? { workspaceId: cleanRequiredString(params.workspaceId, \"workspaceId\") }\n\t\t\t: {}),\n\t\t...(params.agentId\n\t\t\t? { agentId: cleanRequiredString(params.agentId, \"agentId\") }\n\t\t\t: {}),\n\t\t...(params.status ? { status: parseTraceStatus(params.status) } : {}),\n\t\tlimit: parseTraceLimit(params.limit),\n\t\toffset: parseTraceOffset(params.offset),\n\t};\n}\n"]}

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

@@ -0,0 +1,3 @@
+import type { ExecutionTrace, OpenTelemetryTraceExport } from "./types.js";
+export declare function exportTraceToOpenTelemetry(trace: ExecutionTrace): OpenTelemetryTraceExport;
+//# sourceMappingURL=otel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../../src/services/traces/otel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,cAAc,EAKd,wBAAwB,EAExB,MAAM,YAAY,CAAC;AAoKpB,wBAAgB,0BAA0B,CACzC,KAAK,EAAE,cAAc,GACnB,wBAAwB,CA0B1B"}

package/dist/services/traces/otel.js

@@ -0,0 +1,173 @@
+import { createHash } from "node:crypto";
+import { normalizeTraceSpanName } from "./normalize.js";
+const OTEL_SCOPE_NAME = "maestro.traces";
+const OTEL_SCOPE_VERSION = "1.0.0";
+function hashHex(value, length) {
+    return createHash("sha256").update(value).digest("hex").slice(0, length);
+}
+function toOtelTraceId(traceId) {
+    const normalized = traceId.trim().toLowerCase();
+    if (/^[0-9a-f]{32}$/.test(normalized))
+        return normalized;
+    return hashHex(traceId, 32);
+}
+function toOtelSpanId(spanId) {
+    const normalized = spanId.trim().toLowerCase();
+    if (/^[0-9a-f]{16}$/.test(normalized))
+        return normalized;
+    return hashHex(spanId, 16);
+}
+function unixNanoFromIso(value) {
+    const millis = Date.parse(value);
+    if (Number.isNaN(millis))
+        return "0";
+    return (BigInt(millis) * 1000000n).toString();
+}
+function addDurationToIso(startTime, durationMs) {
+    const millis = Date.parse(startTime);
+    if (Number.isNaN(millis))
+        return startTime;
+    return new Date(millis + durationMs).toISOString();
+}
+function spanStartTime(trace, span) {
+    return span.startTime ?? trace.createdAt;
+}
+function spanEndTime(trace, span) {
+    if (span.endTime)
+        return span.endTime;
+    if (span.durationMs !== undefined) {
+        return addDurationToIso(spanStartTime(trace, span), span.durationMs);
+    }
+    return spanStartTime(trace, span);
+}
+function toOtelAnyValue(value) {
+    if (typeof value === "string")
+        return { stringValue: value };
+    if (typeof value === "boolean")
+        return { boolValue: value };
+    if (typeof value === "number") {
+        if (Number.isInteger(value))
+            return { intValue: String(value) };
+        return { doubleValue: value };
+    }
+    if (value === null)
+        return { stringValue: "null" };
+    if (Array.isArray(value)) {
+        return { arrayValue: { values: value.map(toOtelAnyValue) } };
+    }
+    return {
+        kvlistValue: {
+            values: Object.entries(value).map(([key, nestedValue]) => ({
+                key,
+                value: toOtelAnyValue(nestedValue),
+            })),
+        },
+    };
+}
+function attribute(key, value) {
+    return {
+        key,
+        value: toOtelAnyValue(value),
+    };
+}
+function spanKind(kind) {
+    switch (kind) {
+        case "llm_inference":
+        case "tool_call":
+            return "SPAN_KIND_CLIENT";
+        case "delegation":
+            return "SPAN_KIND_PRODUCER";
+        default:
+            return "SPAN_KIND_INTERNAL";
+    }
+}
+function statusCode(status) {
+    if (status === "ok")
+        return "STATUS_CODE_OK";
+    if (status === "error")
+        return "STATUS_CODE_ERROR";
+    return "STATUS_CODE_UNSET";
+}
+function spanEvents(trace, span) {
+    const events = [];
+    const timeUnixNano = unixNanoFromIso(spanStartTime(trace, span));
+    if (span.input !== undefined) {
+        events.push({
+            name: "input",
+            timeUnixNano,
+            attributes: [attribute("payload", JSON.stringify(span.input))],
+        });
+    }
+    if (span.output !== undefined) {
+        events.push({
+            name: "output",
+            timeUnixNano: unixNanoFromIso(spanEndTime(trace, span)),
+            attributes: [attribute("payload", JSON.stringify(span.output))],
+        });
+    }
+    return events.length > 0 ? events : undefined;
+}
+function flattenSpans(spans) {
+    const flattened = [];
+    for (const span of spans) {
+        flattened.push(span);
+        if (span.children) {
+            flattened.push(...flattenSpans(span.children));
+        }
+    }
+    return flattened;
+}
+function toOtelSpan(trace, span) {
+    const attributes = [
+        attribute("maestro.span_kind", span.kind),
+        attribute("maestro.trace_status", trace.status),
+        attribute("maestro.duration_ms", span.durationMs ?? 0),
+        ...Object.entries(span.attributes).map(([key, value]) => attribute(key, value)),
+    ];
+    const otelSpan = {
+        traceId: toOtelTraceId(trace.traceId),
+        spanId: toOtelSpanId(span.spanId),
+        name: normalizeTraceSpanName(span.name),
+        kind: spanKind(span.kind),
+        startTimeUnixNano: unixNanoFromIso(spanStartTime(trace, span)),
+        endTimeUnixNano: unixNanoFromIso(spanEndTime(trace, span)),
+        attributes,
+        status: {
+            code: statusCode(span.status),
+            ...(span.error ? { message: span.error } : {}),
+        },
+    };
+    if (span.parentSpanId) {
+        otelSpan.parentSpanId = toOtelSpanId(span.parentSpanId);
+    }
+    const events = spanEvents(trace, span);
+    if (events)
+        otelSpan.events = events;
+    return otelSpan;
+}
+export function exportTraceToOpenTelemetry(trace) {
+    return {
+        resourceSpans: [
+            {
+                resource: {
+                    attributes: [
+                        attribute("service.name", "maestro"),
+                        attribute("maestro.workspace_id", trace.workspaceId),
+                        attribute("maestro.agent_id", trace.agentId),
+                        attribute("maestro.trace_id", trace.traceId),
+                    ],
+                },
+                scopeSpans: [
+                    {
+                        scope: {
+                            name: OTEL_SCOPE_NAME,
+                            version: OTEL_SCOPE_VERSION,
+                        },
+                        spans: flattenSpans(trace.spans).map((span) => toOtelSpan(trace, span)),
+                    },
+                ],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=otel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../../../src/services/traces/otel.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { normalizeTraceSpanName } from \"./normalize.js\";\nimport type {\n\tExecutionTrace,\n\tExecutionTraceSpan,\n\tOpenTelemetryAnyValue,\n\tOpenTelemetryKeyValue,\n\tOpenTelemetrySpan,\n\tOpenTelemetryTraceExport,\n\tTraceJsonValue,\n} from \"./types.js\";\n\nconst OTEL_SCOPE_NAME = \"maestro.traces\";\nconst OTEL_SCOPE_VERSION = \"1.0.0\";\n\nfunction hashHex(value: string, length: number): string {\n\treturn createHash(\"sha256\").update(value).digest(\"hex\").slice(0, length);\n}\n\nfunction toOtelTraceId(traceId: string): string {\n\tconst normalized = traceId.trim().toLowerCase();\n\tif (/^[0-9a-f]{32}$/.test(normalized)) return normalized;\n\treturn hashHex(traceId, 32);\n}\n\nfunction toOtelSpanId(spanId: string): string {\n\tconst normalized = spanId.trim().toLowerCase();\n\tif (/^[0-9a-f]{16}$/.test(normalized)) return normalized;\n\treturn hashHex(spanId, 16);\n}\n\nfunction unixNanoFromIso(value: string): string {\n\tconst millis = Date.parse(value);\n\tif (Number.isNaN(millis)) return \"0\";\n\treturn (BigInt(millis) * 1_000_000n).toString();\n}\n\nfunction addDurationToIso(startTime: string, durationMs: number): string {\n\tconst millis = Date.parse(startTime);\n\tif (Number.isNaN(millis)) return startTime;\n\treturn new Date(millis + durationMs).toISOString();\n}\n\nfunction spanStartTime(\n\ttrace: ExecutionTrace,\n\tspan: ExecutionTraceSpan,\n): string {\n\treturn span.startTime ?? trace.createdAt;\n}\n\nfunction spanEndTime(trace: ExecutionTrace, span: ExecutionTraceSpan): string {\n\tif (span.endTime) return span.endTime;\n\tif (span.durationMs !== undefined) {\n\t\treturn addDurationToIso(spanStartTime(trace, span), span.durationMs);\n\t}\n\treturn spanStartTime(trace, span);\n}\n\nfunction toOtelAnyValue(value: TraceJsonValue): OpenTelemetryAnyValue {\n\tif (typeof value === \"string\") return { stringValue: value };\n\tif (typeof value === \"boolean\") return { boolValue: value };\n\tif (typeof value === \"number\") {\n\t\tif (Number.isInteger(value)) return { intValue: String(value) };\n\t\treturn { doubleValue: value };\n\t}\n\tif (value === null) return { stringValue: \"null\" };\n\tif (Array.isArray(value)) {\n\t\treturn { arrayValue: { values: value.map(toOtelAnyValue) } };\n\t}\n\treturn {\n\t\tkvlistValue: {\n\t\t\tvalues: Object.entries(value).map(([key, nestedValue]) => ({\n\t\t\t\tkey,\n\t\t\t\tvalue: toOtelAnyValue(nestedValue),\n\t\t\t})),\n\t\t},\n\t};\n}\n\nfunction attribute(key: string, value: TraceJsonValue): OpenTelemetryKeyValue {\n\treturn {\n\t\tkey,\n\t\tvalue: toOtelAnyValue(value),\n\t};\n}\n\nfunction spanKind(kind: string): string {\n\tswitch (kind) {\n\t\tcase \"llm_inference\":\n\t\tcase \"tool_call\":\n\t\t\treturn \"SPAN_KIND_CLIENT\";\n\t\tcase \"delegation\":\n\t\t\treturn \"SPAN_KIND_PRODUCER\";\n\t\tdefault:\n\t\t\treturn \"SPAN_KIND_INTERNAL\";\n\t}\n}\n\nfunction statusCode(\n\tstatus: ExecutionTraceSpan[\"status\"],\n): OpenTelemetrySpan[\"status\"][\"code\"] {\n\tif (status === \"ok\") return \"STATUS_CODE_OK\";\n\tif (status === \"error\") return \"STATUS_CODE_ERROR\";\n\treturn \"STATUS_CODE_UNSET\";\n}\n\nfunction spanEvents(\n\ttrace: ExecutionTrace,\n\tspan: ExecutionTraceSpan,\n): OpenTelemetrySpan[\"events\"] {\n\tconst events: OpenTelemetrySpan[\"events\"] = [];\n\tconst timeUnixNano = unixNanoFromIso(spanStartTime(trace, span));\n\tif (span.input !== undefined) {\n\t\tevents.push({\n\t\t\tname: \"input\",\n\t\t\ttimeUnixNano,\n\t\t\tattributes: [attribute(\"payload\", JSON.stringify(span.input))],\n\t\t});\n\t}\n\tif (span.output !== undefined) {\n\t\tevents.push({\n\t\t\tname: \"output\",\n\t\t\ttimeUnixNano: unixNanoFromIso(spanEndTime(trace, span)),\n\t\t\tattributes: [attribute(\"payload\", JSON.stringify(span.output))],\n\t\t});\n\t}\n\treturn events.length > 0 ? events : undefined;\n}\n\nfunction flattenSpans(spans: ExecutionTraceSpan[]): ExecutionTraceSpan[] {\n\tconst flattened: ExecutionTraceSpan[] = [];\n\tfor (const span of spans) {\n\t\tflattened.push(span);\n\t\tif (span.children) {\n\t\t\tflattened.push(...flattenSpans(span.children));\n\t\t}\n\t}\n\treturn flattened;\n}\n\nfunction toOtelSpan(\n\ttrace: ExecutionTrace,\n\tspan: ExecutionTraceSpan,\n): OpenTelemetrySpan {\n\tconst attributes = [\n\t\tattribute(\"maestro.span_kind\", span.kind),\n\t\tattribute(\"maestro.trace_status\", trace.status),\n\t\tattribute(\"maestro.duration_ms\", span.durationMs ?? 0),\n\t\t...Object.entries(span.attributes).map(([key, value]) =>\n\t\t\tattribute(key, value),\n\t\t),\n\t];\n\n\tconst otelSpan: OpenTelemetrySpan = {\n\t\ttraceId: toOtelTraceId(trace.traceId),\n\t\tspanId: toOtelSpanId(span.spanId),\n\t\tname: normalizeTraceSpanName(span.name),\n\t\tkind: spanKind(span.kind),\n\t\tstartTimeUnixNano: unixNanoFromIso(spanStartTime(trace, span)),\n\t\tendTimeUnixNano: unixNanoFromIso(spanEndTime(trace, span)),\n\t\tattributes,\n\t\tstatus: {\n\t\t\tcode: statusCode(span.status),\n\t\t\t...(span.error ? { message: span.error } : {}),\n\t\t},\n\t};\n\tif (span.parentSpanId) {\n\t\totelSpan.parentSpanId = toOtelSpanId(span.parentSpanId);\n\t}\n\tconst events = spanEvents(trace, span);\n\tif (events) otelSpan.events = events;\n\treturn otelSpan;\n}\n\nexport function exportTraceToOpenTelemetry(\n\ttrace: ExecutionTrace,\n): OpenTelemetryTraceExport {\n\treturn {\n\t\tresourceSpans: [\n\t\t\t{\n\t\t\t\tresource: {\n\t\t\t\t\tattributes: [\n\t\t\t\t\t\tattribute(\"service.name\", \"maestro\"),\n\t\t\t\t\t\tattribute(\"maestro.workspace_id\", trace.workspaceId),\n\t\t\t\t\t\tattribute(\"maestro.agent_id\", trace.agentId),\n\t\t\t\t\t\tattribute(\"maestro.trace_id\", trace.traceId),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tscopeSpans: [\n\t\t\t\t\t{\n\t\t\t\t\t\tscope: {\n\t\t\t\t\t\t\tname: OTEL_SCOPE_NAME,\n\t\t\t\t\t\t\tversion: OTEL_SCOPE_VERSION,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tspans: flattenSpans(trace.spans).map((span) =>\n\t\t\t\t\t\t\ttoOtelSpan(trace, span),\n\t\t\t\t\t\t),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t};\n}\n"]}

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

@@ -0,0 +1,17 @@
+import { type DbClient } from "../../db/client.js";
+import type { ExecutionTrace, ExecutionTraceInput, ExecutionTraceSummary, TraceListQuery, TraceListResult } from "./types.js";
+export declare class TracesUnavailableError extends Error {
+    constructor();
+}
+export declare class TracesService {
+    private readonly getDatabase;
+    private readonly databaseConfigured;
+    constructor(getDatabase?: () => DbClient, databaseConfigured?: () => boolean);
+    recordTrace(input: ExecutionTraceInput): Promise<ExecutionTrace>;
+    getTrace(traceId: string): Promise<ExecutionTrace | null>;
+    listTraces(query: TraceListQuery): Promise<TraceListResult>;
+    summarizeTrace(trace: ExecutionTrace): ExecutionTraceSummary;
+}
+export declare function getTracesService(): TracesService;
+export declare function setTracesServiceForTest(service: TracesService | null): void;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/traces/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAA+B,MAAM,oBAAoB,CAAC;AAQhF,OAAO,KAAK,EACX,cAAc,EACd,mBAAmB,EAEnB,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,MAAM,YAAY,CAAC;AAMpB,qBAAa,sBAAuB,SAAQ,KAAK;;CAKhD;AAsED,qBAAa,aAAa;IAExB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBADlB,WAAW,GAAE,MAAM,QAAgB,EACnC,kBAAkB,GAAE,MAAM,OAA8B;IAGpE,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8ChE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAiBzD,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAuCjE,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,qBAAqB;CAW5D;AAID,wBAAgB,gBAAgB,IAAI,aAAa,CAGhD;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAE3E"}