@evalops/maestro 0.10.8 → 0.10.11

package/dist/services/revenue-attribution/normalize.js

@@ -0,0 +1,155 @@
+import { ATTRIBUTION_MODELS, } from "./types.js";
+export class RevenueAttributionValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RevenueAttributionValidationError";
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cleanOptionalString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}
+function cleanRequiredString(value, label) {
+    const trimmed = cleanOptionalString(value);
+    if (!trimmed) {
+        throw new RevenueAttributionValidationError(`${label} is required.`);
+    }
+    return trimmed;
+}
+function parseDate(value, label) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const parsed = value instanceof Date ? value : new Date(String(value));
+    if (Number.isNaN(parsed.getTime())) {
+        throw new RevenueAttributionValidationError(`${label} must be a valid date.`);
+    }
+    return parsed;
+}
+function parseNumber(value, label) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const parsed = typeof value === "number" ? value : Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new RevenueAttributionValidationError(`${label} must be a number.`);
+    }
+    return parsed;
+}
+function nonNegativeNumber(value, label) {
+    const parsed = parseNumber(value, label) ?? 0;
+    if (parsed < 0) {
+        throw new RevenueAttributionValidationError(`${label} cannot be negative.`);
+    }
+    return parsed;
+}
+function toUsdMicros(value, label) {
+    return Math.round(nonNegativeNumber(value, label) * 1_000_000);
+}
+function parseDurationMs(value) {
+    return Math.floor(nonNegativeNumber(value, "durationMs"));
+}
+function parseAttributionModel(value) {
+    const normalized = cleanOptionalString(value)?.toLowerCase() ?? "direct";
+    if (ATTRIBUTION_MODELS.includes(normalized)) {
+        return normalized;
+    }
+    throw new RevenueAttributionValidationError("Invalid attributionModel. Use direct, assisted, influenced, or custom.");
+}
+function parseAttributionWeightBps(input) {
+    const explicitBps = parseNumber(input.attributionWeightBps, "attributionWeightBps");
+    if (explicitBps !== undefined) {
+        if (explicitBps < 0 || explicitBps > 10000) {
+            throw new RevenueAttributionValidationError("attributionWeightBps must be between 0 and 10000.");
+        }
+        return Math.round(explicitBps);
+    }
+    const weight = parseNumber(input.attributionWeight, "attributionWeight");
+    if (weight === undefined)
+        return 10000;
+    if (weight < 0 || weight > 1) {
+        throw new RevenueAttributionValidationError("attributionWeight must be between 0 and 1.");
+    }
+    return Math.round(weight * 10000);
+}
+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 sanitizeMetadata(value) {
+    if (!value)
+        return {};
+    const sanitized = sanitizeJsonValue(value);
+    return isRecord(sanitized)
+        ? sanitized
+        : {};
+}
+export function normalizeRevenueOutcomeInput(input) {
+    if (!isRecord(input)) {
+        throw new RevenueAttributionValidationError("Outcome must be an object.");
+    }
+    const outcomeInput = input;
+    const actionId = cleanOptionalString(outcomeInput.actionId);
+    const traceId = cleanOptionalString(outcomeInput.traceId);
+    return {
+        workspaceId: cleanRequiredString(outcomeInput.workspaceId, "workspaceId"),
+        agentId: cleanRequiredString(outcomeInput.agentId, "agentId"),
+        outcomeId: cleanRequiredString(outcomeInput.outcomeId, "outcomeId"),
+        outcomeType: cleanRequiredString(outcomeInput.outcomeType, "outcomeType").toLowerCase(),
+        attributionModel: parseAttributionModel(outcomeInput.attributionModel),
+        attributionWeightBps: parseAttributionWeightBps(outcomeInput),
+        revenueUsdMicros: toUsdMicros(outcomeInput.revenueUsd, "revenueUsd"),
+        pipelineValueUsdMicros: toUsdMicros(outcomeInput.pipelineValueUsd, "pipelineValueUsd"),
+        costUsdMicros: toUsdMicros(outcomeInput.costUsd, "costUsd"),
+        durationMs: parseDurationMs(outcomeInput.durationMs),
+        occurredAt: parseDate(outcomeInput.occurredAt, "occurredAt") ?? new Date(),
+        metadata: sanitizeMetadata(outcomeInput.metadata),
+        ...(actionId ? { actionId } : {}),
+        ...(traceId ? { traceId } : {}),
+    };
+}
+export function normalizeRevenueAttributionRoiQuery(input) {
+    const from = parseDate(input.from, "from");
+    const to = parseDate(input.to, "to");
+    if (from && to && from.getTime() > to.getTime()) {
+        throw new RevenueAttributionValidationError("from must be before or equal to to.");
+    }
+    const workspaceId = cleanOptionalString(input.workspaceId);
+    return {
+        agentId: cleanRequiredString(input.agentId, "agentId"),
+        ...(workspaceId ? { workspaceId } : {}),
+        ...(from ? { from } : {}),
+        ...(to ? { to } : {}),
+    };
+}
+export function usdFromMicros(micros) {
+    return micros / 1_000_000;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/services/revenue-attribution/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/services/revenue-attribution/normalize.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tATTRIBUTION_MODELS,\n\ttype AttributionJsonValue,\n\ttype AttributionModel,\n\ttype NormalizedRevenueOutcome,\n\ttype RevenueAttributionRoiQuery,\n\ttype RevenueOutcomeInput,\n} from \"./types.js\";\n\nexport class RevenueAttributionValidationError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"RevenueAttributionValidationError\";\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 cleanOptionalString(value: unknown): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tconst trimmed = value.trim();\n\treturn trimmed ? trimmed : undefined;\n}\n\nfunction cleanRequiredString(value: unknown, label: string): string {\n\tconst trimmed = cleanOptionalString(value);\n\tif (!trimmed) {\n\t\tthrow new RevenueAttributionValidationError(`${label} is required.`);\n\t}\n\treturn trimmed;\n}\n\nfunction parseDate(value: unknown, label: string): Date | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tconst parsed = value instanceof Date ? value : new Date(String(value));\n\tif (Number.isNaN(parsed.getTime())) {\n\t\tthrow new RevenueAttributionValidationError(\n\t\t\t`${label} must be a valid date.`,\n\t\t);\n\t}\n\treturn parsed;\n}\n\nfunction parseNumber(value: unknown, label: string): number | undefined {\n\tif (value === undefined || value === null || value === \"\") return undefined;\n\tconst parsed = typeof value === \"number\" ? value : Number(value);\n\tif (!Number.isFinite(parsed)) {\n\t\tthrow new RevenueAttributionValidationError(`${label} must be a number.`);\n\t}\n\treturn parsed;\n}\n\nfunction nonNegativeNumber(value: unknown, label: string): number {\n\tconst parsed = parseNumber(value, label) ?? 0;\n\tif (parsed < 0) {\n\t\tthrow new RevenueAttributionValidationError(`${label} cannot be negative.`);\n\t}\n\treturn parsed;\n}\n\nfunction toUsdMicros(value: unknown, label: string): number {\n\treturn Math.round(nonNegativeNumber(value, label) * 1_000_000);\n}\n\nfunction parseDurationMs(value: unknown): number {\n\treturn Math.floor(nonNegativeNumber(value, \"durationMs\"));\n}\n\nfunction parseAttributionModel(value: unknown): AttributionModel {\n\tconst normalized = cleanOptionalString(value)?.toLowerCase() ?? \"direct\";\n\tif (ATTRIBUTION_MODELS.includes(normalized as AttributionModel)) {\n\t\treturn normalized as AttributionModel;\n\t}\n\tthrow new RevenueAttributionValidationError(\n\t\t\"Invalid attributionModel. Use direct, assisted, influenced, or custom.\",\n\t);\n}\n\nfunction parseAttributionWeightBps(input: RevenueOutcomeInput): number {\n\tconst explicitBps = parseNumber(\n\t\tinput.attributionWeightBps,\n\t\t\"attributionWeightBps\",\n\t);\n\tif (explicitBps !== undefined) {\n\t\tif (explicitBps < 0 || explicitBps > 10000) {\n\t\t\tthrow new RevenueAttributionValidationError(\n\t\t\t\t\"attributionWeightBps must be between 0 and 10000.\",\n\t\t\t);\n\t\t}\n\t\treturn Math.round(explicitBps);\n\t}\n\tconst weight = parseNumber(input.attributionWeight, \"attributionWeight\");\n\tif (weight === undefined) return 10000;\n\tif (weight < 0 || weight > 1) {\n\t\tthrow new RevenueAttributionValidationError(\n\t\t\t\"attributionWeight must be between 0 and 1.\",\n\t\t);\n\t}\n\treturn Math.round(weight * 10000);\n}\n\nfunction sanitizeJsonValue(\n\tvalue: unknown,\n\tdepth = 0,\n): AttributionJsonValue | 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\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 AttributionJsonValue => item !== undefined);\n\t}\n\tif (isRecord(value)) {\n\t\tconst result: Record<string, AttributionJsonValue> = {};\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 sanitizeMetadata(\n\tvalue: Record<string, unknown> | undefined,\n): Record<string, AttributionJsonValue> {\n\tif (!value) return {};\n\tconst sanitized = sanitizeJsonValue(value);\n\treturn isRecord(sanitized)\n\t\t? (sanitized as Record<string, AttributionJsonValue>)\n\t\t: {};\n}\n\nexport function normalizeRevenueOutcomeInput(\n\tinput: RevenueOutcomeInput,\n): NormalizedRevenueOutcome {\n\tif (!isRecord(input)) {\n\t\tthrow new RevenueAttributionValidationError(\"Outcome must be an object.\");\n\t}\n\tconst outcomeInput = input as RevenueOutcomeInput;\n\tconst actionId = cleanOptionalString(outcomeInput.actionId);\n\tconst traceId = cleanOptionalString(outcomeInput.traceId);\n\treturn {\n\t\tworkspaceId: cleanRequiredString(outcomeInput.workspaceId, \"workspaceId\"),\n\t\tagentId: cleanRequiredString(outcomeInput.agentId, \"agentId\"),\n\t\toutcomeId: cleanRequiredString(outcomeInput.outcomeId, \"outcomeId\"),\n\t\toutcomeType: cleanRequiredString(\n\t\t\toutcomeInput.outcomeType,\n\t\t\t\"outcomeType\",\n\t\t).toLowerCase(),\n\t\tattributionModel: parseAttributionModel(outcomeInput.attributionModel),\n\t\tattributionWeightBps: parseAttributionWeightBps(outcomeInput),\n\t\trevenueUsdMicros: toUsdMicros(outcomeInput.revenueUsd, \"revenueUsd\"),\n\t\tpipelineValueUsdMicros: toUsdMicros(\n\t\t\toutcomeInput.pipelineValueUsd,\n\t\t\t\"pipelineValueUsd\",\n\t\t),\n\t\tcostUsdMicros: toUsdMicros(outcomeInput.costUsd, \"costUsd\"),\n\t\tdurationMs: parseDurationMs(outcomeInput.durationMs),\n\t\toccurredAt: parseDate(outcomeInput.occurredAt, \"occurredAt\") ?? new Date(),\n\t\tmetadata: sanitizeMetadata(outcomeInput.metadata),\n\t\t...(actionId ? { actionId } : {}),\n\t\t...(traceId ? { traceId } : {}),\n\t};\n}\n\nexport function normalizeRevenueAttributionRoiQuery(input: {\n\tagentId?: unknown;\n\tworkspaceId?: unknown;\n\tfrom?: unknown;\n\tto?: unknown;\n}): RevenueAttributionRoiQuery {\n\tconst from = parseDate(input.from, \"from\");\n\tconst to = parseDate(input.to, \"to\");\n\tif (from && to && from.getTime() > to.getTime()) {\n\t\tthrow new RevenueAttributionValidationError(\n\t\t\t\"from must be before or equal to to.\",\n\t\t);\n\t}\n\tconst workspaceId = cleanOptionalString(input.workspaceId);\n\treturn {\n\t\tagentId: cleanRequiredString(input.agentId, \"agentId\"),\n\t\t...(workspaceId ? { workspaceId } : {}),\n\t\t...(from ? { from } : {}),\n\t\t...(to ? { to } : {}),\n\t};\n}\n\nexport function usdFromMicros(micros: number): number {\n\treturn micros / 1_000_000;\n}\n"]}

