@athenaintel/sdk 4.3.2251 → 4.3.2252

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.2251",
-        "User-Agent": "@athenaintel/sdk/4.3.2251",
+        "X-Fern-SDK-Version": "4.3.2252",
+        "User-Agent": "@athenaintel/sdk/4.3.2252",
         "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/workspaces/client/Client.d.ts

@@ -65,6 +65,25 @@ export declare class WorkspacesClient {
      */
     searchMembers(request: AthenaIntelligence.SearchMembersWorkspacesRequest, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceMemberSearchResponseOut>;
     private __searchMembers;
+    /**
+     * The full membership roster of one workspace with each member's user id, name, email, role and join date — built for usage reporting and licence reconciliation, unlike the share-picker search at `GET /workspaces/{workspace_id}/members`. Removed members are left out unless `include_archived=true`. Pages are ordered by user id; `next_cursor` is returned while more remain. Requires workspace owner or manager (or Athena admin) permissions.
+     *
+     * @param {AthenaIntelligence.ListMembershipsWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.listMemberships({
+     *         workspace_id: "workspace_eb171baf",
+     *         include_archived: false,
+     *         limit: 200
+     *     })
+     */
+    listMemberships(request: AthenaIntelligence.ListMembershipsWorkspacesRequest, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceMembershipListResponseOut>;
+    private __listMemberships;
     /**
      * Admin only. Mint a short-lived, read-only Keryx token for a workspace's live presence feed (the awareness room the People page renders). The token is bound to the calling user, so Keryx narrows every frame to the documents that user may open; it can never publish presence or write document content. Requires the presence roster to be enabled for the deployment and opted in for the workspace. Computer-asset sandbox credentials are refused: call with the viewing user's own token.
      *
@@ -158,4 +177,24 @@ export declare class WorkspacesClient {
      */
     getUsage(request: AthenaIntelligence.GetUsageWorkspacesRequest, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceUsageResponseOut>;
     private __getUsage;
+    /**
+     * Per-session LLM token usage for one workspace — the same rows as the workspace usage CSV export, as JSON. Each session yields one row per provider/model/status combination with its token breakdown and billed cost; dry-run (test) sessions are excluded. Pick the window with `from`/`to` (UTC dates, inclusive, at most 365 days) or a rolling `days`. Pages are keyset-paginated newest first: `limit` counts sessions, and `next_cursor` is returned while more sessions remain. Requires workspace owner or manager (or Athena admin) permissions.
+     *
+     * @param {AthenaIntelligence.ListUsageSessionsWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.listUsageSessions({
+     *         workspace_id: "workspace_eb171baf",
+     *         days: 30,
+     *         limit: 100
+     *     })
+     */
+    listUsageSessions(request: AthenaIntelligence.ListUsageSessionsWorkspacesRequest, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceUsageSessionsResponseOut>;
+    private __listUsageSessions;
 }

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

@@ -321,6 +321,99 @@ class WorkspacesClient {
             }
         });
     }
+    /**
+     * The full membership roster of one workspace with each member's user id, name, email, role and join date — built for usage reporting and licence reconciliation, unlike the share-picker search at `GET /workspaces/{workspace_id}/members`. Removed members are left out unless `include_archived=true`. Pages are ordered by user id; `next_cursor` is returned while more remain. Requires workspace owner or manager (or Athena admin) permissions.
+     *
+     * @param {AthenaIntelligence.ListMembershipsWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.listMemberships({
+     *         workspace_id: "workspace_eb171baf",
+     *         include_archived: false,
+     *         limit: 200
+     *     })
+     */
+    listMemberships(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listMemberships(request, requestOptions));
+    }
+    __listMemberships(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, include_archived: includeArchived, cursor, limit } = request;
+            const _queryParams = {};
+            if (includeArchived != null) {
+                _queryParams.include_archived = includeArchived.toString();
+            }
+            if (cursor !== undefined) {
+                _queryParams.cursor = cursor;
+            }
+            if (limit != null) {
+                _queryParams.limit = limit.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)}/memberships`),
+                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}/memberships.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Admin only. Mint a short-lived, read-only Keryx token for a workspace's live presence feed (the awareness room the People page renders). The token is bound to the calling user, so Keryx narrows every frame to the documents that user may open; it can never publish presence or write document content. Requires the presence roster to be enabled for the deployment and opted in for the workspace. Computer-asset sandbox credentials are refused: call with the viewing user's own token.
      *
@@ -740,5 +833,107 @@ class WorkspacesClient {
             }
         });
     }
+    /**
+     * Per-session LLM token usage for one workspace — the same rows as the workspace usage CSV export, as JSON. Each session yields one row per provider/model/status combination with its token breakdown and billed cost; dry-run (test) sessions are excluded. Pick the window with `from`/`to` (UTC dates, inclusive, at most 365 days) or a rolling `days`. Pages are keyset-paginated newest first: `limit` counts sessions, and `next_cursor` is returned while more sessions remain. Requires workspace owner or manager (or Athena admin) permissions.
+     *
+     * @param {AthenaIntelligence.ListUsageSessionsWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.listUsageSessions({
+     *         workspace_id: "workspace_eb171baf",
+     *         days: 30,
+     *         limit: 100
+     *     })
+     */
+    listUsageSessions(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listUsageSessions(request, requestOptions));
+    }
+    __listUsageSessions(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, from: from_, to, days, cursor, limit } = request;
+            const _queryParams = {};
+            if (from_ !== undefined) {
+                _queryParams.from = from_;
+            }
+            if (to !== undefined) {
+                _queryParams.to = to;
+            }
+            if (days != null) {
+                _queryParams.days = days.toString();
+            }
+            if (cursor !== undefined) {
+                _queryParams.cursor = cursor;
+            }
+            if (limit != null) {
+                _queryParams.limit = limit.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/sessions`),
+                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 400:
+                        throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
+                    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/sessions.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }
 exports.WorkspacesClient = WorkspacesClient;

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

