@athenaintel/sdk 4.3.2249 → 4.3.2251

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.2249",
-        "User-Agent": "@athenaintel/sdk/4.3.2249",
+        "X-Fern-SDK-Version": "4.3.2251",
+        "User-Agent": "@athenaintel/sdk/4.3.2251",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Athena-Session-Credential": options === null || options === void 0 ? void 0 : options.sessionCredential,

package/dist/cjs/api/resources/agents/resources/general/client/Client.d.ts

@@ -36,7 +36,7 @@ export declare class GeneralClient {
     invoke(request: AthenaIntelligence.GeneralAgentRequest, requestOptions?: GeneralClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.GeneralAgentResponse>;
     private __invoke;
     /**
-     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it.
+     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it or while it is archived (restore it to continue it).
      *
      * @param {AthenaIntelligence.GeneralAgentRequest} request
      * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/agents/resources/general/client/Client.js

@@ -141,7 +141,7 @@ class GeneralClient {
         });
     }
     /**
-     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it.
+     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it or while it is archived (restore it to continue it).
      *
      * @param {AthenaIntelligence.GeneralAgentRequest} request
      * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/workspaces/client/Client.d.ts

@@ -140,4 +140,22 @@ export declare class WorkspacesClient {
      */
     updateToolRegistry(request: AthenaIntelligence.UpdateWorkspaceToolRegistryRequestIn, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceToolRegistryResponseOut>;
     private __updateToolRegistry;
+    /**
+     * Aggregate LLM token usage (and cost) for one workspace over the last `days` days: workspace totals plus per-member, per-day and per-Computer breakdowns. Token counters are summed from each session's usage ledger; dry-run (test) sessions are reported separately and excluded from the totals. Requires workspace owner or manager (or Athena admin) permissions — the same gate as the in-app Usage page.
+     *
+     * @param {AthenaIntelligence.GetUsageWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.getUsage({
+     *         workspace_id: "workspace_id",
+     *         days: 30
+     *     })
+     */
+    getUsage(request: AthenaIntelligence.GetUsageWorkspacesRequest, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceUsageResponseOut>;
+    private __getUsage;
 }

package/dist/cjs/api/resources/workspaces/client/Client.js

@@ -654,5 +654,91 @@ class WorkspacesClient {
             }
         });
     }
