@meyicloud/meyi-insight-server 1.1.1 → 1.1.3

package/dist/features/ai-usage/ai-usage.controller.d.ts

@@ -0,0 +1,7 @@
+import type { Request, Response } from "express";
+import type { AiUsageService } from "./ai-usage.service.js";
+export declare function createAiUsageController(service: AiUsageService): {
+    summary(req: Request, res: Response): Promise<Response<any, Record<string, any>>>;
+    list(req: Request, res: Response): Promise<Response<any, Record<string, any>>>;
+};
+//# sourceMappingURL=ai-usage.controller.d.ts.map

package/dist/features/ai-usage/ai-usage.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.controller.d.ts","sourceRoot":"","sources":["../../../src/features/ai-usage/ai-usage.controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAU5D,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc;iBAExC,OAAO,OAAO,QAAQ;cAQzB,OAAO,OAAO,QAAQ;EASzC"}

package/dist/features/ai-usage/ai-usage.controller.js

@@ -0,0 +1,32 @@
+import { resolveTenantId } from "../../tenancy.js";
+import { parseUsageFilters } from "./ai-usage.query.js";
+import { AiUsageError } from "./ai-usage.types.js";
+function fail(res, e) {
+    if (e instanceof AiUsageError) {
+        return res.status(e.status).json({ ok: false, error: e.message });
+    }
+    return res.status(500).json({ ok: false, error: e?.message ?? "Internal error" });
+}
+export function createAiUsageController(service) {
+    return {
+        async summary(req, res) {
+            try {
+                const filters = parseUsageFilters(req.query);
+                return res.json({ ok: true, ...(await service.summary(resolveTenantId(req), filters)) });
+            }
+            catch (e) {
+                return fail(res, e);
+            }
+        },
+        async list(req, res) {
+            try {
+                const filters = parseUsageFilters(req.query);
+                return res.json({ ok: true, ...(await service.list(resolveTenantId(req), filters)) });
+            }
+            catch (e) {
+                return fail(res, e);
+            }
+        },
+    };
+}
+//# sourceMappingURL=ai-usage.controller.js.map

package/dist/features/ai-usage/ai-usage.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.controller.js","sourceRoot":"","sources":["../../../src/features/ai-usage/ai-usage.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,SAAS,IAAI,CAAC,GAAa,EAAE,CAAM;IACjC,IAAI,CAAC,YAAY,YAAY,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,IAAI,gBAAgB,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAuB;IAC7D,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,GAAY,EAAE,GAAa;YACvC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAgC,CAAC,CAAC;gBACxE,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3F,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAY,EAAE,GAAa;YACpC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAgC,CAAC,CAAC;gBACxE,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;YACxF,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/features/ai-usage/ai-usage.model.d.ts

@@ -0,0 +1,24 @@
+import type { UsageFilters } from "./ai-usage.types.js";
+/**
+ * Read-only access to meyiconnect.ai_usage_log. Every query is scoped by
+ * tenant_id and the filter window; there are no business rules here.
+ */
+export declare class AiUsageModel {
+    private db;
+    constructor(db: any);
+    private where;
+    totals(tenantId: string, f: UsageFilters): Promise<Record<string, unknown>>;
+    /** Per UTC day; days with no runs are absent (the service fills them). */
+    daily(tenantId: string, f: UsageFilters): Promise<Record<string, unknown>[]>;
+    byCallType(tenantId: string, f: UsageFilters): Promise<Record<string, unknown>[]>;
+    /**
+     * Per model, from each row's per-model lines. A line without "provider" is
+     * Bedrock (insight-ai only tags non-Bedrock lines). Cost sums priced lines.
+     */
+    byModel(tenantId: string, f: UsageFilters, limit?: number): Promise<Record<string, unknown>[]>;
+    list(tenantId: string, f: UsageFilters): Promise<{
+        rows: Record<string, unknown>[];
+        total: number;
+    }>;
+}
+//# sourceMappingURL=ai-usage.model.d.ts.map

package/dist/features/ai-usage/ai-usage.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.model.d.ts","sourceRoot":"","sources":["../../../src/features/ai-usage/ai-usage.model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAgBxD;;;GAGG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,GAAG;IAE3B,OAAO,CAAC,KAAK;IAOP,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAcjF,0EAA0E;IACpE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAa5E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAavF;;;OAGG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAkB1F,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAiB3G"}