@@ -0,0 +1,18 @@
+/**
+ * @example
+ *     {
+ *         workspace_id: "workspace_eb171baf",
+ *         include_archived: false,
+ *         limit: 200
+ *     }
+ */
+export interface ListMembershipsWorkspacesRequest {
+    /** Unique identifier of the workspace */
+    workspace_id: string;
+    /** Also return memberships that were removed from the workspace */
+    include_archived?: boolean;
+    /** `next_cursor` from the previous page */
+    cursor?: string | null;
+    /** Maximum memberships per page */
+    limit?: number;
+}

package/dist/cjs/api/resources/workspaces/client/requests/ListMembershipsWorkspacesRequest.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/ListUsageSessionsWorkspacesRequest.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @example
+ *     {
+ *         workspace_id: "workspace_eb171baf",
+ *         days: 30,
+ *         limit: 100
+ *     }
+ */
+export interface ListUsageSessionsWorkspacesRequest {
+    /** Unique identifier of the workspace */
+    workspace_id: string;
+    /** First UTC day of the window (YYYY-MM-DD); requires `to` */
+    from?: string | null;
+    /** Last UTC day of the window, inclusive (YYYY-MM-DD); requires `from` */
+    to?: string | null;
+    /** Rolling window in days ending now; ignored when `from`/`to` are given */
+    days?: number;
+    /** `next_cursor` from the previous page */
+    cursor?: string | null;
+    /** Maximum sessions per page (each may yield several rows) */
+    limit?: number;
+}

package/dist/cjs/api/resources/workspaces/client/requests/ListUsageSessionsWorkspacesRequest.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

@@ -2,6 +2,8 @@ export type { CreatePresenceTokenWorkspacesRequest } from "./CreatePresenceToken
 export type { GetConfigurationWorkspacesRequest } from "./GetConfigurationWorkspacesRequest.js";
 export type { GetToolRegistryWorkspacesRequest } from "./GetToolRegistryWorkspacesRequest.js";
 export type { GetUsageWorkspacesRequest } from "./GetUsageWorkspacesRequest.js";
