@truefoundry/trueforge-sdk 0.1.4-rc.0 → 0.1.4-rc.1

package/dist/esm/api/resources/internal/client/Client.d.mts

@@ -0,0 +1,18 @@
+import type { BaseClientOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import { AgentsClient } from "../resources/agents/client/Client.mjs";
+import { MetricsClient } from "../resources/metrics/client/Client.mjs";
+import { SessionsClient } from "../resources/sessions/client/Client.mjs";
+export declare namespace InternalClient {
+    type Options = BaseClientOptions;
+}
+export declare class InternalClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<InternalClient.Options>;
+    protected _metrics: MetricsClient | undefined;
+    protected _sessions: SessionsClient | undefined;
+    protected _agents: AgentsClient | undefined;
+    constructor(options: InternalClient.Options);
+    get metrics(): MetricsClient;
+    get sessions(): SessionsClient;
+    get agents(): AgentsClient;
+}

package/dist/esm/api/resources/internal/client/Client.mjs

@@ -0,0 +1,22 @@
+// This file was auto-generated by Fern from our API Definition.
+import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import { AgentsClient } from "../resources/agents/client/Client.mjs";
+import { MetricsClient } from "../resources/metrics/client/Client.mjs";
+import { SessionsClient } from "../resources/sessions/client/Client.mjs";
+export class InternalClient {
+    constructor(options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    get metrics() {
+        var _a;
+        return ((_a = this._metrics) !== null && _a !== void 0 ? _a : (this._metrics = new MetricsClient(this._options)));
+    }
+    get sessions() {
+        var _a;
+        return ((_a = this._sessions) !== null && _a !== void 0 ? _a : (this._sessions = new SessionsClient(this._options)));
+    }
+    get agents() {
+        var _a;
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new AgentsClient(this._options)));
+    }
+}

package/dist/esm/api/resources/internal/client/index.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/internal/client/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/internal/exports.d.mts

@@ -0,0 +1,3 @@
+export { InternalClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/internal/exports.mjs

@@ -0,0 +1,4 @@
+// This file was auto-generated by Fern from our API Definition.
+export { InternalClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/internal/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/internal/index.mjs

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./resources/index.mjs";

package/dist/esm/api/resources/internal/resources/agents/client/Client.d.mts

@@ -0,0 +1,28 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.mjs";
+import * as core from "../../../../../../core/index.mjs";
+import * as TrueForge from "../../../../../index.mjs";
+export declare namespace AgentsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class AgentsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AgentsClient.Options>;
+    constructor(options: AgentsClient.Options);
+    /**
+     * TypeScript TrueForge SDK samples (stream and non-stream) for creating a session and turn against this agent.
+     *
+     * @param {string} agent_id - Immutable agent identifier.
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.NotFoundError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.internal.agents.getCodeSnippets("agent_id")
+     */
+    getCodeSnippets(agent_id: string, requestOptions?: AgentsClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetAgentCodeSnippetsResponse>;
+    private __getCodeSnippets;
+}

package/dist/esm/api/resources/internal/resources/agents/client/Client.mjs

@@ -0,0 +1,87 @@
+// This file was auto-generated by Fern from our API Definition.
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { normalizeClientOptionsWithAuth } from "../../../../../../BaseClient.mjs";
+import { mergeHeaders } from "../../../../../../core/headers.mjs";
+import * as core from "../../../../../../core/index.mjs";
+import { handleNonStatusCodeError } from "../../../../../../errors/handleNonStatusCodeError.mjs";
+import * as errors from "../../../../../../errors/index.mjs";
+import * as serializers from "../../../../../../serialization/index.mjs";
+import * as TrueForge from "../../../../../index.mjs";
+export class AgentsClient {
+    constructor(options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * TypeScript TrueForge SDK samples (stream and non-stream) for creating a session and turn against this agent.
+     *
+     * @param {string} agent_id - Immutable agent identifier.
+     * @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.NotFoundError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.internal.agents.getCodeSnippets("agent_id")
+     */
+    getCodeSnippets(agent_id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getCodeSnippets(agent_id, requestOptions));
+    }
+    __getCodeSnippets(agent_id, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment)), `api/v1/agents/${core.url.encodePathParam(agent_id)}/code-snippets`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.GetAgentCodeSnippetsResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new TrueForge.NotFoundError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.TrueForgeError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/agents/{agent_id}/code-snippets");
+        });
+    }
+}