package/dist/features/ai-usage/ai-usage.model.js

@@ -0,0 +1,105 @@
+import { sql } from "drizzle-orm";
+// Created by src/migrations/run.ts (and, identically, insight-cost-server's
+// schema installer); written by insight-ai and insight-cost-server only.
+const TABLE = sql.raw(`"meyiconnect"."ai_usage_log"`);
+// A row's `models` is a JSON array by both writers' contract; anything else is
+// treated as empty rather than letting jsonb_array_elements() fail the query.
+const MODEL_LINES = sql.raw(`jsonb_array_elements(CASE WHEN jsonb_typeof(u.models) = 'array' THEN u.models ELSE '[]'::jsonb END)`);
+function rowsOf(res) {
+    return res?.rows ?? (Array.isArray(res) ? res : []);
+}
+/**
+ * Read-only access to meyiconnect.ai_usage_log. Every query is scoped by
+ * tenant_id and the filter window; there are no business rules here.
+ */
+export class AiUsageModel {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    where(tenantId, f, opts = {}) {
+        const parts = [sql `u.tenant_id = ${tenantId}`, sql `u.created_at >= ${f.since}`];
+        if (f.callType)
+            parts.push(sql `u.call_type = ${f.callType}`);
+        if (opts.priced !== undefined)
+            parts.push(sql `u.priced = ${opts.priced}`);
+        return sql.join(parts, sql ` AND `);
+    }
+    async totals(tenantId, f) {
+        const res = await this.db.execute(sql `
+      SELECT count(*)::int                                          AS runs,
+             count(*) FILTER (WHERE u.priced)::int                  AS priced_runs,
+             coalesce(sum(u.total_input_tokens), 0)::bigint         AS input_tokens,
+             coalesce(sum(u.total_output_tokens), 0)::bigint        AS output_tokens,
+             coalesce(sum(u.total_tokens), 0)::bigint               AS total_tokens,
+             coalesce(sum(u.total_cost) FILTER (WHERE u.priced), 0) AS total_cost
+      FROM ${TABLE} u
+      WHERE ${this.where(tenantId, f)}
+    `);
+        return rowsOf(res)[0] ?? {};
+    }
+    /** Per UTC day; days with no runs are absent (the service fills them). */
+    async daily(tenantId, f) {
+        return rowsOf(await this.db.execute(sql `
+      SELECT to_char(u.created_at AT TIME ZONE 'UTC', 'YYYY-MM-DD')  AS date,
+             count(*)::int                                          AS runs,
+             coalesce(sum(u.total_tokens), 0)::bigint               AS total_tokens,
+             coalesce(sum(u.total_cost) FILTER (WHERE u.priced), 0) AS total_cost
+      FROM ${TABLE} u
+      WHERE ${this.where(tenantId, f)}
+      GROUP BY 1
+      ORDER BY 1
+    `));
+    }
+    async byCallType(tenantId, f) {
+        return rowsOf(await this.db.execute(sql `
+      SELECT u.call_type,
+             count(*)::int                                          AS runs,
+             coalesce(sum(u.total_tokens), 0)::bigint               AS total_tokens,
+             coalesce(sum(u.total_cost) FILTER (WHERE u.priced), 0) AS total_cost
+      FROM ${TABLE} u
+      WHERE ${this.where(tenantId, f)}
+      GROUP BY u.call_type
+      ORDER BY total_tokens DESC
+    `));
+    }
+    /**
+     * Per model, from each row's per-model lines. A line without "provider" is
+     * Bedrock (insight-ai only tags non-Bedrock lines). Cost sums priced lines.
+     */
+    async byModel(tenantId, f, limit = 10) {
+        return rowsOf(await this.db.execute(sql `
+      SELECT coalesce(nullif(m->>'model_id', ''), 'unknown')                             AS model,
+             coalesce(nullif(m->>'provider', ''), 'bedrock')                             AS provider,
+             coalesce(sum((m->>'calls')::numeric), 0)::bigint                             AS calls,
+             coalesce(sum((m->>'input_tokens')::numeric), 0)::bigint                      AS input_tokens,
+             coalesce(sum((m->>'output_tokens')::numeric), 0)::bigint                     AS output_tokens,
+             coalesce(sum((m->>'total_cost')::numeric) FILTER (WHERE (m->>'priced')::boolean), 0) AS total_cost,
+             bool_or(coalesce((m->>'priced')::boolean, false))                            AS priced
+      FROM ${TABLE} u, ${MODEL_LINES} AS m
+      WHERE ${this.where(tenantId, f)}
+      GROUP BY 1, 2
+      ORDER BY coalesce(sum((m->>'input_tokens')::numeric), 0)
+             + coalesce(sum((m->>'output_tokens')::numeric), 0) DESC
+      LIMIT ${limit}
+    `));
+    }
+    async list(tenantId, f) {
+        const where = this.where(tenantId, f, { priced: f.priced });
+        const [page, count] = await Promise.all([
+            this.db.execute(sql `
+        SELECT u.id, u.call_type, u.incident_id, u.incident_name, u.sop_id, u.report_id, u.models,
+               u.total_input_tokens, u.total_output_tokens, u.total_cache_read_tokens,
+               u.total_cache_write_tokens, u.total_tokens, u.total_cost, u.currency,
+               u.priced, u.reason, u.created_at
+        FROM ${TABLE} u
+        WHERE ${where}
+        ORDER BY u.created_at DESC
+        LIMIT ${f.limit} OFFSET ${(f.page - 1) * f.limit}
+      `),
+            this.db.execute(sql `SELECT count(*)::int AS total FROM ${TABLE} u WHERE ${where}`),
+        ]);
+        return { rows: rowsOf(page), total: Number(rowsOf(count)[0]?.total ?? 0) };
+    }
+}
+//# sourceMappingURL=ai-usage.model.js.map