+export type { ListMembershipsWorkspacesRequest } from "./ListMembershipsWorkspacesRequest.js";
+export type { ListUsageSessionsWorkspacesRequest } from "./ListUsageSessionsWorkspacesRequest.js";
 export type { PresenceResolveRequestIn } from "./PresenceResolveRequestIn.js";
 export type { SearchMembersWorkspacesRequest } from "./SearchMembersWorkspacesRequest.js";
 export type { UpdateWorkspaceConfigurationRequestIn } from "./UpdateWorkspaceConfigurationRequestIn.js";

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

@@ -0,0 +1,12 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * One page of a workspace's membership roster.
+ */
+export interface WorkspaceMembershipListResponseOut {
+    /** Memberships for this page, ordered by user id */
+    memberships: AthenaIntelligence.WorkspaceMembershipOut[];
+    /** Pass as `cursor` to fetch the next page; null on the last page */
+    next_cursor: string | null;
+    /** Workspace the roster belongs to */
+    workspace_id: string;
+}

package/dist/cjs/api/types/WorkspaceMembershipListResponseOut.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/WorkspaceMembershipOut.d.ts

@@ -0,0 +1,18 @@
+/**
+ * One member of a workspace and their role.
+ */
+export interface WorkspaceMembershipOut {
+    email: string;
+    first_name: string | null;
+    /** Membership has been removed from the workspace */
+    is_archived: boolean;
+    /** The user account is suspended deployment-wide */
+    is_suspended: boolean;
+    /** When the membership was created */
+    joined_at: string;
+    last_name: string | null;
+    /** Workspace role: owner, manager or user */
+    role: string;
+    /** User id, stable across workspaces */
+    user_id: string;
+}

package/dist/cjs/api/types/WorkspaceMembershipOut.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/WorkspaceUsageSessionRowOut.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Token usage of one session for one provider/model/status combination.
+ */
+export interface WorkspaceUsageSessionRowOut {
+    /** AOP asset id when started by an AOP run */
+    aop_id: string | null;
+    /** Title of that AOP */
+    aop_title: string | null;
+    /** Billing attribution of the session */
+    billed_to: string | null;
+    /** Null for an `untracked` row */
+    cache_creation_input_tokens: number | null;
+    /** Null for an `untracked` row */
+    cache_read_input_tokens: number | null;
+    /** Earliest model call in the row */
+    first_event_at: string | null;
+    /** Null for an `untracked` row */
+    input_tokens: number | null;
+    /** Latest model call in the row */
+    last_event_at: string | null;
+    /** How the session was started (user_chat, aop_execution, public_api, ...) */
+    origin_kind: string | null;
+    /** Human label for origin_kind */
+    origin_kind_label: string | null;
+    /** Null for an `untracked` row */
+    output_tokens: number | null;
+    /** Project asset id, if any */
+    project_id: string | null;
+    /** Title of that project */
+    project_title: string | null;
+    /** LLM provider */
+    provider: string;
+    /** Null for an `untracked` row */
+    reasoning_output_tokens: number | null;
+    /** Model the session asked for */
+    requested_model: string | null;
+    /** Model that actually served the calls */
+    resolved_model: string;
+    /** Billed cost of this row in USD; safe to sum across rows */
+    row_total_cost_usd: number;
+    /** Model calls aggregated into this row */
+    run_count: number;
+    /** When the session was created */
+    session_created_at: string;
+    /** Session (conversation) asset id */
+    session_id: string;
+    /** Billed cost of the whole session in USD, carried by the session's first row only and null on its other rows, so summing the column never double-counts (same convention as the CSV export) */
+    session_total_cost_usd: number | null;
+    /** Outcome of the aggregated calls; `untracked` marks a session metered before token tracking existed, whose token counters are null */
+    status: string;
+    /** Null for an `untracked` row */
+    total_tokens: number | null;
+    /** AOP trigger type, if any */
+    trigger_type: string | null;
+    /** Null for an `untracked` row */
+    uncached_input_tokens: number | null;
+    /** Window end (exclusive) the row was bounded to */
+    usage_period_end_exclusive: string | null;
+    /** Window start the row was bounded to */
+    usage_period_start: string;
+    /** Email of the member who ran the session */
+    user_email: string | null;
+    /** Display name of that member */
+    user_name: string | null;
+}

