@cat-factory/contracts 0.174.0 → 0.176.0

package/dist/reports.d.ts

@@ -0,0 +1,235 @@
+import * as v from 'valibot';
+/** The time window every breakdown aggregates over. */
+export declare const reportWindowSchema: v.PicklistSchema<["24h", "7d", "30d", "90d"], undefined>;
+export type ReportWindow = v.InferOutput<typeof reportWindowSchema>;
+/**
+ * What a SPEND breakdown groups by. `model` keys on the canonical `provider:model`
+ * id; `agentKind` on the metered call's agent kind; the remaining three resolve
+ * through the call's run (`workspace` directly, `service`/`taskType` via the run
+ * and its block).
+ */
+export declare const reportSpendDimensionSchema: v.PicklistSchema<["model", "agentKind", "workspace", "service", "taskType"], undefined>;
+export type ReportSpendDimension = v.InferOutput<typeof reportSpendDimensionSchema>;
+/**
+ * What an ACTIVITY breakdown groups by. A run carries no single agent kind or model
+ * (those are per-step facts, which is what the spend breakdowns key on), so the
+ * activity axis is deliberately narrower than the spend axis.
+ */
+export declare const reportActivityDimensionSchema: v.PicklistSchema<["workspace", "service", "taskType"], undefined>;
+export type ReportActivityDimension = v.InferOutput<typeof reportActivityDimensionSchema>;
+/**
+ * One slice of a spend breakdown. `key` is the raw dimension value and the row's
+ * identity; EMPTY means unattributed (a call whose run, service, or task type could
+ * not be resolved) — a real bucket, rendered as such, never dropped.
+ *
+ * The two costs are kept apart on purpose and must never be summed blindly: only
+ * `meteredCost` is real money. `subscriptionCost` is what the same tokens WOULD have
+ * cost on the metered API — illustrative for a flat-rate quota harness (Claude Code /
+ * Codex / GLM / pooled Kimi & DeepSeek), which is why the spend gate excludes it.
+ */
+export declare const reportSpendRowSchema: v.ObjectSchema<{
+    readonly key: v.StringSchema<undefined>;
+    /** Human-readable name for `key` when the store can resolve one (workspace/service); else null. */
+    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly inputTokens: v.NumberSchema<undefined>;
+    readonly outputTokens: v.NumberSchema<undefined>;
+    /** Number of metered LLM calls in this slice (both billing kinds). */
+    readonly calls: v.NumberSchema<undefined>;
+    /** Real per-token cost, in the deployment's spend currency. */
+    readonly meteredCost: v.NumberSchema<undefined>;
+    /** Illustrative equivalent-API cost of flat-rate subscription usage. Never real spend. */
+    readonly subscriptionCost: v.NumberSchema<undefined>;
+}, undefined>;
+export type ReportSpendRow = v.InferOutput<typeof reportSpendRowSchema>;
+/**
+ * One slice of an activity breakdown, over the agent runs CREATED in the window — every
+ * kind of run (task pipelines, repo bootstraps, env-config repairs), so this half of a row
+ * covers the same population whose LLM calls the spend half reports.
+ */
+export declare const reportActivityRowSchema: v.ObjectSchema<{
+    readonly key: v.StringSchema<undefined>;
+    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** All runs created in the window in this slice. */
+    readonly runs: v.NumberSchema<undefined>;
+    readonly done: v.NumberSchema<undefined>;
+    readonly failed: v.NumberSchema<undefined>;
+    /** Runs still in flight (`running`). */
+    readonly running: v.NumberSchema<undefined>;
+    /** Every other status (`blocked` / `paused` / `pending`). */
+    readonly other: v.NumberSchema<undefined>;
+    /** Mean wall-clock duration over this slice's TERMINAL runs (ms); null when none. */
+    readonly avgDurationMs: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type ReportActivityRow = v.InferOutput<typeof reportActivityRowSchema>;
+/** One contiguous time bucket of the spend trend (zero-filled, oldest first). */
+export declare const reportTrendPointSchema: v.ObjectSchema<{
+    /** Epoch-ms start of the bucket. */
+    readonly start: v.NumberSchema<undefined>;
+    readonly meteredCost: v.NumberSchema<undefined>;
+    readonly subscriptionCost: v.NumberSchema<undefined>;
+    readonly calls: v.NumberSchema<undefined>;
+    readonly inputTokens: v.NumberSchema<undefined>;
+    readonly outputTokens: v.NumberSchema<undefined>;
+}, undefined>;
+export type ReportTrendPoint = v.InferOutput<typeof reportTrendPointSchema>;
+/** Window-wide totals, folded from the `model` breakdown (no extra query). */
+export declare const reportTotalsSchema: v.ObjectSchema<{
+    readonly inputTokens: v.NumberSchema<undefined>;
+    readonly outputTokens: v.NumberSchema<undefined>;
+    readonly calls: v.NumberSchema<undefined>;
+    readonly meteredCost: v.NumberSchema<undefined>;
+    readonly subscriptionCost: v.NumberSchema<undefined>;
+}, undefined>;
+export type ReportTotals = v.InferOutput<typeof reportTotalsSchema>;
+/** The complete reports projection the SPA renders. */
+export declare const reportsViewSchema: v.ObjectSchema<{
+    readonly window: v.PicklistSchema<["24h", "7d", "30d", "90d"], undefined>;
+    /** When the projection was computed (epoch ms). */
+    readonly generatedAt: v.NumberSchema<undefined>;
+    /**
+     * Start of the window (epoch ms): `generatedAt - window`, snapped DOWN to a trend-bucket
+     * edge so the chart's first column is a complete bucket rather than a short one that reads
+     * as a quiet period. A window therefore covers up to one bucket more than its nominal
+     * length, and this is the real span every number in the projection was computed over.
+     */
+    readonly since: v.NumberSchema<undefined>;
+    /** The single workspace every breakdown was narrowed to, or null for the whole account. */
+    readonly workspaceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** The deployment's spend currency, so the SPA formats costs without a second call. */
+    readonly currency: v.StringSchema<undefined>;
+    readonly totals: v.ObjectSchema<{
+        readonly inputTokens: v.NumberSchema<undefined>;
+        readonly outputTokens: v.NumberSchema<undefined>;
+        readonly calls: v.NumberSchema<undefined>;
+        readonly meteredCost: v.NumberSchema<undefined>;
+        readonly subscriptionCost: v.NumberSchema<undefined>;
+    }, undefined>;
+    /** Spend sliced every way, each heaviest-first. */
+    readonly spend: v.ObjectSchema<{
+        readonly byModel: v.ArraySchema<v.ObjectSchema<{
+            readonly key: v.StringSchema<undefined>;
+            /** Human-readable name for `key` when the store can resolve one (workspace/service); else null. */
+            readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly inputTokens: v.NumberSchema<undefined>;
+            readonly outputTokens: v.NumberSchema<undefined>;
+            /** Number of metered LLM calls in this slice (both billing kinds). */
+            readonly calls: v.NumberSchema<undefined>;
+            /** Real per-token cost, in the deployment's spend currency. */
+            readonly meteredCost: v.NumberSchema<undefined>;
+            /** Illustrative equivalent-API cost of flat-rate subscription usage. Never real spend. */
+            readonly subscriptionCost: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly byAgentKind: v.ArraySchema<v.ObjectSchema<{
+            readonly key: v.StringSchema<undefined>;
+            /** Human-readable name for `key` when the store can resolve one (workspace/service); else null. */
+            readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly inputTokens: v.NumberSchema<undefined>;
+            readonly outputTokens: v.NumberSchema<undefined>;
+            /** Number of metered LLM calls in this slice (both billing kinds). */
+            readonly calls: v.NumberSchema<undefined>;
+            /** Real per-token cost, in the deployment's spend currency. */
+            readonly meteredCost: v.NumberSchema<undefined>;
+            /** Illustrative equivalent-API cost of flat-rate subscription usage. Never real spend. */
+            readonly subscriptionCost: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly byWorkspace: v.ArraySchema<v.ObjectSchema<{
+            readonly key: v.StringSchema<undefined>;
+            /** Human-readable name for `key` when the store can resolve one (workspace/service); else null. */
+            readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly inputTokens: v.NumberSchema<undefined>;
+            readonly outputTokens: v.NumberSchema<undefined>;
+            /** Number of metered LLM calls in this slice (both billing kinds). */
+            readonly calls: v.NumberSchema<undefined>;
+            /** Real per-token cost, in the deployment's spend currency. */
+            readonly meteredCost: v.NumberSchema<undefined>;
+            /** Illustrative equivalent-API cost of flat-rate subscription usage. Never real spend. */
+            readonly subscriptionCost: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly byService: v.ArraySchema<v.ObjectSchema<{
+            readonly key: v.StringSchema<undefined>;
+            /** Human-readable name for `key` when the store can resolve one (workspace/service); else null. */
+            readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly inputTokens: v.NumberSchema<undefined>;
+            readonly outputTokens: v.NumberSchema<undefined>;
+            /** Number of metered LLM calls in this slice (both billing kinds). */
+            readonly calls: v.NumberSchema<undefined>;
+            /** Real per-token cost, in the deployment's spend currency. */
+            readonly meteredCost: v.NumberSchema<undefined>;
+            /** Illustrative equivalent-API cost of flat-rate subscription usage. Never real spend. */
+            readonly subscriptionCost: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly byTaskType: v.ArraySchema<v.ObjectSchema<{
+            readonly key: v.StringSchema<undefined>;
+            /** Human-readable name for `key` when the store can resolve one (workspace/service); else null. */
+            readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly inputTokens: v.NumberSchema<undefined>;
+            readonly outputTokens: v.NumberSchema<undefined>;
+            /** Number of metered LLM calls in this slice (both billing kinds). */
+            readonly calls: v.NumberSchema<undefined>;
+            /** Real per-token cost, in the deployment's spend currency. */
+            readonly meteredCost: v.NumberSchema<undefined>;
+            /** Illustrative equivalent-API cost of flat-rate subscription usage. Never real spend. */
+            readonly subscriptionCost: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>;
+    /** Run activity sliced every way, each busiest-first. */
+    readonly activity: v.ObjectSchema<{
+        readonly byWorkspace: v.ArraySchema<v.ObjectSchema<{
+            readonly key: v.StringSchema<undefined>;
+            readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            /** All runs created in the window in this slice. */
+            readonly runs: v.NumberSchema<undefined>;
+            readonly done: v.NumberSchema<undefined>;
+            readonly failed: v.NumberSchema<undefined>;
+            /** Runs still in flight (`running`). */
+            readonly running: v.NumberSchema<undefined>;
+            /** Every other status (`blocked` / `paused` / `pending`). */
+            readonly other: v.NumberSchema<undefined>;
+            /** Mean wall-clock duration over this slice's TERMINAL runs (ms); null when none. */
+            readonly avgDurationMs: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly byService: v.ArraySchema<v.ObjectSchema<{
+            readonly key: v.StringSchema<undefined>;
+            readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            /** All runs created in the window in this slice. */
+            readonly runs: v.NumberSchema<undefined>;
+            readonly done: v.NumberSchema<undefined>;
+            readonly failed: v.NumberSchema<undefined>;
+            /** Runs still in flight (`running`). */
+            readonly running: v.NumberSchema<undefined>;
+            /** Every other status (`blocked` / `paused` / `pending`). */
+            readonly other: v.NumberSchema<undefined>;
+            /** Mean wall-clock duration over this slice's TERMINAL runs (ms); null when none. */
+            readonly avgDurationMs: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly byTaskType: v.ArraySchema<v.ObjectSchema<{
+            readonly key: v.StringSchema<undefined>;
+            readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            /** All runs created in the window in this slice. */
+            readonly runs: v.NumberSchema<undefined>;
+            readonly done: v.NumberSchema<undefined>;
+            readonly failed: v.NumberSchema<undefined>;
+            /** Runs still in flight (`running`). */
+            readonly running: v.NumberSchema<undefined>;
+            /** Every other status (`blocked` / `paused` / `pending`). */
+            readonly other: v.NumberSchema<undefined>;
+            /** Mean wall-clock duration over this slice's TERMINAL runs (ms); null when none. */
+            readonly avgDurationMs: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>;
+    /** Spend over time at `bucketMs` resolution. */
+    readonly trend: v.ObjectSchema<{
+        readonly bucketMs: v.NumberSchema<undefined>;
+        readonly points: v.ArraySchema<v.ObjectSchema<{
+            /** Epoch-ms start of the bucket. */
+            readonly start: v.NumberSchema<undefined>;
+            readonly meteredCost: v.NumberSchema<undefined>;
+            readonly subscriptionCost: v.NumberSchema<undefined>;
+            readonly calls: v.NumberSchema<undefined>;
+            readonly inputTokens: v.NumberSchema<undefined>;
+            readonly outputTokens: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>;
+}, undefined>;
+export type ReportsView = v.InferOutput<typeof reportsViewSchema>;
+//# sourceMappingURL=reports.d.ts.map

package/dist/reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../src/reports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAe5B,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,0DAA0C,CAAA;AACzE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,yFAMrC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,mEAAmD,CAAA;AAC7F,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEzF;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;IAE/B,mGAAmG;;;;IAInG,sEAAsE;;IAEtE,+DAA+D;;IAE/D,0FAA0F;;aAE1F,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;IAGlC,oDAAoD;;;;IAIpD,wCAAwC;;IAExC,6DAA6D;;IAE7D,qFAAqF;;aAErF,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,iFAAiF;AACjF,eAAO,MAAM,sBAAsB;IACjC,oCAAoC;;;;;;;aAOpC,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB;;;;;;aAM7B,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE,uDAAuD;AACvD,eAAO,MAAM,iBAAiB;;IAE5B,mDAAmD;;IAEnD;;;;;OAKG;;IAEH,2FAA2F;;IAE3F,uFAAuF;;;;;;;;;IAGvF,mDAAmD;;;;YAzEnD,mGAAmG;;;;YAInG,sEAAsE;;YAEtE,+DAA+D;;YAE/D,0FAA0F;;;;;YAR1F,mGAAmG;;;;YAInG,sEAAsE;;YAEtE,+DAA+D;;YAE/D,0FAA0F;;;;;YAR1F,mGAAmG;;;;YAInG,sEAAsE;;YAEtE,+DAA+D;;YAE/D,0FAA0F;;;;;YAR1F,mGAAmG;;;;YAInG,sEAAsE;;YAEtE,+DAA+D;;YAE/D,0FAA0F;;;;;YAR1F,mGAAmG;;;;YAInG,sEAAsE;;YAEtE,+DAA+D;;YAE/D,0FAA0F;;;;IAyE1F,yDAAyD;;;;;YA5DzD,oDAAoD;;;;YAIpD,wCAAwC;;YAExC,6DAA6D;;YAE7D,qFAAqF;;;;;;YARrF,oDAAoD;;;;YAIpD,wCAAwC;;YAExC,6DAA6D;;YAE7D,qFAAqF;;;;;;YARrF,oDAAoD;;;;YAIpD,wCAAwC;;YAExC,6DAA6D;;YAE7D,qFAAqF;;;;IA0DrF,gDAAgD;;;;YAnDhD,oCAAoC;;;;;;;;;aAwDpC,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA"}

package/dist/reports.js

@@ -0,0 +1,132 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Reports: the cross-cutting analytics projection an operator reads to answer
+// "where is the money and the work going". Where `platformObservabilitySchema`
+// answers "is the deployment HEALTHY" (outcomes, failures, latency), this answers
+// "how is it being USED" — spend sliced by model / agent kind, and both spend and
+// run activity sliced by workspace / service / task type, plus a spend trend.
+//
+// Every number is a SQL rollup behind the kernel `ReportsRepository` port (one
+// GROUP BY per breakdown, run in parallel — never rows reduced in JS). Account
+// scoped and admin-gated like the operator dashboard, with an optional single
+// workspace filter that narrows every breakdown at once.
+// ---------------------------------------------------------------------------
+/** The time window every breakdown aggregates over. */
+export const reportWindowSchema = v.picklist(['24h', '7d', '30d', '90d']);
+/**
+ * What a SPEND breakdown groups by. `model` keys on the canonical `provider:model`
+ * id; `agentKind` on the metered call's agent kind; the remaining three resolve
+ * through the call's run (`workspace` directly, `service`/`taskType` via the run
+ * and its block).
+ */
+export const reportSpendDimensionSchema = v.picklist([
+    'model',
+    'agentKind',
+    'workspace',
+    'service',
+    'taskType',
+]);
+/**
+ * What an ACTIVITY breakdown groups by. A run carries no single agent kind or model
+ * (those are per-step facts, which is what the spend breakdowns key on), so the
+ * activity axis is deliberately narrower than the spend axis.
+ */
+export const reportActivityDimensionSchema = v.picklist(['workspace', 'service', 'taskType']);
+/**
+ * One slice of a spend breakdown. `key` is the raw dimension value and the row's
+ * identity; EMPTY means unattributed (a call whose run, service, or task type could
+ * not be resolved) — a real bucket, rendered as such, never dropped.
+ *
+ * The two costs are kept apart on purpose and must never be summed blindly: only
+ * `meteredCost` is real money. `subscriptionCost` is what the same tokens WOULD have
+ * cost on the metered API — illustrative for a flat-rate quota harness (Claude Code /
+ * Codex / GLM / pooled Kimi & DeepSeek), which is why the spend gate excludes it.
+ */
+export const reportSpendRowSchema = v.object({
+    key: v.string(),
+    /** Human-readable name for `key` when the store can resolve one (workspace/service); else null. */
+    label: v.nullable(v.string()),
+    inputTokens: v.number(),
+    outputTokens: v.number(),
+    /** Number of metered LLM calls in this slice (both billing kinds). */
+    calls: v.number(),
+    /** Real per-token cost, in the deployment's spend currency. */
+    meteredCost: v.number(),
+    /** Illustrative equivalent-API cost of flat-rate subscription usage. Never real spend. */
+    subscriptionCost: v.number(),
+});
+/**
+ * One slice of an activity breakdown, over the agent runs CREATED in the window — every
+ * kind of run (task pipelines, repo bootstraps, env-config repairs), so this half of a row
+ * covers the same population whose LLM calls the spend half reports.
+ */
+export const reportActivityRowSchema = v.object({
+    key: v.string(),
+    label: v.nullable(v.string()),
+    /** All runs created in the window in this slice. */
+    runs: v.number(),
+    done: v.number(),
+    failed: v.number(),
+    /** Runs still in flight (`running`). */
+    running: v.number(),
+    /** Every other status (`blocked` / `paused` / `pending`). */
+    other: v.number(),
+    /** Mean wall-clock duration over this slice's TERMINAL runs (ms); null when none. */
+    avgDurationMs: v.nullable(v.number()),
+});
+/** One contiguous time bucket of the spend trend (zero-filled, oldest first). */
+export const reportTrendPointSchema = v.object({
+    /** Epoch-ms start of the bucket. */
+    start: v.number(),
+    meteredCost: v.number(),
+    subscriptionCost: v.number(),
+    calls: v.number(),
+    inputTokens: v.number(),
+    outputTokens: v.number(),
+});
+/** Window-wide totals, folded from the `model` breakdown (no extra query). */
+export const reportTotalsSchema = v.object({
+    inputTokens: v.number(),
+    outputTokens: v.number(),
+    calls: v.number(),
+    meteredCost: v.number(),
+    subscriptionCost: v.number(),
+});
+/** The complete reports projection the SPA renders. */
+export const reportsViewSchema = v.object({
+    window: reportWindowSchema,
+    /** When the projection was computed (epoch ms). */
+    generatedAt: v.number(),
+    /**
+     * Start of the window (epoch ms): `generatedAt - window`, snapped DOWN to a trend-bucket
+     * edge so the chart's first column is a complete bucket rather than a short one that reads
+     * as a quiet period. A window therefore covers up to one bucket more than its nominal
+     * length, and this is the real span every number in the projection was computed over.
+     */
+    since: v.number(),
+    /** The single workspace every breakdown was narrowed to, or null for the whole account. */
+    workspaceId: v.nullable(v.string()),
+    /** The deployment's spend currency, so the SPA formats costs without a second call. */
+    currency: v.string(),
+    totals: reportTotalsSchema,
+    /** Spend sliced every way, each heaviest-first. */
+    spend: v.object({
+        byModel: v.array(reportSpendRowSchema),
+        byAgentKind: v.array(reportSpendRowSchema),
+        byWorkspace: v.array(reportSpendRowSchema),
+        byService: v.array(reportSpendRowSchema),
+        byTaskType: v.array(reportSpendRowSchema),
+    }),
+    /** Run activity sliced every way, each busiest-first. */
+    activity: v.object({
+        byWorkspace: v.array(reportActivityRowSchema),
+        byService: v.array(reportActivityRowSchema),
+        byTaskType: v.array(reportActivityRowSchema),
+    }),
+    /** Spend over time at `bucketMs` resolution. */
+    trend: v.object({
+        bucketMs: v.number(),
+        points: v.array(reportTrendPointSchema),
+    }),
+});
+//# sourceMappingURL=reports.js.map

package/dist/reports.js.map

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

package/dist/requests.d.ts

@@ -153,7 +153,7 @@ export declare const updateBlockSchema: Omit<v.ObjectSchema<{
     readonly pipelineId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>;
     readonly agentConfig: v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>;
     readonly provisioning: v.ObjectSchema<{
-        readonly type: v.PicklistSchema<["kubernetes", "docker-compose", "custom", "infraless"], undefined>;
+        readonly type: v.PicklistSchema<["kubernetes", "docker-compose", "cloudflare", "custom", "infraless"], undefined>;
         readonly manifestSource: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
             readonly type: v.LiteralSchema<"colocated", undefined>;
             readonly path: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 500, undefined>]>;
@@ -444,7 +444,7 @@ export declare const updateBlockSchema: Omit<v.ObjectSchema<{
         readonly pipelineId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
         readonly agentConfig: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, undefined>;
         readonly provisioning: v.OptionalSchema<v.ObjectSchema<{
-            readonly type: v.PicklistSchema<["kubernetes", "docker-compose", "custom", "infraless"], undefined>;
+            readonly type: v.PicklistSchema<["kubernetes", "docker-compose", "cloudflare", "custom", "infraless"], undefined>;
             readonly manifestSource: v.OptionalSchema<v.VariantSchema<"type", [v.ObjectSchema<{
                 readonly type: v.LiteralSchema<"colocated", undefined>;
                 readonly path: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 500, undefined>]>;
@@ -737,7 +737,7 @@ export declare const updateBlockSchema: Omit<v.ObjectSchema<{
             [x: string]: string;
         } | undefined;
         provisioning?: {
-            type: "custom" | "docker-compose" | "infraless" | "kubernetes";
+            type: "cloudflare" | "custom" | "docker-compose" | "infraless" | "kubernetes";
             manifestSource?: {
                 type: "colocated";
                 path: string;
@@ -997,7 +997,7 @@ export declare const updateBlockSchema: Omit<v.ObjectSchema<{
             [x: string]: string;
         } | undefined;
         provisioning?: {
-            type: "custom" | "docker-compose" | "infraless" | "kubernetes";
+            type: "cloudflare" | "custom" | "docker-compose" | "infraless" | "kubernetes";
             manifestSource?: {
                 type: "colocated";
                 path: string;
@@ -1258,7 +1258,7 @@ export declare const updateBlockSchema: Omit<v.ObjectSchema<{
             [x: string]: string;
         } | undefined;
         provisioning?: {
-            type: "custom" | "docker-compose" | "infraless" | "kubernetes";
+            type: "cloudflare" | "custom" | "docker-compose" | "infraless" | "kubernetes";
             manifestSource?: {
                 type: "colocated";
                 path: string;
@@ -1543,7 +1543,7 @@ export declare const updateBlockSchema: Omit<v.ObjectSchema<{
                 [x: string]: string;
             } | undefined;
             provisioning?: {
-                type: "custom" | "docker-compose" | "infraless" | "kubernetes";
+                type: "cloudflare" | "custom" | "docker-compose" | "infraless" | "kubernetes";
                 manifestSource?: {
                     type: "colocated";
                     path: string;
@@ -1804,7 +1804,7 @@ export declare const updateBlockSchema: Omit<v.ObjectSchema<{
                 [x: string]: string;
             } | undefined;
             provisioning?: {
-                type: "custom" | "docker-compose" | "infraless" | "kubernetes";
+                type: "cloudflare" | "custom" | "docker-compose" | "infraless" | "kubernetes";
                 manifestSource?: {
                     type: "colocated";
                     path: string;

package/dist/routes/accounts.d.ts

@@ -1003,4 +1003,145 @@ export declare const getPlatformObservabilityContract: {
         }, undefined>;
     };
 };
+export declare const getReportsContract: {
+    readonly method: "get";
+    readonly requestPathParamsSchema: v.ObjectSchema<{
+        accountId: v.StringSchema<undefined>;
+    }, undefined> & import("@toad-contracts/core").StandardObjectKeysV1<unknown, unknown>;
+    readonly requestQuerySchema: v.ObjectSchema<{
+        readonly window: v.OptionalSchema<v.PicklistSchema<["24h", "7d", "30d", "90d"], undefined>, undefined>;
+        readonly workspaceId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly pathResolver: ({ accountId }: {
+        accountId: string;
+    }) => string;
+    readonly responsesByStatusCode: {
+        readonly '4xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly '5xx': v.ObjectSchema<{
+            readonly error: v.ObjectSchema<{
+                readonly code: v.StringSchema<undefined>;
+                readonly message: v.StringSchema<undefined>;
+                readonly details: v.OptionalSchema<v.UnknownSchema, undefined>;
+                readonly issues: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+                    readonly path: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly message: v.StringSchema<undefined>;
+                }, undefined>, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+        readonly 200: v.ObjectSchema<{
+            readonly window: v.PicklistSchema<["24h", "7d", "30d", "90d"], undefined>;
+            readonly generatedAt: v.NumberSchema<undefined>;
+            readonly since: v.NumberSchema<undefined>;
+            readonly workspaceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly currency: v.StringSchema<undefined>;
+            readonly totals: v.ObjectSchema<{
+                readonly inputTokens: v.NumberSchema<undefined>;
+                readonly outputTokens: v.NumberSchema<undefined>;
+                readonly calls: v.NumberSchema<undefined>;
+                readonly meteredCost: v.NumberSchema<undefined>;
+                readonly subscriptionCost: v.NumberSchema<undefined>;
+            }, undefined>;
+            readonly spend: v.ObjectSchema<{
+                readonly byModel: v.ArraySchema<v.ObjectSchema<{
+                    readonly key: v.StringSchema<undefined>;
+                    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                    readonly inputTokens: v.NumberSchema<undefined>;
+                    readonly outputTokens: v.NumberSchema<undefined>;
+                    readonly calls: v.NumberSchema<undefined>;
+                    readonly meteredCost: v.NumberSchema<undefined>;
+                    readonly subscriptionCost: v.NumberSchema<undefined>;
+                }, undefined>, undefined>;
+                readonly byAgentKind: v.ArraySchema<v.ObjectSchema<{
+                    readonly key: v.StringSchema<undefined>;
+                    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                    readonly inputTokens: v.NumberSchema<undefined>;
+                    readonly outputTokens: v.NumberSchema<undefined>;
+                    readonly calls: v.NumberSchema<undefined>;
+                    readonly meteredCost: v.NumberSchema<undefined>;
+                    readonly subscriptionCost: v.NumberSchema<undefined>;
+                }, undefined>, undefined>;
+                readonly byWorkspace: v.ArraySchema<v.ObjectSchema<{
+                    readonly key: v.StringSchema<undefined>;
+                    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                    readonly inputTokens: v.NumberSchema<undefined>;
+                    readonly outputTokens: v.NumberSchema<undefined>;
+                    readonly calls: v.NumberSchema<undefined>;
+                    readonly meteredCost: v.NumberSchema<undefined>;
+                    readonly subscriptionCost: v.NumberSchema<undefined>;
+                }, undefined>, undefined>;
+                readonly byService: v.ArraySchema<v.ObjectSchema<{
+                    readonly key: v.StringSchema<undefined>;
+                    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                    readonly inputTokens: v.NumberSchema<undefined>;
+                    readonly outputTokens: v.NumberSchema<undefined>;
+                    readonly calls: v.NumberSchema<undefined>;
+                    readonly meteredCost: v.NumberSchema<undefined>;
+                    readonly subscriptionCost: v.NumberSchema<undefined>;
+                }, undefined>, undefined>;
+                readonly byTaskType: v.ArraySchema<v.ObjectSchema<{
+                    readonly key: v.StringSchema<undefined>;
+                    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                    readonly inputTokens: v.NumberSchema<undefined>;
+                    readonly outputTokens: v.NumberSchema<undefined>;
+                    readonly calls: v.NumberSchema<undefined>;
+                    readonly meteredCost: v.NumberSchema<undefined>;
+                    readonly subscriptionCost: v.NumberSchema<undefined>;
+                }, undefined>, undefined>;
+            }, undefined>;
+            readonly activity: v.ObjectSchema<{
+                readonly byWorkspace: v.ArraySchema<v.ObjectSchema<{
+                    readonly key: v.StringSchema<undefined>;
+                    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                    readonly runs: v.NumberSchema<undefined>;
+                    readonly done: v.NumberSchema<undefined>;
+                    readonly failed: v.NumberSchema<undefined>;
+                    readonly running: v.NumberSchema<undefined>;
+                    readonly other: v.NumberSchema<undefined>;
+                    readonly avgDurationMs: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+                }, undefined>, undefined>;
+                readonly byService: v.ArraySchema<v.ObjectSchema<{
+                    readonly key: v.StringSchema<undefined>;
+                    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                    readonly runs: v.NumberSchema<undefined>;
+                    readonly done: v.NumberSchema<undefined>;
+                    readonly failed: v.NumberSchema<undefined>;
+                    readonly running: v.NumberSchema<undefined>;
+                    readonly other: v.NumberSchema<undefined>;
+                    readonly avgDurationMs: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+                }, undefined>, undefined>;
+                readonly byTaskType: v.ArraySchema<v.ObjectSchema<{
+                    readonly key: v.StringSchema<undefined>;
+                    readonly label: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+                    readonly runs: v.NumberSchema<undefined>;
+                    readonly done: v.NumberSchema<undefined>;
+                    readonly failed: v.NumberSchema<undefined>;
+                    readonly running: v.NumberSchema<undefined>;
+                    readonly other: v.NumberSchema<undefined>;
+                    readonly avgDurationMs: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+                }, undefined>, undefined>;
+            }, undefined>;
+            readonly trend: v.ObjectSchema<{
+                readonly bucketMs: v.NumberSchema<undefined>;
+                readonly points: v.ArraySchema<v.ObjectSchema<{
+                    readonly start: v.NumberSchema<undefined>;
+                    readonly meteredCost: v.NumberSchema<undefined>;
+                    readonly subscriptionCost: v.NumberSchema<undefined>;
+                    readonly calls: v.NumberSchema<undefined>;
+                    readonly inputTokens: v.NumberSchema<undefined>;
+                    readonly outputTokens: v.NumberSchema<undefined>;
+                }, undefined>, undefined>;
+            }, undefined>;
+        }, undefined>;
+    };
+};
 //# sourceMappingURL=accounts.d.ts.map

package/dist/routes/accounts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/routes/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqC,MAAM,yBAAyB,CAAA;AAC3F,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AA+C5B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI/B,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKhC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMhC,CAAA;AAIF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKrC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMnC,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMjC,CAAA;AAIF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKlC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMnC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQnC,CAAA;AAIF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKrC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMnC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMtC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKtC,CAAA;AAIF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKrC,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM/B,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKlC,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM5B,CAAA;AAIF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKrC,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMxC,CAAA;AAMF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM3C,CAAA"}
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/routes/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqC,MAAM,yBAAyB,CAAA;AAC3F,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAgD5B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI/B,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKhC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMhC,CAAA;AAIF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKrC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMnC,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMjC,CAAA;AAIF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKlC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMnC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQnC,CAAA;AAIF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKrC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMnC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMtC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKtC,CAAA;AAIF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKrC,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM/B,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKlC,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM5B,CAAA;AAIF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKrC,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMxC,CAAA;AAMF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM3C,CAAA;AAQF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAS7B,CAAA"}

package/dist/routes/accounts.js

@@ -4,6 +4,7 @@ import { accountInvitationSchema, accountMemberSchema, accountSchema, addMemberS
 import { accountSettingsViewSchema, updateAccountSettingsSchema } from '../accountSettings.js';
 import { addApiKeySchema, apiKeyListResultSchema, apiKeySchema, updateApiKeySchema, } from '../api-keys.js';
 import { platformObservabilitySchema, platformObservabilityWindowSchema } from '../observability.js';
+import { reportWindowSchema, reportsViewSchema } from '../reports.js';
 import { errorResponses, singleStringParam } from './_shared.js';
 // ---------------------------------------------------------------------------
 // Account tenancy route contracts. See AccountController in @cat-factory/server.
@@ -160,4 +161,19 @@ export const getPlatformObservabilityContract = defineApiContract({
     pathResolver: ({ accountId }) => `/accounts/${accountId}/observability/platform`,
     responsesByStatusCode: { 200: platformObservabilitySchema, ...errorResponses },
 });
+// ---- reports (admin-only) -------------------------------------------------
+// Cross-cutting usage analytics for the account: spend per model / agent kind, and
+// spend + run activity per workspace / service / task type, over a time window. Admin
+// gated for the same reason as the dashboard above (cross-workspace operational data).
+// `workspaceId` narrows EVERY breakdown to one board; absent ⇒ the whole account.
+export const getReportsContract = defineApiContract({
+    method: 'get',
+    requestPathParamsSchema: accountIdParams,
+    requestQuerySchema: v.object({
+        window: v.optional(reportWindowSchema),
+        workspaceId: v.optional(v.string()),
+    }),
+    pathResolver: ({ accountId }) => `/accounts/${accountId}/reports`,
+    responsesByStatusCode: { 200: reportsViewSchema, ...errorResponses },
+});
 //# sourceMappingURL=accounts.js.map