@kopai/api 0.2.3 → 0.4.0

package/dist/index.cjs

@@ -1,4 +1,5 @@
-//#region rolldown:runtime
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -33,12 +34,15 @@ let zod = require("zod");
 zod = __toESM(zod);
 
 //#region src/routes/errors.ts
-var SignalsApiError = class extends Error {
+var ApiError = class extends Error {
 	constructor(message, options) {
 		super(message, options);
 		Object.setPrototypeOf(this, new.target.prototype);
 	}
 };
+var DashboardNotFoundError = class extends ApiError {
+	code = "DASHBOARD_NOT_FOUND";
+};
 
 //#endregion
 //#region src/routes/error-handler.ts
@@ -49,8 +53,17 @@ function errorHandler(error, request, reply) {
 		title: "Invalid data",
 		detail: error.message
 	});
+	if (error instanceof DashboardNotFoundError) {
+		request.log.info(error.message);
+		return reply.status(404).send({
+			type: "https://docs.kopai.app/errors/dashboard-not-found",
+			status: 404,
+			title: "Dashboard not found",
+			detail: error.message
+		});
+	}
 	request.log.error(error);
-	if (error instanceof SignalsApiError) return reply.status(500).send({
+	if (error instanceof ApiError) return reply.status(500).send({
 		type: "https://docs.kopai.app/errors/signals-api-internal-error",
 		status: 500,
 		title: "Internal server error",
@@ -95,7 +108,10 @@ const tracesRoutes = async function(fastify, opts) {
 			}
 		},
 		handler: async (req, res) => {
-			const result = await opts.readTracesDatasource.getTraces({ traceId: req.params.traceId });
+			const result = await opts.readTracesDatasource.getTraces({
+				traceId: req.params.traceId,
+				requestContext: req.requestContext
+			});
 			res.send(result.data);
 		}
 	});
@@ -116,7 +132,10 @@ const tracesRoutes = async function(fastify, opts) {
 			}
 		},
 		handler: async (req, res) => {
-			const result = await opts.readTracesDatasource.getTraces(req.body);
+			const result = await opts.readTracesDatasource.getTraces({
+				...req.body,
+				requestContext: req.requestContext
+			});
 			res.send(result);
 		}
 	});
@@ -142,7 +161,10 @@ const logsRoutes = async function(fastify, opts) {
 			}
 		},
 		handler: async (req, res) => {
-			const result = await opts.readLogsDatasource.getLogs(req.body);
+			const result = await opts.readLogsDatasource.getLogs({
+				...req.body,
+				requestContext: req.requestContext
+			});
 			res.send(result);
 		}
 	});
@@ -168,7 +190,10 @@ const metricsRoutes = async function(fastify, opts) {
 			}
 		},
 		handler: async (req, res) => {
-			const result = await opts.readMetricsDatasource.getMetrics(req.body);
+			const result = await opts.readMetricsDatasource.getMetrics({
+				...req.body,
+				requestContext: req.requestContext
+			});
 			res.send(result);
 		}
 	});
@@ -183,8 +208,8 @@ const metricsRoutes = async function(fastify, opts) {
 				"5xx": problemDetailsSchema
 			}
 		},
-		handler: async (_req, res) => {
-			const result = await opts.readMetricsDatasource.discoverMetrics();
+		handler: async (req, res) => {
+			const result = await opts.readMetricsDatasource.discoverMetrics({ requestContext: req.requestContext });
 			res.send(result);
 		}
 	});
@@ -210,6 +235,102 @@ const discoveredMetricSchema = zod_v4.z.object({
 });
 const metricsDiscoveryResponseSchema = zod_v4.z.object({ metrics: zod_v4.z.array(discoveredMetricSchema) });
 