package/dist/cjs/api/types/WorkspaceUsageSessionRowOut.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/WorkspaceUsageSessionsResponseOut.d.ts

@@ -0,0 +1,13 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * One page of per-session token usage for a workspace.
+ */
+export interface WorkspaceUsageSessionsResponseOut {
+    /** Pass as `cursor` to fetch the next page; null when the window is exhausted */
+    next_cursor: string | null;
+    /** Rows for this page, newest session first */
+    sessions: AthenaIntelligence.WorkspaceUsageSessionRowOut[];
+    window: AthenaIntelligence.WorkspaceUsageWindowOut;
+    /** Workspace the rows belong to */
+    workspace_id: string;
+}

package/dist/cjs/api/types/WorkspaceUsageSessionsResponseOut.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/WorkspaceUsageWindowOut.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The reporting window a usage page covers.
+ */
+export interface WorkspaceUsageWindowOut {
+    /** Number of days the window spans */
+    days: number;
+    /** Last UTC day (inclusive) of an explicit window; null for a rolling window */
+    end_date: string | null;
+    /** First UTC day of an explicit `from`/`to` window; null for a rolling window */
+    start_date: string | null;
+    /** Window end (exclusive); null means 'now' for a rolling window */
+    usage_period_end_exclusive: string | null;
+    /** Window start (inclusive) */
+    usage_period_start: string;
+}

package/dist/cjs/api/types/WorkspaceUsageWindowOut.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

@@ -165,12 +165,17 @@ export * from "./WorkspaceDisclaimerOut.js";
 export * from "./WorkspaceInfoOut.js";
 export * from "./WorkspaceMemberOut.js";
 export * from "./WorkspaceMemberSearchResponseOut.js";
+export * from "./WorkspaceMembershipListResponseOut.js";
+export * from "./WorkspaceMembershipOut.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 "./WorkspaceUsageSessionRowOut.js";
+export * from "./WorkspaceUsageSessionsResponseOut.js";
 export * from "./WorkspaceUsageTokensOut.js";
 export * from "./WorkspaceUsageUserOut.js";
+export * from "./WorkspaceUsageWindowOut.js";
 export * from "./WrapStrategy.js";

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

@@ -181,12 +181,17 @@ __exportStar(require("./WorkspaceDisclaimerOut.js"), exports);
 __exportStar(require("./WorkspaceInfoOut.js"), exports);
 __exportStar(require("./WorkspaceMemberOut.js"), exports);
 __exportStar(require("./WorkspaceMemberSearchResponseOut.js"), exports);
