@alephantai/logs-collector-analytics 0.1.0

package/README.md

@@ -0,0 +1,15 @@
+# @alephantai/logs-collector-analytics
+
+TypeScript client for the **logs-collector** Analytics HTTP API (`/v1/analytics/*`), generated from the Fern definition in `../../fern/definition/`.
+
+## Publish / build
+
+From the `logs-collector` repo root:
+
+```bash
+npm run fern:sdk
+npm run sdk:build
+npm publish -w @alephantai/logs-collector-analytics
+```
+
+`prepublishOnly` runs `tsc` so the tarball only includes compiled `dist/` (see `files` in `package.json`).

package/dist/BaseClient.d.ts

@@ -0,0 +1,33 @@
+import * as core from "./core/index.js";
+export interface BaseClientOptions {
+    environment: core.Supplier<string>;
+    /** Specify a custom URL to connect the client to. */
+    baseUrl?: core.Supplier<string>;
+    /** Additional headers to include in requests. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** The default maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The default number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** Provide a custom fetch implementation. Useful for platforms that don't have a built-in fetch or need a custom implementation. */
+    fetch?: typeof fetch;
+    /** Configure logging for the client. */
+    logging?: core.logging.LogConfig | core.logging.Logger;
+}
+export interface BaseRequestOptions {
+    /** The maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** A hook to abort the request. */
+    abortSignal?: AbortSignal;
+    /** Additional query string parameters to include in the request. */
+    queryParams?: Record<string, unknown>;
+    /** Additional headers to include in the request. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+}
+export type NormalizedClientOptions<T extends BaseClientOptions = BaseClientOptions> = T & {
+    logging: core.logging.Logger;
+};
+export declare function normalizeClientOptions<T extends BaseClientOptions = BaseClientOptions>(options: T): NormalizedClientOptions<T>;
+//# sourceMappingURL=BaseClient.d.ts.map

package/dist/BaseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseClient.d.ts","sourceRoot":"","sources":["../generated/BaseClient.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,qDAAqD;IACrD,OAAO,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC/F,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oIAAoI;IACpI,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,wCAAwC;IACxC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IAC/B,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CAClG;AAED,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,IAAI,CAAC,GAAG;IACvF,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;CAChC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EAClF,OAAO,EAAE,CAAC,GACX,uBAAuB,CAAC,CAAC,CAAC,CAe5B"}

package/dist/BaseClient.js

@@ -0,0 +1,16 @@
+// This file was auto-generated by Fern from our API Definition.
+import { mergeHeaders } from "./core/headers.js";
+import * as core from "./core/index.js";
+export function normalizeClientOptions(options) {
+    const headers = mergeHeaders({
+        "X-Fern-Language": "JavaScript",
+        "X-Fern-Runtime": core.RUNTIME.type,
+        "X-Fern-Runtime-Version": core.RUNTIME.version,
+    }, options?.headers);
+    return {
+        ...options,
+        logging: core.logging.createLogger(options?.logging),
+        headers,
+    };
+}
+//# sourceMappingURL=BaseClient.js.map

package/dist/BaseClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseClient.js","sourceRoot":"","sources":["../generated/BaseClient.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAmCxC,MAAM,UAAU,sBAAsB,CAClC,OAAU;IAEV,MAAM,OAAO,GAAG,YAAY,CACxB;QACI,iBAAiB,EAAE,YAAY;QAC/B,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACnC,wBAAwB,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;KACjD,EACD,OAAO,EAAE,OAAO,CACnB,CAAC;IAEF,OAAO;QACH,GAAG,OAAO;QACV,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC;QACpD,OAAO;KACoB,CAAC;AACpC,CAAC"}

package/dist/Client.d.ts

@@ -0,0 +1,30 @@
+import { AnalyticsAtomicClient } from "./api/resources/analyticsAtomic/client/Client.js";
+import { AnalyticsSaasClient } from "./api/resources/analyticsSaas/client/Client.js";
+import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
+import { type NormalizedClientOptions } from "./BaseClient.js";
+import * as core from "./core/index.js";
+export declare namespace LogsCollectorAnalyticsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class LogsCollectorAnalyticsClient {
+    protected readonly _options: NormalizedClientOptions<LogsCollectorAnalyticsClient.Options>;
+    protected _analyticsAtomic: AnalyticsAtomicClient | undefined;
+    protected _analyticsSaas: AnalyticsSaasClient | undefined;
+    constructor(options: LogsCollectorAnalyticsClient.Options);
+    get analyticsAtomic(): AnalyticsAtomicClient;
+    get analyticsSaas(): AnalyticsSaasClient;
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    fetch(input: Request | string | URL, init?: RequestInit, requestOptions?: core.PassthroughRequest.RequestOptions): Promise<Response>;
+}
+//# sourceMappingURL=Client.d.ts.map

package/dist/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../generated/Client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,KAAK,uBAAuB,EAA0B,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,MAAM,CAAC,OAAO,WAAW,4BAA4B,CAAC;IAClD,KAAY,OAAO,GAAG,iBAAiB,CAAC;IAExC,UAAiB,cAAe,SAAQ,kBAAkB;KAAG;CAChE;AAED,qBAAa,4BAA4B;IACrC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAC3F,SAAS,CAAC,gBAAgB,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC9D,SAAS,CAAC,cAAc,EAAE,mBAAmB,GAAG,SAAS,CAAC;gBAE9C,OAAO,EAAE,4BAA4B,CAAC,OAAO;IAIzD,IAAW,eAAe,IAAI,qBAAqB,CAElD;IAED,IAAW,aAAa,IAAI,mBAAmB,CAE9C;IAED;;;;;;;;;OASG;IACU,KAAK,CACd,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,GAAG,EAC7B,IAAI,CAAC,EAAE,WAAW,EAClB,cAAc,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,cAAc,GACxD,OAAO,CAAC,QAAQ,CAAC;CAevB"}

package/dist/Client.js

@@ -0,0 +1,40 @@
+// This file was auto-generated by Fern from our API Definition.
+import { AnalyticsAtomicClient } from "./api/resources/analyticsAtomic/client/Client.js";
+import { AnalyticsSaasClient } from "./api/resources/analyticsSaas/client/Client.js";
+import { normalizeClientOptions } from "./BaseClient.js";
+import * as core from "./core/index.js";
+export class LogsCollectorAnalyticsClient {
+    _options;
+    _analyticsAtomic;
+    _analyticsSaas;
+    constructor(options) {
+        this._options = normalizeClientOptions(options);
+    }
+    get analyticsAtomic() {
+        return (this._analyticsAtomic ??= new AnalyticsAtomicClient(this._options));
+    }
+    get analyticsSaas() {
+        return (this._analyticsSaas ??= new AnalyticsSaasClient(this._options));
+    }
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    async fetch(input, init, requestOptions) {
+        return core.makePassthroughRequest(input, init, {
+            baseUrl: this._options.baseUrl ?? this._options.environment,
+            headers: this._options.headers,
+            timeoutInSeconds: this._options.timeoutInSeconds,
+            maxRetries: this._options.maxRetries,
+            fetch: this._options.fetch,
+            logging: this._options.logging,
+        }, requestOptions);
+    }
+}
+//# sourceMappingURL=Client.js.map

package/dist/Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sourceRoot":"","sources":["../generated/Client.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAErF,OAAO,EAAgC,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAQxC,MAAM,OAAO,4BAA4B;IAClB,QAAQ,CAAgE;IACjF,gBAAgB,CAAoC;IACpD,cAAc,CAAkC;IAE1D,YAAY,OAA6C;QACrD,IAAI,CAAC,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,IAAW,eAAe;QACtB,OAAO,CAAC,IAAI,CAAC,gBAAgB,KAAK,IAAI,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,IAAW,aAAa;QACpB,OAAO,CAAC,IAAI,CAAC,cAAc,KAAK,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;OASG;IACI,KAAK,CAAC,KAAK,CACd,KAA6B,EAC7B,IAAkB,EAClB,cAAuD;QAEvD,OAAO,IAAI,CAAC,sBAAsB,CAC9B,KAAK,EACL,IAAI,EACJ;YACI,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW;YAC3D,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;YAC9B,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB;YAChD,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU;YACpC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK;YAC1B,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;SACjC,EACD,cAAc,CACjB,CAAC;IACN,CAAC;CACJ"}

package/dist/api/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./resources/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../generated/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,2 @@
+export * from "./resources/index.js";
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../generated/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/api/resources/analyticsAtomic/client/Client.d.ts

@@ -0,0 +1,307 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptions } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import type * as LogsCollectorAnalytics from "../../../index.js";
+export declare namespace AnalyticsAtomicClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class AnalyticsAtomicClient {
+    protected readonly _options: NormalizedClientOptions<AnalyticsAtomicClient.Options>;
+    constructor(options: AnalyticsAtomicClient.Options);
+    /**
+     * Public probe. Does not require analytics auth.
+     *
+     * **Success `data`:** `{ "status": "ok", "analyticsChConfigured": boolean }`
+     *
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getHealth()
+     */
+    getHealth(requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsHealthResponse>;
+    private __getHealth;
+    /**
+     * Rolling ~24h workspace totals from hourly aggregates (`usage_aggregates_hourly`).
+     *
+     * **Success `data`:** `{ "summary": { ... } }` — KPI fields are mostly strings from ClickHouse (request_count, cost_sum, token sums, cache fields, etc.).
+     *
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getLive24HSummary()
+     */
+    getLive24HSummary(requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getLive24HSummary;
+    /**
+     * Daily-aggregate KPIs for the window plus an equal-length **previous** window for comparison.
+     *
+     * **Success `data`:** `preset`, `window`, `previousWindow`, `current`, `previous` (rollup rows).
+     *
+     * **Example `data` (shape):**
+     * ```json
+     * {
+     *   "preset": "30d",
+     *   "window": { "startDate": "2026-01-01", "endDate": "2026-01-30" },
+     *   "previousWindow": { "startDate": "2025-12-02", "endDate": "2025-12-31" },
+     *   "current": { "request_count": "...", "cost_sum": "..." },
+     *   "previous": { "request_count": "...", "cost_sum": "..." }
+     * }
+     * ```
+     *
+     * @param {LogsCollectorAnalytics.GetUsageSummaryRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getUsageSummary()
+     */
+    getUsageSummary(request?: LogsCollectorAnalytics.GetUsageSummaryRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getUsageSummary;
+    /**
+     * Time series for one metric; buckets are **days** or **hours**.
+     *
+     * **Required:** `metric`. **Optional:** `granularity` (`day` default, or `hour`), plus date window (see query params).
+     *
+     * **Constraint:** `granularity=hour` does **not** support `success_rate` or `latency` → HTTP 400 / `40010`.
+     *
+     * **Success `data`:** `{ "granularity", "metric", "window", "points": [{ "bucket", "value" }] }`
+     *
+     * @param {LogsCollectorAnalytics.GetUsageTimeseriesRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getUsageTimeseries({
+     *         metric: "metric"
+     *     })
+     */
+    getUsageTimeseries(request: LogsCollectorAnalytics.GetUsageTimeseriesRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getUsageTimeseries;
+    /**
+     * Per-day spend trend for the workspace, optionally scoped to one master key.
+     *
+     * **Success `data`:** `{ "window", "rows": [{ "bucket", "cost_sum", "request_count", ... }] }`
+     *
+     * @param {LogsCollectorAnalytics.GetMasterKeysSpendTrendRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getMasterKeysSpendTrend()
+     */
+    getMasterKeysSpendTrend(request?: LogsCollectorAnalytics.GetMasterKeysSpendTrendRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getMasterKeysSpendTrend;
+    /**
+     * Single master key KPIs over a calendar window (vault). **Requires** valid non-nil `masterKeyId`.
+     *
+     * **Success `data`:** `{ "window", "masterKeyId", "summary": { ... } }` — summary fields align with daily rollup KPIs (strings from CH).
+     *
+     * @param {LogsCollectorAnalytics.GetMasterKeysVaultSummaryRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getMasterKeysVaultSummary({
+     *         masterKeyId: "masterKeyId"
+     *     })
+     */
+    getMasterKeysVaultSummary(request: LogsCollectorAnalytics.GetMasterKeysVaultSummaryRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getMasterKeysVaultSummary;
+    /**
+     * Top members (user/member entity rollup) for one master key, ordered by cost.
+     *
+     * **Success `data`:** `{ "window", "masterKeyId", "rows": [...] }`
+     *
+     * @param {LogsCollectorAnalytics.GetMasterKeysVaultByMemberRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getMasterKeysVaultByMember({
+     *         masterKeyId: "masterKeyId"
+     *     })
+     */
+    getMasterKeysVaultByMember(request: LogsCollectorAnalytics.GetMasterKeysVaultByMemberRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getMasterKeysVaultByMember;
+    /**
+     * Top agents for one master key, ordered by cost.
+     *
+     * **Success `data`:** `{ "window", "masterKeyId", "rows": [...] }`
+     *
+     * @param {LogsCollectorAnalytics.GetMasterKeysVaultByAgentRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getMasterKeysVaultByAgent({
+     *         masterKeyId: "masterKeyId"
+     *     })
+     */
+    getMasterKeysVaultByAgent(request: LogsCollectorAnalytics.GetMasterKeysVaultByAgentRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getMasterKeysVaultByAgent;
+    /**
+     * Workspace master-key KPI totals for current vs previous equal-length window.
+     *
+     * **Success `data`:** `{ "window", "previousWindow", "current", "previous" }` — each of current/previous includes totals and active key counts (string numerics).
+     *
+     * @param {LogsCollectorAnalytics.GetMasterKeysBreakdownRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getMasterKeysBreakdown()
+     */
+    getMasterKeysBreakdown(request?: LogsCollectorAnalytics.GetMasterKeysBreakdownRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getMasterKeysBreakdown;
+    /**
+     * Per-master-key spend with previous-window comparison plus a **full-slice** `summary` (not limited by `limit`).
+     *
+     * **Success `data`:** `window`, `previousWindow`, `summary`, `rows` (camelCase spend fields, `spendChangePercent` may be null).
+     *
+     * **Optional filters:** `departmentId` (UUID) scopes slice; invalid UUID → 400 / `40013`.
+     *
+     * @param {LogsCollectorAnalytics.GetMasterKeysSpendByKeyRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getMasterKeysSpendByKey()
+     */
+    getMasterKeysSpendByKey(request?: LogsCollectorAnalytics.GetMasterKeysSpendByKeyRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getMasterKeysSpendByKey;
+    /**
+     * Departments ranked by cost in the window; names enriched from Postgres when available.
+     *
+     * **Success `data`:** `{ "window", "rows": [{ "department_id", "department_name", ... }] }`
+     *
+     * @param {LogsCollectorAnalytics.GetByDepartmentRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getByDepartment()
+     */
+    getByDepartment(request?: LogsCollectorAnalytics.GetByDepartmentRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getByDepartment;
+    /**
+     * Department cost breakdown with MoM-style previous window and workspace-level `summary`.
+     *
+     * **Success `data`:** `window`, `previousWindow`, `summary`, `rows` (camelCase, `departmentName` may be null).
+     *
+     * @param {LogsCollectorAnalytics.GetDepartmentsCostBreakdownRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getDepartmentsCostBreakdown()
+     */
+    getDepartmentsCostBreakdown(request?: LogsCollectorAnalytics.GetDepartmentsCostBreakdownRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getDepartmentsCostBreakdown;
+    /**
+     * Agent-dimension cost breakdown with compared window + agent-scoped `summary`.
+     *
+     * **Success `data`:** `window`, `previousWindow`, `summary`, `rows`.
+     *
+     * @param {LogsCollectorAnalytics.GetAgentsCostBreakdownRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getAgentsCostBreakdown()
+     */
+    getAgentsCostBreakdown(request?: LogsCollectorAnalytics.GetAgentsCostBreakdownRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getAgentsCostBreakdown;
+    /**
+     * Agents ranked by cost; includes primary model/provider hints from aggregates.
+     *
+     * **Success `data`:** `{ "window", "rows": [...] }`
+     *
+     * @param {LogsCollectorAnalytics.GetByAgentRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getByAgent()
+     */
+    getByAgent(request?: LogsCollectorAnalytics.GetByAgentRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getByAgent;
+    /**
+     * Member/user rollup cost breakdown with compared window + member-scoped `summary`.
+     *
+     * **Success `data`:** `window`, `previousWindow`, `summary`, `rows`.
+     *
+     * @param {LogsCollectorAnalytics.GetMembersCostBreakdownRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getMembersCostBreakdown()
+     */
+    getMembersCostBreakdown(request?: LogsCollectorAnalytics.GetMembersCostBreakdownRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getMembersCostBreakdown;
+    /**
+     * Members/users ranked by cost for the window.
+     *
+     * **Success `data`:** `{ "window", "rows": [...] }`
+     *
+     * @param {LogsCollectorAnalytics.GetByMemberRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getByMember()
+     */
+    getByMember(request?: LogsCollectorAnalytics.GetByMemberRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getByMember;
+    /**
+     * Single RMT detail row by `requestId`. **404** with `40401` when not found.
+     *
+     * **Success `data`:** `{ "row": { ... } }` — includes optional bodies (may contain sensitive data).
+     *
+     * @param {string} requestId - Request id string (UUID or opaque id as stored in CH).
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getRequestLogById("requestId")
+     */
+    getRequestLogById(requestId: string, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getRequestLogById;
+    /**
+     * RMT list for a time window. **Offset is fixed at 0** in the executor (no paging offset param).
+     *
+     * **Required:** `start`, `end` — ISO 8601 datetimes parseable by `Date`, with `end` > `start`.
+     *
+     * **Errors:** window too long → `40004`; invalid UUIDs → `40011`/`40013`/`40014`; `entityId` without `entityType` → `40016`; non-UUID `search` → `40033`.
+     *
+     * **Success `data`:** `{ "rows": [ ... ] }` (no total in atomic list).
+     *
+     * @param {LogsCollectorAnalytics.GetRequestLogsRequest} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.getRequestLogs({
+     *         start: "start",
+     *         end: "end"
+     *     })
+     */
+    getRequestLogs(request: LogsCollectorAnalytics.GetRequestLogsRequest, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __getRequestLogs;
+    /**
+     * Sample rows from aggregate tables for connectivity.
+     *
+     * **Success `data`:** `{ "granularity", "rows": [{ "request_count", "cost_sum" }] }`
+     *
+     * @param {LogsCollectorAnalytics.AggregatePingBody} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.postAggregatePing({})
+     */
+    postAggregatePing(request: LogsCollectorAnalytics.AggregatePingBody, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __postAggregatePing;
+    /**
+     * Sample RMT/detail rows for connectivity.
+     *
+     * **Success `data`:** `{ "rows": [{ "request_id", "model", "provider", "cost", "request_created_at" }] }`
+     *
+     * @param {LogsCollectorAnalytics.DetailPingBody} request
+     * @param {AnalyticsAtomicClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.analyticsAtomic.postDetailPing({
+     *         start: "start",
+     *         end: "end"
+     *     })
+     */
+    postDetailPing(request: LogsCollectorAnalytics.DetailPingBody, requestOptions?: AnalyticsAtomicClient.RequestOptions): core.HttpResponsePromise<LogsCollectorAnalytics.AnalyticsJsonResponse>;
+    private __postDetailPing;
+}
+//# sourceMappingURL=Client.d.ts.map

package/dist/api/resources/analyticsAtomic/client/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../../../../generated/api/resources/analyticsAtomic/client/Client.ts"],"names":[],"mappings":"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"}