package/dist/features/ai-usage/ai-usage.model.js.map

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

package/dist/features/ai-usage/ai-usage.query.d.ts

@@ -0,0 +1,13 @@
+import { type UsageDay, type UsageFilters, type UsageRecord } from "./ai-usage.types.js";
+/** Midnight UTC, (days - 1) days before *now* — so "7d" is today plus the six days before it. */
+export declare function windowStart(days: number, now?: Date): Date;
+/** Validates the query string; unknown values fall back to defaults, malformed filters are rejected. */
+export declare function parseUsageFilters(query: Record<string, unknown>, now?: Date): UsageFilters;
+/** pg returns bigint/numeric as strings; nulls stay null only where the caller asks. */
+export declare function num(value: unknown): number;
+export declare function cost(value: unknown): number | null;
+/** One entry per day of the window, oldest first, with zeroes where nothing ran. */
+export declare function fillDailySeries(rows: Array<Record<string, unknown>>, since: Date, days: number): UsageDay[];
+/** A raw ai_usage_log row → the API shape. The busiest model names the row. */
+export declare function toUsageRecord(row: Record<string, any>): UsageRecord;
+//# sourceMappingURL=ai-usage.query.d.ts.map

package/dist/features/ai-usage/ai-usage.query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.query.d.ts","sourceRoot":"","sources":["../../../src/features/ai-usage/ai-usage.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,YAAY,EAGjB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAmB7B,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,IAAI,CAIhE;AAED,wGAAwG;AACxG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAa,GAAG,YAAY,CAyBhG;AAED,wFAAwF;AACxF,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG1C;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIlD;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAgB3G;AAUD,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,CA6BnE"}

package/dist/features/ai-usage/ai-usage.query.js