package/dist/services/revenue-attribution/service.d.ts

@@ -0,0 +1,21 @@
+import { type DbClient } from "../../db/client.js";
+import type { RevenueAttributionRecord, RevenueAttributionRoiQuery, RevenueAttributionRoiReport, RevenueOutcomeInput } from "./types.js";
+export declare class RevenueAttributionUnavailableError extends Error {
+    constructor();
+}
+export declare function createRevenueAttributionRoiReport(params: {
+    query: RevenueAttributionRoiQuery;
+    totalsRow?: Record<string, unknown>;
+    outcomeRows?: Array<Record<string, unknown>>;
+}): RevenueAttributionRoiReport;
+export declare class RevenueAttributionService {
+    private readonly getDatabase;
+    private readonly databaseConfigured;
+    constructor(getDatabase?: () => DbClient, databaseConfigured?: () => boolean);
+    private requireDatabase;
+    recordOutcome(input: RevenueOutcomeInput): Promise<RevenueAttributionRecord>;
+    queryRoi(input: RevenueAttributionRoiQuery): Promise<RevenueAttributionRoiReport>;
+}
+export declare function getRevenueAttributionService(): RevenueAttributionService;
+export declare function setRevenueAttributionServiceForTest(service: RevenueAttributionService | null): void;
+//# sourceMappingURL=service.d.ts.map

