@codemation/host 0.2.5 → 0.3.0

package/prisma/schema.sqlite.prisma

@@ -27,7 +27,6 @@ model Run {
   workItems          RunWorkItem[]
   executionInstances ExecutionInstance[]
   slotProjection     RunSlotProjection?
-
   @@index([workflowId, startedAt])
   @@index([workflowId, status, finishedAt])
 }
@@ -140,6 +139,106 @@ model TriggerSetupState {
   @@id([workflowId, nodeId])
 }
 
+model RunTraceContext {
+  runId       String  @id @map("run_id")
+  workflowId  String  @map("workflow_id")
+  traceId     String  @unique @map("trace_id")
+  rootSpanId  String  @map("root_span_id")
+  serviceName String? @map("service_name")
+  createdAt   String  @map("created_at")
+  expiresAt   String? @map("expires_at")
+
+  @@index([workflowId, createdAt])
+}
+
+model TelemetrySpan {
+  telemetrySpanId          String  @id @map("telemetry_span_id")
+  traceId                  String  @map("trace_id")
+  spanId                   String  @map("span_id")
+  parentSpanId             String? @map("parent_span_id")
+  runId                    String  @map("run_id")
+  workflowId               String  @map("workflow_id")
+  nodeId                   String? @map("node_id")
+  activationId             String? @map("activation_id")
+  connectionInvocationId   String? @map("connection_invocation_id")
+  name                     String
+  kind                     String
+  status                   String?
+  statusMessage            String? @map("status_message")
+  startTime                String? @map("start_time")
+  endTime                  String? @map("end_time")
+  workflowFolder           String? @map("workflow_folder")
+  nodeType                 String? @map("node_type")
+  nodeRole                 String? @map("node_role")
+  modelName                String? @map("model_name")
+  attributesJson           String? @map("attributes_json")
+  eventsJson               String? @map("events_json")
+  retentionExpiresAt       String? @map("retention_expires_at")
+  updatedAt                String  @map("updated_at")
+
+  @@unique([traceId, spanId])
+  @@index([traceId, startTime])
+  @@index([workflowId, endTime])
+  @@index([workflowId, status, endTime])
+  @@index([runId, endTime])
+  @@index([modelName, endTime])
+  @@index([connectionInvocationId])
+  @@index([retentionExpiresAt])
+}
+
+model TelemetryArtifact {
+  artifactId   String  @id @map("artifact_id")
+  traceId      String  @map("trace_id")
+  spanId       String  @map("span_id")
+  runId        String  @map("run_id")
+  workflowId   String  @map("workflow_id")
+  nodeId       String? @map("node_id")
+  activationId String? @map("activation_id")
+  kind         String
+  contentType  String  @map("content_type")
+  previewText  String? @map("preview_text")
+  previewJson  String? @map("preview_json")
+  payloadText  String? @map("payload_text")
+  payloadJson  String? @map("payload_json")
+  bytes        Int?
+  truncated    Boolean?
+  createdAt    String  @map("created_at")
+  expiresAt    String? @map("expires_at")
+  retentionExpiresAt String? @map("retention_expires_at")
+
+  @@index([traceId, createdAt])
+  @@index([spanId, createdAt])
+  @@index([runId, createdAt])
+  @@index([retentionExpiresAt])
+}
+
+model TelemetryMetricPoint {
+  metricPointId      String  @id @map("metric_point_id")
+  traceId            String? @map("trace_id")
+  spanId             String? @map("span_id")
+  runId              String? @map("run_id")
+  workflowId         String  @map("workflow_id")
+  nodeId             String? @map("node_id")
+  activationId       String? @map("activation_id")
+  metricName         String  @map("metric_name")
+  value              Float
+  unit               String?
+  observedAt         String  @map("observed_at")
+  workflowFolder     String? @map("workflow_folder")
+  nodeType           String? @map("node_type")
+  nodeRole           String? @map("node_role")
+  modelName          String? @map("model_name")
+  dimensionsJson     String? @map("dimensions_json")
+  retentionExpiresAt String? @map("retention_expires_at")
+
+  @@index([workflowId, observedAt])
+  @@index([workflowId, metricName, observedAt])
+  @@index([runId, observedAt])
+  @@index([traceId, observedAt])
+  @@index([modelName, observedAt])
+  @@index([retentionExpiresAt])
+}
+
 model CredentialInstance {
   instanceId       String @id @map("instance_id")
   typeId           String @map("type_id")

package/scripts/generate-prisma-clients.mjs

@@ -1,11 +1,20 @@
 import { spawnSync } from "node:child_process";
+import { existsSync, realpathSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+
+const require = createRequire(import.meta.url);
 
 class PrismaClientGenerator {
   static providers = ["postgresql", "sqlite"];
+  static prismaCliEntrypoint = require.resolve("prisma/build/index.js");
+  static minimumNodeVersion = { major: 20, minor: 19 };
+  static reexecMarker = "CODEMATION_PRISMA_GENERATE_REEXEC";
 
   static run() {
+    this.reexecUnderSupportedNodeWhenNeeded();
     for (const provider of this.providers) {
-      const result = spawnSync("pnpm", ["exec", "prisma", "generate"], {
+      const result = spawnSync(process.execPath, [this.prismaCliEntrypoint, "generate"], {
         cwd: import.meta.dirname.replace(/\/scripts$/, ""),
         env: {
           ...process.env,
@@ -19,6 +28,85 @@ class PrismaClientGenerator {
       }
     }
   }
+
+  static reexecUnderSupportedNodeWhenNeeded() {
+    if (process.env[this.reexecMarker] === "1" || this.isSupportedNode(process.versions.node)) {
+      return;
+    }
+    const supportedNodeBinary = this.resolveSupportedNodeBinary();
+    if (!supportedNodeBinary) {
+      throw new Error(
+        `Prisma generation requires Node >= ${this.minimumNodeVersion.major}.${this.minimumNodeVersion.minor}. ` +
+          `Current process is ${process.versions.node} and no supported Node binary could be resolved.`,
+      );
+    }
+    const result = spawnSync(supportedNodeBinary, [new URL(import.meta.url).pathname], {
+      cwd: import.meta.dirname.replace(/\/scripts$/, ""),
+      env: {
+        ...process.env,
+        [this.reexecMarker]: "1",
+      },
+      stdio: "inherit",
+      shell: false,
+    });
+    process.exit(result.status ?? 1);
+  }
+
+  static resolveSupportedNodeBinary() {
+    const pnpmPath = this.resolvePnpmPath();
+    if (!pnpmPath) {
+      return undefined;
+    }
+    const pnpmDir = path.dirname(pnpmPath);
+    const candidates = [path.join(pnpmDir, "node"), path.resolve(pnpmDir, "../../../../bin/node")];
+    for (const candidate of candidates) {
+      if (!existsSync(candidate)) {
+        continue;
+      }
+      const versionResult = spawnSync(candidate, ["-p", "process.versions.node"], {
+        env: process.env,
+        encoding: "utf8",
+        shell: false,
+      });
+      if (versionResult.status === 0 && this.isSupportedNode(versionResult.stdout.trim())) {
+        return candidate;
+      }
+    }
+    return undefined;
+  }
+
+  static resolvePnpmPath() {
+    const npmExecPath = process.env.npm_execpath?.trim();
+    if (npmExecPath) {
+      return realpathSync(npmExecPath);
+    }
+    const result = spawnSync("bash", ["-lc", 'realpath "$(command -v pnpm)"'], {
+      env: process.env,
+      encoding: "utf8",
+      shell: false,
+    });
+    if (result.status !== 0) {
+      return undefined;
+    }
+    const pnpmPath = result.stdout.trim();
+    return pnpmPath.length > 0 ? pnpmPath : undefined;
+  }
+
+  static isSupportedNode(version) {
+    const [majorText = "0", minorText = "0"] = version.split(".");
+    const major = Number(majorText);
+    const minor = Number(minorText);
+    if (!Number.isInteger(major) || !Number.isInteger(minor)) {
+      return false;
+    }
+    if (major > this.minimumNodeVersion.major) {
+      return true;
+    }
+    if (major < this.minimumNodeVersion.major) {
+      return false;
+    }
+    return minor >= this.minimumNodeVersion.minor;
+  }
 }
 
 PrismaClientGenerator.run();

package/src/application/contracts/TelemetryDashboardContracts.ts

@@ -0,0 +1,113 @@
+import type { TelemetrySpanStatus } from "../../domain/telemetry/TelemetryContracts";
+
+export type TelemetryDashboardBucketIntervalDto = "minute_5" | "minute_15" | "hour" | "day" | "week";
+export type TelemetryDashboardRunOriginDto = "triggered" | "manual";
+
+export interface TelemetryDashboardFiltersDto {
+  readonly workflowIds?: ReadonlyArray<string>;
+  readonly statuses?: ReadonlyArray<TelemetrySpanStatus>;
+  readonly runOrigins?: ReadonlyArray<TelemetryDashboardRunOriginDto>;
+  readonly modelNames?: ReadonlyArray<string>;
+  readonly startTimeGte?: string;
+  readonly endTimeLte?: string;
+}
+
+export interface TelemetryDashboardRunAggregateDto {
+  readonly totalRuns: number;
+  readonly completedRuns: number;
+  readonly failedRuns: number;
+  readonly runningRuns: number;
+  readonly averageDurationMs: number;
+}
+
+export interface TelemetryDashboardAiAggregateDto {
+  readonly inputTokens: number;
+  readonly outputTokens: number;
+  readonly totalTokens: number;
+  readonly cachedInputTokens: number;
+  readonly reasoningTokens: number;
+}
+
+export interface TelemetryDashboardCostKeyTotalDto {
+  readonly costKey: string;
+  readonly estimatedCostMinor: number;
+}
+
+export interface TelemetryDashboardCostCurrencyTotalDto {
+  readonly currency: string;
+  readonly currencyScale: number;
+  readonly estimatedCostMinor: number;
+  readonly averageCostPerRunMinor: number;
+  readonly costKeys: ReadonlyArray<TelemetryDashboardCostKeyTotalDto>;
+}
+
+export interface TelemetryDashboardCostAggregateDto {
+  readonly currencies: ReadonlyArray<TelemetryDashboardCostCurrencyTotalDto>;
+}
+
+export interface TelemetryDashboardSummaryDto {
+  readonly runs: TelemetryDashboardRunAggregateDto;
+  readonly ai: TelemetryDashboardAiAggregateDto;
+  readonly costs: TelemetryDashboardCostAggregateDto;
+}
+
+export interface TelemetryDashboardBucketCostDto {
+  readonly currency: string;
+  readonly currencyScale: number;
+  readonly estimatedCostMinor: number;
+  readonly component?: string;
+  readonly costKey?: string;
+}
+
+export interface TelemetryDashboardTimeseriesBucketDto {
+  readonly bucketStartIso: string;
+  readonly bucketEndIso: string;
+  readonly totalRuns: number;
+  readonly completedRuns: number;
+  readonly failedRuns: number;
+  readonly runningRuns: number;
+  readonly averageDurationMs: number;
+  readonly inputTokens: number;
+  readonly outputTokens: number;
+  readonly totalTokens: number;
+  readonly cachedInputTokens: number;
+  readonly reasoningTokens: number;
+  readonly costs: ReadonlyArray<TelemetryDashboardBucketCostDto>;
+}
+
+export interface TelemetryDashboardTimeseriesDto {
+  readonly interval: TelemetryDashboardBucketIntervalDto;
+  readonly buckets: ReadonlyArray<TelemetryDashboardTimeseriesBucketDto>;
+}
+
+export interface TelemetryDashboardDimensionsDto {
+  readonly modelNames: ReadonlyArray<string>;
+}
+
+export interface TelemetryDashboardTimeseriesRequestDto {
+  readonly filters: TelemetryDashboardFiltersDto;
+  readonly interval: TelemetryDashboardBucketIntervalDto;
+}
+
+export interface TelemetryDashboardRunsRequestDto {
+  readonly filters: TelemetryDashboardFiltersDto;
+  readonly page: number;
+  readonly pageSize: number;
+}
+
+export interface TelemetryDashboardRunListItemDto {
+  readonly runId: string;
+  readonly workflowId: string;
+  readonly status: TelemetrySpanStatus;
+  readonly origin: TelemetryDashboardRunOriginDto;
+  readonly startedAt: string;
+  readonly finishedAt?: string;
+  readonly costs?: ReadonlyArray<TelemetryDashboardBucketCostDto>;
+}
+
+export interface TelemetryDashboardRunsDto {
+  readonly items: ReadonlyArray<TelemetryDashboardRunListItemDto>;
+  readonly totalCount: number;
+  readonly page: number;
+  readonly pageSize: number;
+}

package/src/application/contracts/TelemetryRunTraceContracts.ts

@@ -0,0 +1,13 @@
+import type {
+  TelemetryArtifactRecord,
+  TelemetryMetricPointRecord,
+  TelemetrySpanRecord,
+} from "../../domain/telemetry/TelemetryContracts";
+
+export interface TelemetryRunTraceViewDto {
+  readonly traceId: string;
+  readonly runId: string;
+  readonly spans: ReadonlyArray<TelemetrySpanRecord>;
+  readonly artifacts: ReadonlyArray<TelemetryArtifactRecord>;
+  readonly metricPoints: ReadonlyArray<TelemetryMetricPointRecord>;
+}

package/src/application/cost/FrameworkCostCatalogEntries.ts

@@ -0,0 +1,126 @@
+import type { CostCatalogEntry } from "@codemation/core";
+
+const currencyScale = 1_000_000_000;
+
+export const FrameworkCostCatalogEntries: ReadonlyArray<CostCatalogEntry> = [
+  {
+    component: "chat",
+    provider: "openai",
+    operation: "completion.input",
+    pricingKey: "demo-gpt",
+    usageUnit: "input_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 1_000,
+  },
+  {
+    component: "chat",
+    provider: "openai",
+    operation: "completion.output",
+    pricingKey: "demo-gpt",
+    usageUnit: "output_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 2_000,
+  },
+  {
+    component: "chat",
+    provider: "openai",
+    operation: "completion.input",
+    pricingKey: "gpt-4o-mini",
+    usageUnit: "input_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 150,
+  },
+  {
+    component: "chat",
+    provider: "openai",
+    operation: "completion.output",
+    pricingKey: "gpt-4o-mini",
+    usageUnit: "output_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 600,
+  },
+  {
+    component: "chat",
+    provider: "openai",
+    operation: "completion.input",
+    pricingKey: "gpt-4.1-nano",
+    usageUnit: "input_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 100,
+  },
+  {
+    component: "chat",
+    provider: "openai",
+    operation: "completion.output",
+    pricingKey: "gpt-4.1-nano",
+    usageUnit: "output_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 400,
+  },
+  {
+    component: "chat",
+    provider: "openai",
+    operation: "completion.input",
+    pricingKey: "gpt-4.1-mini",
+    usageUnit: "input_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 400,
+  },
+  {
+    component: "chat",
+    provider: "openai",
+    operation: "completion.output",
+    pricingKey: "gpt-4.1-mini",
+    usageUnit: "output_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 1_600,
+  },
+  {
+    component: "chat",
+    provider: "openai",
+    operation: "completion.input",
+    pricingKey: "gpt-4.1",
+    usageUnit: "input_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 2_000,
+  },
+  {
+    component: "chat",
+    provider: "openai",
+    operation: "completion.output",
+    pricingKey: "gpt-4.1",
+    usageUnit: "output_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 8_000,
+  },
+  {
+    component: "rag",
+    provider: "openai",
+    operation: "embed_documents",
+    pricingKey: "text-embedding-3-small",
+    usageUnit: "input_tokens",
+    currency: "USD",
+    currencyScale,
+    pricePerUnitMinor: 20,
+  },
+  {
+    component: "ocr",
+    provider: "azure_document_intelligence",
+    operation: "analyze_document",
+    pricingKey: "prebuilt_read",
+    usageUnit: "pages",
+    currency: "EUR",
+    currencyScale,
+    pricePerUnitMinor: 15_000_000,
+  },
+] as const;

package/src/application/queries/GetTelemetryDashboardDimensionsQuery.ts

@@ -0,0 +1,11 @@
+import type {
+  TelemetryDashboardDimensionsDto,
+  TelemetryDashboardFiltersDto,
+} from "../contracts/TelemetryDashboardContracts";
+import { Query } from "../bus/Query";
+
+export class GetTelemetryDashboardDimensionsQuery extends Query<TelemetryDashboardDimensionsDto> {
+  constructor(public readonly filters: TelemetryDashboardFiltersDto) {
+    super();
+  }
+}

package/src/application/queries/GetTelemetryDashboardDimensionsQueryHandler.ts

@@ -0,0 +1,20 @@
+import { inject } from "@codemation/core";
+import type { TelemetryDashboardDimensionsDto } from "../contracts/TelemetryDashboardContracts";
+import { HandlesQuery } from "../../infrastructure/di/HandlesQueryRegistry";
+import { QueryHandler } from "../bus/QueryHandler";
+import { TelemetryQueryService } from "../telemetry/TelemetryQueryService";
+import { GetTelemetryDashboardDimensionsQuery } from "./GetTelemetryDashboardDimensionsQuery";
+
+@HandlesQuery.for(GetTelemetryDashboardDimensionsQuery)
+export class GetTelemetryDashboardDimensionsQueryHandler extends QueryHandler<
+  GetTelemetryDashboardDimensionsQuery,
+  TelemetryDashboardDimensionsDto
+> {
+  constructor(@inject(TelemetryQueryService) private readonly telemetryQueryService: TelemetryQueryService) {
+    super();
+  }
+
+  async execute(query: GetTelemetryDashboardDimensionsQuery): Promise<TelemetryDashboardDimensionsDto> {
+    return await this.telemetryQueryService.listModelNames(query.filters);
+  }
+}

package/src/application/queries/GetTelemetryDashboardRunsQuery.ts

@@ -0,0 +1,11 @@
+import type {
+  TelemetryDashboardRunsDto,
+  TelemetryDashboardRunsRequestDto,
+} from "../contracts/TelemetryDashboardContracts";
+import { Query } from "../bus/Query";
+
+export class GetTelemetryDashboardRunsQuery extends Query<TelemetryDashboardRunsDto> {
+  constructor(public readonly request: TelemetryDashboardRunsRequestDto) {
+    super();
+  }
+}

package/src/application/queries/GetTelemetryDashboardRunsQueryHandler.ts

@@ -0,0 +1,20 @@
+import { inject } from "@codemation/core";
+import type { TelemetryDashboardRunsDto } from "../contracts/TelemetryDashboardContracts";
+import { HandlesQuery } from "../../infrastructure/di/HandlesQueryRegistry";
+import { QueryHandler } from "../bus/QueryHandler";
+import { TelemetryQueryService } from "../telemetry/TelemetryQueryService";
+import { GetTelemetryDashboardRunsQuery } from "./GetTelemetryDashboardRunsQuery";
+
+@HandlesQuery.for(GetTelemetryDashboardRunsQuery)
+export class GetTelemetryDashboardRunsQueryHandler extends QueryHandler<
+  GetTelemetryDashboardRunsQuery,
+  TelemetryDashboardRunsDto
+> {
+  constructor(@inject(TelemetryQueryService) private readonly telemetryQueryService: TelemetryQueryService) {
+    super();
+  }
+
+  async execute(query: GetTelemetryDashboardRunsQuery): Promise<TelemetryDashboardRunsDto> {
+    return await this.telemetryQueryService.listRuns(query.request);
+  }
+}

package/src/application/queries/GetTelemetryDashboardSummaryQuery.ts

@@ -0,0 +1,11 @@
+import type {
+  TelemetryDashboardFiltersDto,
+  TelemetryDashboardSummaryDto,
+} from "../contracts/TelemetryDashboardContracts";
+import { Query } from "../bus/Query";
+
+export class GetTelemetryDashboardSummaryQuery extends Query<TelemetryDashboardSummaryDto> {
+  constructor(public readonly filters: TelemetryDashboardFiltersDto) {
+    super();
+  }
+}

package/src/application/queries/GetTelemetryDashboardSummaryQueryHandler.ts

@@ -0,0 +1,29 @@
+import { inject } from "@codemation/core";
+import type { TelemetryDashboardSummaryDto } from "../contracts/TelemetryDashboardContracts";
+import { HandlesQuery } from "../../infrastructure/di/HandlesQueryRegistry";
+import { QueryHandler } from "../bus/QueryHandler";
+import { TelemetryQueryService } from "../telemetry/TelemetryQueryService";
+import { GetTelemetryDashboardSummaryQuery } from "./GetTelemetryDashboardSummaryQuery";
+
+@HandlesQuery.for(GetTelemetryDashboardSummaryQuery)
+export class GetTelemetryDashboardSummaryQueryHandler extends QueryHandler<
+  GetTelemetryDashboardSummaryQuery,
+  TelemetryDashboardSummaryDto
+> {
+  constructor(@inject(TelemetryQueryService) private readonly telemetryQueryService: TelemetryQueryService) {
+    super();
+  }
+
+  async execute(query: GetTelemetryDashboardSummaryQuery): Promise<TelemetryDashboardSummaryDto> {
+    const [runs, ai, costs] = await Promise.all([
+      this.telemetryQueryService.summarizeRuns(query.filters),
+      this.telemetryQueryService.summarizeAiUsage(query.filters),
+      this.telemetryQueryService.summarizeCosts(query.filters),
+    ]);
+    return {
+      runs,
+      ai,
+      costs,
+    };
+  }
+}

package/src/application/queries/GetTelemetryDashboardTimeseriesQuery.ts

@@ -0,0 +1,11 @@
+import type {
+  TelemetryDashboardTimeseriesDto,
+  TelemetryDashboardTimeseriesRequestDto,
+} from "../contracts/TelemetryDashboardContracts";
+import { Query } from "../bus/Query";
+
+export class GetTelemetryDashboardTimeseriesQuery extends Query<TelemetryDashboardTimeseriesDto> {
+  constructor(public readonly request: TelemetryDashboardTimeseriesRequestDto) {
+    super();
+  }
+}

package/src/application/queries/GetTelemetryDashboardTimeseriesQueryHandler.ts

@@ -0,0 +1,36 @@
+import { inject } from "@codemation/core";
+import type { TelemetryDashboardTimeseriesDto } from "../contracts/TelemetryDashboardContracts";
+import { HandlesQuery } from "../../infrastructure/di/HandlesQueryRegistry";
+import { QueryHandler } from "../bus/QueryHandler";
+import { TelemetryQueryService } from "../telemetry/TelemetryQueryService";
+import { GetTelemetryDashboardTimeseriesQuery } from "./GetTelemetryDashboardTimeseriesQuery";
+
+@HandlesQuery.for(GetTelemetryDashboardTimeseriesQuery)
+export class GetTelemetryDashboardTimeseriesQueryHandler extends QueryHandler<
+  GetTelemetryDashboardTimeseriesQuery,
+  TelemetryDashboardTimeseriesDto
+> {
+  constructor(@inject(TelemetryQueryService) private readonly telemetryQueryService: TelemetryQueryService) {
+    super();
+  }
+
+  async execute(query: GetTelemetryDashboardTimeseriesQuery): Promise<TelemetryDashboardTimeseriesDto> {
+    const [runSeries, aiSeries, costSeries] = await Promise.all([
+      this.telemetryQueryService.summarizeRunsTimeseries(query.request.filters, query.request.interval),
+      this.telemetryQueryService.summarizeAiUsageTimeseries(query.request.filters, query.request.interval),
+      this.telemetryQueryService.summarizeCostsTimeseries(query.request.filters, query.request.interval),
+    ]);
+    return {
+      interval: query.request.interval,
+      buckets: runSeries.buckets.map((runBucket, index) => ({
+        ...runBucket,
+        inputTokens: aiSeries.buckets[index]?.inputTokens ?? 0,
+        outputTokens: aiSeries.buckets[index]?.outputTokens ?? 0,
+        totalTokens: aiSeries.buckets[index]?.totalTokens ?? 0,
+        cachedInputTokens: aiSeries.buckets[index]?.cachedInputTokens ?? 0,
+        reasoningTokens: aiSeries.buckets[index]?.reasoningTokens ?? 0,
+        costs: costSeries.buckets[index]?.costs ?? [],
+      })),
+    };
+  }
+}

package/src/application/queries/GetTelemetryRunTraceQuery.ts

@@ -0,0 +1,8 @@
+import type { TelemetryRunTraceViewDto } from "../contracts/TelemetryRunTraceContracts";
+import { Query } from "../bus/Query";
+
+export class GetTelemetryRunTraceQuery extends Query<TelemetryRunTraceViewDto> {
+  constructor(public readonly runId: string) {
+    super();
+  }
+}

package/src/application/queries/GetTelemetryRunTraceQueryHandler.ts

@@ -0,0 +1,20 @@
+import { inject } from "@codemation/core";
+import type { TelemetryRunTraceViewDto } from "../contracts/TelemetryRunTraceContracts";
+import { HandlesQuery } from "../../infrastructure/di/HandlesQueryRegistry";
+import { QueryHandler } from "../bus/QueryHandler";
+import { TelemetryQueryService } from "../telemetry/TelemetryQueryService";
+import { GetTelemetryRunTraceQuery } from "./GetTelemetryRunTraceQuery";
+
+@HandlesQuery.for(GetTelemetryRunTraceQuery)
+export class GetTelemetryRunTraceQueryHandler extends QueryHandler<
+  GetTelemetryRunTraceQuery,
+  TelemetryRunTraceViewDto
+> {
+  constructor(@inject(TelemetryQueryService) private readonly telemetryQueryService: TelemetryQueryService) {
+    super();
+  }
+
+  async execute(query: GetTelemetryRunTraceQuery): Promise<TelemetryRunTraceViewDto> {
+    return await this.telemetryQueryService.loadRunTrace(query.runId);
+  }
+}

package/src/application/queries/WorkflowQueryHandlers.ts

@@ -1,5 +1,10 @@
 export { GetRunBinaryAttachmentQueryHandler } from "./GetRunBinaryAttachmentQueryHandler";
 export { GetRunStateQueryHandler } from "./GetRunStateQueryHandler";
+export { GetTelemetryDashboardDimensionsQueryHandler } from "./GetTelemetryDashboardDimensionsQueryHandler";
+export { GetTelemetryDashboardRunsQueryHandler } from "./GetTelemetryDashboardRunsQueryHandler";
+export { GetTelemetryRunTraceQueryHandler } from "./GetTelemetryRunTraceQueryHandler";
+export { GetTelemetryDashboardSummaryQueryHandler } from "./GetTelemetryDashboardSummaryQueryHandler";
+export { GetTelemetryDashboardTimeseriesQueryHandler } from "./GetTelemetryDashboardTimeseriesQueryHandler";
 export { GetWorkflowRunDetailQueryHandler } from "./GetWorkflowRunDetailQueryHandler";
 export { GetWorkflowDebuggerOverlayQueryHandler } from "./GetWorkflowDebuggerOverlayQueryHandler";
 export { GetWorkflowDetailQueryHandler } from "./GetWorkflowDetailQueryHandler";