+__exportStar(require("./WorkspaceMembershipListResponseOut.js"), exports);
+__exportStar(require("./WorkspaceMembershipOut.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("./WorkspaceUsageSessionRowOut.js"), exports);
+__exportStar(require("./WorkspaceUsageSessionsResponseOut.js"), exports);
 __exportStar(require("./WorkspaceUsageTokensOut.js"), exports);
 __exportStar(require("./WorkspaceUsageUserOut.js"), exports);
+__exportStar(require("./WorkspaceUsageWindowOut.js"), exports);
 __exportStar(require("./WrapStrategy.js"), exports);

package/dist/cjs/version.d.ts

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

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.2251";
+exports.SDK_VERSION = "4.3.2252";

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.2251",
-        "User-Agent": "@athenaintel/sdk/4.3.2251",
+        "X-Fern-SDK-Version": "4.3.2252",
+        "User-Agent": "@athenaintel/sdk/4.3.2252",
         "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/workspaces/client/Client.d.mts

@@ -65,6 +65,25 @@ export declare class WorkspacesClient {
      */
     searchMembers(request: AthenaIntelligence.SearchMembersWorkspacesRequest, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceMemberSearchResponseOut>;
     private __searchMembers;
+    /**
+     * The full membership roster of one workspace with each member's user id, name, email, role and join date — built for usage reporting and licence reconciliation, unlike the share-picker search at `GET /workspaces/{workspace_id}/members`. Removed members are left out unless `include_archived=true`. Pages are ordered by user id; `next_cursor` is returned while more remain. Requires workspace owner or manager (or Athena admin) permissions.
+     *
+     * @param {AthenaIntelligence.ListMembershipsWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.listMemberships({
+     *         workspace_id: "workspace_eb171baf",
+     *         include_archived: false,
+     *         limit: 200
+     *     })
+     */
+    listMemberships(request: AthenaIntelligence.ListMembershipsWorkspacesRequest, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceMembershipListResponseOut>;
+    private __listMemberships;
     /**
      * Admin only. Mint a short-lived, read-only Keryx token for a workspace's live presence feed (the awareness room the People page renders). The token is bound to the calling user, so Keryx narrows every frame to the documents that user may open; it can never publish presence or write document content. Requires the presence roster to be enabled for the deployment and opted in for the workspace. Computer-asset sandbox credentials are refused: call with the viewing user's own token.
      *
@@ -158,4 +177,24 @@ export declare class WorkspacesClient {
      */
     getUsage(request: AthenaIntelligence.GetUsageWorkspacesRequest, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceUsageResponseOut>;
     private __getUsage;
+    /**
+     * Per-session LLM token usage for one workspace — the same rows as the workspace usage CSV export, as JSON. Each session yields one row per provider/model/status combination with its token breakdown and billed cost; dry-run (test) sessions are excluded. Pick the window with `from`/`to` (UTC dates, inclusive, at most 365 days) or a rolling `days`. Pages are keyset-paginated newest first: `limit` counts sessions, and `next_cursor` is returned while more sessions remain. Requires workspace owner or manager (or Athena admin) permissions.
+     *
+     * @param {AthenaIntelligence.ListUsageSessionsWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.listUsageSessions({
+     *         workspace_id: "workspace_eb171baf",
+     *         days: 30,
+     *         limit: 100
+     *     })
+     */
+    listUsageSessions(request: AthenaIntelligence.ListUsageSessionsWorkspacesRequest, requestOptions?: WorkspacesClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.WorkspaceUsageSessionsResponseOut>;
+    private __listUsageSessions;
 }

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

@@ -285,6 +285,99 @@ export class WorkspacesClient {
             }
         });
     }
+    /**
+     * The full membership roster of one workspace with each member's user id, name, email, role and join date — built for usage reporting and licence reconciliation, unlike the share-picker search at `GET /workspaces/{workspace_id}/members`. Removed members are left out unless `include_archived=true`. Pages are ordered by user id; `next_cursor` is returned while more remain. Requires workspace owner or manager (or Athena admin) permissions.
+     *
+     * @param {AthenaIntelligence.ListMembershipsWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.listMemberships({
+     *         workspace_id: "workspace_eb171baf",
+     *         include_archived: false,
+     *         limit: 200
+     *     })
+     */
+    listMemberships(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listMemberships(request, requestOptions));
+    }
+    __listMemberships(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, include_archived: includeArchived, cursor, limit } = request;
+            const _queryParams = {};
+            if (includeArchived != null) {
+                _queryParams.include_archived = includeArchived.toString();
+            }
+            if (cursor !== undefined) {
+                _queryParams.cursor = cursor;
+            }
+            if (limit != null) {
+                _queryParams.limit = limit.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)}/memberships`),
+                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}/memberships.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Admin only. Mint a short-lived, read-only Keryx token for a workspace's live presence feed (the awareness room the People page renders). The token is bound to the calling user, so Keryx narrows every frame to the documents that user may open; it can never publish presence or write document content. Requires the presence roster to be enabled for the deployment and opted in for the workspace. Computer-asset sandbox credentials are refused: call with the viewing user's own token.
      *
@@ -704,4 +797,106 @@ export class WorkspacesClient {
             }
         });
     }
+    /**
+     * Per-session LLM token usage for one workspace — the same rows as the workspace usage CSV export, as JSON. Each session yields one row per provider/model/status combination with its token breakdown and billed cost; dry-run (test) sessions are excluded. Pick the window with `from`/`to` (UTC dates, inclusive, at most 365 days) or a rolling `days`. Pages are keyset-paginated newest first: `limit` counts sessions, and `next_cursor` is returned while more sessions remain. Requires workspace owner or manager (or Athena admin) permissions.
+     *
+     * @param {AthenaIntelligence.ListUsageSessionsWorkspacesRequest} request
+     * @param {WorkspacesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.ForbiddenError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.workspaces.listUsageSessions({
+     *         workspace_id: "workspace_eb171baf",
+     *         days: 30,
+     *         limit: 100
+     *     })
+     */
+    listUsageSessions(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listUsageSessions(request, requestOptions));
+    }
+    __listUsageSessions(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, from: from_, to, days, cursor, limit } = request;
+            const _queryParams = {};
+            if (from_ !== undefined) {
+                _queryParams.from = from_;
+            }
+            if (to !== undefined) {
+                _queryParams.to = to;
+            }
+            if (days != null) {
+                _queryParams.days = days.toString();
+            }
+            if (cursor !== undefined) {
+                _queryParams.cursor = cursor;
+            }
+            if (limit != null) {
+                _queryParams.limit = limit.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/sessions`),
+                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 400:
+                        throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
+                    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/sessions.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }

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

