telnyx 7.24.0 → 7.25.0

package/resources/llm-token-gateway/llm-token-gateway.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-token-gateway.d.mts","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/llm-token-gateway.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,QAAQ,oBAAgB;AACpC,OAAO,EAAE,KAAK,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,oBAAgB;AAE1F,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAoC;CAC1D;AAID,MAAM,CAAC,OAAO,WAAW,eAAe,CAAC;IACvC,OAAO,EACL,KAAK,IAAI,KAAK,EACd,KAAK,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,0BAA0B,IAAI,0BAA0B,GAC9D,CAAC;CACH"}

package/resources/llm-token-gateway/llm-token-gateway.d.ts

@@ -0,0 +1,10 @@
+import { APIResource } from "../../core/resource.js";
+import * as UsageAPI from "./usage.js";
+import { Usage, UsageRetrieveSummaryParams, UsageRetrieveSummaryResponse } from "./usage.js";
+export declare class LlmTokenGateway extends APIResource {
+    usage: UsageAPI.Usage;
+}
+export declare namespace LlmTokenGateway {
+    export { Usage as Usage, type UsageRetrieveSummaryResponse as UsageRetrieveSummaryResponse, type UsageRetrieveSummaryParams as UsageRetrieveSummaryParams, };
+}
+//# sourceMappingURL=llm-token-gateway.d.ts.map

package/resources/llm-token-gateway/llm-token-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-token-gateway.d.ts","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/llm-token-gateway.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,QAAQ,mBAAgB;AACpC,OAAO,EAAE,KAAK,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,mBAAgB;AAE1F,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAoC;CAC1D;AAID,MAAM,CAAC,OAAO,WAAW,eAAe,CAAC;IACvC,OAAO,EACL,KAAK,IAAI,KAAK,EACd,KAAK,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,0BAA0B,IAAI,0BAA0B,GAC9D,CAAC;CACH"}

package/resources/llm-token-gateway/llm-token-gateway.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmTokenGateway = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const UsageAPI = tslib_1.__importStar(require("./usage.js"));
+const usage_1 = require("./usage.js");
+class LlmTokenGateway extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.usage = new UsageAPI.Usage(this._client);
+    }
+}
+exports.LlmTokenGateway = LlmTokenGateway;
+LlmTokenGateway.Usage = usage_1.Usage;
+//# sourceMappingURL=llm-token-gateway.js.map

package/resources/llm-token-gateway/llm-token-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-token-gateway.js","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/llm-token-gateway.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,6DAAoC;AACpC,sCAA0F;AAE1F,MAAa,eAAgB,SAAQ,sBAAW;IAAhD;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;CAAA;AAFD,0CAEC;AAED,eAAe,CAAC,KAAK,GAAG,aAAK,CAAC"}

package/resources/llm-token-gateway/llm-token-gateway.mjs

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as UsageAPI from "./usage.mjs";
+import { Usage } from "./usage.mjs";
+export class LlmTokenGateway extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.usage = new UsageAPI.Usage(this._client);
+    }
+}
+LlmTokenGateway.Usage = Usage;
+//# sourceMappingURL=llm-token-gateway.mjs.map

package/resources/llm-token-gateway/llm-token-gateway.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-token-gateway.mjs","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/llm-token-gateway.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,QAAQ,oBAAgB;AACpC,OAAO,EAAE,KAAK,EAA4D,oBAAgB;AAE1F,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAAhD;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;CAAA;AAED,eAAe,CAAC,KAAK,GAAG,KAAK,CAAC"}

package/resources/llm-token-gateway/usage.d.mts