package/dist/services/revenue-attribution/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/revenue-attribution/service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAA+B,MAAM,oBAAoB,CAAC;AAQhF,OAAO,KAAK,EAGX,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAMpB,qBAAa,kCAAmC,SAAQ,KAAK;;CAK5D;AA4FD,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACzD,KAAK,EAAE,0BAA0B,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7C,GAAG,2BAA2B,CA2C9B;AAED,qBAAa,yBAAyB;IAEpC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBADlB,WAAW,GAAE,MAAM,QAAgB,EACnC,kBAAkB,GAAE,MAAM,OAA8B;IAG1E,OAAO,CAAC,eAAe;IAOjB,aAAa,CAClB,KAAK,EAAE,mBAAmB,GACxB,OAAO,CAAC,wBAAwB,CAAC;IA4D9B,QAAQ,CACb,KAAK,EAAE,0BAA0B,GAC/B,OAAO,CAAC,2BAA2B,CAAC;CA2CvC;AAID,wBAAgB,4BAA4B,IAAI,yBAAyB,CAGxE;AAED,wBAAgB,mCAAmC,CAClD,OAAO,EAAE,yBAAyB,GAAG,IAAI,GACvC,IAAI,CAEN"}

package/dist/services/revenue-attribution/service.js

@@ -0,0 +1,248 @@
+import { randomUUID } from "node:crypto";
+import { sql } from "drizzle-orm";
+import { getDb, isDatabaseConfigured } from "../../db/client.js";
+import { revenueAttribution } from "../../db/schema.js";
+import { createLogger } from "../../utils/logger.js";
+import { normalizeRevenueAttributionRoiQuery, normalizeRevenueOutcomeInput, usdFromMicros, } from "./normalize.js";
+const logger = createLogger("revenue-attribution");
+export class RevenueAttributionUnavailableError extends Error {
+    constructor() {
+        super("Revenue attribution database is not configured.");
+        this.name = "RevenueAttributionUnavailableError";
+    }
+}
+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 dateIso(value) {
+    return value instanceof Date
+        ? value.toISOString()
+        : new Date(value).toISOString();
+}
+function parseAttributionModel(value) {
+    if (value === "direct" ||
+        value === "assisted" ||
+        value === "influenced" ||
+        value === "custom") {
+        return value;
+    }
+    return "custom";
+}
+function recordFromRow(row) {
+    return {
+        id: row.id,
+        workspaceId: row.workspaceId,
+        agentId: row.agentId,
+        outcomeId: row.outcomeId,
+        outcomeType: row.outcomeType,
+        attributionModel: parseAttributionModel(row.attributionModel),
+        attributionWeightBps: row.attributionWeightBps,
+        revenueUsd: usdFromMicros(row.revenueUsdMicros),
+        pipelineValueUsd: usdFromMicros(row.pipelineValueUsdMicros),
+        costUsd: usdFromMicros(row.costUsdMicros),
+        durationMs: row.durationMs,
+        occurredAt: dateIso(row.occurredAt),
+        createdAt: dateIso(row.createdAt),
+        updatedAt: dateIso(row.updatedAt),
+        metadata: row.metadata &&
+            typeof row.metadata === "object" &&
+            !Array.isArray(row.metadata)
+            ? row.metadata
+            : {},
+        ...(row.actionId ? { actionId: row.actionId } : {}),
+        ...(row.traceId ? { traceId: row.traceId } : {}),
+    };
+}
+function buildFilters(query) {
+    const filters = [sql `agent_id = ${query.agentId}`];
+    if (query.workspaceId) {
+        filters.push(sql `workspace_id = ${query.workspaceId}`);
+    }
+    if (query.from) {
+        filters.push(sql `occurred_at >= ${query.from}`);
+    }
+    if (query.to) {
+        filters.push(sql `occurred_at <= ${query.to}`);
+    }
+    return filters;
+}
+function periodForReport(query) {
+    return {
+        ...(query.from ? { from: query.from.toISOString() } : {}),
+        ...(query.to ? { to: query.to.toISOString() } : {}),
+    };
+}
+function roiValue(revenueUsd, costUsd) {
+    return costUsd > 0 ? revenueUsd / costUsd : null;
+}
+function costPerOutcome(costUsd, outcomeCount) {
+    return outcomeCount > 0 ? costUsd / outcomeCount : null;
+}
+export function createRevenueAttributionRoiReport(params) {
+    const totals = params.totalsRow ?? {};
+    const revenueUsd = usdFromMicros(readNumber(totals, "revenue_usd_micros"));
+    const pipelineValueUsd = usdFromMicros(readNumber(totals, "pipeline_value_usd_micros"));
+    const costUsd = usdFromMicros(readNumber(totals, "cost_usd_micros"));
+    const outcomeCount = readNumber(totals, "outcome_count");
+    const byOutcomeType = (params.outcomeRows ?? []).map((row) => ({
+        outcomeType: readString(row, "outcome_type"),
+        outcomeCount: readNumber(row, "outcome_count"),
+        revenueUsd: usdFromMicros(readNumber(row, "revenue_usd_micros")),
+        pipelineValueUsd: usdFromMicros(readNumber(row, "pipeline_value_usd_micros")),
+        costUsd: usdFromMicros(readNumber(row, "cost_usd_micros")),
+    }));
+    return {
+        agentId: params.query.agentId,
+        period: periodForReport(params.query),
+        attribution: {
+            outcomeCount,
+            actionCount: readNumber(totals, "action_count"),
+            traceCount: readNumber(totals, "trace_count"),
+            revenueUsd,
+            pipelineValueUsd,
+        },
+        cost: {
+            costUsd,
+            totalDurationMs: readNumber(totals, "duration_ms"),
+        },
+        roi: {
+            revenuePerDollarSpent: roiValue(revenueUsd, costUsd),
+            netRevenueUsd: revenueUsd - costUsd,
+            costPerOutcome: costPerOutcome(costUsd, outcomeCount),
+        },
+        byOutcomeType,
+        ...(params.query.workspaceId
+            ? { workspaceId: params.query.workspaceId }
+            : {}),
+    };
+}
+export class RevenueAttributionService {
+    constructor(getDatabase = getDb, databaseConfigured = isDatabaseConfigured) {
+        this.getDatabase = getDatabase;
+        this.databaseConfigured = databaseConfigured;
+    }
+    requireDatabase() {
+        if (!this.databaseConfigured()) {
+            throw new RevenueAttributionUnavailableError();
+        }
+        return this.getDatabase();
+    }
+    async recordOutcome(input) {
+        const outcome = normalizeRevenueOutcomeInput(input);
+        const db = this.requireDatabase();
+        const now = new Date();
+        try {
+            const [row] = await db
+                .insert(revenueAttribution)
+                .values({
+                workspaceId: outcome.workspaceId,
+                agentId: outcome.agentId,
+                actionId: outcome.actionId,
+                traceId: outcome.traceId,
+                outcomeId: outcome.outcomeId,
+                outcomeType: outcome.outcomeType,
+                attributionModel: outcome.attributionModel,
+                attributionWeightBps: outcome.attributionWeightBps,
+                revenueUsdMicros: outcome.revenueUsdMicros,
+                pipelineValueUsdMicros: outcome.pipelineValueUsdMicros,
+                costUsdMicros: outcome.costUsdMicros,
+                durationMs: outcome.durationMs,
+                metadata: outcome.metadata,
+                occurredAt: outcome.occurredAt,
+                createdAt: now,
+                updatedAt: now,
+            })
+                .returning();
+            return row
+                ? recordFromRow(row)
+                : {
+                    id: randomUUID(),
+                    workspaceId: outcome.workspaceId,
+                    agentId: outcome.agentId,
+                    outcomeId: outcome.outcomeId,
+                    outcomeType: outcome.outcomeType,
+                    attributionModel: outcome.attributionModel,
+                    attributionWeightBps: outcome.attributionWeightBps,
+                    revenueUsd: usdFromMicros(outcome.revenueUsdMicros),
+                    pipelineValueUsd: usdFromMicros(outcome.pipelineValueUsdMicros),
+                    costUsd: usdFromMicros(outcome.costUsdMicros),
+                    durationMs: outcome.durationMs,
+                    occurredAt: outcome.occurredAt.toISOString(),
+                    createdAt: now.toISOString(),
+                    updatedAt: now.toISOString(),
+                    metadata: outcome.metadata,
+                    ...(outcome.actionId ? { actionId: outcome.actionId } : {}),
+                    ...(outcome.traceId ? { traceId: outcome.traceId } : {}),
+                };
+        }
+        catch (error) {
+            logger.warn("Failed to record revenue attribution outcome", {
+                error: error instanceof Error ? error.message : String(error),
+                workspaceId: outcome.workspaceId,
+                agentId: outcome.agentId,
+                outcomeId: outcome.outcomeId,
+            });
+            throw error;
+        }
+    }
+    async queryRoi(input) {
+        const query = normalizeRevenueAttributionRoiQuery(input);
+        const db = this.requireDatabase();
+        const filters = buildFilters(query);
+        const where = sql `WHERE ${sql.join(filters, sql ` AND `)}`;
+        const totalsResult = await db.execute(sql `
+			SELECT
+				COUNT(*) AS outcome_count,
+				COUNT(DISTINCT action_id) FILTER (WHERE action_id IS NOT NULL) AS action_count,
+				COUNT(DISTINCT trace_id) FILTER (WHERE trace_id IS NOT NULL) AS trace_count,
+				COALESCE(SUM((revenue_usd_micros * attribution_weight_bps) / 10000), 0) AS revenue_usd_micros,
+				COALESCE(SUM((pipeline_value_usd_micros * attribution_weight_bps) / 10000), 0) AS pipeline_value_usd_micros,
+				COALESCE(SUM(cost_usd_micros), 0) AS cost_usd_micros,
+				COALESCE(SUM(duration_ms), 0) AS duration_ms
+			FROM revenue_attribution
+			${where}
+		`);
+        const outcomeResult = await db.execute(sql `
+			SELECT
+				outcome_type,
+				COUNT(*) AS outcome_count,
+				COALESCE(SUM((revenue_usd_micros * attribution_weight_bps) / 10000), 0) AS revenue_usd_micros,
+				COALESCE(SUM((pipeline_value_usd_micros * attribution_weight_bps) / 10000), 0) AS pipeline_value_usd_micros,
+				COALESCE(SUM(cost_usd_micros), 0) AS cost_usd_micros
+			FROM revenue_attribution
+			${where}
+			GROUP BY outcome_type
+			ORDER BY revenue_usd_micros DESC, outcome_type ASC
+		`);
+        const [totalsRow] = Array.from(totalsResult);
+        const outcomeRows = Array.from(outcomeResult);
+        return createRevenueAttributionRoiReport({
+            query,
+            totalsRow,
+            outcomeRows,
+        });
+    }
+}
+let defaultRevenueAttributionService = null;
+export function getRevenueAttributionService() {
+    defaultRevenueAttributionService ??= new RevenueAttributionService();
+    return defaultRevenueAttributionService;
+}
+export function setRevenueAttributionServiceForTest(service) {
+    defaultRevenueAttributionService = service;
+}
+//# sourceMappingURL=service.js.map