@@ -0,0 +1,18 @@
+/**
+ * @example
+ *     {
+ *         workspace_id: "workspace_eb171baf",
+ *         include_archived: false,
+ *         limit: 200
+ *     }
+ */
+export interface ListMembershipsWorkspacesRequest {
+    /** Unique identifier of the workspace */
+    workspace_id: string;
+    /** Also return memberships that were removed from the workspace */
+    include_archived?: boolean;
+    /** `next_cursor` from the previous page */
+    cursor?: string | null;
+    /** Maximum memberships per page */
+    limit?: number;
+}

package/dist/esm/api/resources/workspaces/client/requests/ListMembershipsWorkspacesRequest.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/ListUsageSessionsWorkspacesRequest.d.mts

@@ -0,0 +1,22 @@
+/**
+ * @example
+ *     {
+ *         workspace_id: "workspace_eb171baf",
+ *         days: 30,
+ *         limit: 100
+ *     }
+ */
+export interface ListUsageSessionsWorkspacesRequest {
+    /** Unique identifier of the workspace */
+    workspace_id: string;
+    /** First UTC day of the window (YYYY-MM-DD); requires `to` */
+    from?: string | null;
+    /** Last UTC day of the window, inclusive (YYYY-MM-DD); requires `from` */
+    to?: string | null;
+    /** Rolling window in days ending now; ignored when `from`/`to` are given */
+    days?: number;
+    /** `next_cursor` from the previous page */
+    cursor?: string | null;
+    /** Maximum sessions per page (each may yield several rows) */
+    limit?: number;
+}

package/dist/esm/api/resources/workspaces/client/requests/ListUsageSessionsWorkspacesRequest.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

@@ -2,6 +2,8 @@ export type { CreatePresenceTokenWorkspacesRequest } from "./CreatePresenceToken
 export type { GetConfigurationWorkspacesRequest } from "./GetConfigurationWorkspacesRequest.mjs";
 export type { GetToolRegistryWorkspacesRequest } from "./GetToolRegistryWorkspacesRequest.mjs";
 export type { GetUsageWorkspacesRequest } from "./GetUsageWorkspacesRequest.mjs";
+export type { ListMembershipsWorkspacesRequest } from "./ListMembershipsWorkspacesRequest.mjs";
+export type { ListUsageSessionsWorkspacesRequest } from "./ListUsageSessionsWorkspacesRequest.mjs";
 export type { PresenceResolveRequestIn } from "./PresenceResolveRequestIn.mjs";
 export type { SearchMembersWorkspacesRequest } from "./SearchMembersWorkspacesRequest.mjs";
 export type { UpdateWorkspaceConfigurationRequestIn } from "./UpdateWorkspaceConfigurationRequestIn.mjs";

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