@@ -0,0 +1,260 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * Manage and report AI Gateway traffic.
+ */
+export declare class Usage extends APIResource {
+    /**
+     * Return complete usage totals, UTC daily and model breakdowns, and guardrail
+     * event counts for one token group owned by the authenticated account. Requires
+     * the llm_token_gateway.usage.read permission; spend and guardrail read
+     * permissions do not grant this combined report. All sections share one database
+     * snapshot and include the latest usage corrections. Dates use an inclusive start
+     * and exclusive end spanning 1 to 31 days. Only token_group_id, start_date and
+     * end_date are accepted; pagination, group_by and other filters are rejected.
+     * Spend is reference/enforcement USD, not invoice truth or BYOK provider charges.
+     * Unknown cost is excluded from spend and reported through unknown_requests and
+     * reserved_spend. Daily rows include zero-activity days. Model rows are ordered by
+     * request count descending, then model name, and are limited to 1,000. Guardrail
+     * counts count events, not distinct requests; recent_events contains at most 20
+     * newest events. A report that exceeds model or query limits returns 503 rather
+     * than a truncated success.
+     */
+    retrieveSummary(query: UsageRetrieveSummaryParams, options?: RequestOptions): APIPromise<UsageRetrieveSummaryResponse>;
+}
+export interface UsageRetrieveSummaryResponse {
+    data: UsageRetrieveSummaryResponse.Data;
+    meta: UsageRetrieveSummaryResponse.Meta;
+}
+export declare namespace UsageRetrieveSummaryResponse {
+    interface Data {
+        /**
+         * One row per UTC day, including zero-activity days.
+         */
+        by_day: Array<Data.ByDay>;
+        /**
+         * One row per model, ordered by request count descending then model name.
+         */
+        by_model: Array<Data.ByModel>;
+        /**
+         * Complete guardrail event counts and bounded recent findings for the same group
+         * and range.
+         */
+        guardrails: Data.Guardrails;
+        /**
+         * Metrics for all matching requests.
+         */
+        totals: Data.Totals;
+    }
+    namespace Data {
+        interface ByDay {
+            /**
+             * Requests served from the gateway cache.
+             */
+            cache_hits: number;
+            /**
+             * UTC day.
+             */
+            date: string;
+            /**
+             * Requests classified as failed.
+             */
+            failed_requests: number;
+            /**
+             * Independently known input tokens across attempts, including corrected usage.
+             */
+            input_tokens: number;
+            /**
+             * Independently known output tokens across attempts, including corrected usage.
+             */
+            output_tokens: number;
+            /**
+             * Requests classified as partial after streaming began.
+             */
+            partial_requests: number;
+            /**
+             * Number of matching requests.
+             */
+            requests: number;
+            /**
+             * Unresolved budget reservations in USD.
+             */
+            reserved_spend: number;
+            /**
+             * Sum of known reference/enforcement cost in USD.
+             */
+            spend: number;
+            /**
+             * Requests classified as succeeded.
+             */
+            succeeded_requests: number;
+            /**
+             * Requests whose cost remains unresolved; unknown cost is excluded from spend.
+             */
+            unknown_requests: number;
+        }
+        interface ByModel {
+            /**
+             * Requests served from the gateway cache.
+             */
+            cache_hits: number;
+            /**
+             * Requests classified as failed.
+             */
+            failed_requests: number;
+            /**
+             * Independently known input tokens across attempts, including corrected usage.
+             */
+            input_tokens: number;
+            /**
+             * Model identifier.
+             */
+            model: string;
+            /**
+             * Independently known output tokens across attempts, including corrected usage.
+             */
+            output_tokens: number;
+            /**
+             * Requests classified as partial after streaming began.
+             */
+            partial_requests: number;
+            /**
+             * Number of matching requests.
+             */
+            requests: number;
+            /**
+             * Unresolved budget reservations in USD.
+             */
+            reserved_spend: number;
+            /**
+             * Sum of known reference/enforcement cost in USD.
+             */
+            spend: number;
+            /**
+             * Requests classified as succeeded.
+             */
+            succeeded_requests: number;
+            /**
+             * Requests whose cost remains unresolved; unknown cost is excluded from spend.
+             */
+            unknown_requests: number;
+        }
+        /**
+         * Complete guardrail event counts and bounded recent findings for the same group
+         * and range.
+         */
+        interface Guardrails {
+            /**
+             * Total blocked guardrail events, not distinct requests.
+             */
+            blocked_events: number;
+            /**
+             * Total flagged guardrail events, not distinct requests.
+             */
+            flagged_events: number;
+            /**
+             * Up to 20 newest privacy-safe guardrail events, ordered by creation time
+             * descending and event ID.
+             */
+            recent_events: Array<Guardrails.RecentEvent>;
+        }
+        namespace Guardrails {
+            interface RecentEvent {
+                id: string;
+                created_at: string;
+                end_user_id: string | null;
+                evaluation_input_tokens: number | null;
+                evaluation_output_tokens: number | null;
+                findings: Array<RecentEvent.Finding>;
+                /**
+                 * Model identifier.
+                 */
+                model: string;
+                outcome: 'evaluated' | 'flagged' | 'blocked' | 'unevaluated';
+                record_type: 'guardrail_event';
+                request_id: string;
+                stage: 'prompt' | 'response';
+                token_group_id: string;
+                token_key_id: string;
+                token_user_id: string | null;
+            }
+            namespace RecentEvent {
+                interface Finding {
+                    action: 'flag' | 'block';
+                    code: string;
+                    count: number;
+                    detector: 'secrets' | 'dlp' | 'safety';
+                }
+            }
+        }
+        /**
+         * Metrics for all matching requests.
+         */
+        interface Totals {
+            /**
+             * Requests served from the gateway cache.
+             */
+            cache_hits: number;
+            /**
+             * Requests classified as failed.
+             */
+            failed_requests: number;
+            /**
+             * Independently known input tokens across attempts, including corrected usage.
+             */
+            input_tokens: number;
+            /**
+             * Independently known output tokens across attempts, including corrected usage.
+             */
+            output_tokens: number;
+            /**
+             * Requests classified as partial after streaming began.
+             */
+            partial_requests: number;
+            /**
+             * Number of matching requests.
+             */
+            requests: number;
+            /**
+             * Unresolved budget reservations in USD.
+             */
+            reserved_spend: number;
+            /**
+             * Sum of known reference/enforcement cost in USD.
+             */
+            spend: number;
+            /**
+             * Requests classified as succeeded.
+             */
+            succeeded_requests: number;
+            /**
+             * Requests whose cost remains unresolved; unknown cost is excluded from spend.
+             */
+            unknown_requests: number;
+        }
+    }
+    interface Meta {
+        end_date: string;
+        start_date: string;
+        token_group_id: string;
+    }
+}
+export interface UsageRetrieveSummaryParams {
+    /**
+     * Exclusive UTC date in YYYY-MM-DD format. Must follow start_date by 1 to 31 days.
+     */
+    end_date: string;
+    /**
+     * Inclusive UTC date in YYYY-MM-DD format. Must precede end_date by 1 to 31 days.
+     */
+    start_date: string;
+    /**
+     * ID of a token group owned by the authenticated account.
+     */
+    token_group_id: string;
+}
+export declare namespace Usage {
+    export { type UsageRetrieveSummaryResponse as UsageRetrieveSummaryResponse, type UsageRetrieveSummaryParams as UsageRetrieveSummaryParams, };
+}
+//# sourceMappingURL=usage.d.mts.map

