@opengeni/contracts 0.50.0 → 1.0.0

package/dist/insights-usage.d.ts

@@ -0,0 +1,877 @@
+import { z } from "zod";
+export declare const InsightsUsageRange: z.ZodEnum<{
+    "30d": "30d";
+    "90d": "90d";
+    custom: "custom";
+    month: "month";
+    today: "today";
+    week: "week";
+    ytd: "ytd";
+}>;
+export type InsightsUsageRange = z.infer<typeof InsightsUsageRange>;
+export declare const InsightsUsageGroupBy: z.ZodEnum<{
+    model: "model";
+    payer: "payer";
+    person: "person";
+    plan: "plan";
+    project: "project";
+    provider: "provider";
+    rootSession: "rootSession";
+    schedule: "schedule";
+    session: "session";
+    source: "source";
+    workspace: "workspace";
+}>;
+export type InsightsUsageGroupBy = z.infer<typeof InsightsUsageGroupBy>;
+/** Recorded entry surface only; API includes SDK/embed. Missing provenance is other. */
+export declare const InsightsUsageSource: z.ZodEnum<{
+    agent: "agent";
+    api: "api";
+    other: "other";
+    schedule: "schedule";
+    slack: "slack";
+    web: "web";
+}>;
+export type InsightsUsageSource = z.infer<typeof InsightsUsageSource>;
+/** At most 370 inclusive UTC days; exclusive end and equally long immediate prior. */
+export declare function resolveInsightsUsageCustomWindow(dates: {
+    from: string;
+    to: string;
+}): {
+    windowStart: string;
+    windowEnd: string;
+    priorWindowStart: string;
+    priorWindowEnd: string;
+    bucket: "day" | "hour";
+};
+export declare const InsightsUsagePayer: z.ZodUnion<readonly [z.ZodLiteral<"opengeni_credits">, z.ZodLiteral<"subscription">, z.ZodLiteral<"own_key">]>;
+export type InsightsUsagePayer = z.infer<typeof InsightsUsagePayer>;
+/** Split at the FIRST slash: model IDs themselves may contain slashes. */
+export declare const InsightsUsageModelKey: z.ZodString;
+export type InsightsUsageModelKey = z.infer<typeof InsightsUsageModelKey>;
+export declare const WorkspaceInsightsUsageQuery: z.ZodObject<{
+    range: z.ZodDefault<z.ZodEnum<{
+        "30d": "30d";
+        "90d": "90d";
+        custom: "custom";
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    provider: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    model: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    payer: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("opengeni_credits" | "own_key" | "subscription")[], string | string[]>>>;
+    plan: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    source: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("agent" | "api" | "other" | "schedule" | "slack" | "web")[], string | string[]>>>;
+    projectId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    person: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    sessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    rootSessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    scheduleId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    groupBy: z.ZodDefault<z.ZodEnum<{
+        model: "model";
+        payer: "payer";
+        person: "person";
+        plan: "plan";
+        project: "project";
+        provider: "provider";
+        rootSession: "rootSession";
+        schedule: "schedule";
+        session: "session";
+        source: "source";
+        workspace: "workspace";
+    }>>;
+    seriesGroups: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, "false" | "true" | boolean>>>;
+    limit: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>, z.ZodNumber>>;
+}, z.core.$strict>;
+export type WorkspaceInsightsUsageQuery = z.infer<typeof WorkspaceInsightsUsageQuery>;
+export type WorkspaceInsightsUsageQueryInput = z.input<typeof WorkspaceInsightsUsageQuery>;
+export declare const OrganizationInsightsUsageQuery: z.ZodObject<{
+    range: z.ZodDefault<z.ZodEnum<{
+        "30d": "30d";
+        "90d": "90d";
+        custom: "custom";
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    provider: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    model: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    payer: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("opengeni_credits" | "own_key" | "subscription")[], string | string[]>>>;
+    plan: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    source: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("agent" | "api" | "other" | "schedule" | "slack" | "web")[], string | string[]>>>;
+    projectId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    person: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    sessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    rootSessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    scheduleId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    groupBy: z.ZodDefault<z.ZodEnum<{
+        model: "model";
+        payer: "payer";
+        person: "person";
+        plan: "plan";
+        project: "project";
+        provider: "provider";
+        rootSession: "rootSession";
+        schedule: "schedule";
+        session: "session";
+        source: "source";
+        workspace: "workspace";
+    }>>;
+    seriesGroups: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, "false" | "true" | boolean>>>;
+    limit: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>, z.ZodNumber>>;
+}, z.core.$strict>;
+export type OrganizationInsightsUsageQuery = z.infer<typeof OrganizationInsightsUsageQuery>;
+export type OrganizationInsightsUsageQueryInput = z.input<typeof OrganizationInsightsUsageQuery>;
+/** Organization-capable shared shape; use the workspace parser at workspace scope. */
+export declare const InsightsUsageQuery: z.ZodObject<{
+    range: z.ZodDefault<z.ZodEnum<{
+        "30d": "30d";
+        "90d": "90d";
+        custom: "custom";
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    provider: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    model: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    payer: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("opengeni_credits" | "own_key" | "subscription")[], string | string[]>>>;
+    plan: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    source: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("agent" | "api" | "other" | "schedule" | "slack" | "web")[], string | string[]>>>;
+    projectId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    person: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    sessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    rootSessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    scheduleId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    groupBy: z.ZodDefault<z.ZodEnum<{
+        model: "model";
+        payer: "payer";
+        person: "person";
+        plan: "plan";
+        project: "project";
+        provider: "provider";
+        rootSession: "rootSession";
+        schedule: "schedule";
+        session: "session";
+        source: "source";
+        workspace: "workspace";
+    }>>;
+    seriesGroups: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, "false" | "true" | boolean>>>;
+    limit: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>, z.ZodNumber>>;
+}, z.core.$strict>;
+export type InsightsUsageQuery = OrganizationInsightsUsageQuery;
+export type InsightsUsageQueryInput = OrganizationInsightsUsageQueryInput;
+export declare const WorkspaceInsightsCallsQuery: z.ZodObject<{
+    range: z.ZodDefault<z.ZodEnum<{
+        "30d": "30d";
+        "90d": "90d";
+        custom: "custom";
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    provider: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    model: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    payer: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("opengeni_credits" | "own_key" | "subscription")[], string | string[]>>>;
+    plan: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    source: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("agent" | "api" | "other" | "schedule" | "slack" | "web")[], string | string[]>>>;
+    projectId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    person: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    sessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    rootSessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    scheduleId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>, z.ZodNumber>>;
+}, z.core.$strict>;
+export type WorkspaceInsightsCallsQuery = z.infer<typeof WorkspaceInsightsCallsQuery>;
+export type WorkspaceInsightsCallsQueryInput = z.input<typeof WorkspaceInsightsCallsQuery>;
+export declare const OrganizationInsightsCallsQuery: z.ZodObject<{
+    range: z.ZodDefault<z.ZodEnum<{
+        "30d": "30d";
+        "90d": "90d";
+        custom: "custom";
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    provider: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    model: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    payer: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("opengeni_credits" | "own_key" | "subscription")[], string | string[]>>>;
+    plan: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    source: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("agent" | "api" | "other" | "schedule" | "slack" | "web")[], string | string[]>>>;
+    projectId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    person: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    sessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    rootSessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    scheduleId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>, z.ZodNumber>>;
+}, z.core.$strict>;
+export type OrganizationInsightsCallsQuery = z.infer<typeof OrganizationInsightsCallsQuery>;
+export type OrganizationInsightsCallsQueryInput = z.input<typeof OrganizationInsightsCallsQuery>;
+export declare const InsightsCallsQuery: z.ZodObject<{
+    range: z.ZodDefault<z.ZodEnum<{
+        "30d": "30d";
+        "90d": "90d";
+        custom: "custom";
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    provider: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    model: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    payer: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("opengeni_credits" | "own_key" | "subscription")[], string | string[]>>>;
+    plan: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    source: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<("agent" | "api" | "other" | "schedule" | "slack" | "web")[], string | string[]>>>;
+    projectId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    person: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    sessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    rootSessionId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    scheduleId: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>, z.ZodNumber>>;
+}, z.core.$strict>;
+export type InsightsCallsQuery = OrganizationInsightsCallsQuery;
+export type InsightsCallsQueryInput = OrganizationInsightsCallsQueryInput;
+/** Missing historical token classes are represented by known-call counters, not guessed zeroes. */
+export declare const InsightsUsageTokens: z.ZodObject<{
+    uncachedInput: z.ZodNumber;
+    cacheRead: z.ZodNumber;
+    cacheWrite: z.ZodNumber;
+    output: z.ZodNumber;
+    reasoning: z.ZodNumber;
+}, z.core.$strict>;
+export type InsightsUsageTokens = z.infer<typeof InsightsUsageTokens>;
+/**
+ * List-price classes only: exact write-time snapshots or flagged historical
+ * allocations of each call's recorded total, never repricing that total.
+ * chargedMicros is the actual debit-ledger total and has no class split.
+ */
+export declare const InsightsUsageClassMicros: z.ZodObject<{
+    uncachedInput: z.ZodNumber;
+    cacheRead: z.ZodNumber;
+    cacheWrite: z.ZodNumber;
+    output: z.ZodNumber;
+}, z.core.$strict>;
+export type InsightsUsageClassMicros = z.infer<typeof InsightsUsageClassMicros>;
+export declare const InsightsUsageMeasures: z.ZodObject<{
+    calls: z.ZodNumber;
+    tokenKnownCalls: z.ZodNumber;
+    cacheKnownCalls: z.ZodNumber;
+    cacheWriteKnownCalls: z.ZodNumber;
+    listClassKnownCalls: z.ZodNumber;
+    tokens: z.ZodObject<{
+        uncachedInput: z.ZodNumber;
+        cacheRead: z.ZodNumber;
+        cacheWrite: z.ZodNumber;
+        output: z.ZodNumber;
+        reasoning: z.ZodNumber;
+    }, z.core.$strict>;
+    chargedMicros: z.ZodNumber;
+    listMicros: z.ZodNumber;
+    listByClassMicros: z.ZodNullable<z.ZodObject<{
+        uncachedInput: z.ZodNumber;
+        cacheRead: z.ZodNumber;
+        cacheWrite: z.ZodNumber;
+        output: z.ZodNumber;
+    }, z.core.$strict>>;
+    listByClassApprox: z.ZodBoolean;
+    pricedCalls: z.ZodNumber;
+    byPayer: z.ZodObject<{
+        opengeni_credits: z.ZodObject<{
+            calls: z.ZodNumber;
+            chargedMicros: z.ZodNumber;
+            listMicros: z.ZodNumber;
+        }, z.core.$strict>;
+        subscription: z.ZodObject<{
+            calls: z.ZodNumber;
+            chargedMicros: z.ZodNumber;
+            listMicros: z.ZodNumber;
+        }, z.core.$strict>;
+        own_key: z.ZodObject<{
+            calls: z.ZodNumber;
+            chargedMicros: z.ZodNumber;
+            listMicros: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type InsightsUsageMeasures = z.infer<typeof InsightsUsageMeasures>;
+export declare const InsightsUsageScope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"workspace">;
+    accountId: z.ZodString;
+    workspaceId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"organization">;
+    accountId: z.ZodString;
+    workspaceId: z.ZodNull;
+}, z.core.$strict>], "kind">;
+export type InsightsUsageScope = z.infer<typeof InsightsUsageScope>;
+export declare const InsightsUsageGroup: z.ZodObject<{
+    key: z.ZodString;
+    kind: z.ZodEnum<{
+        deleted: "deleted";
+        item: "item";
+        other: "other";
+        personal: "personal";
+        private: "private";
+        restricted: "restricted";
+        service: "service";
+        unfiled: "unfiled";
+    }>;
+    label: z.ZodString;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    personKey: z.ZodOptional<z.ZodString>;
+    you: z.ZodOptional<z.ZodBoolean>;
+    measures: z.ZodObject<{
+        calls: z.ZodNumber;
+        tokenKnownCalls: z.ZodNumber;
+        cacheKnownCalls: z.ZodNumber;
+        cacheWriteKnownCalls: z.ZodNumber;
+        listClassKnownCalls: z.ZodNumber;
+        tokens: z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+            reasoning: z.ZodNumber;
+        }, z.core.$strict>;
+        chargedMicros: z.ZodNumber;
+        listMicros: z.ZodNumber;
+        listByClassMicros: z.ZodNullable<z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$strict>>;
+        listByClassApprox: z.ZodBoolean;
+        pricedCalls: z.ZodNumber;
+        byPayer: z.ZodObject<{
+            opengeni_credits: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+            subscription: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+            own_key: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type InsightsUsageGroup = z.infer<typeof InsightsUsageGroup>;
+export declare const InsightsUsageSeriesPoint: z.ZodObject<{
+    start: z.ZodString;
+    measures: z.ZodObject<{
+        calls: z.ZodNumber;
+        tokenKnownCalls: z.ZodNumber;
+        cacheKnownCalls: z.ZodNumber;
+        cacheWriteKnownCalls: z.ZodNumber;
+        listClassKnownCalls: z.ZodNumber;
+        tokens: z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+            reasoning: z.ZodNumber;
+        }, z.core.$strict>;
+        chargedMicros: z.ZodNumber;
+        listMicros: z.ZodNumber;
+        listByClassMicros: z.ZodNullable<z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$strict>>;
+        listByClassApprox: z.ZodBoolean;
+        pricedCalls: z.ZodNumber;
+        byPayer: z.ZodObject<{
+            opengeni_credits: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+            subscription: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+            own_key: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    groups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        chargedMicros: z.ZodNumber;
+        listMicros: z.ZodNumber;
+        tokens: z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+            reasoning: z.ZodNumber;
+        }, z.core.$strict>;
+        calls: z.ZodNumber;
+        byPayer: z.ZodObject<{
+            opengeni_credits: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+            subscription: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+            own_key: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type InsightsUsageSeriesPoint = z.infer<typeof InsightsUsageSeriesPoint>;
+/** Range/scope-only authorized metadata, not hidden row IDs or unconditional profile hydration. */
+export declare const InsightsUsageFacets: z.ZodObject<{
+    workspaces: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        personal: z.ZodBoolean;
+    }, z.core.$strict>>;
+    providers: z.ZodArray<z.ZodString>;
+    models: z.ZodArray<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strict>>;
+    payers: z.ZodArray<z.ZodString>;
+    plans: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        agent: "agent";
+        api: "api";
+        other: "other";
+        schedule: "schedule";
+        slack: "slack";
+        web: "web";
+    }>>>;
+    projects: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>;
+    people: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        you: z.ZodBoolean;
+    }, z.core.$strict>>;
+    schedules: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type InsightsUsageFacets = z.infer<typeof InsightsUsageFacets>;
+export declare const InsightsUsageResponse: z.ZodObject<{
+    scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"workspace">;
+        accountId: z.ZodString;
+        workspaceId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"organization">;
+        accountId: z.ZodString;
+        workspaceId: z.ZodNull;
+    }, z.core.$strict>], "kind">;
+    range: z.ZodEnum<{
+        "30d": "30d";
+        "90d": "90d";
+        custom: "custom";
+        month: "month";
+        today: "today";
+        week: "week";
+        ytd: "ytd";
+    }>;
+    windowStart: z.ZodString;
+    windowEnd: z.ZodString;
+    priorWindowStart: z.ZodString;
+    priorWindowEnd: z.ZodString;
+    bucket: z.ZodEnum<{
+        day: "day";
+        hour: "hour";
+    }>;
+    generatedAt: z.ZodString;
+    dataThrough: z.ZodNullable<z.ZodString>;
+    totals: z.ZodObject<{
+        calls: z.ZodNumber;
+        tokenKnownCalls: z.ZodNumber;
+        cacheKnownCalls: z.ZodNumber;
+        cacheWriteKnownCalls: z.ZodNumber;
+        listClassKnownCalls: z.ZodNumber;
+        tokens: z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+            reasoning: z.ZodNumber;
+        }, z.core.$strict>;
+        chargedMicros: z.ZodNumber;
+        listMicros: z.ZodNumber;
+        listByClassMicros: z.ZodNullable<z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$strict>>;
+        listByClassApprox: z.ZodBoolean;
+        pricedCalls: z.ZodNumber;
+        byPayer: z.ZodObject<{
+            opengeni_credits: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+            subscription: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+            own_key: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    prior: z.ZodNullable<z.ZodObject<{
+        calls: z.ZodNumber;
+        tokenKnownCalls: z.ZodNumber;
+        cacheKnownCalls: z.ZodNumber;
+        cacheWriteKnownCalls: z.ZodNumber;
+        listClassKnownCalls: z.ZodNumber;
+        tokens: z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+            reasoning: z.ZodNumber;
+        }, z.core.$strict>;
+        chargedMicros: z.ZodNumber;
+        listMicros: z.ZodNumber;
+        listByClassMicros: z.ZodNullable<z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$strict>>;
+        listByClassApprox: z.ZodBoolean;
+        pricedCalls: z.ZodNumber;
+        byPayer: z.ZodObject<{
+            opengeni_credits: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+            subscription: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+            own_key: z.ZodObject<{
+                calls: z.ZodNumber;
+                chargedMicros: z.ZodNumber;
+                listMicros: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    groupBy: z.ZodEnum<{
+        model: "model";
+        payer: "payer";
+        person: "person";
+        plan: "plan";
+        project: "project";
+        provider: "provider";
+        rootSession: "rootSession";
+        schedule: "schedule";
+        session: "session";
+        source: "source";
+        workspace: "workspace";
+    }>;
+    groups: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        kind: z.ZodEnum<{
+            deleted: "deleted";
+            item: "item";
+            other: "other";
+            personal: "personal";
+            private: "private";
+            restricted: "restricted";
+            service: "service";
+            unfiled: "unfiled";
+        }>;
+        label: z.ZodString;
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        workspaceId: z.ZodOptional<z.ZodString>;
+        personKey: z.ZodOptional<z.ZodString>;
+        you: z.ZodOptional<z.ZodBoolean>;
+        measures: z.ZodObject<{
+            calls: z.ZodNumber;
+            tokenKnownCalls: z.ZodNumber;
+            cacheKnownCalls: z.ZodNumber;
+            cacheWriteKnownCalls: z.ZodNumber;
+            listClassKnownCalls: z.ZodNumber;
+            tokens: z.ZodObject<{
+                uncachedInput: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                output: z.ZodNumber;
+                reasoning: z.ZodNumber;
+            }, z.core.$strict>;
+            chargedMicros: z.ZodNumber;
+            listMicros: z.ZodNumber;
+            listByClassMicros: z.ZodNullable<z.ZodObject<{
+                uncachedInput: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                output: z.ZodNumber;
+            }, z.core.$strict>>;
+            listByClassApprox: z.ZodBoolean;
+            pricedCalls: z.ZodNumber;
+            byPayer: z.ZodObject<{
+                opengeni_credits: z.ZodObject<{
+                    calls: z.ZodNumber;
+                    chargedMicros: z.ZodNumber;
+                    listMicros: z.ZodNumber;
+                }, z.core.$strict>;
+                subscription: z.ZodObject<{
+                    calls: z.ZodNumber;
+                    chargedMicros: z.ZodNumber;
+                    listMicros: z.ZodNumber;
+                }, z.core.$strict>;
+                own_key: z.ZodObject<{
+                    calls: z.ZodNumber;
+                    chargedMicros: z.ZodNumber;
+                    listMicros: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    groupCount: z.ZodNumber;
+    groupsTruncated: z.ZodBoolean;
+    series: z.ZodArray<z.ZodObject<{
+        start: z.ZodString;
+        measures: z.ZodObject<{
+            calls: z.ZodNumber;
+            tokenKnownCalls: z.ZodNumber;
+            cacheKnownCalls: z.ZodNumber;
+            cacheWriteKnownCalls: z.ZodNumber;
+            listClassKnownCalls: z.ZodNumber;
+            tokens: z.ZodObject<{
+                uncachedInput: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                output: z.ZodNumber;
+                reasoning: z.ZodNumber;
+            }, z.core.$strict>;
+            chargedMicros: z.ZodNumber;
+            listMicros: z.ZodNumber;
+            listByClassMicros: z.ZodNullable<z.ZodObject<{
+                uncachedInput: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                output: z.ZodNumber;
+            }, z.core.$strict>>;
+            listByClassApprox: z.ZodBoolean;
+            pricedCalls: z.ZodNumber;
+            byPayer: z.ZodObject<{
+                opengeni_credits: z.ZodObject<{
+                    calls: z.ZodNumber;
+                    chargedMicros: z.ZodNumber;
+                    listMicros: z.ZodNumber;
+                }, z.core.$strict>;
+                subscription: z.ZodObject<{
+                    calls: z.ZodNumber;
+                    chargedMicros: z.ZodNumber;
+                    listMicros: z.ZodNumber;
+                }, z.core.$strict>;
+                own_key: z.ZodObject<{
+                    calls: z.ZodNumber;
+                    chargedMicros: z.ZodNumber;
+                    listMicros: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        groups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            chargedMicros: z.ZodNumber;
+            listMicros: z.ZodNumber;
+            tokens: z.ZodObject<{
+                uncachedInput: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                output: z.ZodNumber;
+                reasoning: z.ZodNumber;
+            }, z.core.$strict>;
+            calls: z.ZodNumber;
+            byPayer: z.ZodObject<{
+                opengeni_credits: z.ZodObject<{
+                    calls: z.ZodNumber;
+                    chargedMicros: z.ZodNumber;
+                    listMicros: z.ZodNumber;
+                }, z.core.$strict>;
+                subscription: z.ZodObject<{
+                    calls: z.ZodNumber;
+                    chargedMicros: z.ZodNumber;
+                    listMicros: z.ZodNumber;
+                }, z.core.$strict>;
+                own_key: z.ZodObject<{
+                    calls: z.ZodNumber;
+                    chargedMicros: z.ZodNumber;
+                    listMicros: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    facets: z.ZodObject<{
+        workspaces: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            personal: z.ZodBoolean;
+        }, z.core.$strict>>;
+        providers: z.ZodArray<z.ZodString>;
+        models: z.ZodArray<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strict>>;
+        payers: z.ZodArray<z.ZodString>;
+        plans: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        sources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            agent: "agent";
+            api: "api";
+            other: "other";
+            schedule: "schedule";
+            slack: "slack";
+            web: "web";
+        }>>>;
+        projects: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>;
+        people: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            name: z.ZodNullable<z.ZodString>;
+            you: z.ZodBoolean;
+        }, z.core.$strict>>;
+        schedules: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type InsightsUsageResponse = z.infer<typeof InsightsUsageResponse>;
+/** Backend must omit unreadable calls entirely; this schema grants no access. */
+export declare const InsightsCall: z.ZodObject<{
+    id: z.ZodString;
+    occurredAt: z.ZodString;
+    workspaceId: z.ZodString;
+    sessionId: z.ZodNullable<z.ZodString>;
+    sessionTitle: z.ZodNullable<z.ZodString>;
+    sessionKind: z.ZodEnum<{
+        deleted: "deleted";
+        private: "private";
+        visible: "visible";
+    }>;
+    personKey: z.ZodNullable<z.ZodString>;
+    provider: z.ZodString;
+    model: z.ZodString;
+    payer: z.ZodUnion<readonly [z.ZodLiteral<"opengeni_credits">, z.ZodLiteral<"subscription">, z.ZodLiteral<"own_key">]>;
+    tokens: z.ZodNullable<z.ZodObject<{
+        uncachedInput: z.ZodNumber;
+        cacheRead: z.ZodNumber;
+        cacheWrite: z.ZodNumber;
+        output: z.ZodNumber;
+        reasoning: z.ZodNumber;
+    }, z.core.$strict>>;
+    chargedMicros: z.ZodNumber;
+    listMicros: z.ZodNullable<z.ZodNumber>;
+    listByClassMicros: z.ZodNullable<z.ZodObject<{
+        uncachedInput: z.ZodNumber;
+        cacheRead: z.ZodNumber;
+        cacheWrite: z.ZodNumber;
+        output: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type InsightsCall = z.infer<typeof InsightsCall>;
+export declare const InsightsCallsResponse: z.ZodObject<{
+    calls: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        occurredAt: z.ZodString;
+        workspaceId: z.ZodString;
+        sessionId: z.ZodNullable<z.ZodString>;
+        sessionTitle: z.ZodNullable<z.ZodString>;
+        sessionKind: z.ZodEnum<{
+            deleted: "deleted";
+            private: "private";
+            visible: "visible";
+        }>;
+        personKey: z.ZodNullable<z.ZodString>;
+        provider: z.ZodString;
+        model: z.ZodString;
+        payer: z.ZodUnion<readonly [z.ZodLiteral<"opengeni_credits">, z.ZodLiteral<"subscription">, z.ZodLiteral<"own_key">]>;
+        tokens: z.ZodNullable<z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+            reasoning: z.ZodNumber;
+        }, z.core.$strict>>;
+        chargedMicros: z.ZodNumber;
+        listMicros: z.ZodNullable<z.ZodNumber>;
+        listByClassMicros: z.ZodNullable<z.ZodObject<{
+            uncachedInput: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type InsightsCallsResponse = z.infer<typeof InsightsCallsResponse>;