+//#endregion
+//#region src/routes/dashboards.ts
+const dashboardsRoutes$1 = async function(fastify, opts) {
+	fastify.route({
+		method: "GET",
+		url: "/dashboards/schema",
+		schema: {
+			description: "Get UI tree schema as markdown prompt instructions for AI agents",
+			produces: ["text/markdown"],
+			response: {
+				200: {
+					type: "string",
+					description: "Markdown prompt instructions"
+				},
+				404: {
+					type: "string",
+					description: "Prompt instructions not configured"
+				}
+			}
+		},
+		handler: async (_req, reply) => {
+			if (!opts.promptInstructions) return reply.status(404).send("Dashboard schema not configured");
+			reply.type("text/markdown").send(opts.promptInstructions);
+		}
+	});
+	fastify.route({
+		method: "POST",
+		url: "/dashboards",
+		schema: {
+			description: "Create a dashboard containing a uiTree",
+			body: _kopai_core.dashboardDatasource.createDashboardParams,
+			response: {
+				201: _kopai_core.dashboardDatasource.dashboardSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.dynamicDashboardDatasource.createDashboard({
+				...req.body,
+				requestContext: req.requestContext
+			});
+			res.status(201).send(result);
+		}
+	});
+	fastify.route({
+		method: "GET",
+		url: "/dashboards/:dashboardId",
+		schema: {
+			description: "Get a dashboard containing a uiTree to be rendered",
+			params: zod_v4.z.object({ dashboardId: zod_v4.z.string() }),
+			response: {
+				200: _kopai_core.dashboardDatasource.dashboardSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			try {
+				const result = await opts.dynamicDashboardDatasource.getDashboard({
+					id: req.params.dashboardId,
+					requestContext: req.requestContext
+				});
+				res.send(result);
+			} catch (error) {
+				if ((error instanceof Error ? error.message.toLowerCase() : "").includes("not found")) throw new DashboardNotFoundError(`Dashboard not found: ${req.params.dashboardId}`, { cause: error });
+				throw error;
+			}
+		}
+	});
+	const searchResponseSchema = zod_v4.z.object({
+		data: zod_v4.z.array(_kopai_core.dashboardDatasource.dashboardSchema),
+		nextCursor: zod_v4.z.string().nullable()
+	});
+	fastify.route({
+		method: "POST",
+		url: "/dashboards/search",
+		schema: {
+			description: "Search dashboards matching a filter",
+			body: _kopai_core.dashboardDatasource.searchDashboardsFilter,
+			response: {
+				200: searchResponseSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.dynamicDashboardDatasource.searchDashboards({
+				...req.body,
+				requestContext: req.requestContext
+			});
+			res.send(result);
+		}
+	});
+};
+
 //#endregion
 //#region src/index.ts
 const signalsRoutes = async function(fastify, opts) {
@@ -220,6 +341,16 @@ const signalsRoutes = async function(fastify, opts) {
 	fastify.register(logsRoutes, { readLogsDatasource: opts.readTelemetryDatasource });
 	fastify.register(metricsRoutes, { readMetricsDatasource: opts.readTelemetryDatasource });
 };
+const dashboardsRoutes = async function(fastify, opts) {
+	fastify.setValidatorCompiler(fastify_type_provider_zod.validatorCompiler);
+	fastify.setSerializerCompiler(fastify_type_provider_zod.serializerCompiler);
+	fastify.setErrorHandler(errorHandler);
+	fastify.register(dashboardsRoutes$1, {
+		dynamicDashboardDatasource: opts.dynamicDashboardDatasource,
+		promptInstructions: opts.promptInstructions
+	});
+};
 
 //#endregion
+exports.dashboardsRoutes = dashboardsRoutes;
 exports.signalsRoutes = signalsRoutes;

package/dist/index.d.cts

@@ -1,10 +1,19 @@
 import { FastifyPluginAsyncZod } from "fastify-type-provider-zod";
-import { datasource } from "@kopai/core";
+import { dashboardDatasource, datasource } from "@kopai/core";
 
 //#region src/index.d.ts
 declare const signalsRoutes: FastifyPluginAsyncZod<{
   readTelemetryDatasource: datasource.ReadTelemetryDatasource;
 }>;
+declare const dashboardsRoutes: FastifyPluginAsyncZod<{
+  dynamicDashboardDatasource: dashboardDatasource.DynamicDashboardDatasource;
+  promptInstructions?: string;
+}>;
+declare module "fastify" {
+  interface FastifyRequest {
+    requestContext?: unknown;
+  }
+} //# sourceMappingURL=index.d.ts.map
 //#endregion
-export { signalsRoutes };
+export { dashboardsRoutes, signalsRoutes };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;cAWa,aAAA,EAAe,qBAAA;EAC1B,uBAAA,EAAyB,UAAA,CAAW,uBAAA;AAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;cAaa,aAAA,EAAe,qBAAA;EAC1B,uBAAA,EAAyB,UAAA,CAAW,uBAAA;AAAA;AAAA,cAmBzB,gBAAA,EAAkB,qBAAA;EAC7B,0BAAA,EAA4B,mBAAA,CAAoB,0BAAA;EAChD,kBAAA;AAAA;AAAA;EAAA,UAaU,cAAA;IACR,cAAA;EAAA;AAAA"}

package/dist/index.d.mts

@@ -1,10 +1,19 @@
-import { datasource } from "@kopai/core";
+import { dashboardDatasource, datasource } from "@kopai/core";
 import { FastifyPluginAsyncZod } from "fastify-type-provider-zod";
 
 //#region src/index.d.ts
 declare const signalsRoutes: FastifyPluginAsyncZod<{
   readTelemetryDatasource: datasource.ReadTelemetryDatasource;
 }>;
+declare const dashboardsRoutes: FastifyPluginAsyncZod<{
+  dynamicDashboardDatasource: dashboardDatasource.DynamicDashboardDatasource;
+  promptInstructions?: string;
+}>;
+declare module "fastify" {
+  interface FastifyRequest {
+    requestContext?: unknown;
+  }
+} //# sourceMappingURL=index.d.ts.map
 //#endregion
-export { signalsRoutes };
+export { dashboardsRoutes, signalsRoutes };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;cAWa,aAAA,EAAe,qBAAA;EAC1B,uBAAA,EAAyB,UAAA,CAAW,uBAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;cAaa,aAAA,EAAe,qBAAA;EAC1B,uBAAA,EAAyB,UAAA,CAAW,uBAAA;AAAA;AAAA,cAmBzB,gBAAA,EAAkB,qBAAA;EAC7B,0BAAA,EAA4B,mBAAA,CAAoB,0BAAA;EAChD,kBAAA;AAAA;AAAA;EAAA,UAaU,cAAA;IACR,cAAA;EAAA;AAAA"}

package/dist/index.mjs

@@ -1,16 +1,19 @@
-import { dataFilterSchemas, denormalizedSignals } from "@kopai/core";
+import { dashboardDatasource, dataFilterSchemas, denormalizedSignals } from "@kopai/core";
 import { serializerCompiler, validatorCompiler } from "fastify-type-provider-zod";
 import "fastify";
 import { z } from "zod/v4";
 import z$1 from "zod";
 
 //#region src/routes/errors.ts
-var SignalsApiError = class extends Error {
+var ApiError = class extends Error {
 	constructor(message, options) {
 		super(message, options);
 		Object.setPrototypeOf(this, new.target.prototype);
 	}
 };
+var DashboardNotFoundError = class extends ApiError {
+	code = "DASHBOARD_NOT_FOUND";
+};
 
 //#endregion
 //#region src/routes/error-handler.ts
@@ -21,8 +24,17 @@ function errorHandler(error, request, reply) {
 		title: "Invalid data",
 		detail: error.message
 	});
+	if (error instanceof DashboardNotFoundError) {
+		request.log.info(error.message);
+		return reply.status(404).send({
+			type: "https://docs.kopai.app/errors/dashboard-not-found",
+			status: 404,
+			title: "Dashboard not found",
+			detail: error.message
+		});
+	}
 	request.log.error(error);
-	if (error instanceof SignalsApiError) return reply.status(500).send({
+	if (error instanceof ApiError) return reply.status(500).send({
 		type: "https://docs.kopai.app/errors/signals-api-internal-error",
 		status: 500,
 		title: "Internal server error",
@@ -67,7 +79,10 @@ const tracesRoutes = async function(fastify, opts) {
 			}
 		},
 		handler: async (req, res) => {
-			const result = await opts.readTracesDatasource.getTraces({ traceId: req.params.traceId });
+			const result = await opts.readTracesDatasource.getTraces({
+				traceId: req.params.traceId,
+				requestContext: req.requestContext
+			});
 			res.send(result.data);
 		}
 	});
@@ -88,7 +103,10 @@ const tracesRoutes = async function(fastify, opts) {
 			}
 		},
 		handler: async (req, res) => {
-			const result = await opts.readTracesDatasource.getTraces(req.body);
+			const result = await opts.readTracesDatasource.getTraces({
+				...req.body,
+				requestContext: req.requestContext
+			});
 			res.send(result);
 		}
 	});
@@ -114,7 +132,10 @@ const logsRoutes = async function(fastify, opts) {
 			}
 		},
 		handler: async (req, res) => {
-			const result = await opts.readLogsDatasource.getLogs(req.body);
+			const result = await opts.readLogsDatasource.getLogs({
+				...req.body,
+				requestContext: req.requestContext
+			});
 			res.send(result);
 		}
 	});