package/resources/llm-token-gateway/usage.d.mts.map

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

package/resources/llm-token-gateway/usage.d.ts

@@ -0,0 +1,260 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Manage and report AI Gateway traffic.
+ */
+export declare class Usage extends APIResource {
+    /**
+     * Return complete usage totals, UTC daily and model breakdowns, and guardrail
+     * event counts for one token group owned by the authenticated account. Requires
+     * the llm_token_gateway.usage.read permission; spend and guardrail read
+     * permissions do not grant this combined report. All sections share one database
+     * snapshot and include the latest usage corrections. Dates use an inclusive start
+     * and exclusive end spanning 1 to 31 days. Only token_group_id, start_date and
+     * end_date are accepted; pagination, group_by and other filters are rejected.
+     * Spend is reference/enforcement USD, not invoice truth or BYOK provider charges.
+     * Unknown cost is excluded from spend and reported through unknown_requests and
+     * reserved_spend. Daily rows include zero-activity days. Model rows are ordered by
+     * request count descending, then model name, and are limited to 1,000. Guardrail
+     * counts count events, not distinct requests; recent_events contains at most 20
+     * newest events. A report that exceeds model or query limits returns 503 rather
+     * than a truncated success.
+     */
+    retrieveSummary(query: UsageRetrieveSummaryParams, options?: RequestOptions): APIPromise<UsageRetrieveSummaryResponse>;
+}
+export interface UsageRetrieveSummaryResponse {
+    data: UsageRetrieveSummaryResponse.Data;
+    meta: UsageRetrieveSummaryResponse.Meta;
+}
+export declare namespace UsageRetrieveSummaryResponse {
+    interface Data {
+        /**
+         * One row per UTC day, including zero-activity days.
+         */
+        by_day: Array<Data.ByDay>;
+        /**
+         * One row per model, ordered by request count descending then model name.
+         */
+        by_model: Array<Data.ByModel>;
+        /**
+         * Complete guardrail event counts and bounded recent findings for the same group
+         * and range.
+         */
+        guardrails: Data.Guardrails;
+        /**
+         * Metrics for all matching requests.
+         */
+        totals: Data.Totals;
+    }
+    namespace Data {
+        interface ByDay {
+            /**
+             * Requests served from the gateway cache.
+             */
+            cache_hits: number;
+            /**
+             * UTC day.
+             */
+            date: string;
+            /**
+             * Requests classified as failed.
+             */
+            failed_requests: number;
+            /**
+             * Independently known input tokens across attempts, including corrected usage.
+             */
+            input_tokens: number;
+            /**
+             * Independently known output tokens across attempts, including corrected usage.
+             */
+            output_tokens: number;
+            /**
+             * Requests classified as partial after streaming began.
+             */
+            partial_requests: number;
+            /**
+             * Number of matching requests.
+             */
+            requests: number;
+            /**
+             * Unresolved budget reservations in USD.
+             */
+            reserved_spend: number;
+            /**
+             * Sum of known reference/enforcement cost in USD.
+             */
+            spend: number;
+            /**
+             * Requests classified as succeeded.
+             */
+            succeeded_requests: number;
+            /**
+             * Requests whose cost remains unresolved; unknown cost is excluded from spend.
+             */
+            unknown_requests: number;
+        }
+        interface ByModel {
+            /**
+             * Requests served from the gateway cache.
+             */
+            cache_hits: number;
+            /**
+             * Requests classified as failed.
+             */
+            failed_requests: number;
+            /**
+             * Independently known input tokens across attempts, including corrected usage.
+             */
+            input_tokens: number;
+            /**
+             * Model identifier.
+             */
+            model: string;
+            /**
+             * Independently known output tokens across attempts, including corrected usage.
+             */
+            output_tokens: number;
+            /**
+             * Requests classified as partial after streaming began.
+             */
+            partial_requests: number;
+            /**
+             * Number of matching requests.
+             */
+            requests: number;
+            /**
+             * Unresolved budget reservations in USD.
+             */
+            reserved_spend: number;
+            /**
+             * Sum of known reference/enforcement cost in USD.
+             */
+            spend: number;
+            /**
+             * Requests classified as succeeded.
+             */
+            succeeded_requests: number;
+            /**
+             * Requests whose cost remains unresolved; unknown cost is excluded from spend.
+             */
+            unknown_requests: number;
+        }
+        /**
+         * Complete guardrail event counts and bounded recent findings for the same group
+         * and range.
+         */
+        interface Guardrails {
+            /**
+             * Total blocked guardrail events, not distinct requests.
+             */
+            blocked_events: number;
+            /**
+             * Total flagged guardrail events, not distinct requests.
+             */
+            flagged_events: number;
+            /**
+             * Up to 20 newest privacy-safe guardrail events, ordered by creation time
+             * descending and event ID.
+             */
+            recent_events: Array<Guardrails.RecentEvent>;
+        }
+        namespace Guardrails {
+            interface RecentEvent {
+                id: string;
+                created_at: string;
+                end_user_id: string | null;
+                evaluation_input_tokens: number | null;
+                evaluation_output_tokens: number | null;
+                findings: Array<RecentEvent.Finding>;
+                /**
+                 * Model identifier.
+                 */
+                model: string;
+                outcome: 'evaluated' | 'flagged' | 'blocked' | 'unevaluated';
+                record_type: 'guardrail_event';
+                request_id: string;
+                stage: 'prompt' | 'response';
+                token_group_id: string;
+                token_key_id: string;
+                token_user_id: string | null;
+            }
+            namespace RecentEvent {
+                interface Finding {
+                    action: 'flag' | 'block';
+                    code: string;
+                    count: number;
+                    detector: 'secrets' | 'dlp' | 'safety';
+                }
+            }
+        }
+        /**
+         * Metrics for all matching requests.
+         */
+        interface Totals {
+            /**
+             * Requests served from the gateway cache.
+             */
+            cache_hits: number;
+            /**
+             * Requests classified as failed.
+             */
+            failed_requests: number;
+            /**
+             * Independently known input tokens across attempts, including corrected usage.
+             */
+            input_tokens: number;
+            /**
+             * Independently known output tokens across attempts, including corrected usage.
+             */
+            output_tokens: number;
+            /**
+             * Requests classified as partial after streaming began.
+             */
+            partial_requests: number;
+            /**
+             * Number of matching requests.
+             */
+            requests: number;
+            /**
+             * Unresolved budget reservations in USD.
+             */
+            reserved_spend: number;
+            /**
+             * Sum of known reference/enforcement cost in USD.
+             */
+            spend: number;
+            /**
+             * Requests classified as succeeded.
+             */
+            succeeded_requests: number;
+            /**
+             * Requests whose cost remains unresolved; unknown cost is excluded from spend.
+             */
+            unknown_requests: number;
+        }
+    }
+    interface Meta {
+        end_date: string;
+        start_date: string;
+        token_group_id: string;
+    }
+}
+export interface UsageRetrieveSummaryParams {
+    /**
+     * Exclusive UTC date in YYYY-MM-DD format. Must follow start_date by 1 to 31 days.
+     */
+    end_date: string;
+    /**
+     * Inclusive UTC date in YYYY-MM-DD format. Must precede end_date by 1 to 31 days.
+     */
+    start_date: string;
+    /**
+     * ID of a token group owned by the authenticated account.
+     */
+    token_group_id: string;
+}
+export declare namespace Usage {
+    export { type UsageRetrieveSummaryResponse as UsageRetrieveSummaryResponse, type UsageRetrieveSummaryParams as UsageRetrieveSummaryParams, };
+}
+//# sourceMappingURL=usage.d.ts.map