package/dist/services/revenue-attribution/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/services/revenue-attribution/service.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { type SQL, sql } from \"drizzle-orm\";\nimport { type DbClient, getDb, isDatabaseConfigured } from \"../../db/client.js\";\nimport { revenueAttribution } from \"../../db/schema.js\";\nimport { createLogger } from \"../../utils/logger.js\";\nimport {\n\tnormalizeRevenueAttributionRoiQuery,\n\tnormalizeRevenueOutcomeInput,\n\tusdFromMicros,\n} from \"./normalize.js\";\nimport type {\n\tAttributionModel,\n\tRevenueAttributionOutcomeSummary,\n\tRevenueAttributionRecord,\n\tRevenueAttributionRoiQuery,\n\tRevenueAttributionRoiReport,\n\tRevenueOutcomeInput,\n} from \"./types.js\";\n\nconst logger = createLogger(\"revenue-attribution\");\n\ntype RevenueAttributionRow = typeof revenueAttribution.$inferSelect;\n\nexport class RevenueAttributionUnavailableError extends Error {\n\tconstructor() {\n\t\tsuper(\"Revenue attribution database is not configured.\");\n\t\tthis.name = \"RevenueAttributionUnavailableError\";\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 dateIso(value: Date | string): string {\n\treturn value instanceof Date\n\t\t? value.toISOString()\n\t\t: new Date(value).toISOString();\n}\n\nfunction parseAttributionModel(value: string): AttributionModel {\n\tif (\n\t\tvalue === \"direct\" ||\n\t\tvalue === \"assisted\" ||\n\t\tvalue === \"influenced\" ||\n\t\tvalue === \"custom\"\n\t) {\n\t\treturn value;\n\t}\n\treturn \"custom\";\n}\n\nfunction recordFromRow(row: RevenueAttributionRow): RevenueAttributionRecord {\n\treturn {\n\t\tid: row.id,\n\t\tworkspaceId: row.workspaceId,\n\t\tagentId: row.agentId,\n\t\toutcomeId: row.outcomeId,\n\t\toutcomeType: row.outcomeType,\n\t\tattributionModel: parseAttributionModel(row.attributionModel),\n\t\tattributionWeightBps: row.attributionWeightBps,\n\t\trevenueUsd: usdFromMicros(row.revenueUsdMicros),\n\t\tpipelineValueUsd: usdFromMicros(row.pipelineValueUsdMicros),\n\t\tcostUsd: usdFromMicros(row.costUsdMicros),\n\t\tdurationMs: row.durationMs,\n\t\toccurredAt: dateIso(row.occurredAt),\n\t\tcreatedAt: dateIso(row.createdAt),\n\t\tupdatedAt: dateIso(row.updatedAt),\n\t\tmetadata:\n\t\t\trow.metadata &&\n\t\t\ttypeof row.metadata === \"object\" &&\n\t\t\t!Array.isArray(row.metadata)\n\t\t\t\t? (row.metadata as RevenueAttributionRecord[\"metadata\"])\n\t\t\t\t: {},\n\t\t...(row.actionId ? { actionId: row.actionId } : {}),\n\t\t...(row.traceId ? { traceId: row.traceId } : {}),\n\t};\n}\n\nfunction buildFilters(query: RevenueAttributionRoiQuery): SQL[] {\n\tconst filters: SQL[] = [sql`agent_id = ${query.agentId}`];\n\tif (query.workspaceId) {\n\t\tfilters.push(sql`workspace_id = ${query.workspaceId}`);\n\t}\n\tif (query.from) {\n\t\tfilters.push(sql`occurred_at >= ${query.from}`);\n\t}\n\tif (query.to) {\n\t\tfilters.push(sql`occurred_at <= ${query.to}`);\n\t}\n\treturn filters;\n}\n\nfunction periodForReport(query: RevenueAttributionRoiQuery) {\n\treturn {\n\t\t...(query.from ? { from: query.from.toISOString() } : {}),\n\t\t...(query.to ? { to: query.to.toISOString() } : {}),\n\t};\n}\n\nfunction roiValue(revenueUsd: number, costUsd: number): number | null {\n\treturn costUsd > 0 ? revenueUsd / costUsd : null;\n}\n\nfunction costPerOutcome(costUsd: number, outcomeCount: number): number | null {\n\treturn outcomeCount > 0 ? costUsd / outcomeCount : null;\n}\n\nexport function createRevenueAttributionRoiReport(params: {\n\tquery: RevenueAttributionRoiQuery;\n\ttotalsRow?: Record<string, unknown>;\n\toutcomeRows?: Array<Record<string, unknown>>;\n}): RevenueAttributionRoiReport {\n\tconst totals = params.totalsRow ?? {};\n\tconst revenueUsd = usdFromMicros(readNumber(totals, \"revenue_usd_micros\"));\n\tconst pipelineValueUsd = usdFromMicros(\n\t\treadNumber(totals, \"pipeline_value_usd_micros\"),\n\t);\n\tconst costUsd = usdFromMicros(readNumber(totals, \"cost_usd_micros\"));\n\tconst outcomeCount = readNumber(totals, \"outcome_count\");\n\tconst byOutcomeType: RevenueAttributionOutcomeSummary[] = (\n\t\tparams.outcomeRows ?? []\n\t).map((row) => ({\n\t\toutcomeType: readString(row, \"outcome_type\"),\n\t\toutcomeCount: readNumber(row, \"outcome_count\"),\n\t\trevenueUsd: usdFromMicros(readNumber(row, \"revenue_usd_micros\")),\n\t\tpipelineValueUsd: usdFromMicros(\n\t\t\treadNumber(row, \"pipeline_value_usd_micros\"),\n\t\t),\n\t\tcostUsd: usdFromMicros(readNumber(row, \"cost_usd_micros\")),\n\t}));\n\treturn {\n\t\tagentId: params.query.agentId,\n\t\tperiod: periodForReport(params.query),\n\t\tattribution: {\n\t\t\toutcomeCount,\n\t\t\tactionCount: readNumber(totals, \"action_count\"),\n\t\t\ttraceCount: readNumber(totals, \"trace_count\"),\n\t\t\trevenueUsd,\n\t\t\tpipelineValueUsd,\n\t\t},\n\t\tcost: {\n\t\t\tcostUsd,\n\t\t\ttotalDurationMs: readNumber(totals, \"duration_ms\"),\n\t\t},\n\t\troi: {\n\t\t\trevenuePerDollarSpent: roiValue(revenueUsd, costUsd),\n\t\t\tnetRevenueUsd: revenueUsd - costUsd,\n\t\t\tcostPerOutcome: costPerOutcome(costUsd, outcomeCount),\n\t\t},\n\t\tbyOutcomeType,\n\t\t...(params.query.workspaceId\n\t\t\t? { workspaceId: params.query.workspaceId }\n\t\t\t: {}),\n\t};\n}\n\nexport class RevenueAttributionService {\n\tconstructor(\n\t\tprivate readonly getDatabase: () => DbClient = getDb,\n\t\tprivate readonly databaseConfigured: () => boolean = isDatabaseConfigured,\n\t) {}\n\n\tprivate requireDatabase(): DbClient {\n\t\tif (!this.databaseConfigured()) {\n\t\t\tthrow new RevenueAttributionUnavailableError();\n\t\t}\n\t\treturn this.getDatabase();\n\t}\n\n\tasync recordOutcome(\n\t\tinput: RevenueOutcomeInput,\n\t): Promise<RevenueAttributionRecord> {\n\t\tconst outcome = normalizeRevenueOutcomeInput(input);\n\t\tconst db = this.requireDatabase();\n\t\tconst now = new Date();\n\n\t\ttry {\n\t\t\tconst [row] = await db\n\t\t\t\t.insert(revenueAttribution)\n\t\t\t\t.values({\n\t\t\t\t\tworkspaceId: outcome.workspaceId,\n\t\t\t\t\tagentId: outcome.agentId,\n\t\t\t\t\tactionId: outcome.actionId,\n\t\t\t\t\ttraceId: outcome.traceId,\n\t\t\t\t\toutcomeId: outcome.outcomeId,\n\t\t\t\t\toutcomeType: outcome.outcomeType,\n\t\t\t\t\tattributionModel: outcome.attributionModel,\n\t\t\t\t\tattributionWeightBps: outcome.attributionWeightBps,\n\t\t\t\t\trevenueUsdMicros: outcome.revenueUsdMicros,\n\t\t\t\t\tpipelineValueUsdMicros: outcome.pipelineValueUsdMicros,\n\t\t\t\t\tcostUsdMicros: outcome.costUsdMicros,\n\t\t\t\t\tdurationMs: outcome.durationMs,\n\t\t\t\t\tmetadata: outcome.metadata,\n\t\t\t\t\toccurredAt: outcome.occurredAt,\n\t\t\t\t\tcreatedAt: now,\n\t\t\t\t\tupdatedAt: now,\n\t\t\t\t})\n\t\t\t\t.returning();\n\n\t\t\treturn row\n\t\t\t\t? recordFromRow(row)\n\t\t\t\t: {\n\t\t\t\t\t\tid: randomUUID(),\n\t\t\t\t\t\tworkspaceId: outcome.workspaceId,\n\t\t\t\t\t\tagentId: outcome.agentId,\n\t\t\t\t\t\toutcomeId: outcome.outcomeId,\n\t\t\t\t\t\toutcomeType: outcome.outcomeType,\n\t\t\t\t\t\tattributionModel: outcome.attributionModel,\n\t\t\t\t\t\tattributionWeightBps: outcome.attributionWeightBps,\n\t\t\t\t\t\trevenueUsd: usdFromMicros(outcome.revenueUsdMicros),\n\t\t\t\t\t\tpipelineValueUsd: usdFromMicros(outcome.pipelineValueUsdMicros),\n\t\t\t\t\t\tcostUsd: usdFromMicros(outcome.costUsdMicros),\n\t\t\t\t\t\tdurationMs: outcome.durationMs,\n\t\t\t\t\t\toccurredAt: outcome.occurredAt.toISOString(),\n\t\t\t\t\t\tcreatedAt: now.toISOString(),\n\t\t\t\t\t\tupdatedAt: now.toISOString(),\n\t\t\t\t\t\tmetadata: outcome.metadata,\n\t\t\t\t\t\t...(outcome.actionId ? { actionId: outcome.actionId } : {}),\n\t\t\t\t\t\t...(outcome.traceId ? { traceId: outcome.traceId } : {}),\n\t\t\t\t\t};\n\t\t} catch (error) {\n\t\t\tlogger.warn(\"Failed to record revenue attribution outcome\", {\n\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\tworkspaceId: outcome.workspaceId,\n\t\t\t\tagentId: outcome.agentId,\n\t\t\t\toutcomeId: outcome.outcomeId,\n\t\t\t});\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tasync queryRoi(\n\t\tinput: RevenueAttributionRoiQuery,\n\t): Promise<RevenueAttributionRoiReport> {\n\t\tconst query = normalizeRevenueAttributionRoiQuery(input);\n\t\tconst db = this.requireDatabase();\n\t\tconst filters = buildFilters(query);\n\t\tconst where = sql`WHERE ${sql.join(filters, sql` AND `)}`;\n\n\t\tconst totalsResult = await db.execute(sql`\n\t\t\tSELECT\n\t\t\t\tCOUNT(*) AS outcome_count,\n\t\t\t\tCOUNT(DISTINCT action_id) FILTER (WHERE action_id IS NOT NULL) AS action_count,\n\t\t\t\tCOUNT(DISTINCT trace_id) FILTER (WHERE trace_id IS NOT NULL) AS trace_count,\n\t\t\t\tCOALESCE(SUM((revenue_usd_micros * attribution_weight_bps) / 10000), 0) AS revenue_usd_micros,\n\t\t\t\tCOALESCE(SUM((pipeline_value_usd_micros * attribution_weight_bps) / 10000), 0) AS pipeline_value_usd_micros,\n\t\t\t\tCOALESCE(SUM(cost_usd_micros), 0) AS cost_usd_micros,\n\t\t\t\tCOALESCE(SUM(duration_ms), 0) AS duration_ms\n\t\t\tFROM revenue_attribution\n\t\t\t${where}\n\t\t`);\n\t\tconst outcomeResult = await db.execute(sql`\n\t\t\tSELECT\n\t\t\t\toutcome_type,\n\t\t\t\tCOUNT(*) AS outcome_count,\n\t\t\t\tCOALESCE(SUM((revenue_usd_micros * attribution_weight_bps) / 10000), 0) AS revenue_usd_micros,\n\t\t\t\tCOALESCE(SUM((pipeline_value_usd_micros * attribution_weight_bps) / 10000), 0) AS pipeline_value_usd_micros,\n\t\t\t\tCOALESCE(SUM(cost_usd_micros), 0) AS cost_usd_micros\n\t\t\tFROM revenue_attribution\n\t\t\t${where}\n\t\t\tGROUP BY outcome_type\n\t\t\tORDER BY revenue_usd_micros DESC, outcome_type ASC\n\t\t`);\n\n\t\tconst [totalsRow] = Array.from(totalsResult) as Array<\n\t\t\tRecord<string, unknown>\n\t\t>;\n\t\tconst outcomeRows = Array.from(outcomeResult) as Array<\n\t\t\tRecord<string, unknown>\n\t\t>;\n\t\treturn createRevenueAttributionRoiReport({\n\t\t\tquery,\n\t\t\ttotalsRow,\n\t\t\toutcomeRows,\n\t\t});\n\t}\n}\n\nlet defaultRevenueAttributionService: RevenueAttributionService | null = null;\n\nexport function getRevenueAttributionService(): RevenueAttributionService {\n\tdefaultRevenueAttributionService ??= new RevenueAttributionService();\n\treturn defaultRevenueAttributionService;\n}\n\nexport function setRevenueAttributionServiceForTest(\n\tservice: RevenueAttributionService | null,\n): void {\n\tdefaultRevenueAttributionService = service;\n}\n"]}