@@ -0,0 +1,119 @@
+import { AiUsageError, USAGE_RANGES, } from "./ai-usage.types.js";
+const DEFAULT_RANGE = "30d";
+const DEFAULT_LIMIT = 25;
+const MAX_LIMIT = 100;
+// call_type is free text written by other services; accept anything shaped
+// like one (rca, sop, cost_report, …) rather than a list that goes stale.
+const CALL_TYPE = /^[a-z][a-z0-9_]{0,31}$/;
+function first(value) {
+    if (Array.isArray(value))
+        return first(value[0]);
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function positiveInt(value, fallback) {
+    const n = Number(first(value));
+    return Number.isInteger(n) && n > 0 ? n : fallback;
+}
+/** Midnight UTC, (days - 1) days before *now* — so "7d" is today plus the six days before it. */
+export function windowStart(days, now = new Date()) {
+    const start = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
+    start.setUTCDate(start.getUTCDate() - (days - 1));
+    return start;
+}
+/** Validates the query string; unknown values fall back to defaults, malformed filters are rejected. */
+export function parseUsageFilters(query, now = new Date()) {
+    const rangeRaw = first(query.range);
+    if (rangeRaw && !(rangeRaw in USAGE_RANGES)) {
+        throw new AiUsageError(`range must be one of ${Object.keys(USAGE_RANGES).join(", ")}`);
+    }
+    const range = rangeRaw || DEFAULT_RANGE;
+    const days = USAGE_RANGES[range];
+    const callType = first(query.callType);
+    if (callType && !CALL_TYPE.test(callType))
+        throw new AiUsageError("callType is invalid");
+    const pricedRaw = first(query.priced);
+    if (pricedRaw && pricedRaw !== "true" && pricedRaw !== "false") {
+        throw new AiUsageError("priced must be true or false");
+    }
+    return {
+        range,
+        days,
+        since: windowStart(days, now),
+        callType,
+        priced: pricedRaw === undefined ? undefined : pricedRaw === "true",
+        page: positiveInt(query.page, 1),
+        limit: Math.min(positiveInt(query.limit, DEFAULT_LIMIT), MAX_LIMIT),
+    };
+}
+/** pg returns bigint/numeric as strings; nulls stay null only where the caller asks. */
+export function num(value) {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : 0;
+}
+export function cost(value) {
+    if (value === null || value === undefined || value === "")
+        return null;
+    const n = Number(value);
+    return Number.isFinite(n) ? Math.round(n * 1e6) / 1e6 : null;
+}
+/** One entry per day of the window, oldest first, with zeroes where nothing ran. */
+export function fillDailySeries(rows, since, days) {
+    const byDate = new Map(rows.map((r) => [String(r.date), r]));
+    const out = [];
+    for (let i = 0; i < days; i++) {
+        const d = new Date(since);
+        d.setUTCDate(d.getUTCDate() + i);
+        const date = d.toISOString().slice(0, 10);
+        const row = byDate.get(date);
+        out.push({
+            date,
+            runs: num(row?.runs),
+            totalTokens: num(row?.total_tokens),
+            totalCost: cost(row?.total_cost) ?? 0,
+        });
+    }
+    return out;
+}
+function modelLines(models) {
+    if (Array.isArray(models))
+        return models.filter((m) => m && typeof m === "object");
+    if (typeof models === "string") {
+        try {
+            return modelLines(JSON.parse(models));
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+/** A raw ai_usage_log row → the API shape. The busiest model names the row. */
+export function toUsageRecord(row) {
+    const lines = modelLines(row.models);
+    const busiest = [...lines].sort((a, b) => num(b.input_tokens) + num(b.output_tokens) - (num(a.input_tokens) + num(a.output_tokens)))[0];
+    const priced = Boolean(row.priced);
+    return {
+        id: String(row.id),
+        callType: String(row.call_type),
+        incidentId: row.incident_id ?? null,
+        incidentName: row.incident_name ?? null,
+        sopId: row.sop_id ?? null,
+        reportId: row.report_id ?? null,
+        model: busiest?.model_id || null,
+        // Only non-Bedrock lines carry "provider" from insight-ai; an absent one is Bedrock.
+        provider: busiest ? busiest.provider || "bedrock" : null,
+        modelCount: lines.length,
+        calls: lines.reduce((sum, m) => sum + num(m.calls), 0),
+        inputTokens: num(row.total_input_tokens),
+        outputTokens: num(row.total_output_tokens),
+        cacheReadTokens: num(row.total_cache_read_tokens),
+        cacheWriteTokens: num(row.total_cache_write_tokens),
+        totalTokens: num(row.total_tokens),
+        totalCost: priced ? cost(row.total_cost) : null,
+        currency: row.currency || "USD",
+        priced,
+        reason: row.reason ?? null,
+        createdAt: new Date(row.created_at).toISOString(),
+    };
+}
+//# sourceMappingURL=ai-usage.query.js.map

package/dist/features/ai-usage/ai-usage.query.js.map

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

package/dist/features/ai-usage/ai-usage.routes.d.ts

@@ -0,0 +1,8 @@
+import { Router } from "express";
+import type { AiUsageService } from "./ai-usage.service.js";
+/**
+ * Read-only. Query: range=7d|30d|90d (default 30d), callType, and for the list
+ * priced=true|false, page, limit (max 100). Admin-only — gated in routes/index.ts.
+ */
+export declare function createAiUsageRouter(service: AiUsageService): Router;
+//# sourceMappingURL=ai-usage.routes.d.ts.map

package/dist/features/ai-usage/ai-usage.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.routes.d.ts","sourceRoot":"","sources":["../../../src/features/ai-usage/ai-usage.routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAQnE"}

package/dist/features/ai-usage/ai-usage.routes.js

@@ -0,0 +1,14 @@
+import { Router } from "express";
+import { createAiUsageController } from "./ai-usage.controller.js";
+/**
+ * Read-only. Query: range=7d|30d|90d (default 30d), callType, and for the list
+ * priced=true|false, page, limit (max 100). Admin-only — gated in routes/index.ts.
+ */
+export function createAiUsageRouter(service) {
+    const router = Router();
+    const ctrl = createAiUsageController(service);
+    router.get("/summary", ctrl.summary.bind(ctrl));
+    router.get("/", ctrl.list.bind(ctrl));
+    return router;
+}
+//# sourceMappingURL=ai-usage.routes.js.map

package/dist/features/ai-usage/ai-usage.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.routes.js","sourceRoot":"","sources":["../../../src/features/ai-usage/ai-usage.routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGnE;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAuB;IACzD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAE9C,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEtC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/features/ai-usage/ai-usage.service.d.ts

@@ -0,0 +1,9 @@
+import type { AiUsageModel } from "./ai-usage.model.js";
+import type { UsageFilters, UsageList, UsageSummary } from "./ai-usage.types.js";
+export declare class AiUsageService {
+    private model;
+    constructor(model: AiUsageModel);
+    summary(tenantId: string, f: UsageFilters): Promise<UsageSummary>;
+    list(tenantId: string, f: UsageFilters): Promise<UsageList>;
+}
+//# sourceMappingURL=ai-usage.service.d.ts.map

package/dist/features/ai-usage/ai-usage.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.service.d.ts","sourceRoot":"","sources":["../../../src/features/ai-usage/ai-usage.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEjF,qBAAa,cAAc;IACb,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY;IAEjC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAyCjE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;CAIlE"}

package/dist/features/ai-usage/ai-usage.service.js

@@ -0,0 +1,52 @@
+import { cost, fillDailySeries, num, toUsageRecord } from "./ai-usage.query.js";
+export class AiUsageService {
+    model;
+    constructor(model) {
+        this.model = model;
+    }
+    async summary(tenantId, f) {
+        const [totals, daily, byCallType, byModel] = await Promise.all([
+            this.model.totals(tenantId, f),
+            this.model.daily(tenantId, f),
+            this.model.byCallType(tenantId, f),
+            this.model.byModel(tenantId, f),
+        ]);
+        const runs = num(totals.runs);
+        const pricedRuns = num(totals.priced_runs);
+        return {
+            range: f.range,
+            since: f.since.toISOString(),
+            currency: "USD",
+            totals: {
+                runs,
+                pricedRuns,
+                unpricedRuns: runs - pricedRuns,
+                inputTokens: num(totals.input_tokens),
+                outputTokens: num(totals.output_tokens),
+                totalTokens: num(totals.total_tokens),
+                totalCost: cost(totals.total_cost) ?? 0,
+            },
+            daily: fillDailySeries(daily, f.since, f.days),
+            byCallType: byCallType.map((r) => ({
+                callType: String(r.call_type),
+                runs: num(r.runs),
+                totalTokens: num(r.total_tokens),
+                totalCost: cost(r.total_cost) ?? 0,
+            })),
+            byModel: byModel.map((r) => ({
+                model: String(r.model),
+                provider: String(r.provider),
+                calls: num(r.calls),
+                inputTokens: num(r.input_tokens),
+                outputTokens: num(r.output_tokens),
+                totalCost: cost(r.total_cost) ?? 0,
+                priced: Boolean(r.priced),
+            })),
+        };
+    }
+    async list(tenantId, f) {
+        const { rows, total } = await this.model.list(tenantId, f);
+        return { items: rows.map(toUsageRecord), total, page: f.page, limit: f.limit };
+    }
+}
+//# sourceMappingURL=ai-usage.service.js.map

package/dist/features/ai-usage/ai-usage.service.js.map

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

package/dist/features/ai-usage/ai-usage.types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * AI usage — one row of meyiconnect.ai_usage_log per AI run, written by
+ * insight-ai (call_type 'rca' | 'sop') and insight-cost-server ('cost_report').
+ * This feature only reads it.
+ */
+export declare const USAGE_RANGES: {
+    readonly "7d": 7;
+    readonly "30d": 30;
+    readonly "90d": 90;
+};
+export type UsageRange = keyof typeof USAGE_RANGES;
+export interface UsageFilters {
+    range: UsageRange;
+    /** Inclusive UTC start of the window: midnight, (days - 1) days before today. */
+    since: Date;
+    days: number;
+    callType?: string;
+    priced?: boolean;
+    page: number;
+    limit: number;
+}
+/** One per-model line from the row's `models` JSONB (both writers use this snake_case shape). */
+export interface UsageModelLine {
+    model_id?: string;
+    provider?: string;
+    region?: string;
+    input_tokens?: number;
+    output_tokens?: number;
+    calls?: number;
+    priced?: boolean;
+    total_cost?: number | null;
+    reason?: string;
+}
+export interface UsageRecord {
+    id: string;
+    callType: string;
+    incidentId: string | null;
+    incidentName: string | null;
+    sopId: string | null;
+    reportId: string | null;
+    model: string | null;
+    provider: string | null;
+    modelCount: number;
+    calls: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    totalTokens: number;
+    /** null when the run could not be priced — never a fabricated 0. */
+    totalCost: number | null;
+    currency: string;
+    priced: boolean;
+    reason: string | null;
+    createdAt: string;
+}
+export interface UsageTotals {
+    runs: number;
+    pricedRuns: number;
+    unpricedRuns: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    /** Sum over priced runs only; unpricedRuns says how much is missing from it. */
+    totalCost: number;
+}
+export interface UsageDay {
+    date: string;
+    runs: number;
+    totalTokens: number;
+    totalCost: number;
+}
+export interface UsageByCallType {
+    callType: string;
+    runs: number;
+    totalTokens: number;
+    totalCost: number;
+}
+export interface UsageByModel {
+    model: string;
+    provider: string;
+    calls: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalCost: number;
+    priced: boolean;
+}
+export interface UsageSummary {
+    range: UsageRange;
+    since: string;
+    currency: "USD";
+    totals: UsageTotals;
+    daily: UsageDay[];
+    byCallType: UsageByCallType[];
+    byModel: UsageByModel[];
+}
+export interface UsageList {
+    items: UsageRecord[];
+    total: number;
+    page: number;
+    limit: number;
+}
+export declare class AiUsageError extends Error {
+    status: number;
+    constructor(message: string, status?: number);
+}
+//# sourceMappingURL=ai-usage.types.d.ts.map

package/dist/features/ai-usage/ai-usage.types.d.ts.map

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

package/dist/features/ai-usage/ai-usage.types.js

@@ -0,0 +1,14 @@
+/**
+ * AI usage — one row of meyiconnect.ai_usage_log per AI run, written by
+ * insight-ai (call_type 'rca' | 'sop') and insight-cost-server ('cost_report').
+ * This feature only reads it.
+ */
+export const USAGE_RANGES = { "7d": 7, "30d": 30, "90d": 90 };
+export class AiUsageError extends Error {
+    status;
+    constructor(message, status = 400) {
+        super(message);
+        this.status = status;
+    }
+}
+//# sourceMappingURL=ai-usage.types.js.map

package/dist/features/ai-usage/ai-usage.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage.types.js","sourceRoot":"","sources":["../../../src/features/ai-usage/ai-usage.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAW,CAAC;AA2FvE,MAAM,OAAO,YAAa,SAAQ,KAAK;IACD;IAApC,YAAY,OAAe,EAAS,SAAS,GAAG;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QADmB,WAAM,GAAN,MAAM,CAAM;IAEhD,CAAC;CACF"}

package/dist/features/ai-usage/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./ai-usage.types.js";
+export { AiUsageModel } from "./ai-usage.model.js";
+export { AiUsageService } from "./ai-usage.service.js";
+export { createAiUsageRouter } from "./ai-usage.routes.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/ai-usage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/ai-usage/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/features/ai-usage/index.js

@@ -0,0 +1,5 @@
+export * from "./ai-usage.types.js";
+export { AiUsageModel } from "./ai-usage.model.js";
+export { AiUsageService } from "./ai-usage.service.js";
+export { createAiUsageRouter } from "./ai-usage.routes.js";
+//# sourceMappingURL=index.js.map

package/dist/features/ai-usage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/ai-usage/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}