@@ -0,0 +1,12 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * One page of a workspace's membership roster.
+ */
+export interface WorkspaceMembershipListResponseOut {
+    /** Memberships for this page, ordered by user id */
+    memberships: AthenaIntelligence.WorkspaceMembershipOut[];
+    /** Pass as `cursor` to fetch the next page; null on the last page */
+    next_cursor: string | null;
+    /** Workspace the roster belongs to */
+    workspace_id: string;
+}

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * One member of a workspace and their role.
+ */
+export interface WorkspaceMembershipOut {
+    email: string;
+    first_name: string | null;
+    /** Membership has been removed from the workspace */
+    is_archived: boolean;
+    /** The user account is suspended deployment-wide */
+    is_suspended: boolean;
+    /** When the membership was created */
+    joined_at: string;
+    last_name: string | null;
+    /** Workspace role: owner, manager or user */
+    role: string;
+    /** User id, stable across workspaces */
+    user_id: string;
+}

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * Token usage of one session for one provider/model/status combination.
+ */
+export interface WorkspaceUsageSessionRowOut {
+    /** AOP asset id when started by an AOP run */
+    aop_id: string | null;
+    /** Title of that AOP */
+    aop_title: string | null;
+    /** Billing attribution of the session */
+    billed_to: string | null;
+    /** Null for an `untracked` row */
+    cache_creation_input_tokens: number | null;
+    /** Null for an `untracked` row */
+    cache_read_input_tokens: number | null;
+    /** Earliest model call in the row */
+    first_event_at: string | null;
+    /** Null for an `untracked` row */
+    input_tokens: number | null;
+    /** Latest model call in the row */
+    last_event_at: string | null;
+    /** How the session was started (user_chat, aop_execution, public_api, ...) */
+    origin_kind: string | null;
+    /** Human label for origin_kind */
+    origin_kind_label: string | null;
+    /** Null for an `untracked` row */
+    output_tokens: number | null;
+    /** Project asset id, if any */
+    project_id: string | null;
+    /** Title of that project */
+    project_title: string | null;
+    /** LLM provider */
+    provider: string;
+    /** Null for an `untracked` row */
+    reasoning_output_tokens: number | null;
+    /** Model the session asked for */
+    requested_model: string | null;
+    /** Model that actually served the calls */
+    resolved_model: string;
+    /** Billed cost of this row in USD; safe to sum across rows */
+    row_total_cost_usd: number;
+    /** Model calls aggregated into this row */
+    run_count: number;
+    /** When the session was created */
+    session_created_at: string;
+    /** Session (conversation) asset id */
+    session_id: string;
+    /** Billed cost of the whole session in USD, carried by the session's first row only and null on its other rows, so summing the column never double-counts (same convention as the CSV export) */
+    session_total_cost_usd: number | null;
+    /** Outcome of the aggregated calls; `untracked` marks a session metered before token tracking existed, whose token counters are null */
+    status: string;
+    /** Null for an `untracked` row */
+    total_tokens: number | null;
+    /** AOP trigger type, if any */
+    trigger_type: string | null;
+    /** Null for an `untracked` row */
+    uncached_input_tokens: number | null;
+    /** Window end (exclusive) the row was bounded to */
+    usage_period_end_exclusive: string | null;
+    /** Window start the row was bounded to */
+    usage_period_start: string;
+    /** Email of the member who ran the session */
+    user_email: string | null;
+    /** Display name of that member */
+    user_name: string | null;
+}

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

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

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

@@ -0,0 +1,13 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * One page of per-session token usage for a workspace.
+ */
+export interface WorkspaceUsageSessionsResponseOut {
+    /** Pass as `cursor` to fetch the next page; null when the window is exhausted */
+    next_cursor: string | null;
+    /** Rows for this page, newest session first */
+    sessions: AthenaIntelligence.WorkspaceUsageSessionRowOut[];
+    window: AthenaIntelligence.WorkspaceUsageWindowOut;
+    /** Workspace the rows belong to */
+    workspace_id: string;
+}

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * The reporting window a usage page covers.
+ */
+export interface WorkspaceUsageWindowOut {
+    /** Number of days the window spans */
+    days: number;
+    /** Last UTC day (inclusive) of an explicit window; null for a rolling window */
+    end_date: string | null;
+    /** First UTC day of an explicit `from`/`to` window; null for a rolling window */
+    start_date: string | null;
+    /** Window end (exclusive); null means 'now' for a rolling window */
+    usage_period_end_exclusive: string | null;
+    /** Window start (inclusive) */
+    usage_period_start: string;
+}