package/dist/esm/api/resources/internal/resources/agents/client/index.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/internal/resources/agents/client/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/internal/resources/agents/exports.d.mts

@@ -0,0 +1,2 @@
+export { AgentsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/internal/resources/agents/exports.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { AgentsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/internal/resources/agents/index.d.mts

@@ -0,0 +1 @@
+export * from "./client/index.mjs";

package/dist/esm/api/resources/internal/resources/agents/index.mjs

@@ -0,0 +1 @@
+export * from "./client/index.mjs";

package/dist/esm/api/resources/internal/resources/index.d.mts

@@ -0,0 +1,5 @@
+export * as agents from "./agents/index.mjs";
+export * from "./metrics/client/requests/index.mjs";
+export * as metrics from "./metrics/index.mjs";
+export * from "./sessions/client/requests/index.mjs";
+export * as sessions from "./sessions/index.mjs";

package/dist/esm/api/resources/internal/resources/index.mjs

@@ -0,0 +1,5 @@
+export * as agents from "./agents/index.mjs";
+export * from "./metrics/client/requests/index.mjs";
+export * as metrics from "./metrics/index.mjs";
+export * from "./sessions/client/requests/index.mjs";
+export * as sessions from "./sessions/index.mjs";

package/dist/esm/api/resources/internal/resources/metrics/client/Client.d.mts

@@ -0,0 +1,65 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.mjs";
+import * as core from "../../../../../../core/index.mjs";
+import * as TrueForge from "../../../../../index.mjs";
+export declare namespace MetricsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class MetricsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<MetricsClient.Options>;
+    constructor(options: MetricsClient.Options);
+    /**
+     * List available session metric charts.
+     *
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.internal.metrics.listCharts()
+     */
+    listCharts(requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetSessionMetricsChartResponse>;
+    private __listCharts;
+    /**
+     * Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.
+     *
+     * @param {TrueForge.internal.GetChartDataMetricsRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.internal.metrics.getChartData({
+     *         agentId: "agent_id",
+     *         startTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+     *         endTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+     *         chartName: "sessions_over_time"
+     *     })
+     */
+    getChartData(request: TrueForge.internal.GetChartDataMetricsRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetSessionMetricsChartDataResponse>;
+    private __getChartData;
+    /**
+     * Aggregate the caller's session meters for a named agent over an inclusive creation-time window.
+     *
+     * @param {TrueForge.internal.GetMetersMetricsRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.internal.metrics.getMeters({
+     *         agentId: "agent_id",
+     *         startTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+     *         endTimestamp: new Date("2024-01-15T09:30:00.000Z")
+     *     })
+     */
+    getMeters(request: TrueForge.internal.GetMetersMetricsRequest, requestOptions?: MetricsClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetSessionMetricsMeterResponse>;
+    private __getMeters;
+}

package/dist/esm/api/resources/internal/resources/metrics/client/Client.mjs

@@ -0,0 +1,239 @@
+// This file was auto-generated by Fern from our API Definition.
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { normalizeClientOptionsWithAuth } from "../../../../../../BaseClient.mjs";
+import { mergeHeaders } from "../../../../../../core/headers.mjs";
+import * as core from "../../../../../../core/index.mjs";
+import { handleNonStatusCodeError } from "../../../../../../errors/handleNonStatusCodeError.mjs";
+import * as errors from "../../../../../../errors/index.mjs";
+import * as serializers from "../../../../../../serialization/index.mjs";
+import * as TrueForge from "../../../../../index.mjs";
+export class MetricsClient {
+    constructor(options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * List available session metric charts.
+     *
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.internal.metrics.listCharts()
+     */
+    listCharts(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listCharts(requestOptions));
+    }
+    __listCharts(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment)), "api/internal/metrics/charts"),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.GetSessionMetricsChartResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.TrueForgeError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                    rawResponse: _response.rawResponse,
+                });
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/internal/metrics/charts");
+        });
+    }
+    /**
+     * Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.
+     *
+     * @param {TrueForge.internal.GetChartDataMetricsRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.internal.metrics.getChartData({
+     *         agentId: "agent_id",
+     *         startTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+     *         endTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+     *         chartName: "sessions_over_time"
+     *     })
+     */
+    getChartData(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getChartData(request, requestOptions));
+    }
+    __getChartData(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { agentId, startTimestamp, endTimestamp, chartName } = request;
+            const _queryParams = {
+                agent_id: agentId,
+                start_timestamp: startTimestamp.toISOString(),
+                end_timestamp: endTimestamp.toISOString(),
+                chart_name: serializers.SessionMetricsChartName.jsonOrThrow(chartName, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    omitUndefined: true,
+                }),
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment)), "api/internal/metrics/charts-data"),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.GetSessionMetricsChartDataResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new TrueForge.BadRequestError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.TrueForgeError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/internal/metrics/charts-data");
+        });
+    }
+    /**
+     * Aggregate the caller's session meters for a named agent over an inclusive creation-time window.
+     *
+     * @param {TrueForge.internal.GetMetersMetricsRequest} request
+     * @param {MetricsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link TrueForge.BadRequestError}
+     * @throws {@link errors.TrueForgeError}
+     * @throws {@link errors.TrueForgeTimeoutError}
+     *
+     * @example
+     *     await client.internal.metrics.getMeters({
+     *         agentId: "agent_id",
+     *         startTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+     *         endTimestamp: new Date("2024-01-15T09:30:00.000Z")
+     *     })
+     */
+    getMeters(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getMeters(request, requestOptions));
+    }
+    __getMeters(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { agentId, startTimestamp, endTimestamp } = request;
+            const _queryParams = {
+                agent_id: agentId,
+                start_timestamp: startTimestamp.toISOString(),
+                end_timestamp: endTimestamp.toISOString(),
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment)), "api/internal/metrics/meters"),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.GetSessionMetricsMeterResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new TrueForge.BadRequestError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.TrueForgeError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/internal/metrics/meters");
+        });
+    }
+}

