@trigger.dev/core 4.5.10 → 4.5.12

package/dist/commonjs/v3/schemas/reports.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportViewModelSchema = exports.ReportLinkSchema = exports.ReportSummaryStatementSchema = exports.ReportFindingSchema = exports.ReportObservationSchema = exports.ReportExclusionSchema = exports.ReportFooterEntrySchema = exports.ReportRecommendationSchema = exports.ReportMetricSchema = exports.ReportMetricSeriesSchema = exports.ReportDeltaSchema = exports.ReportLinkKeySchema = exports.ReportReasonCodeSchema = exports.ReportUnitSchema = exports.ReportSeveritySchema = exports.ReportFormatSchema = exports.ReportPeriodSchema = void 0;
+const zod_1 = require("zod");
+// Shared contract for `GET /api/v1/reports/:key`: the period grammar and the `format=json` body.
+// The view model is semantic, not a UI tree: reasons are codes the renderer resolves to prose.
+const PERIOD_UNIT_MS = { m: 6e4, h: 36e5, d: 864e5, w: 6048e5 };
+const MAX_PERIOD_MS = 90 * 864e5; // 90d
+/** A positive integer plus `m`, `h`, `d` or `w`, capped at 90d. Reports bucket by whole minutes. */
+exports.ReportPeriodSchema = zod_1.z
+    .string()
+    .regex(/^[1-9]\d*[mhdw]$/, "period must be a shorthand like '30m', '1h' or '7d' — minutes (m), hours (h), days (d) or weeks (w); seconds are not supported")
+    .refine(
+// The regex guarantees the last char is a known unit; `?? 0` just satisfies the type checker.
+(p) => Number(p.slice(0, -1)) * (PERIOD_UNIT_MS[p.slice(-1)] ?? 0) <= MAX_PERIOD_MS, "period is too large (max 90d)");
+/** The response encodings the endpoint can render. `json` returns a `ReportViewModel`. */
+exports.ReportFormatSchema = zod_1.z.enum(["markdown", "json", "ansi"]);
+exports.ReportSeveritySchema = zod_1.z.enum(["ok", "warn", "crit"]);
+exports.ReportUnitSchema = zod_1.z.enum(["ms", "count", "ratio", "perMin"]);
+/** A code resolved to a human string by the renderer's message table. */
+exports.ReportReasonCodeSchema = zod_1.z.string();
+/** A key into `ReportViewModel.links`, so a recommendation can point at a URL. */
+exports.ReportLinkKeySchema = zod_1.z.string();
+exports.ReportDeltaSchema = zod_1.z.object({
+    dir: zod_1.z.enum(["up", "down", "flat"]),
+    /** rounded value/normal multiplier; renderer decides whether to print "6×". */
+    mult: zod_1.z.number().optional(),
+});
+exports.ReportMetricSeriesSchema = zod_1.z.object({
+    points: zod_1.z.array(zod_1.z.number()),
+    /** "estimated" = a proxy (e.g. pending backlog), shown informational-only. */
+    kind: zod_1.z.enum(["measured", "estimated"]),
+});
+exports.ReportMetricSchema = zod_1.z.object({
+    /** A code, e.g. "start_latency_p95"; the messages map turns it into the label. */
+    id: zod_1.z.string(),
+    value: zod_1.z.number(),
+    unit: exports.ReportUnitSchema,
+    aggregation: zod_1.z.enum(["p95", "rate", "ratio", "count"]).optional(),
+    /** baseline; renderer formats "(normal ~7s)". */
+    normal: zod_1.z.number().optional(),
+    delta: exports.ReportDeltaSchema.optional(),
+    series: exports.ReportMetricSeriesSchema.optional(),
+    /** named sub-values for composite metrics (e.g. throughput { done, triggered }). */
+    breakdown: zod_1.z.record(zod_1.z.number()).optional(),
+    /** shown on a cause line INSTEAD of "(normal ~x)", e.g. "pinned 40 of last 60 min". */
+    annotation: zod_1.z.object({ code: exports.ReportReasonCodeSchema, value: zod_1.z.number().optional() }).optional(),
+    /** "unknown" means `value` is a placeholder a consumer must not read as real. Absent = measured. */
+    availability: zod_1.z.enum(["measured", "unknown"]).optional(),
+    severity: exports.ReportSeveritySchema,
+});
+exports.ReportRecommendationSchema = zod_1.z.object({
+    code: exports.ReportReasonCodeSchema,
+    link: exports.ReportLinkKeySchema.optional(),
+});
+/** A footer line: an action, or the "do nothing" option (carries value). */
+exports.ReportFooterEntrySchema = zod_1.z.object({
+    code: exports.ReportReasonCodeSchema,
+    link: exports.ReportLinkKeySchema.optional(),
+    /** a computed fact (e.g. drainMinutes), never invented. */
+    value: zod_1.z.number().optional(),
+});
+/** A ruled-out cause + its evidence, e.g. "not your code" (never emitted without evidence). */
+exports.ReportExclusionSchema = zod_1.z.object({
+    code: exports.ReportReasonCodeSchema,
+    evidence: zod_1.z.record(zod_1.z.number()).optional(),
+});
+/** A measured fact backing the verdict. `ReportExclusion` states what the problem isn't. */
+exports.ReportObservationSchema = zod_1.z.object({
+    code: exports.ReportReasonCodeSchema,
+    evidence: zod_1.z.record(zod_1.z.number()).optional(),
+});
+exports.ReportFindingSchema = zod_1.z.object({
+    /** "flow" | "execution" | "liveness" | future "infrastructure" | "billing" */
+    type: zod_1.z.string(),
+    severity: exports.ReportSeveritySchema,
+    /** Code for the state or cause, e.g. "env_limit_saturation" | "healthy". */
+    reason: exports.ReportReasonCodeSchema,
+    /** Code for the "read:" line. Built last, may span findings. */
+    read: exports.ReportReasonCodeSchema.optional(),
+    /** metric ids this finding covers, in causal order when degraded. */
+    metricIds: zod_1.z.array(zod_1.z.string()),
+    /** A single primary action. */
+    recommendation: exports.ReportRecommendationSchema.optional(),
+    /** optional parenthetical — same shape as recommendation. */
+    hedge: exports.ReportRecommendationSchema.optional(),
+    /** contiguous breach window of the driving metric -> "(last 40 min)". */
+    anomalyWindow: zod_1.z.object({ minutes: zod_1.z.number(), touchesEnd: zod_1.z.boolean() }).optional(),
+    /** Which dimension and key own the problem. `of` is the denominator label the renderer prints. */
+    attribution: zod_1.z
+        .object({ dim: zod_1.z.string(), key: zod_1.z.string(), share: zod_1.z.number(), of: zod_1.z.string() })
+        .optional(),
+    /** Ruled-out causes and evidence, rendered under the `read:` line. */
+    exclusions: zod_1.z.array(exports.ReportExclusionSchema).optional(),
+    /** Supporting facts, rendered under the `read:` line after the exclusions. */
+    observations: zod_1.z.array(exports.ReportObservationSchema).optional(),
+});
+exports.ReportSummaryStatementSchema = zod_1.z.object({
+    findingType: zod_1.z.string(),
+    severity: exports.ReportSeveritySchema,
+    /** Renders from (findingType, severity) unless a reason is present. */
+    reason: exports.ReportReasonCodeSchema.optional(),
+});
+exports.ReportLinkSchema = zod_1.z.object({
+    key: exports.ReportLinkKeySchema,
+    label: zod_1.z.string(),
+    url: zod_1.z.string(),
+});
+exports.ReportViewModelSchema = zod_1.z.object({
+    /** "health" | "cost" | … */
+    title: zod_1.z.string(),
+    /** "prod" */
+    scope: zod_1.z.string(),
+    /** "last 1h" */
+    period: zod_1.z.string(),
+    /** "vs your 7d normal" */
+    baselineLabel: zod_1.z.string().optional(),
+    /** ISO string. Passed in, never read from the clock inside interpret. */
+    generatedAt: zod_1.z.string(),
+    /** live window length in minutes — lets the renderer say "of last 60 min". */
+    windowMinutes: zod_1.z.number(),
+    summary: zod_1.z.object({
+        severity: exports.ReportSeveritySchema,
+        statements: zod_1.z.array(exports.ReportSummaryStatementSchema),
+    }),
+    findings: zod_1.z.array(exports.ReportFindingSchema),
+    metrics: zod_1.z.array(exports.ReportMetricSchema),
+    /** dense structured payload for agents. */
+    facts: zod_1.z.record(zod_1.z.unknown()),
+    links: zod_1.z.array(exports.ReportLinkSchema),
+    /** dominant finding's action + optional "do nothing" option. Max two entries. */
+    footer: zod_1.z.array(exports.ReportFooterEntrySchema),
+});
+//# sourceMappingURL=reports.js.map

package/dist/commonjs/v3/schemas/reports.js.map

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