package/dist/esm/api/types/WorkspaceUsageWindowOut.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

@@ -165,12 +165,17 @@ export * from "./WorkspaceDisclaimerOut.mjs";
 export * from "./WorkspaceInfoOut.mjs";
 export * from "./WorkspaceMemberOut.mjs";
 export * from "./WorkspaceMemberSearchResponseOut.mjs";
+export * from "./WorkspaceMembershipListResponseOut.mjs";
+export * from "./WorkspaceMembershipOut.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 "./WorkspaceUsageSessionRowOut.mjs";
+export * from "./WorkspaceUsageSessionsResponseOut.mjs";
 export * from "./WorkspaceUsageTokensOut.mjs";
 export * from "./WorkspaceUsageUserOut.mjs";
+export * from "./WorkspaceUsageWindowOut.mjs";
 export * from "./WrapStrategy.mjs";

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

@@ -165,12 +165,17 @@ export * from "./WorkspaceDisclaimerOut.mjs";
 export * from "./WorkspaceInfoOut.mjs";
 export * from "./WorkspaceMemberOut.mjs";
 export * from "./WorkspaceMemberSearchResponseOut.mjs";
+export * from "./WorkspaceMembershipListResponseOut.mjs";
+export * from "./WorkspaceMembershipOut.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 "./WorkspaceUsageSessionRowOut.mjs";
+export * from "./WorkspaceUsageSessionsResponseOut.mjs";
 export * from "./WorkspaceUsageTokensOut.mjs";
 export * from "./WorkspaceUsageUserOut.mjs";
+export * from "./WorkspaceUsageWindowOut.mjs";
 export * from "./WrapStrategy.mjs";

package/dist/esm/version.d.mts

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

package/dist/esm/version.mjs

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

package/package.json

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

package/reference.md

@@ -5578,6 +5578,73 @@ await client.workspaces.searchMembers({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.workspaces.<a href="/src/api/resources/workspaces/client/Client.ts">listMemberships</a>({ ...params }) -> AthenaIntelligence.WorkspaceMembershipListResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+The full membership roster of one workspace with each member's user id, name, email, role and join date — built for usage reporting and licence reconciliation, unlike the share-picker search at `GET /workspaces/{workspace_id}/members`. Removed members are left out unless `include_archived=true`. Pages are ordered by user id; `next_cursor` is returned while more remain. Requires workspace owner or manager (or Athena admin) permissions.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.workspaces.listMemberships({
+    workspace_id: "workspace_eb171baf",
+    include_archived: false,
+    limit: 200
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.ListMembershipsWorkspacesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `WorkspacesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -5913,6 +5980,73 @@ await client.workspaces.getUsage({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.workspaces.<a href="/src/api/resources/workspaces/client/Client.ts">listUsageSessions</a>({ ...params }) -> AthenaIntelligence.WorkspaceUsageSessionsResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Per-session LLM token usage for one workspace — the same rows as the workspace usage CSV export, as JSON. Each session yields one row per provider/model/status combination with its token breakdown and billed cost; dry-run (test) sessions are excluded. Pick the window with `from`/`to` (UTC dates, inclusive, at most 365 days) or a rolling `days`. Pages are keyset-paginated newest first: `limit` counts sessions, and `next_cursor` is returned while more sessions remain. Requires workspace owner or manager (or Athena admin) permissions.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.workspaces.listUsageSessions({
+    workspace_id: "workspace_eb171baf",
+    days: 30,
+    limit: 100
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.ListUsageSessionsWorkspacesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `WorkspacesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>