package/dist/esm/api/resources/internal/resources/metrics/client/index.d.mts

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/internal/resources/metrics/client/index.mjs

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/internal/resources/metrics/client/requests/GetChartDataMetricsRequest.d.mts

@@ -0,0 +1,20 @@
+import type * as TrueForge from "../../../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         agentId: "agent_id",
+ *         startTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+ *         endTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+ *         chartName: "sessions_over_time"
+ *     }
+ */
+export interface GetChartDataMetricsRequest {
+    /** Named agent identifier. */
+    agentId: string;
+    /** Inclusive lower bound on session `created_at`. */
+    startTimestamp: Date;
+    /** Inclusive upper bound on session `created_at`. */
+    endTimestamp: Date;
+    /** Session metrics chart to return. */
+    chartName: TrueForge.SessionMetricsChartName;
+}

package/dist/esm/api/resources/internal/resources/metrics/client/requests/GetChartDataMetricsRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/internal/resources/metrics/client/requests/GetMetersMetricsRequest.d.mts

@@ -0,0 +1,16 @@
+/**
+ * @example
+ *     {
+ *         agentId: "agent_id",
+ *         startTimestamp: new Date("2024-01-15T09:30:00.000Z"),
+ *         endTimestamp: new Date("2024-01-15T09:30:00.000Z")
+ *     }
+ */
+export interface GetMetersMetricsRequest {
+    /** Named agent identifier. */
+    agentId: string;
+    /** Inclusive lower bound on session `created_at`. */
+    startTimestamp: Date;
+    /** Inclusive upper bound on session `created_at`. */
+    endTimestamp: Date;
+}

package/dist/esm/api/resources/internal/resources/metrics/client/requests/GetMetersMetricsRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/internal/resources/metrics/client/requests/index.d.mts

@@ -0,0 +1,2 @@
+export type { GetChartDataMetricsRequest } from "./GetChartDataMetricsRequest.mjs";
+export type { GetMetersMetricsRequest } from "./GetMetersMetricsRequest.mjs";

package/dist/esm/api/resources/internal/resources/metrics/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/internal/resources/metrics/exports.d.mts

@@ -0,0 +1,2 @@
+export { MetricsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/internal/resources/metrics/exports.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { MetricsClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/internal/resources/metrics/index.d.mts

@@ -0,0 +1 @@
+export * from "./client/index.mjs";

package/dist/esm/api/resources/internal/resources/metrics/index.mjs

@@ -0,0 +1 @@
+export * from "./client/index.mjs";