@@ -140,7 +161,10 @@ const metricsRoutes = async function(fastify, opts) {
 			}
 		},
 		handler: async (req, res) => {
-			const result = await opts.readMetricsDatasource.getMetrics(req.body);
+			const result = await opts.readMetricsDatasource.getMetrics({
+				...req.body,
+				requestContext: req.requestContext
+			});
 			res.send(result);
 		}
 	});
@@ -155,8 +179,8 @@ const metricsRoutes = async function(fastify, opts) {
 				"5xx": problemDetailsSchema
 			}
 		},
-		handler: async (_req, res) => {
-			const result = await opts.readMetricsDatasource.discoverMetrics();
+		handler: async (req, res) => {
+			const result = await opts.readMetricsDatasource.discoverMetrics({ requestContext: req.requestContext });
 			res.send(result);
 		}
 	});
@@ -182,6 +206,102 @@ const discoveredMetricSchema = z.object({
 });
 const metricsDiscoveryResponseSchema = z.object({ metrics: z.array(discoveredMetricSchema) });
 
+//#endregion
+//#region src/routes/dashboards.ts
+const dashboardsRoutes$1 = async function(fastify, opts) {
+	fastify.route({
+		method: "GET",
+		url: "/dashboards/schema",
+		schema: {
+			description: "Get UI tree schema as markdown prompt instructions for AI agents",
+			produces: ["text/markdown"],
+			response: {
+				200: {
+					type: "string",
+					description: "Markdown prompt instructions"
+				},
+				404: {
+					type: "string",
+					description: "Prompt instructions not configured"
+				}
+			}
+		},
+		handler: async (_req, reply) => {
+			if (!opts.promptInstructions) return reply.status(404).send("Dashboard schema not configured");
+			reply.type("text/markdown").send(opts.promptInstructions);
+		}
+	});
+	fastify.route({
+		method: "POST",
+		url: "/dashboards",
+		schema: {
+			description: "Create a dashboard containing a uiTree",
+			body: dashboardDatasource.createDashboardParams,
+			response: {
+				201: dashboardDatasource.dashboardSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.dynamicDashboardDatasource.createDashboard({
+				...req.body,
+				requestContext: req.requestContext
+			});
+			res.status(201).send(result);
+		}
+	});
+	fastify.route({
+		method: "GET",
+		url: "/dashboards/:dashboardId",
+		schema: {
+			description: "Get a dashboard containing a uiTree to be rendered",
+			params: z.object({ dashboardId: z.string() }),
+			response: {
+				200: dashboardDatasource.dashboardSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			try {
+				const result = await opts.dynamicDashboardDatasource.getDashboard({
+					id: req.params.dashboardId,
+					requestContext: req.requestContext
+				});
+				res.send(result);
+			} catch (error) {
+				if ((error instanceof Error ? error.message.toLowerCase() : "").includes("not found")) throw new DashboardNotFoundError(`Dashboard not found: ${req.params.dashboardId}`, { cause: error });
+				throw error;
+			}
+		}
+	});
+	const searchResponseSchema = z.object({
+		data: z.array(dashboardDatasource.dashboardSchema),
+		nextCursor: z.string().nullable()
+	});
+	fastify.route({
+		method: "POST",
+		url: "/dashboards/search",
+		schema: {
+			description: "Search dashboards matching a filter",
+			body: dashboardDatasource.searchDashboardsFilter,
+			response: {
+				200: searchResponseSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.dynamicDashboardDatasource.searchDashboards({
+				...req.body,
+				requestContext: req.requestContext
+			});
+			res.send(result);
+		}
+	});
+};
+
 //#endregion
 //#region src/index.ts
 const signalsRoutes = async function(fastify, opts) {
@@ -192,7 +312,16 @@ const signalsRoutes = async function(fastify, opts) {
 	fastify.register(logsRoutes, { readLogsDatasource: opts.readTelemetryDatasource });
 	fastify.register(metricsRoutes, { readMetricsDatasource: opts.readTelemetryDatasource });
 };
+const dashboardsRoutes = async function(fastify, opts) {
+	fastify.setValidatorCompiler(validatorCompiler);
+	fastify.setSerializerCompiler(serializerCompiler);
+	fastify.setErrorHandler(errorHandler);
+	fastify.register(dashboardsRoutes$1, {
+		dynamicDashboardDatasource: opts.dynamicDashboardDatasource,
+		promptInstructions: opts.promptInstructions
+	});
+};
 
 //#endregion
-export { signalsRoutes };
+export { dashboardsRoutes, signalsRoutes };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["z"],"sources":["../src/routes/errors.ts","../src/routes/error-handler.ts","../src/routes/error-schema-zod.ts","../src/routes/traces.ts","../src/routes/logs.ts","../src/routes/metrics.ts","../src/index.ts"],"sourcesContent":["export abstract class SignalsApiError extends Error {\n  abstract readonly code: string;\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import {\n  type FastifyError,\n  type FastifyReply,\n  type FastifyRequest,\n} from \"fastify\";\nimport { SignalsApiError } from \"./errors.js\";\nimport type { SignalsApiErrorResponse } from \"./error-schema-zod.js\";\nexport function errorHandler(\n  error: FastifyError | Error | string,\n  request: FastifyRequest,\n  reply: FastifyReply\n) {\n  if (isClientError(error)) {\n    return reply.status(400).send({\n      // https://datatracker.ietf.org/doc/html/rfc9457\n      //      HTTP/1.1 422 Unprocessable Content\n      //      Content-Type: application/problem+json\n      //      Content-Language: en\n      //\n      //      {\n      //       \"type\": \"https://example.net/validation-error\",\n      //       \"title\": \"Your request is not valid.\",\n      //       \"errors\": [\n      //                   {\n      //                     \"detail\": \"must be a positive integer\",\n      //                     \"pointer\": \"#/age\"\n      //                   },\n      //                   {\n      //                     \"detail\": \"must be 'green', 'red' or 'blue'\",\n      //                     \"pointer\": \"#/profile/color\"\n      //                   }\n      //                ]\n      //      }\n      type: \"https://docs.kopai.app/errors/signals-api-validation-error\", // TODO: document error\n      status: 400,\n      title: \"Invalid data\",\n      detail: error.message,\n    } satisfies SignalsApiErrorResponse);\n  }\n\n  request.log.error(error);\n  if (error instanceof SignalsApiError) {\n    return reply.status(500).send({\n      type: \"https://docs.kopai.app/errors/signals-api-internal-error\", // TODO: document error\n      status: 500,\n      title: \"Internal server error\",\n      detail: error.message,\n    } satisfies SignalsApiErrorResponse);\n  }\n\n  return reply.status(500).send({\n    type: \"https://docs.kopai.app/errors/signals-api-internal-error\", // TODO: document error\n    status: 500,\n    title: \"Internal server error\",\n  } satisfies SignalsApiErrorResponse);\n}\n\nfunction isFastifyError(error: unknown): error is FastifyError {\n  return (\n    error instanceof Error &&\n    \"code\" in error &&\n    typeof (error as FastifyError).code === \"string\"\n  );\n}\n\nfunction isClientError(error: unknown): error is FastifyError {\n  return (\n    isFastifyError(error) &&\n    typeof error.statusCode === \"number\" &&\n    error.statusCode >= 400 &&\n    error.statusCode < 500\n  );\n}\n","import z from \"zod\";\n\nexport const problemDetailsSchema = z.object({\n  type: z\n    .url()\n    .default(\"about:blank\")\n    .describe(\"URI reference identifying the problem type\"),\n  status: z\n    .number()\n    .int()\n    .min(100)\n    .max(599)\n    .optional()\n    .describe(\"HTTP status code generated by the origin server\"),\n  title: z\n    .string()\n    .optional()\n    .describe(\"Short human-readable summary of the problem type\"),\n  detail: z\n    .string()\n    .optional()\n    .describe(\"Human-readable explanation specific to this occurrence\"),\n  instance: z\n    .string()\n    .optional()\n    .describe(\"URI reference identifying this specific occurrence\"),\n});\n\nexport type SignalsApiErrorResponse = z.infer<typeof problemDetailsSchema>;\n","import { z } from \"zod/v4\";\nimport type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport {\n  dataFilterSchemas,\n  denormalizedSignals,\n  type datasource,\n} from \"@kopai/core\";\nimport { problemDetailsSchema } from \"./error-schema-zod.js\";\n\nexport const tracesRoutes: FastifyPluginAsyncZod<{\n  readTracesDatasource: datasource.ReadTracesDatasource;\n}> = async function (fastify, opts) {\n  fastify.route({\n    method: \"GET\",\n    url: \"/signals/traces/:traceId\",\n    schema: {\n      description: \"Get all spans for a trace by traceId\",\n      params: z.object({\n        traceId: z.string().describe(\"A TraceId of the trace\"),\n      }),\n      response: {\n        200: z.array(denormalizedSignals.otelTracesSchema),\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readTracesDatasource.getTraces({\n        traceId: req.params.traceId,\n      });\n      res.send(result.data);\n    },\n  });\n\n  const searchResponseSchema = z.object({\n    data: z.array(denormalizedSignals.otelTracesSchema),\n    nextCursor: z.string().nullable(),\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/signals/traces/search\",\n    schema: {\n      description: \"Search spans matching a filter\",\n      body: dataFilterSchemas.tracesDataFilterSchema,\n      response: {\n        200: searchResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readTracesDatasource.getTraces(req.body);\n      res.send(result);\n    },\n  });\n};\n","import { z } from \"zod/v4\";\nimport type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport {\n  dataFilterSchemas,\n  denormalizedSignals,\n  type datasource,\n} from \"@kopai/core\";\nimport { problemDetailsSchema } from \"./error-schema-zod.js\";\n\nexport const logsRoutes: FastifyPluginAsyncZod<{\n  readLogsDatasource: datasource.ReadLogsDatasource;\n}> = async function (fastify, opts) {\n  const searchResponseSchema = z.object({\n    data: z.array(denormalizedSignals.otelLogsSchema),\n    nextCursor: z.string().nullable(),\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/signals/logs/search\",\n    schema: {\n      description: \"Search logs matching a filter\",\n      body: dataFilterSchemas.logsDataFilterSchema,\n      response: {\n        200: searchResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readLogsDatasource.getLogs(req.body);\n      res.send(result);\n    },\n  });\n};\n","import { z } from \"zod/v4\";\nimport type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport {\n  dataFilterSchemas,\n  denormalizedSignals,\n  type datasource,\n} from \"@kopai/core\";\nimport { problemDetailsSchema } from \"./error-schema-zod.js\";\n\nexport const metricsRoutes: FastifyPluginAsyncZod<{\n  readMetricsDatasource: datasource.ReadMetricsDatasource;\n}> = async function (fastify, opts) {\n  const searchResponseSchema = z.object({\n    data: z.array(denormalizedSignals.otelMetricsSchema),\n    nextCursor: z.string().nullable(),\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/signals/metrics/search\",\n    schema: {\n      description: \"Search metrics matching a filter\",\n      body: dataFilterSchemas.metricsDataFilterSchema,\n      response: {\n        200: searchResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readMetricsDatasource.getMetrics(req.body);\n      res.send(result);\n    },\n  });\n\n  fastify.route({\n    method: \"GET\",\n    url: \"/signals/metrics/discover\",\n    schema: {\n      description: \"Discover available metrics and their attributes\",\n      response: {\n        200: metricsDiscoveryResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (_req, res) => {\n      const result = await opts.readMetricsDatasource.discoverMetrics();\n      res.send(result);\n    },\n  });\n};\n\nconst metricTypeSchema = z.enum([\n  \"Gauge\",\n  \"Sum\",\n  \"Histogram\",\n  \"ExponentialHistogram\",\n  \"Summary\",\n]);\n\nconst discoveredAttributesSchema = z.object({\n  values: z\n    .record(z.string(), z.array(z.string()))\n    .describe(\"Attribute key/value pairs. Max 100 values per key.\"),\n  _truncated: z\n    .boolean()\n    .optional()\n    .describe(\"True if any attribute key exceeded 100 values.\"),\n});\n\nconst discoveredMetricSchema = z.object({\n  name: z.string().describe(\"Metric name from MetricName field.\"),\n  type: metricTypeSchema.describe(\n    \"Metric type: Gauge, Sum, Histogram, ExponentialHistogram, or Summary.\"\n  ),\n  unit: z.string().optional().describe(\"Metric unit from MetricUnit field.\"),\n  description: z\n    .string()\n    .optional()\n    .describe(\"Metric description from MetricDescription field.\"),\n  attributes: discoveredAttributesSchema.describe(\n    \"Data point attributes aggregated across all data points.\"\n  ),\n  resourceAttributes: discoveredAttributesSchema.describe(\n    \"Resource attributes aggregated across all data points.\"\n  ),\n});\n\nconst metricsDiscoveryResponseSchema = z.object({\n  metrics: z.array(discoveredMetricSchema),\n});\n","import type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport { type datasource } from \"@kopai/core\";\nimport {\n  serializerCompiler,\n  validatorCompiler,\n} from \"fastify-type-provider-zod\";\nimport { errorHandler } from \"./routes/error-handler.js\";\nimport { tracesRoutes } from \"./routes/traces.js\";\nimport { logsRoutes } from \"./routes/logs.js\";\nimport { metricsRoutes } from \"./routes/metrics.js\";\n\nexport const signalsRoutes: FastifyPluginAsyncZod<{\n  readTelemetryDatasource: datasource.ReadTelemetryDatasource;\n}> = async function (fastify, opts) {\n  fastify.setValidatorCompiler(validatorCompiler);\n  fastify.setSerializerCompiler(serializerCompiler);\n  fastify.setErrorHandler(errorHandler);\n\n  fastify.register(tracesRoutes, {\n    readTracesDatasource: opts.readTelemetryDatasource,\n  });\n\n  fastify.register(logsRoutes, {\n    readLogsDatasource: opts.readTelemetryDatasource,\n  });\n\n  fastify.register(metricsRoutes, {\n    readMetricsDatasource: opts.readTelemetryDatasource,\n  });\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["z","dashboardsRoutes","_dashboardsRoutes"],"sources":["../src/routes/errors.ts","../src/routes/error-handler.ts","../src/routes/error-schema-zod.ts","../src/routes/traces.ts","../src/routes/logs.ts","../src/routes/metrics.ts","../src/routes/dashboards.ts","../src/index.ts"],"sourcesContent":["export abstract class ApiError extends Error {\n  abstract readonly code: string;\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport abstract class SignalsApiError extends ApiError {}\n\nexport class DashboardNotFoundError extends ApiError {\n  readonly code = \"DASHBOARD_NOT_FOUND\";\n}\n","import {\n  type FastifyError,\n  type FastifyReply,\n  type FastifyRequest,\n} from \"fastify\";\nimport { ApiError, DashboardNotFoundError } from \"./errors.js\";\nimport type { ApiErrorResponse } from \"./error-schema-zod.js\";\nexport function errorHandler(\n  error: FastifyError | Error | string,\n  request: FastifyRequest,\n  reply: FastifyReply\n) {\n  if (isClientError(error)) {\n    return reply.status(400).send({\n      // https://datatracker.ietf.org/doc/html/rfc9457\n      //      HTTP/1.1 422 Unprocessable Content\n      //      Content-Type: application/problem+json\n      //      Content-Language: en\n      //\n      //      {\n      //       \"type\": \"https://example.net/validation-error\",\n      //       \"title\": \"Your request is not valid.\",\n      //       \"errors\": [\n      //                   {\n      //                     \"detail\": \"must be a positive integer\",\n      //                     \"pointer\": \"#/age\"\n      //                   },\n      //                   {\n      //                     \"detail\": \"must be 'green', 'red' or 'blue'\",\n      //                     \"pointer\": \"#/profile/color\"\n      //                   }\n      //                ]\n      //      }\n      type: \"https://docs.kopai.app/errors/signals-api-validation-error\", // TODO: document error\n      status: 400,\n      title: \"Invalid data\",\n      detail: error.message,\n    } satisfies ApiErrorResponse);\n  }\n\n  if (error instanceof DashboardNotFoundError) {\n    request.log.info(error.message);\n    return reply.status(404).send({\n      type: \"https://docs.kopai.app/errors/dashboard-not-found\",\n      status: 404,\n      title: \"Dashboard not found\",\n      detail: error.message,\n    } satisfies ApiErrorResponse);\n  }\n  request.log.error(error);\n  if (error instanceof ApiError) {\n    return reply.status(500).send({\n      type: \"https://docs.kopai.app/errors/signals-api-internal-error\", // TODO: document error\n      status: 500,\n      title: \"Internal server error\",\n      detail: error.message,\n    } satisfies ApiErrorResponse);\n  }\n\n  return reply.status(500).send({\n    type: \"https://docs.kopai.app/errors/signals-api-internal-error\", // TODO: document error\n    status: 500,\n    title: \"Internal server error\",\n  } satisfies ApiErrorResponse);\n}\n\nfunction isFastifyError(error: unknown): error is FastifyError {\n  return (\n    error instanceof Error &&\n    \"code\" in error &&\n    typeof (error as FastifyError).code === \"string\"\n  );\n}\n\nfunction isClientError(error: unknown): error is FastifyError {\n  return (\n    isFastifyError(error) &&\n    typeof error.statusCode === \"number\" &&\n    error.statusCode >= 400 &&\n    error.statusCode < 500\n  );\n}\n","import z from \"zod\";\n\nexport const problemDetailsSchema = z.object({\n  type: z\n    .url()\n    .default(\"about:blank\")\n    .describe(\"URI reference identifying the problem type\"),\n  status: z\n    .number()\n    .int()\n    .min(100)\n    .max(599)\n    .optional()\n    .describe(\"HTTP status code generated by the origin server\"),\n  title: z\n    .string()\n    .optional()\n    .describe(\"Short human-readable summary of the problem type\"),\n  detail: z\n    .string()\n    .optional()\n    .describe(\"Human-readable explanation specific to this occurrence\"),\n  instance: z\n    .string()\n    .optional()\n    .describe(\"URI reference identifying this specific occurrence\"),\n});\n\nexport type ApiErrorResponse = z.infer<typeof problemDetailsSchema>;\n","import { z } from \"zod/v4\";\nimport type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport {\n  dataFilterSchemas,\n  denormalizedSignals,\n  type datasource,\n} from \"@kopai/core\";\nimport { problemDetailsSchema } from \"./error-schema-zod.js\";\n\nexport const tracesRoutes: FastifyPluginAsyncZod<{\n  readTracesDatasource: datasource.ReadTracesDatasource;\n}> = async function (fastify, opts) {\n  fastify.route({\n    method: \"GET\",\n    url: \"/signals/traces/:traceId\",\n    schema: {\n      description: \"Get all spans for a trace by traceId\",\n      params: z.object({\n        traceId: z.string().describe(\"A TraceId of the trace\"),\n      }),\n      response: {\n        200: z.array(denormalizedSignals.otelTracesSchema),\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readTracesDatasource.getTraces({\n        traceId: req.params.traceId,\n        requestContext: req.requestContext,\n      });\n      res.send(result.data);\n    },\n  });\n\n  const searchResponseSchema = z.object({\n    data: z.array(denormalizedSignals.otelTracesSchema),\n    nextCursor: z.string().nullable(),\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/signals/traces/search\",\n    schema: {\n      description: \"Search spans matching a filter\",\n      body: dataFilterSchemas.tracesDataFilterSchema,\n      response: {\n        200: searchResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readTracesDatasource.getTraces({\n        ...req.body,\n        requestContext: req.requestContext,\n      });\n      res.send(result);\n    },\n  });\n};\n","import { z } from \"zod/v4\";\nimport type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport {\n  dataFilterSchemas,\n  denormalizedSignals,\n  type datasource,\n} from \"@kopai/core\";\nimport { problemDetailsSchema } from \"./error-schema-zod.js\";\n\nexport const logsRoutes: FastifyPluginAsyncZod<{\n  readLogsDatasource: datasource.ReadLogsDatasource;\n}> = async function (fastify, opts) {\n  const searchResponseSchema = z.object({\n    data: z.array(denormalizedSignals.otelLogsSchema),\n    nextCursor: z.string().nullable(),\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/signals/logs/search\",\n    schema: {\n      description: \"Search logs matching a filter\",\n      body: dataFilterSchemas.logsDataFilterSchema,\n      response: {\n        200: searchResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readLogsDatasource.getLogs({\n        ...req.body,\n        requestContext: req.requestContext,\n      });\n      res.send(result);\n    },\n  });\n};\n","import { z } from \"zod/v4\";\nimport type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport {\n  dataFilterSchemas,\n  denormalizedSignals,\n  type datasource,\n} from \"@kopai/core\";\nimport { problemDetailsSchema } from \"./error-schema-zod.js\";\n\nexport const metricsRoutes: FastifyPluginAsyncZod<{\n  readMetricsDatasource: datasource.ReadMetricsDatasource;\n}> = async function (fastify, opts) {\n  const searchResponseSchema = z.object({\n    data: z.array(denormalizedSignals.otelMetricsSchema),\n    nextCursor: z.string().nullable(),\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/signals/metrics/search\",\n    schema: {\n      description: \"Search metrics matching a filter\",\n      body: dataFilterSchemas.metricsDataFilterSchema,\n      response: {\n        200: searchResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readMetricsDatasource.getMetrics({\n        ...req.body,\n        requestContext: req.requestContext,\n      });\n      res.send(result);\n    },\n  });\n\n  fastify.route({\n    method: \"GET\",\n    url: \"/signals/metrics/discover\",\n    schema: {\n      description: \"Discover available metrics and their attributes\",\n      response: {\n        200: metricsDiscoveryResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readMetricsDatasource.discoverMetrics({\n        requestContext: req.requestContext,\n      });\n      res.send(result);\n    },\n  });\n};\n\nconst metricTypeSchema = z.enum([\n  \"Gauge\",\n  \"Sum\",\n  \"Histogram\",\n  \"ExponentialHistogram\",\n  \"Summary\",\n]);\n\nconst discoveredAttributesSchema = z.object({\n  values: z\n    .record(z.string(), z.array(z.string()))\n    .describe(\"Attribute key/value pairs. Max 100 values per key.\"),\n  _truncated: z\n    .boolean()\n    .optional()\n    .describe(\"True if any attribute key exceeded 100 values.\"),\n});\n\nconst discoveredMetricSchema = z.object({\n  name: z.string().describe(\"Metric name from MetricName field.\"),\n  type: metricTypeSchema.describe(\n    \"Metric type: Gauge, Sum, Histogram, ExponentialHistogram, or Summary.\"\n  ),\n  unit: z.string().optional().describe(\"Metric unit from MetricUnit field.\"),\n  description: z\n    .string()\n    .optional()\n    .describe(\"Metric description from MetricDescription field.\"),\n  attributes: discoveredAttributesSchema.describe(\n    \"Data point attributes aggregated across all data points.\"\n  ),\n  resourceAttributes: discoveredAttributesSchema.describe(\n    \"Resource attributes aggregated across all data points.\"\n  ),\n});\n\nconst metricsDiscoveryResponseSchema = z.object({\n  metrics: z.array(discoveredMetricSchema),\n});\n","import { z } from \"zod/v4\";\nimport type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport { dashboardDatasource } from \"@kopai/core\";\nimport { problemDetailsSchema } from \"./error-schema-zod.js\";\nimport { DashboardNotFoundError } from \"./errors.js\";\n\nexport const dashboardsRoutes: FastifyPluginAsyncZod<{\n  dynamicDashboardDatasource: dashboardDatasource.DynamicDashboardDatasource;\n  promptInstructions?: string;\n}> = async function (fastify, opts) {\n  fastify.route({\n    method: \"GET\",\n    url: \"/dashboards/schema\",\n    schema: {\n      description:\n        \"Get UI tree schema as markdown prompt instructions for AI agents\",\n      produces: [\"text/markdown\"],\n      response: {\n        200: { type: \"string\", description: \"Markdown prompt instructions\" },\n        404: {\n          type: \"string\",\n          description: \"Prompt instructions not configured\",\n        },\n      },\n    },\n    handler: async (_req, reply) => {\n      if (!opts.promptInstructions) {\n        return reply.status(404).send(\"Dashboard schema not configured\");\n      }\n      reply.type(\"text/markdown\").send(opts.promptInstructions);\n    },\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/dashboards\",\n    schema: {\n      description: \"Create a dashboard containing a uiTree\",\n      body: dashboardDatasource.createDashboardParams,\n      response: {\n        201: dashboardDatasource.dashboardSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.dynamicDashboardDatasource.createDashboard({\n        ...req.body,\n        requestContext: req.requestContext,\n      });\n      res.status(201).send(result);\n    },\n  });\n\n  fastify.route({\n    method: \"GET\",\n    url: \"/dashboards/:dashboardId\",\n    schema: {\n      description: \"Get a dashboard containing a uiTree to be rendered\",\n      params: z.object({\n        dashboardId: z.string(),\n      }),\n      response: {\n        200: dashboardDatasource.dashboardSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      try {\n        const result = await opts.dynamicDashboardDatasource.getDashboard({\n          id: req.params.dashboardId,\n          requestContext: req.requestContext,\n        });\n        res.send(result);\n      } catch (error) {\n        const msg = error instanceof Error ? error.message.toLowerCase() : \"\";\n        if (msg.includes(\"not found\")) {\n          throw new DashboardNotFoundError(\n            `Dashboard not found: ${req.params.dashboardId}`,\n            { cause: error }\n          );\n        }\n        throw error;\n      }\n    },\n  });\n\n  const searchResponseSchema = z.object({\n    data: z.array(dashboardDatasource.dashboardSchema),\n    nextCursor: z.string().nullable(),\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/dashboards/search\",\n    schema: {\n      description: \"Search dashboards matching a filter\",\n      body: dashboardDatasource.searchDashboardsFilter,\n      response: {\n        200: searchResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.dynamicDashboardDatasource.searchDashboards({\n        ...req.body,\n        requestContext: req.requestContext,\n      });\n      res.send(result);\n    },\n  });\n};\n","import type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport { type datasource, type dashboardDatasource } from \"@kopai/core\";\n\nimport {\n  serializerCompiler,\n  validatorCompiler,\n} from \"fastify-type-provider-zod\";\nimport { errorHandler } from \"./routes/error-handler.js\";\nimport { tracesRoutes } from \"./routes/traces.js\";\nimport { logsRoutes } from \"./routes/logs.js\";\nimport { metricsRoutes } from \"./routes/metrics.js\";\nimport { dashboardsRoutes as _dashboardsRoutes } from \"./routes/dashboards.js\";\n\nexport const signalsRoutes: FastifyPluginAsyncZod<{\n  readTelemetryDatasource: datasource.ReadTelemetryDatasource;\n}> = async function (fastify, opts) {\n  fastify.setValidatorCompiler(validatorCompiler);\n  fastify.setSerializerCompiler(serializerCompiler);\n  fastify.setErrorHandler(errorHandler);\n\n  fastify.register(tracesRoutes, {\n    readTracesDatasource: opts.readTelemetryDatasource,\n  });\n\n  fastify.register(logsRoutes, {\n    readLogsDatasource: opts.readTelemetryDatasource,\n  });\n\n  fastify.register(metricsRoutes, {\n    readMetricsDatasource: opts.readTelemetryDatasource,\n  });\n};\n\nexport const dashboardsRoutes: FastifyPluginAsyncZod<{\n  dynamicDashboardDatasource: dashboardDatasource.DynamicDashboardDatasource;\n  promptInstructions?: string;\n}> = async function (fastify, opts) {\n  fastify.setValidatorCompiler(validatorCompiler);\n  fastify.setSerializerCompiler(serializerCompiler);\n  fastify.setErrorHandler(errorHandler);\n\n  fastify.register(_dashboardsRoutes, {\n    dynamicDashboardDatasource: opts.dynamicDashboardDatasource,\n    promptInstructions: opts.promptInstructions,\n  });\n};\n\ndeclare module \"fastify\" {\n  interface FastifyRequest {\n    requestContext?: unknown;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kopai/api",
-  "version": "0.2.3",
+  "version": "0.4.0",
   "license": "Apache-2.0",
   "author": "Vladimir Adamic",
   "repository": {
@@ -27,17 +27,17 @@
     "dist"
   ],
   "peerDependencies": {
-    "fastify": "^5.0.0",
+    "fastify": "^5.7.4",
     "zod": "^4.0.0"
   },
   "dependencies": {
     "fastify-type-provider-zod": "^6.1.0",
-    "@kopai/core": "0.5.0"
+    "@kopai/core": "0.7.0"
   },
   "devDependencies": {
-    "@fastify/swagger": "^9.6.1",
+    "@fastify/swagger": "^9.7.0",
     "@fastify/swagger-ui": "^5.2.5",
-    "tsdown": "^0.20.1",
+    "tsdown": "^0.20.3",
     "@kopai/tsconfig": "0.2.0"
   },
   "scripts": {