@codemation/host 0.2.5 → 0.3.0

package/src/infrastructure/persistence/generated/prisma-sqlite-client/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "prisma-client-3f3f000a1859780bac77f597d0546225b8704168f6fd25847c97f9251b13834e",
+  "name": "prisma-client-0beac79a8d446f9e6d9185ba8052b692286e94e537a00cdd7625f560acde6676",
   "main": "index.js",
   "types": "index.d.ts",
   "browser": "default.js",

package/src/infrastructure/persistence/generated/prisma-sqlite-client/schema.prisma

@@ -140,6 +140,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/src/presentation/http/ApiPaths.ts

@@ -13,6 +13,8 @@ export class ApiPaths {
 
   private static readonly usersBasePath = `${this.apiBasePath}/users`;
 
+  private static readonly telemetryBasePath = `${this.apiBasePath}/telemetry`;
+
   private static readonly whitelabelBasePath = `${this.apiBasePath}/whitelabel`;
 
   private static readonly bootstrapBasePath = `${this.apiBasePath}/bootstrap`;
@@ -122,6 +124,26 @@ export class ApiPaths {
     return this.usersBasePath;
   }
 
+  static telemetryDashboardSummary(): string {
+    return `${this.telemetryBasePath}/dashboard/summary`;
+  }
+
+  static telemetryDashboardTimeseries(): string {
+    return `${this.telemetryBasePath}/dashboard/timeseries`;
+  }
+
+  static telemetryDashboardDimensions(): string {
+    return `${this.telemetryBasePath}/dashboard/dimensions`;
+  }
+
+  static telemetryDashboardRuns(): string {
+    return `${this.telemetryBasePath}/dashboard/runs`;
+  }
+
+  static telemetryRunTrace(runId: string): string {
+    return `${this.telemetryBasePath}/runs/${runId}/trace`;
+  }
+
   static authSession(): string {
     return `${this.authBasePath}/session`;
   }

package/src/presentation/http/hono/registrars/TelemetryHonoApiRouteRegistrar.ts

@@ -0,0 +1,19 @@
+import { inject, injectable, registry } from "@codemation/core";
+import { Hono } from "hono";
+import { ApplicationTokens } from "../../../../applicationTokens";
+import { TelemetryHttpRouteHandler } from "../../routeHandlers/TelemetryHttpRouteHandler";
+import type { HonoApiRouteRegistrar } from "../HonoApiRouteRegistrar";
+
+@injectable()
+@registry([{ token: ApplicationTokens.HonoApiRouteRegistrar, useClass: TelemetryHonoApiRouteRegistrar }])
+export class TelemetryHonoApiRouteRegistrar implements HonoApiRouteRegistrar {
+  constructor(@inject(TelemetryHttpRouteHandler) private readonly handler: TelemetryHttpRouteHandler) {}
+
+  register(app: Hono): void {
+    app.get("/telemetry/dashboard/summary", (c) => this.handler.getDashboardSummary(c.req.raw));
+    app.get("/telemetry/dashboard/timeseries", (c) => this.handler.getDashboardTimeseries(c.req.raw));
+    app.get("/telemetry/dashboard/dimensions", (c) => this.handler.getDashboardDimensions(c.req.raw));
+    app.get("/telemetry/dashboard/runs", (c) => this.handler.getDashboardRuns(c.req.raw));
+    app.get("/telemetry/runs/:runId/trace", (c) => this.handler.getRunTrace(c.req.param("runId")));
+  }
+}

package/src/presentation/http/routeHandlers/TelemetryDashboardRequestError.ts

@@ -0,0 +1 @@
+export class TelemetryDashboardRequestError extends Error {}

package/src/presentation/http/routeHandlers/TelemetryHttpRouteHandler.ts

@@ -0,0 +1,181 @@
+import { inject, injectable } from "@codemation/core";
+import type {
+  TelemetryDashboardFiltersDto,
+  TelemetryDashboardRunsRequestDto,
+  TelemetryDashboardTimeseriesRequestDto,
+} from "../../../application/contracts/TelemetryDashboardContracts";
+import type { QueryBus } from "../../../application/bus/QueryBus";
+import { GetTelemetryDashboardDimensionsQuery } from "../../../application/queries/GetTelemetryDashboardDimensionsQuery";
+import { GetTelemetryDashboardRunsQuery } from "../../../application/queries/GetTelemetryDashboardRunsQuery";
+import { GetTelemetryRunTraceQuery } from "../../../application/queries/GetTelemetryRunTraceQuery";
+import { GetTelemetryDashboardSummaryQuery } from "../../../application/queries/GetTelemetryDashboardSummaryQuery";
+import { GetTelemetryDashboardTimeseriesQuery } from "../../../application/queries/GetTelemetryDashboardTimeseriesQuery";
+import { ApplicationTokens } from "../../../applicationTokens";
+import { ServerHttpErrorResponseFactory } from "../ServerHttpErrorResponseFactory";
+import { TelemetryDashboardRequestError } from "./TelemetryDashboardRequestError";
+
+@injectable()
+export class TelemetryHttpRouteHandler {
+  constructor(
+    @inject(ApplicationTokens.QueryBus)
+    private readonly queryBus: QueryBus,
+  ) {}
+
+  async getDashboardSummary(request: Request): Promise<Response> {
+    try {
+      const filters = this.parseFilters(request);
+      return Response.json(await this.queryBus.execute(new GetTelemetryDashboardSummaryQuery(filters)));
+    } catch (error) {
+      if (error instanceof TelemetryDashboardRequestError) {
+        return Response.json({ error: error.message }, { status: 400 });
+      }
+      return ServerHttpErrorResponseFactory.fromUnknown(error);
+    }
+  }
+
+  async getDashboardTimeseries(request: Request): Promise<Response> {
+    try {
+      const parsed = this.parseTimeseriesRequest(request);
+      return Response.json(await this.queryBus.execute(new GetTelemetryDashboardTimeseriesQuery(parsed)));
+    } catch (error) {
+      if (error instanceof TelemetryDashboardRequestError) {
+        return Response.json({ error: error.message }, { status: 400 });
+      }
+      return ServerHttpErrorResponseFactory.fromUnknown(error);
+    }
+  }
+
+  async getDashboardDimensions(request: Request): Promise<Response> {
+    try {
+      const filters = this.parseFilters(request);
+      return Response.json(await this.queryBus.execute(new GetTelemetryDashboardDimensionsQuery(filters)));
+    } catch (error) {
+      if (error instanceof TelemetryDashboardRequestError) {
+        return Response.json({ error: error.message }, { status: 400 });
+      }
+      return ServerHttpErrorResponseFactory.fromUnknown(error);
+    }
+  }
+
+  async getDashboardRuns(request: Request): Promise<Response> {
+    try {
+      const parsed = this.parseRunsRequest(request);
+      return Response.json(await this.queryBus.execute(new GetTelemetryDashboardRunsQuery(parsed)));
+    } catch (error) {
+      if (error instanceof TelemetryDashboardRequestError) {
+        return Response.json({ error: error.message }, { status: 400 });
+      }
+      return ServerHttpErrorResponseFactory.fromUnknown(error);
+    }
+  }
+
+  async getRunTrace(runId: string): Promise<Response> {
+    try {
+      if (!runId.trim()) {
+        throw new TelemetryDashboardRequestError("Run trace request requires a run id.");
+      }
+      return Response.json(await this.queryBus.execute(new GetTelemetryRunTraceQuery(runId)));
+    } catch (error) {
+      if (error instanceof TelemetryDashboardRequestError) {
+        return Response.json({ error: error.message }, { status: 400 });
+      }
+      return ServerHttpErrorResponseFactory.fromUnknown(error);
+    }
+  }
+
+  private parseTimeseriesRequest(request: Request): TelemetryDashboardTimeseriesRequestDto {
+    const url = new URL(request.url);
+    const interval = url.searchParams.get("interval");
+    if (
+      interval !== "minute_5" &&
+      interval !== "minute_15" &&
+      interval !== "hour" &&
+      interval !== "day" &&
+      interval !== "week"
+    ) {
+      throw new TelemetryDashboardRequestError("Query string must include interval=minute_5|minute_15|hour|day|week.");
+    }
+    return {
+      interval,
+      filters: this.parseFilters(request),
+    };
+  }
+
+  private parseRunsRequest(request: Request): TelemetryDashboardRunsRequestDto {
+    const url = new URL(request.url);
+    return {
+      filters: this.parseFilters(request),
+      page: this.readPositiveInt(url, "page", 1),
+      pageSize: this.readPositiveInt(url, "pageSize", 10),
+    };
+  }
+
+  private parseFilters(request: Request): TelemetryDashboardFiltersDto {
+    const url = new URL(request.url);
+    return {
+      workflowIds: this.readMany(url, "workflowId"),
+      statuses: this.readStatuses(url),
+      runOrigins: this.readRunOrigins(url),
+      modelNames: this.readMany(url, "modelName"),
+      startTimeGte: this.readIso(url, "startTimeGte"),
+      endTimeLte: this.readIso(url, "endTimeLte"),
+    };
+  }
+
+  private readMany(url: URL, key: string): ReadonlyArray<string> | undefined {
+    const values = url.searchParams
+      .getAll(key)
+      .map((value) => value.trim())
+      .filter((value) => value.length > 0);
+    return values.length > 0 ? values : undefined;
+  }
+
+  private readStatuses(url: URL): TelemetryDashboardFiltersDto["statuses"] {
+    const values = this.readMany(url, "status");
+    if (!values) {
+      return undefined;
+    }
+    for (const value of values) {
+      if (value !== "running" && value !== "completed" && value !== "failed") {
+        throw new TelemetryDashboardRequestError(`Unsupported telemetry status filter: ${value}`);
+      }
+    }
+    return values as TelemetryDashboardFiltersDto["statuses"];
+  }
+
+  private readRunOrigins(url: URL): TelemetryDashboardFiltersDto["runOrigins"] {
+    const values = this.readMany(url, "runOrigin");
+    if (!values) {
+      return undefined;
+    }
+    for (const value of values) {
+      if (value !== "triggered" && value !== "manual") {
+        throw new TelemetryDashboardRequestError(`Unsupported telemetry run origin filter: ${value}`);
+      }
+    }
+    return values as TelemetryDashboardFiltersDto["runOrigins"];
+  }
+
+  private readIso(url: URL, key: string): string | undefined {
+    const value = url.searchParams.get(key)?.trim();
+    if (!value) {
+      return undefined;
+    }
+    if (Number.isNaN(new Date(value).getTime())) {
+      throw new TelemetryDashboardRequestError(`Invalid ISO timestamp for ${key}.`);
+    }
+    return value;
+  }
+
+  private readPositiveInt(url: URL, key: string, fallback: number): number {
+    const raw = url.searchParams.get(key)?.trim();
+    if (!raw) {
+      return fallback;
+    }
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value <= 0) {
+      throw new TelemetryDashboardRequestError(`${key} must be a positive integer.`);
+    }
+    return value;
+  }
+}