package/resources/llm-token-gateway/usage.d.ts.map

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

package/resources/llm-token-gateway/usage.js

@@ -0,0 +1,31 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Usage = void 0;
+const resource_1 = require("../../core/resource.js");
+/**
+ * Manage and report AI Gateway traffic.
+ */
+class Usage extends resource_1.APIResource {
+    /**
+     * Return complete usage totals, UTC daily and model breakdowns, and guardrail
+     * event counts for one token group owned by the authenticated account. Requires
+     * the llm_token_gateway.usage.read permission; spend and guardrail read
+     * permissions do not grant this combined report. All sections share one database
+     * snapshot and include the latest usage corrections. Dates use an inclusive start
+     * and exclusive end spanning 1 to 31 days. Only token_group_id, start_date and
+     * end_date are accepted; pagination, group_by and other filters are rejected.
+     * Spend is reference/enforcement USD, not invoice truth or BYOK provider charges.
+     * Unknown cost is excluded from spend and reported through unknown_requests and
+     * reserved_spend. Daily rows include zero-activity days. Model rows are ordered by
+     * request count descending, then model name, and are limited to 1,000. Guardrail
+     * counts count events, not distinct requests; recent_events contains at most 20
+     * newest events. A report that exceeds model or query limits returns 503 rather
+     * than a truncated success.
+     */
+    retrieveSummary(query, options) {
+        return this._client.get('/llm_token_gateway/usage/summary', { query, ...options });
+    }
+}
+exports.Usage = Usage;
+//# sourceMappingURL=usage.js.map