+    /**
+     * Aggregate LLM token usage (and cost) for one workspace over the last `days` days: workspace totals plus per-member, per-day and per-Computer breakdowns. Token counters are summed from each session's usage ledger; dry-run (test) sessions are reported separately and excluded from the totals. Requires workspace owner or manager (or Athena admin) permissions — the same gate as the in-app Usage page.
+     *
+     * @param {AthenaIntelligence.GetUsageWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.getUsage({
+     *         workspace_id: "workspace_id",
+     *         days: 30
+     *     })
+     */
+    getUsage(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getUsage(request, requestOptions));
+    }
+    __getUsage(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            const { workspace_id: workspaceId, days } = request;
+            const _queryParams = {};
+            if (days != null) {
+                _queryParams.days = days.toString();
+            }
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({
+                "X-Athena-Session-Credential": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.sessionCredential) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.sessionCredential,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
+                url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, `api/v0/workspaces/${core.url.encodePathParam(workspaceId)}/usage`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_j = (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.timeoutInSeconds) !== null && _j !== void 0 ? _j : 60) * 1000,
+                maxRetries: (_k = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _k !== void 0 ? _k : (_l = this._options) === null || _l === void 0 ? void 0 : _l.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 403:
+                        throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/workspaces/{workspace_id}/usage.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }
 exports.WorkspacesClient = WorkspacesClient;

package/dist/cjs/api/resources/workspaces/client/requests/GetUsageWorkspacesRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {
+ *         workspace_id: "workspace_id",
+ *         days: 30
+ *     }
+ */
+export interface GetUsageWorkspacesRequest {
+    workspace_id: string;
+    /** Reporting window in days, ending now (1-365) */
+    days?: number;
+}

package/dist/cjs/api/resources/workspaces/client/requests/GetUsageWorkspacesRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/workspaces/client/requests/index.d.ts

@@ -1,6 +1,7 @@
 export type { CreatePresenceTokenWorkspacesRequest } from "./CreatePresenceTokenWorkspacesRequest.js";
 export type { GetConfigurationWorkspacesRequest } from "./GetConfigurationWorkspacesRequest.js";
 export type { GetToolRegistryWorkspacesRequest } from "./GetToolRegistryWorkspacesRequest.js";
+export type { GetUsageWorkspacesRequest } from "./GetUsageWorkspacesRequest.js";
 export type { PresenceResolveRequestIn } from "./PresenceResolveRequestIn.js";
 export type { SearchMembersWorkspacesRequest } from "./SearchMembersWorkspacesRequest.js";
 export type { UpdateWorkspaceConfigurationRequestIn } from "./UpdateWorkspaceConfigurationRequestIn.js";

package/dist/cjs/api/types/WorkspaceUsageComputerOut.d.ts

@@ -0,0 +1,22 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * Usage attributed to one Computer asset over the window.
+ */
+export interface WorkspaceUsageComputerOut {
+    /** The Computer asset ID */
+    computer_asset_id: string;
+    /** Whether the Computer is archived */
+    is_archived: boolean;
+    /** When the most recent usage session was created */
+    last_session_at?: string | null;
+    /** Number of successful model calls */
+    request_count: number;
+    /** Number of usage sessions */
+    session_count: number;
+    /** The Computer's title */
+    title?: string | null;
+    /** Token counters behind this Computer's usage */
+    tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Total LLM cost in USD */
+    total_cost_usd: number;
+}

package/dist/cjs/api/types/WorkspaceUsageComputerOut.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/WorkspaceUsageDayOut.d.ts

@@ -0,0 +1,14 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * Usage of the workspace on one UTC day.
+ */
+export interface WorkspaceUsageDayOut {
+    /** Date in YYYY-MM-DD format (UTC) */
+    date: string;
+    /** Number of sessions created on the day */
+    session_count: number;
+    /** Token counters for the day */
+    tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Total LLM cost in USD for the day */
+    total_cost_usd: number;
+}

package/dist/cjs/api/types/WorkspaceUsageDayOut.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/WorkspaceUsageResponseOut.d.ts

@@ -0,0 +1,36 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * Aggregated LLM token and cost usage for one workspace.
+ */
+export interface WorkspaceUsageResponseOut {
+    /** Users with at least one session */
+    active_users: number;
+    /** Portion of total_cost_usd produced by Computers */
+    computer_cost_usd: number;
+    /** Number of Computer usage sessions */
+    computer_sessions: number;
+    /** Portion of tokens produced by Computers' LLM usage (already included in tokens, never additive) */
+    computer_tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Per-day breakdown, oldest first */
+    daily: AthenaIntelligence.WorkspaceUsageDayOut[];
+    /** Length of the reporting window in days */
+    days: number;
+    /** Cost of dry-run (test) sessions */
+    dry_run_cost_usd: number;
+    /** Number of dry-run (test) sessions */
+    dry_run_sessions: number;
+    /** Token counters from dry-run (test) sessions, excluded from tokens */
+    dry_run_tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Per-Computer breakdown, highest cost first */
+    per_computer: AthenaIntelligence.WorkspaceUsageComputerOut[];
+    /** Per-member breakdown, highest cost first */
+    per_user: AthenaIntelligence.WorkspaceUsageUserOut[];
+    /** Token counters across the workspace's sessions in the window, excluding dry-run (test) sessions */
+    tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Total LLM cost in USD */
+    total_cost_usd: number;
+    /** Number of sessions in the window */
+    total_sessions: number;
+    /** The workspace ID */
+    workspace_id: string;
+}

package/dist/cjs/api/types/WorkspaceUsageResponseOut.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/WorkspaceUsageTokensOut.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Token counters summed from the sessions' LLM usage ledgers.
+ */
+export interface WorkspaceUsageTokensOut {
+    /** Input tokens written to the provider's prompt cache */
+    cache_creation_input_tokens: number;
+    /** Input tokens served from the provider's prompt cache */
+    cache_read_input_tokens: number;
+    /** Input (prompt) tokens, including cached reads */
+    input_tokens: number;
+    /** Output (completion) tokens, including reasoning tokens */
+    output_tokens: number;
+    /** Output tokens spent on reasoning */
+    reasoning_output_tokens: number;
+    /** Total tokens (input + output) */
+    total_tokens: number;
+}

package/dist/cjs/api/types/WorkspaceUsageTokensOut.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/WorkspaceUsageUserOut.d.ts

@@ -0,0 +1,22 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * Usage of one workspace member over the window.
+ */
+export interface WorkspaceUsageUserOut {
+    /** The user's email */
+    email: string;
+    /** First name */
+    first_name?: string | null;
+    /** Last name */
+    last_name?: string | null;
+    /** When the user's most recent session was created */
+    last_session_at?: string | null;
+    /** Number of sessions */
+    session_count: number;
+    /** Token counters across the user's sessions */
+    tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Total LLM cost in USD */
+    total_cost_usd: number;
+    /** The user ID */
+    user_id: string;
+}

package/dist/cjs/api/types/WorkspaceUsageUserOut.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/index.d.ts

@@ -168,4 +168,9 @@ export * from "./WorkspaceMemberSearchResponseOut.js";
 export * from "./WorkspaceShareAccess.js";
 export * from "./WorkspaceToolRegistryResponseOut.js";
 export * from "./WorkspaceToolRegistryToolOut.js";
+export * from "./WorkspaceUsageComputerOut.js";
+export * from "./WorkspaceUsageDayOut.js";
+export * from "./WorkspaceUsageResponseOut.js";
+export * from "./WorkspaceUsageTokensOut.js";
+export * from "./WorkspaceUsageUserOut.js";
 export * from "./WrapStrategy.js";

package/dist/cjs/api/types/index.js

@@ -184,4 +184,9 @@ __exportStar(require("./WorkspaceMemberSearchResponseOut.js"), exports);
 __exportStar(require("./WorkspaceShareAccess.js"), exports);
 __exportStar(require("./WorkspaceToolRegistryResponseOut.js"), exports);
 __exportStar(require("./WorkspaceToolRegistryToolOut.js"), exports);
+__exportStar(require("./WorkspaceUsageComputerOut.js"), exports);
+__exportStar(require("./WorkspaceUsageDayOut.js"), exports);
+__exportStar(require("./WorkspaceUsageResponseOut.js"), exports);
+__exportStar(require("./WorkspaceUsageTokensOut.js"), exports);
+__exportStar(require("./WorkspaceUsageUserOut.js"), exports);
 __exportStar(require("./WrapStrategy.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2249";
+export declare const SDK_VERSION = "4.3.2251";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "4.3.2249";
+exports.SDK_VERSION = "4.3.2251";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.2249",
-        "User-Agent": "@athenaintel/sdk/4.3.2249",
+        "X-Fern-SDK-Version": "4.3.2251",
+        "User-Agent": "@athenaintel/sdk/4.3.2251",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Athena-Session-Credential": options === null || options === void 0 ? void 0 : options.sessionCredential,

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

@@ -36,7 +36,7 @@ export declare class GeneralClient {
     invoke(request: AthenaIntelligence.GeneralAgentRequest, requestOptions?: GeneralClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.GeneralAgentResponse>;
     private __invoke;
     /**
-     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it.
+     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it or while it is archived (restore it to continue it).
      *
      * @param {AthenaIntelligence.GeneralAgentRequest} request
      * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -105,7 +105,7 @@ export class GeneralClient {
         });
     }
     /**
-     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it.
+     * Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it or while it is archived (restore it to continue it).
      *
      * @param {AthenaIntelligence.GeneralAgentRequest} request
      * @param {GeneralClient.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -140,4 +140,22 @@ export declare class WorkspacesClient {
      */
     updateToolRegistry(request: AthenaIntelligence.UpdateWorkspaceToolRegistryRequestIn, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceToolRegistryResponseOut>;
     private __updateToolRegistry;
+    /**
+     * Aggregate LLM token usage (and cost) for one workspace over the last `days` days: workspace totals plus per-member, per-day and per-Computer breakdowns. Token counters are summed from each session's usage ledger; dry-run (test) sessions are reported separately and excluded from the totals. Requires workspace owner or manager (or Athena admin) permissions — the same gate as the in-app Usage page.
+     *
+     * @param {AthenaIntelligence.GetUsageWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.getUsage({
+     *         workspace_id: "workspace_id",
+     *         days: 30
+     *     })
+     */
+    getUsage(request: AthenaIntelligence.GetUsageWorkspacesRequest, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceUsageResponseOut>;
+    private __getUsage;
 }

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

@@ -618,4 +618,90 @@ export class WorkspacesClient {
             }
         });
     }
+    /**
+     * Aggregate LLM token usage (and cost) for one workspace over the last `days` days: workspace totals plus per-member, per-day and per-Computer breakdowns. Token counters are summed from each session's usage ledger; dry-run (test) sessions are reported separately and excluded from the totals. Requires workspace owner or manager (or Athena admin) permissions — the same gate as the in-app Usage page.
+     *
+     * @param {AthenaIntelligence.GetUsageWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.getUsage({
+     *         workspace_id: "workspace_id",
+     *         days: 30
+     *     })
+     */
+    getUsage(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getUsage(request, requestOptions));
+    }
+    __getUsage(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            const { workspace_id: workspaceId, days } = request;
+            const _queryParams = {};
+            if (days != null) {
+                _queryParams.days = days.toString();
+            }
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({
+                "X-Athena-Session-Credential": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.sessionCredential) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.sessionCredential,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
+                url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.AthenaIntelligenceEnvironment.Production, `api/v0/workspaces/${core.url.encodePathParam(workspaceId)}/usage`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_j = (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.timeoutInSeconds) !== null && _j !== void 0 ? _j : 60) * 1000,
+                maxRetries: (_k = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _k !== void 0 ? _k : (_l = this._options) === null || _l === void 0 ? void 0 : _l.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 403:
+                        throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/workspaces/{workspace_id}/usage.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }

package/dist/esm/api/resources/workspaces/client/requests/GetUsageWorkspacesRequest.d.mts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {
+ *         workspace_id: "workspace_id",
+ *         days: 30
+ *     }
+ */
+export interface GetUsageWorkspacesRequest {
+    workspace_id: string;
+    /** Reporting window in days, ending now (1-365) */
+    days?: number;
+}

package/dist/esm/api/resources/workspaces/client/requests/GetUsageWorkspacesRequest.mjs

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

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

@@ -1,6 +1,7 @@
 export type { CreatePresenceTokenWorkspacesRequest } from "./CreatePresenceTokenWorkspacesRequest.mjs";
 export type { GetConfigurationWorkspacesRequest } from "./GetConfigurationWorkspacesRequest.mjs";
 export type { GetToolRegistryWorkspacesRequest } from "./GetToolRegistryWorkspacesRequest.mjs";
+export type { GetUsageWorkspacesRequest } from "./GetUsageWorkspacesRequest.mjs";
 export type { PresenceResolveRequestIn } from "./PresenceResolveRequestIn.mjs";
 export type { SearchMembersWorkspacesRequest } from "./SearchMembersWorkspacesRequest.mjs";
 export type { UpdateWorkspaceConfigurationRequestIn } from "./UpdateWorkspaceConfigurationRequestIn.mjs";

package/dist/esm/api/types/WorkspaceUsageComputerOut.d.mts

@@ -0,0 +1,22 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * Usage attributed to one Computer asset over the window.
+ */
+export interface WorkspaceUsageComputerOut {
+    /** The Computer asset ID */
+    computer_asset_id: string;
+    /** Whether the Computer is archived */
+    is_archived: boolean;
+    /** When the most recent usage session was created */
+    last_session_at?: string | null;
+    /** Number of successful model calls */
+    request_count: number;
+    /** Number of usage sessions */
+    session_count: number;
+    /** The Computer's title */
+    title?: string | null;
+    /** Token counters behind this Computer's usage */
+    tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Total LLM cost in USD */
+    total_cost_usd: number;
+}

package/dist/esm/api/types/WorkspaceUsageComputerOut.mjs

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

package/dist/esm/api/types/WorkspaceUsageDayOut.d.mts

@@ -0,0 +1,14 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * Usage of the workspace on one UTC day.
+ */
+export interface WorkspaceUsageDayOut {
+    /** Date in YYYY-MM-DD format (UTC) */
+    date: string;
+    /** Number of sessions created on the day */
+    session_count: number;
+    /** Token counters for the day */
+    tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Total LLM cost in USD for the day */
+    total_cost_usd: number;
+}

package/dist/esm/api/types/WorkspaceUsageDayOut.mjs

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

package/dist/esm/api/types/WorkspaceUsageResponseOut.d.mts

@@ -0,0 +1,36 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * Aggregated LLM token and cost usage for one workspace.
+ */
+export interface WorkspaceUsageResponseOut {
+    /** Users with at least one session */
+    active_users: number;
+    /** Portion of total_cost_usd produced by Computers */
+    computer_cost_usd: number;
+    /** Number of Computer usage sessions */
+    computer_sessions: number;
+    /** Portion of tokens produced by Computers' LLM usage (already included in tokens, never additive) */
+    computer_tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Per-day breakdown, oldest first */
+    daily: AthenaIntelligence.WorkspaceUsageDayOut[];
+    /** Length of the reporting window in days */
+    days: number;
+    /** Cost of dry-run (test) sessions */
+    dry_run_cost_usd: number;
+    /** Number of dry-run (test) sessions */
+    dry_run_sessions: number;
+    /** Token counters from dry-run (test) sessions, excluded from tokens */
+    dry_run_tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Per-Computer breakdown, highest cost first */
+    per_computer: AthenaIntelligence.WorkspaceUsageComputerOut[];
+    /** Per-member breakdown, highest cost first */
+    per_user: AthenaIntelligence.WorkspaceUsageUserOut[];
+    /** Token counters across the workspace's sessions in the window, excluding dry-run (test) sessions */
+    tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Total LLM cost in USD */
+    total_cost_usd: number;
+    /** Number of sessions in the window */
+    total_sessions: number;
+    /** The workspace ID */
+    workspace_id: string;
+}

package/dist/esm/api/types/WorkspaceUsageResponseOut.mjs

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

package/dist/esm/api/types/WorkspaceUsageTokensOut.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Token counters summed from the sessions' LLM usage ledgers.
+ */
+export interface WorkspaceUsageTokensOut {
+    /** Input tokens written to the provider's prompt cache */
+    cache_creation_input_tokens: number;
+    /** Input tokens served from the provider's prompt cache */
+    cache_read_input_tokens: number;
+    /** Input (prompt) tokens, including cached reads */
+    input_tokens: number;
+    /** Output (completion) tokens, including reasoning tokens */
+    output_tokens: number;
+    /** Output tokens spent on reasoning */
+    reasoning_output_tokens: number;
+    /** Total tokens (input + output) */
+    total_tokens: number;
+}

package/dist/esm/api/types/WorkspaceUsageTokensOut.mjs

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

package/dist/esm/api/types/WorkspaceUsageUserOut.d.mts

@@ -0,0 +1,22 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * Usage of one workspace member over the window.
+ */
+export interface WorkspaceUsageUserOut {
+    /** The user's email */
+    email: string;
+    /** First name */
+    first_name?: string | null;
+    /** Last name */
+    last_name?: string | null;
+    /** When the user's most recent session was created */
+    last_session_at?: string | null;
+    /** Number of sessions */
+    session_count: number;
+    /** Token counters across the user's sessions */
+    tokens: AthenaIntelligence.WorkspaceUsageTokensOut;
+    /** Total LLM cost in USD */
+    total_cost_usd: number;
+    /** The user ID */
+    user_id: string;
+}

package/dist/esm/api/types/WorkspaceUsageUserOut.mjs

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

package/dist/esm/api/types/index.d.mts

@@ -168,4 +168,9 @@ export * from "./WorkspaceMemberSearchResponseOut.mjs";
 export * from "./WorkspaceShareAccess.mjs";
 export * from "./WorkspaceToolRegistryResponseOut.mjs";
 export * from "./WorkspaceToolRegistryToolOut.mjs";
+export * from "./WorkspaceUsageComputerOut.mjs";
+export * from "./WorkspaceUsageDayOut.mjs";
+export * from "./WorkspaceUsageResponseOut.mjs";
+export * from "./WorkspaceUsageTokensOut.mjs";
+export * from "./WorkspaceUsageUserOut.mjs";
 export * from "./WrapStrategy.mjs";

package/dist/esm/api/types/index.mjs

@@ -168,4 +168,9 @@ export * from "./WorkspaceMemberSearchResponseOut.mjs";
 export * from "./WorkspaceShareAccess.mjs";
 export * from "./WorkspaceToolRegistryResponseOut.mjs";
 export * from "./WorkspaceToolRegistryToolOut.mjs";
+export * from "./WorkspaceUsageComputerOut.mjs";
+export * from "./WorkspaceUsageDayOut.mjs";
+export * from "./WorkspaceUsageResponseOut.mjs";
+export * from "./WorkspaceUsageTokensOut.mjs";
+export * from "./WorkspaceUsageUserOut.mjs";
 export * from "./WrapStrategy.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2249";
+export declare const SDK_VERSION = "4.3.2251";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2249";
+export const SDK_VERSION = "4.3.2251";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@athenaintel/sdk",
-    "version": "4.3.2249",
+    "version": "4.3.2251",
     "private": false,
     "repository": "github:Athena-Intel/athena-typescript",
     "type": "commonjs",

package/reference.md

@@ -5847,6 +5847,72 @@ await client.workspaces.updateToolRegistry({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.workspaces.<a href="/src/api/resources/workspaces/client/Client.ts">getUsage</a>({ ...params }) -> AthenaIntelligence.WorkspaceUsageResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Aggregate LLM token usage (and cost) for one workspace over the last `days` days: workspace totals plus per-member, per-day and per-Computer breakdowns. Token counters are summed from each session's usage ledger; dry-run (test) sessions are reported separately and excluded from the totals. Requires workspace owner or manager (or Athena admin) permissions — the same gate as the in-app Usage page.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.workspaces.getUsage({
+    workspace_id: "workspace_id",
+    days: 30
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.GetUsageWorkspacesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `WorkspacesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -5938,7 +6004,7 @@ await client.agents.general.invoke({
 <dl>
 <dd>
 
-Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it.
+Start a general-agent run and return immediately with a `thread_id`. Use this instead of `/agents/general/invoke` for any call that may take more than a few seconds (tool use, multi-step work), so the HTTP connection is never held open past client or proxy timeouts. Poll `GET /threads/{thread_id}/status` until `status` is `completed` or `failed`; pass `include_messages=true` to read the agent's reply. Supply the `thread_id` of a general-agent thread you can access to continue it; 404/403 when it is unknown/not yours, 409 while a run is still in progress on it or while it is archived (restore it to continue it).
 </dd>
 </dl>
 </dd>