package/dist/services/revenue-attribution/types.d.ts

@@ -0,0 +1,96 @@
+export declare const ATTRIBUTION_MODELS: readonly ["direct", "assisted", "influenced", "custom"];
+export type AttributionModel = (typeof ATTRIBUTION_MODELS)[number];
+export type AttributionJsonValue = string | number | boolean | null | AttributionJsonValue[] | {
+    [key: string]: AttributionJsonValue;
+};
+export interface RevenueOutcomeInput {
+    workspaceId: string;
+    agentId: string;
+    actionId?: string;
+    traceId?: string;
+    outcomeId: string;
+    outcomeType: string;
+    attributionModel?: AttributionModel;
+    attributionWeight?: number;
+    attributionWeightBps?: number;
+    revenueUsd?: number;
+    pipelineValueUsd?: number;
+    costUsd?: number;
+    durationMs?: number;
+    occurredAt?: Date | string;
+    metadata?: Record<string, unknown>;
+}
+export interface NormalizedRevenueOutcome {
+    workspaceId: string;
+    agentId: string;
+    outcomeId: string;
+    outcomeType: string;
+    attributionModel: AttributionModel;
+    attributionWeightBps: number;
+    revenueUsdMicros: number;
+    pipelineValueUsdMicros: number;
+    costUsdMicros: number;
+    durationMs: number;
+    occurredAt: Date;
+    metadata: Record<string, AttributionJsonValue>;
+    actionId?: string;
+    traceId?: string;
+}
+export interface RevenueAttributionRecord {
+    id: string;
+    workspaceId: string;
+    agentId: string;
+    outcomeId: string;
+    outcomeType: string;
+    attributionModel: AttributionModel;
+    attributionWeightBps: number;
+    revenueUsd: number;
+    pipelineValueUsd: number;
+    costUsd: number;
+    durationMs: number;
+    occurredAt: string;
+    createdAt: string;
+    updatedAt: string;
+    metadata: Record<string, AttributionJsonValue>;
+    actionId?: string;
+    traceId?: string;
+}
+export interface RevenueAttributionRoiQuery {
+    agentId: string;
+    workspaceId?: string;
+    from?: Date;
+    to?: Date;
+}
+export interface RevenueAttributionOutcomeSummary {
+    outcomeType: string;
+    outcomeCount: number;
+    revenueUsd: number;
+    pipelineValueUsd: number;
+    costUsd: number;
+}
+export interface RevenueAttributionRoiReport {
+    agentId: string;
+    workspaceId?: string;
+    period: {
+        from?: string;
+        to?: string;
+    };
+    attribution: {
+        outcomeCount: number;
+        actionCount: number;
+        traceCount: number;
+        revenueUsd: number;
+        pipelineValueUsd: number;
+    };
+    cost: {
+        costUsd: number;
+        totalDurationMs: number;
+    };
+    roi: {
+        revenuePerDollarSpent: number | null;
+        netRevenueUsd: number;
+        costPerOutcome: number | null;
+    };
+    byOutcomeType: RevenueAttributionOutcomeSummary[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/revenue-attribution/types.d.ts.map

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

package/dist/services/revenue-attribution/types.js

@@ -0,0 +1,7 @@
+export const ATTRIBUTION_MODELS = [
+    "direct",
+    "assisted",
+    "influenced",
+    "custom",
+];
+//# sourceMappingURL=types.js.map

package/dist/services/revenue-attribution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/revenue-attribution/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IACjC,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,QAAQ;CACC,CAAC","sourcesContent":["export const ATTRIBUTION_MODELS = [\n\t\"direct\",\n\t\"assisted\",\n\t\"influenced\",\n\t\"custom\",\n] as const;\n\nexport type AttributionModel = (typeof ATTRIBUTION_MODELS)[number];\n\nexport type AttributionJsonValue =\n\t| string\n\t| number\n\t| boolean\n\t| null\n\t| AttributionJsonValue[]\n\t| { [key: string]: AttributionJsonValue };\n\nexport interface RevenueOutcomeInput {\n\tworkspaceId: string;\n\tagentId: string;\n\tactionId?: string;\n\ttraceId?: string;\n\toutcomeId: string;\n\toutcomeType: string;\n\tattributionModel?: AttributionModel;\n\tattributionWeight?: number;\n\tattributionWeightBps?: number;\n\trevenueUsd?: number;\n\tpipelineValueUsd?: number;\n\tcostUsd?: number;\n\tdurationMs?: number;\n\toccurredAt?: Date | string;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport interface NormalizedRevenueOutcome {\n\tworkspaceId: string;\n\tagentId: string;\n\toutcomeId: string;\n\toutcomeType: string;\n\tattributionModel: AttributionModel;\n\tattributionWeightBps: number;\n\trevenueUsdMicros: number;\n\tpipelineValueUsdMicros: number;\n\tcostUsdMicros: number;\n\tdurationMs: number;\n\toccurredAt: Date;\n\tmetadata: Record<string, AttributionJsonValue>;\n\tactionId?: string;\n\ttraceId?: string;\n}\n\nexport interface RevenueAttributionRecord {\n\tid: string;\n\tworkspaceId: string;\n\tagentId: string;\n\toutcomeId: string;\n\toutcomeType: string;\n\tattributionModel: AttributionModel;\n\tattributionWeightBps: number;\n\trevenueUsd: number;\n\tpipelineValueUsd: number;\n\tcostUsd: number;\n\tdurationMs: number;\n\toccurredAt: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tmetadata: Record<string, AttributionJsonValue>;\n\tactionId?: string;\n\ttraceId?: string;\n}\n\nexport interface RevenueAttributionRoiQuery {\n\tagentId: string;\n\tworkspaceId?: string;\n\tfrom?: Date;\n\tto?: Date;\n}\n\nexport interface RevenueAttributionOutcomeSummary {\n\toutcomeType: string;\n\toutcomeCount: number;\n\trevenueUsd: number;\n\tpipelineValueUsd: number;\n\tcostUsd: number;\n}\n\nexport interface RevenueAttributionRoiReport {\n\tagentId: string;\n\tworkspaceId?: string;\n\tperiod: {\n\t\tfrom?: string;\n\t\tto?: string;\n\t};\n\tattribution: {\n\t\toutcomeCount: number;\n\t\tactionCount: number;\n\t\ttraceCount: number;\n\t\trevenueUsd: number;\n\t\tpipelineValueUsd: number;\n\t};\n\tcost: {\n\t\tcostUsd: number;\n\t\ttotalDurationMs: number;\n\t};\n\troi: {\n\t\trevenuePerDollarSpent: number | null;\n\t\tnetRevenueUsd: number;\n\t\tcostPerOutcome: number | null;\n\t};\n\tbyOutcomeType: RevenueAttributionOutcomeSummary[];\n}\n"]}

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

@@ -0,0 +1,5 @@
+export { TracesValidationError, countTraceSpans, generateSpanId, generateTraceId, normalizeTraceSpanName, normalizeExecutionTraceInput, normalizeTraceListQuery, parseTraceLimit, parseTraceOffset, parseTraceStatus, } from "./normalize.js";
+export { exportTraceToOpenTelemetry } from "./otel.js";
+export { TracesService, TracesUnavailableError, getTracesService, setTracesServiceForTest, } from "./service.js";
+export type { ExecutionTrace, ExecutionTraceInput, ExecutionTraceSpan, ExecutionTraceSummary, OpenTelemetryAnyValue, OpenTelemetryKeyValue, OpenTelemetrySpan, OpenTelemetryTraceExport, TraceJsonValue, TraceListQuery, TraceListResult, TraceSpanInput, TraceSpanStatus, TraceStatus, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/traces/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EACN,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EACX,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,GACX,MAAM,YAAY,CAAC"}

package/dist/services/traces/index.js

@@ -0,0 +1,4 @@
+export { TracesValidationError, countTraceSpans, generateSpanId, generateTraceId, normalizeTraceSpanName, normalizeExecutionTraceInput, normalizeTraceListQuery, parseTraceLimit, parseTraceOffset, parseTraceStatus, } from "./normalize.js";
+export { exportTraceToOpenTelemetry } from "./otel.js";
+export { TracesService, TracesUnavailableError, getTracesService, setTracesServiceForTest, } from "./service.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/traces/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EACN,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,GACvB,MAAM,cAAc,CAAC","sourcesContent":["export {\n\tTracesValidationError,\n\tcountTraceSpans,\n\tgenerateSpanId,\n\tgenerateTraceId,\n\tnormalizeTraceSpanName,\n\tnormalizeExecutionTraceInput,\n\tnormalizeTraceListQuery,\n\tparseTraceLimit,\n\tparseTraceOffset,\n\tparseTraceStatus,\n} from \"./normalize.js\";\nexport { exportTraceToOpenTelemetry } from \"./otel.js\";\nexport {\n\tTracesService,\n\tTracesUnavailableError,\n\tgetTracesService,\n\tsetTracesServiceForTest,\n} from \"./service.js\";\nexport type {\n\tExecutionTrace,\n\tExecutionTraceInput,\n\tExecutionTraceSpan,\n\tExecutionTraceSummary,\n\tOpenTelemetryAnyValue,\n\tOpenTelemetryKeyValue,\n\tOpenTelemetrySpan,\n\tOpenTelemetryTraceExport,\n\tTraceJsonValue,\n\tTraceListQuery,\n\tTraceListResult,\n\tTraceSpanInput,\n\tTraceSpanStatus,\n\tTraceStatus,\n} from \"./types.js\";\n"]}