@miragon/pulse-analytics-client 0.0.0-stage → 0.21.0

package/dist/schemas/engine-compare.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const engineCompareInput: z.ZodObject<{
+    processDefinitionKey: z.ZodString;
+    engineA: z.ZodString;
+    engineB: z.ZodString;
+    windowDays: z.ZodDefault<z.ZodNumber>;
+    activityId: z.ZodOptional<z.ZodString>;
+    minBucketSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+//# sourceMappingURL=engine-compare.d.ts.map

package/dist/schemas/engine-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-compare.d.ts","sourceRoot":"","sources":["../../src/schemas/engine-compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,kBAAkB;;;;;;;iBA0B7B,CAAA"}

package/dist/schemas/engine-compare.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export const engineCompareInput = z.object({
+    processDefinitionKey: z
+        .string()
+        .min(1)
+        .describe("The process definition key to compare on both engines — REQUIRED. Engines run different process mixes, so comparing their whole workloads measures the mix, not the engines; scoping to ONE process is what makes the delta attributable. Discover keys deployed on several engines in the `sharedProcessKeys` field of analytics_engine_landscape."),
+    engineA: z.string().min(1).describe("First engine id (the baseline)."),
+    engineB: z.string().min(1).describe("Second engine id (the comparison)."),
+    windowDays: z
+        .number()
+        .int()
+        .min(1)
+        .max(30)
+        .default(14)
+        .describe("Look-back window applied to both engines, in days (max 30 — Prometheus retention)."),
+    activityId: z
+        .string()
+        .optional()
+        .describe("Also count the incidents at this BPMN element (element_incident_*; optional)."),
+    minBucketSize: z
+        .number()
+        .int()
+        .min(1)
+        .default(10)
+        .describe("Minimum instance count per engine before results are trusted."),
+});
+//# sourceMappingURL=engine-compare.js.map

package/dist/schemas/engine-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-compare.js","sourceRoot":"","sources":["../../src/schemas/engine-compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,qVAAqV,CACtV;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACtE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACzE,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,oFAAoF,CAAC;IACjG,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+EAA+E,CAAC;IAC5F,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAC,CAAA"}

package/dist/schemas/engine-landscape.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const engineLandscapeInput: z.ZodObject<{
+    engine: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strip>;
+//# sourceMappingURL=engine-landscape.d.ts.map

package/dist/schemas/engine-landscape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-landscape.d.ts","sourceRoot":"","sources":["../../src/schemas/engine-landscape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,oBAAoB;;iBAO/B,CAAA"}

package/dist/schemas/engine-landscape.js

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export const engineLandscapeInput = z.object({
+    engine: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe("Engine ids to include; omitted = every configured engine. An engine that reports no metrics at all comes back with `reporting: false`."),
+});
+//# sourceMappingURL=engine-landscape.js.map

package/dist/schemas/engine-landscape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-landscape.js","sourceRoot":"","sources":["../../src/schemas/engine-landscape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACxC,QAAQ,EAAE;SACV,QAAQ,CACP,wIAAwI,CACzI;CACJ,CAAC,CAAA"}

package/dist/schemas/failures.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const findFailedInstancesInput: z.ZodObject<{
+    engine: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    processDefinitionKey: z.ZodOptional<z.ZodString>;
+    incidentType: z.ZodOptional<z.ZodString>;
+    maxResults: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+//# sourceMappingURL=failures.d.ts.map

package/dist/schemas/failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.d.ts","sourceRoot":"","sources":["../../src/schemas/failures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,wBAAwB;;;;;iBAKnC,CAAA"}

package/dist/schemas/failures.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { engineFilterShape } from "./shared.js";
+export const findFailedInstancesInput = z.object({
+    processDefinitionKey: z.string().optional().describe("Filter by process definition key"),
+    incidentType: z.string().optional().describe("Filter by incident type (e.g. failedJob)"),
+    maxResults: z.number().int().positive().max(100).default(20).describe("Maximum results"),
+    ...engineFilterShape,
+});
+//# sourceMappingURL=failures.js.map

package/dist/schemas/failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.js","sourceRoot":"","sources":["../../src/schemas/failures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACxF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACxF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACxF,GAAG,iBAAiB;CACrB,CAAC,CAAA"}

package/dist/schemas/health.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+export declare const engineHealthInput: z.ZodObject<{
+    engine: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strip>;
+//# sourceMappingURL=health.d.ts.map

package/dist/schemas/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/schemas/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,iBAAiB;;iBAE5B,CAAA"}

package/dist/schemas/health.js

@@ -0,0 +1,6 @@
+import { z } from "zod";
+import { engineFilterShape } from "./shared.js";
+export const engineHealthInput = z.object({
+    ...engineFilterShape,
+});
+//# sourceMappingURL=health.js.map

package/dist/schemas/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/schemas/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,iBAAiB;CACrB,CAAC,CAAA"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,10 @@
+export { analyzePerformanceInput, comparePeriodsInput } from "./performance.js";
+export { findFailedInstancesInput } from "./failures.js";
+export { elementBottleneckInput } from "./path.js";
+export { clusterCompareInput } from "./cluster-compare.js";
+export { versionCompareInput } from "./version-compare.js";
+export { engineCompareInput } from "./engine-compare.js";
+export { engineLandscapeInput } from "./engine-landscape.js";
+export { engineHealthInput } from "./health.js";
+export { engineFilterShape } from "./shared.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA"}

package/dist/schemas/index.js

@@ -0,0 +1,10 @@
+export { analyzePerformanceInput, comparePeriodsInput } from "./performance.js";
+export { findFailedInstancesInput } from "./failures.js";
+export { elementBottleneckInput } from "./path.js";
+export { clusterCompareInput } from "./cluster-compare.js";
+export { versionCompareInput } from "./version-compare.js";
+export { engineCompareInput } from "./engine-compare.js";
+export { engineLandscapeInput } from "./engine-landscape.js";
+export { engineHealthInput } from "./health.js";
+export { engineFilterShape } from "./shared.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA"}

package/dist/schemas/path.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+export declare const elementBottleneckInput: z.ZodObject<{
+    engine: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    processDefinitionKey: z.ZodString;
+    period: z.ZodDefault<z.ZodEnum<{
+        "1d": "1d";
+        "3d": "3d";
+        "7d": "7d";
+        "14d": "14d";
+        "30d": "30d";
+    }>>;
+    minBucketSize: z.ZodDefault<z.ZodNumber>;
+    maxResults: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+//# sourceMappingURL=path.d.ts.map

package/dist/schemas/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/schemas/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAiBjC,CAAA"}

package/dist/schemas/path.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { engineFilterShape, periodField } from "./shared.js";
+export const elementBottleneckInput = z.object({
+    processDefinitionKey: z.string().describe("Process definition key to analyze"),
+    period: periodField,
+    minBucketSize: z
+        .number()
+        .int()
+        .min(1)
+        .default(10)
+        .describe("Minimum number of executions per activity before it is returned."),
+    maxResults: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(20)
+        .describe("Maximum number of activities to return"),
+    ...engineFilterShape,
+});
+//# sourceMappingURL=path.js.map

package/dist/schemas/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/schemas/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC9E,MAAM,EAAE,WAAW;IACnB,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,wCAAwC,CAAC;IACrD,GAAG,iBAAiB;CACrB,CAAC,CAAA"}

package/dist/schemas/performance.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export declare const analyzePerformanceInput: z.ZodObject<{
+    engine: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    processDefinitionKey: z.ZodString;
+    period: z.ZodDefault<z.ZodEnum<{
+        "1d": "1d";
+        "3d": "3d";
+        "7d": "7d";
+        "14d": "14d";
+        "30d": "30d";
+    }>>;
+    includeActivityBreakdown: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const comparePeriodsInput: z.ZodObject<{
+    engine: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    processDefinitionKey: z.ZodString;
+    periodAFrom: z.ZodString;
+    periodATo: z.ZodString;
+    periodBFrom: z.ZodString;
+    periodBTo: z.ZodString;
+    includeActivityBreakdown: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+//# sourceMappingURL=performance.d.ts.map

package/dist/schemas/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/schemas/performance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,uBAAuB;;;;;;;;;;;iBAQlC,CAAA;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;iBAQ9B,CAAA"}

package/dist/schemas/performance.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { engineFilterShape, isoDatetimeString, periodField } from "./shared.js";
+export const analyzePerformanceInput = z.object({
+    processDefinitionKey: z.string().describe("Process definition key to analyze"),
+    period: periodField,
+    includeActivityBreakdown: z
+        .boolean()
+        .default(true)
+        .describe("Include per-activity bottleneck analysis"),
+    ...engineFilterShape,
+});
+export const comparePeriodsInput = z.object({
+    processDefinitionKey: z.string().describe("Process definition key to compare"),
+    periodAFrom: isoDatetimeString.describe("Period A start (ISO datetime)"),
+    periodATo: isoDatetimeString.describe("Period A end (ISO datetime)"),
+    periodBFrom: isoDatetimeString.describe("Period B start (ISO datetime)"),
+    periodBTo: isoDatetimeString.describe("Period B end (ISO datetime)"),
+    includeActivityBreakdown: z.boolean().default(false).describe("Include per-activity comparison"),
+    ...engineFilterShape,
+});
+//# sourceMappingURL=performance.js.map

package/dist/schemas/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../src/schemas/performance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC9E,MAAM,EAAE,WAAW;IACnB,wBAAwB,EAAE,CAAC;SACxB,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,0CAA0C,CAAC;IACvD,GAAG,iBAAiB;CACrB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC9E,WAAW,EAAE,iBAAiB,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACxE,SAAS,EAAE,iBAAiB,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACpE,WAAW,EAAE,iBAAiB,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACxE,SAAS,EAAE,iBAAiB,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACpE,wBAAwB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAChG,GAAG,iBAAiB;CACrB,CAAC,CAAA"}

package/dist/schemas/shared.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+/** Canonical `period` input field, derived from PERIOD_RANGE. */
+export declare const periodField: z.ZodDefault<z.ZodEnum<{
+    "1d": "1d";
+    "3d": "3d";
+    "7d": "7d";
+    "14d": "14d";
+    "30d": "30d";
+}>>;
+/**
+ * ISO-datetime input field. Validates parseability at the tool boundary so an
+ * LLM-supplied value like "last week" fails with a readable message instead of
+ * reaching PromQL as `@ NaN`.
+ */
+export declare const isoDatetimeString: z.ZodString;
+/**
+ * Optional `engine` filter spread into every analytics tool's input schema.
+ * Same parameter name as the camunda7 operations tools' per-call override,
+ * but a Prometheus label filter — no saved default, and with subset support:
+ *
+ *   - Omitted → the server's configured engines, aggregated (the fleet view).
+ *   - One id → restricts to one engine.
+ *   - Array  → restricts to that subset (e.g. for prod-only or A-vs-B compare).
+ *
+ * The analytics module resolves it against the configured engine ids (an id
+ * outside them is refused) before any query runs.
+ *
+ * The description stays one line: the semantics are stated once in the
+ * module's server instructions (`analytics-connector/src/instructions.ts`).
+ */
+export declare const engineFilterShape: {
+    engine: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+};
+//# sourceMappingURL=shared.d.ts.map

package/dist/schemas/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/schemas/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,iEAAiE;AACjE,eAAO,MAAM,WAAW;;;;;;GAAiE,CAAA;AAEzF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAE5B,CAAA;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB;;CAK7B,CAAA"}

package/dist/schemas/shared.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { PERIODS } from "../prometheus.js";
+/** Canonical `period` input field, derived from PERIOD_RANGE. */
+export const periodField = z.enum(PERIODS).default("7d").describe("Analysis time period");
+/**
+ * ISO-datetime input field. Validates parseability at the tool boundary so an
+ * LLM-supplied value like "last week" fails with a readable message instead of
+ * reaching PromQL as `@ NaN`.
+ */
+export const isoDatetimeString = z.string().refine((v) => Number.isFinite(Date.parse(v)), {
+    message: "Not a parseable ISO datetime (expected e.g. 2026-07-01T12:00:00Z)",
+});
+/**
+ * Optional `engine` filter spread into every analytics tool's input schema.
+ * Same parameter name as the camunda7 operations tools' per-call override,
+ * but a Prometheus label filter — no saved default, and with subset support:
+ *
+ *   - Omitted → the server's configured engines, aggregated (the fleet view).
+ *   - One id → restricts to one engine.
+ *   - Array  → restricts to that subset (e.g. for prod-only or A-vs-B compare).
+ *
+ * The analytics module resolves it against the configured engine ids (an id
+ * outside them is refused) before any query runs.
+ *
+ * The description stays one line: the semantics are stated once in the
+ * module's server instructions (`analytics-connector/src/instructions.ts`).
+ */
+export const engineFilterShape = {
+    engine: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe("Engine id(s) to scope to; omitted = all configured (see server instructions)"),
+};
+//# sourceMappingURL=shared.js.map

package/dist/schemas/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/schemas/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE1C,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAA;AAEzF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;IACxF,OAAO,EAAE,mEAAmE;CAC7E,CAAC,CAAA;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACxC,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAA"}

package/dist/schemas/version-compare.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const versionCompareInput: z.ZodObject<{
+    engine: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    processDefinitionKey: z.ZodString;
+    versionA: z.ZodNumber;
+    versionB: z.ZodNumber;
+    windowDays: z.ZodDefault<z.ZodNumber>;
+    minBucketSize: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+//# sourceMappingURL=version-compare.d.ts.map

package/dist/schemas/version-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare.d.ts","sourceRoot":"","sources":["../../src/schemas/version-compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,mBAAmB;;;;;;;iBAuB9B,CAAA"}

package/dist/schemas/version-compare.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { engineFilterShape } from "./shared.js";
+export const versionCompareInput = z.object({
+    processDefinitionKey: z
+        .string()
+        .min(1)
+        .describe("Process definition key — versions are only meaningful within a single key."),
+    versionA: z.number().int().min(1).describe("First process definition version (the baseline)."),
+    versionB: z.number().int().min(1).describe("Second process definition version (the candidate)."),
+    windowDays: z
+        .number()
+        .int()
+        .min(1)
+        .max(30)
+        .default(14)
+        .describe("Look-back window applied to both versions, in days (max 30 — Prometheus retention)."),
+    minBucketSize: z
+        .number()
+        .int()
+        .min(1)
+        .default(10)
+        .describe("Minimum instance count per version before results are trusted."),
+    ...engineFilterShape,
+});
+//# sourceMappingURL=version-compare.js.map

package/dist/schemas/version-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare.js","sourceRoot":"","sources":["../../src/schemas/version-compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,4EAA4E,CAAC;IACzF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC9F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IAChG,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CACP,qFAAqF,CACtF;IACH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,GAAG,iBAAiB;CACrB,CAAC,CAAA"}

package/dist/widgets.d.ts

@@ -0,0 +1,138 @@
+import type { Period } from "./prometheus.js";
+/**
+ * One group of currently-open incidents — exactly what the
+ * `camunda_incidents_open` gauge carries (no message, activity, timestamps or
+ * instance ids exist on it).
+ */
+export interface ErrorPatternItem {
+    incidentType: string;
+    processDefinitionKey: string;
+    incidentCount: number;
+}
+/** One process definition's live failure state (point-in-time gauges). */
+export interface ProcessFailureItem {
+    processDefinitionKey: string;
+    /** Instances running right now. */
+    runningNow: number;
+    /** Jobs whose retries are exhausted, right now. */
+    deadJobs: number;
+    /** Incidents open right now. */
+    openIncidents: number;
+    /**
+     * `openIncidents` per 100 running instances — null when none run. One
+     * instance can carry several incidents, so it may exceed 100.
+     */
+    incidentRatePct: number | null;
+}
+export interface FailureDashboardData {
+    /**
+     * The engine ids the snapshot covers; `null` = every engine Prometheus
+     * holds (an unscoped library call — the analytics tools always scope).
+     */
+    engines: string[] | null;
+    totalIncidents: number;
+    uniqueErrorPatterns: number;
+    mostAffectedProcess: string | null;
+    errorPatterns: ErrorPatternItem[];
+    processBreakdown: ProcessFailureItem[];
+    /**
+     * When the figures were read from Prometheus (ISO timestamp): the "Stand"
+     * a view shows. Optional only for payloads recorded before it existed.
+     */
+    asOf?: string;
+}
+/**
+ * One BPMN element of one process definition — ids are only unique within a
+ * model. Element names are not a metric label; resolve them from the BPMN.
+ */
+export interface ActivityBreakdownItem {
+    processDefinitionKey: string;
+    activityId: string;
+    activityType: string;
+    executionCount: number;
+    avgDurationMs: number | null;
+    p95DurationMs: number | null;
+    totalTimeMs: number;
+}
+export interface DefinitionBreakdownItem {
+    processDefinitionKey: string;
+    /** Instances started in the window. */
+    totalInstances: number;
+    /** Instances completed in the window. */
+    completed: number;
+    /** Instances running right now (live gauge); null when no engine in scope reports its state gauges. */
+    runningNow: number | null;
+    /** Incidents created in the window — incidents, not failed instances. */
+    incidentsCreated: number;
+    avgDurationMs: number | null;
+}
+export interface AnalyticsDashboardData {
+    /** The scope the figures cover — echoed so no reader has to guess it. */
+    processDefinitionKey: string | null;
+    period: Period;
+    /** The engine ids aggregated; `null` = every engine Prometheus holds (unscoped library call). */
+    engines: string[] | null;
+    /**
+     * The engine ids in scope that report their state gauges (the presence
+     * probe), ascending — so a view can say how many of `engines` send no
+     * metrics. Optional only for payloads recorded before it existed.
+     */
+    reportingEngines?: string[];
+    /**
+     * When the figures were read from Prometheus (ISO timestamp): the "Stand"
+     * a view shows. Optional only for payloads recorded before it existed.
+     */
+    asOf?: string;
+    /** Instances started in the window. */
+    totalCount: number;
+    /** Instances completed in the window. */
+    completedCount: number;
+    /** Incidents created in the window — incidents, not failed instances. */
+    incidentsCreated: number;
+    /** Incidents resolved in the window (whenever they were created). */
+    incidentsResolved: number;
+    /** `incidentsCreated` per 100 started instances (may exceed 100); null when nothing started. */
+    incidentRatePct: number | null;
+    /** Durations of the instances that ENDED in the window; null when none did. */
+    avgDurationMs: number | null;
+    medianDurationMs: number | null;
+    p95DurationMs: number | null;
+    /**
+     * Instances running now (live gauge, independent of the window); 0 when an
+     * engine in scope reports but runs none, null only when none reports.
+     */
+    runningNow: number | null;
+    /**
+     * Incidents open now (live gauge — the failure dashboard's number); 0 when
+     * an engine in scope reports but has none open, null only when none reports.
+     */
+    openIncidentsNow: number | null;
+    /**
+     * Starts and incidents over the window right before the period — what the
+     * incident rate is judged against. Null when that window lies wholly before
+     * the Prometheus retention (no figures can exist for it).
+     */
+    previous: PreviousPeriodFlows | null;
+    /** The top (process, activity) rows by total time, at most `ACTIVITY_BREAKDOWN_LIMIT`. */
+    activityBreakdown: ActivityBreakdownItem[];
+    /** How many (process, activity) rows there were before the cut — the "of" of a top list. */
+    activityCount: number;
+    definitionBreakdown: DefinitionBreakdownItem[];
+}
+/** The flows of the window right before a dashboard's period. */
+export interface PreviousPeriodFlows {
+    /** Instances started in the previous window. */
+    totalCount: number;
+    /** Incidents created in the previous window. */
+    incidentsCreated: number;
+    /** `incidentsCreated` per 100 starts; null when nothing started. */
+    incidentRatePct: number | null;
+    /** The retention cut the previous window short; its rate still compares (per 100 starts). */
+    partial: boolean;
+    /**
+     * Either window started fewer instances than the comparison floor
+     * (`minBucketSize`): the rate's change is shown, but not judged.
+     */
+    suppressed: boolean;
+}
+//# sourceMappingURL=widgets.d.ts.map

package/dist/widgets.d.ts.map

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

package/dist/widgets.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=widgets.js.map

package/dist/widgets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.js","sourceRoot":"","sources":["../src/widgets.ts"],"names":[],"mappings":""}