package/resources/llm-token-gateway/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/usage.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD;;GAEG;AACH,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CACb,KAAiC,EACjC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;CACF;AAvBD,sBAuBC"}

package/resources/llm-token-gateway/usage.mjs

@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+/**
+ * Manage and report AI Gateway traffic.
+ */
+export class Usage extends APIResource {
+    /**
+     * Return complete usage totals, UTC daily and model breakdowns, and guardrail
+     * event counts for one token group owned by the authenticated account. Requires
+     * the llm_token_gateway.usage.read permission; spend and guardrail read
+     * permissions do not grant this combined report. All sections share one database
+     * snapshot and include the latest usage corrections. Dates use an inclusive start
+     * and exclusive end spanning 1 to 31 days. Only token_group_id, start_date and
+     * end_date are accepted; pagination, group_by and other filters are rejected.
+     * Spend is reference/enforcement USD, not invoice truth or BYOK provider charges.
+     * Unknown cost is excluded from spend and reported through unknown_requests and
+     * reserved_spend. Daily rows include zero-activity days. Model rows are ordered by
+     * request count descending, then model name, and are limited to 1,000. Guardrail
+     * counts count events, not distinct requests; recent_events contains at most 20
+     * newest events. A report that exceeds model or query limits returns 503 rather
+     * than a truncated success.
+     */
+    retrieveSummary(query, options) {
+        return this._client.get('/llm_token_gateway/usage/summary', { query, ...options });
+    }
+}
+//# sourceMappingURL=usage.mjs.map

package/resources/llm-token-gateway/usage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.mjs","sourceRoot":"","sources":["../../src/resources/llm-token-gateway/usage.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAIlD;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CACb,KAAiC,EACjC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;CACF"}

package/resources/llm-token-gateway.d.mts

@@ -0,0 +1,2 @@
+export * from "./llm-token-gateway/index.mjs";
+//# sourceMappingURL=llm-token-gateway.d.mts.map

package/resources/llm-token-gateway.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-token-gateway.d.mts","sourceRoot":"","sources":["../src/resources/llm-token-gateway.ts"],"names":[],"mappings":"AAEA,8CAA0C"}