@athenaintel/sdk 4.3.2127 → 4.3.2129

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.2127",
-        "User-Agent": "@athenaintel/sdk/4.3.2127",
+        "X-Fern-SDK-Version": "4.3.2129",
+        "User-Agent": "@athenaintel/sdk/4.3.2129",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

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

@@ -12,7 +12,7 @@ export declare class SessionsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<SessionsClient.Options>;
     constructor(options?: SessionsClient.Options);
     /**
-     * Retrieve a paginated list of agent sessions (conversations) with optional title search, state filtering, source channel filtering, date range filtering, and sorting. By default, AOP/workflow runs and branched sub-sessions are excluded.
+     * Retrieve a paginated list of agent sessions (conversations) with optional title search, state filtering, source channel filtering, date range filtering, and sorting. By default, AOP/workflow runs and branched sub-sessions are excluded, and only sessions in the caller's current workspace are visible — pass `workspace_id` to list sessions in another workspace the caller belongs to.
      *
      * @param {AthenaIntelligence.ListSessionsRequest} request
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -62,4 +62,38 @@ export declare class SessionsClient {
      */
     download(request: AthenaIntelligence.DownloadSessionsRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<unknown>;
     private __download;
+    /**
+     * Record that the calling user has read the session as of now, clearing its unread indicator. Idempotent: repeated calls only move the read receipt forward.
+     *
+     * @param {AthenaIntelligence.MarkReadSessionsRequest} request
+     * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.markRead({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    markRead(request: AthenaIntelligence.MarkReadSessionsRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.SessionOut>;
+    private __markRead;
+    /**
+     * Clear the calling user's read receipt so the session shows as unread again. Idempotent: repeated calls leave the session unread.
+     *
+     * @param {AthenaIntelligence.MarkUnreadSessionsRequest} request
+     * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.markUnread({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    markUnread(request: AthenaIntelligence.MarkUnreadSessionsRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.SessionOut>;
+    private __markUnread;
 }

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

@@ -56,7 +56,7 @@ class SessionsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * Retrieve a paginated list of agent sessions (conversations) with optional title search, state filtering, source channel filtering, date range filtering, and sorting. By default, AOP/workflow runs and branched sub-sessions are excluded.
+     * Retrieve a paginated list of agent sessions (conversations) with optional title search, state filtering, source channel filtering, date range filtering, and sorting. By default, AOP/workflow runs and branched sub-sessions are excluded, and only sessions in the caller's current workspace are visible — pass `workspace_id` to list sessions in another workspace the caller belongs to.
      *
      * @param {AthenaIntelligence.ListSessionsRequest} request
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -75,7 +75,7 @@ class SessionsClient {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const { query, state, source_channel: sourceChannel, session_type: sessionType, app_id: appId, include_sub_sessions: includeSubSessions, include_task_sessions: includeTaskSessions, aop_asset_id: aopAssetId, trigger_type: triggerType, created_after: createdAfter, created_before: createdBefore, sort_by: sortBy, sort_direction: sortDirection, limit, offset, } = request;
+                const { query, state, source_channel: sourceChannel, session_type: sessionType, app_id: appId, include_sub_sessions: includeSubSessions, include_task_sessions: includeTaskSessions, aop_asset_id: aopAssetId, workspace_id: workspaceId, trigger_type: triggerType, created_after: createdAfter, created_before: createdBefore, sort_by: sortBy, sort_direction: sortDirection, limit, offset, } = request;
                 const _queryParams = {};
                 if (query !== undefined) {
                     _queryParams.query = query;
@@ -101,6 +101,9 @@ class SessionsClient {
                 if (aopAssetId !== undefined) {
                     _queryParams.aop_asset_id = aopAssetId;
                 }
+                if (workspaceId !== undefined) {
+                    _queryParams.workspace_id = workspaceId;
+                }
                 if (triggerType !== undefined) {
                     _queryParams.trigger_type = (0, json_js_1.toJson)(triggerType);
                 }
@@ -344,5 +347,157 @@ class SessionsClient {
             }
         });
     }
+    /**
+     * Record that the calling user has read the session as of now, clearing its unread indicator. Idempotent: repeated calls only move the read receipt forward.
+     *
+     * @param {AthenaIntelligence.MarkReadSessionsRequest} request
+     * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.markRead({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    markRead(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__markRead(request, requestOptions));
+    }
+    __markRead(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { asset_id: assetId } = request;
+            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, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/sessions/${core.url.encodePathParam(assetId)}/read`),
+                method: "POST",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.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 401:
+                        throw new AthenaIntelligence.UnauthorizedError(_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 POST /api/v0/sessions/{asset_id}/read.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Clear the calling user's read receipt so the session shows as unread again. Idempotent: repeated calls leave the session unread.
+     *
+     * @param {AthenaIntelligence.MarkUnreadSessionsRequest} request
+     * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.markUnread({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    markUnread(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__markUnread(request, requestOptions));
+    }
+    __markUnread(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { asset_id: assetId } = request;
+            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, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/sessions/${core.url.encodePathParam(assetId)}/unread`),
+                method: "POST",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.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 401:
+                        throw new AthenaIntelligence.UnauthorizedError(_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 POST /api/v0/sessions/{asset_id}/unread.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }
 exports.SessionsClient = SessionsClient;

package/dist/cjs/api/resources/sessions/client/requests/ListSessionsRequest.d.ts

@@ -25,6 +25,8 @@ export interface ListSessionsRequest {
     include_task_sessions?: boolean;
     /** Only include task sessions originating from this AOP asset identifier */
     aop_asset_id?: string | null;
+    /** Workspace to list sessions from. Defaults to the caller's current workspace; any other workspace the caller is a member of can be requested explicitly. */
+    workspace_id?: string | null;
     /** Trigger type(s) to filter by (e.g. 'schedule', 'api', 'email'). Repeat the parameter or pass a comma-separated list. */
     trigger_type?: string[] | null;
     /** Only include sessions created at or after this ISO 8601 timestamp */

package/dist/cjs/api/resources/sessions/client/requests/MarkReadSessionsRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+ *     }
+ */
+export interface MarkReadSessionsRequest {
+    /** Unique identifier of the session asset to mark as read */
+    asset_id: string;
+}

package/dist/cjs/api/resources/sessions/client/requests/MarkReadSessionsRequest.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/sessions/client/requests/MarkUnreadSessionsRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+ *     }
+ */
+export interface MarkUnreadSessionsRequest {
+    /** Unique identifier of the session asset to mark as unread */
+    asset_id: string;
+}

package/dist/cjs/api/resources/sessions/client/requests/MarkUnreadSessionsRequest.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/sessions/client/requests/index.d.ts

@@ -1,3 +1,5 @@
 export type { DownloadSessionsRequest } from "./DownloadSessionsRequest.js";
 export type { GetSessionsRequest } from "./GetSessionsRequest.js";
 export type { ListSessionsRequest } from "./ListSessionsRequest.js";
+export type { MarkReadSessionsRequest } from "./MarkReadSessionsRequest.js";
+export type { MarkUnreadSessionsRequest } from "./MarkUnreadSessionsRequest.js";

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

@@ -22,6 +22,8 @@ export interface SessionOut {
     id: string;
     /** Whether this is a branched sub-session of another session */
     is_sub_session?: boolean;
+    /** Whether the session is unread for the calling user: it changed since they last opened it, or they never opened it and it did not originate from the web app */
+    is_unread?: boolean;
     /** Plain-text preview of the most recent message, when available */
     last_message_preview?: string | null;
     /** Model the session ran with, when set */

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2127";
+export declare const SDK_VERSION = "4.3.2129";

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.2127";
+exports.SDK_VERSION = "4.3.2129";

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.2127",
-        "User-Agent": "@athenaintel/sdk/4.3.2127",
+        "X-Fern-SDK-Version": "4.3.2129",
+        "User-Agent": "@athenaintel/sdk/4.3.2129",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

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

@@ -12,7 +12,7 @@ export declare class SessionsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<SessionsClient.Options>;
     constructor(options?: SessionsClient.Options);
     /**
-     * Retrieve a paginated list of agent sessions (conversations) with optional title search, state filtering, source channel filtering, date range filtering, and sorting. By default, AOP/workflow runs and branched sub-sessions are excluded.
+     * Retrieve a paginated list of agent sessions (conversations) with optional title search, state filtering, source channel filtering, date range filtering, and sorting. By default, AOP/workflow runs and branched sub-sessions are excluded, and only sessions in the caller's current workspace are visible — pass `workspace_id` to list sessions in another workspace the caller belongs to.
      *
      * @param {AthenaIntelligence.ListSessionsRequest} request
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -62,4 +62,38 @@ export declare class SessionsClient {
      */
     download(request: AthenaIntelligence.DownloadSessionsRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<unknown>;
     private __download;
+    /**
+     * Record that the calling user has read the session as of now, clearing its unread indicator. Idempotent: repeated calls only move the read receipt forward.
+     *
+     * @param {AthenaIntelligence.MarkReadSessionsRequest} request
+     * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.markRead({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    markRead(request: AthenaIntelligence.MarkReadSessionsRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.SessionOut>;
+    private __markRead;
+    /**
+     * Clear the calling user's read receipt so the session shows as unread again. Idempotent: repeated calls leave the session unread.
+     *
+     * @param {AthenaIntelligence.MarkUnreadSessionsRequest} request
+     * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.markUnread({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    markUnread(request: AthenaIntelligence.MarkUnreadSessionsRequest, requestOptions?: SessionsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.SessionOut>;
+    private __markUnread;
 }

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

@@ -20,7 +20,7 @@ export class SessionsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
-     * Retrieve a paginated list of agent sessions (conversations) with optional title search, state filtering, source channel filtering, date range filtering, and sorting. By default, AOP/workflow runs and branched sub-sessions are excluded.
+     * Retrieve a paginated list of agent sessions (conversations) with optional title search, state filtering, source channel filtering, date range filtering, and sorting. By default, AOP/workflow runs and branched sub-sessions are excluded, and only sessions in the caller's current workspace are visible — pass `workspace_id` to list sessions in another workspace the caller belongs to.
      *
      * @param {AthenaIntelligence.ListSessionsRequest} request
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -39,7 +39,7 @@ export class SessionsClient {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const { query, state, source_channel: sourceChannel, session_type: sessionType, app_id: appId, include_sub_sessions: includeSubSessions, include_task_sessions: includeTaskSessions, aop_asset_id: aopAssetId, trigger_type: triggerType, created_after: createdAfter, created_before: createdBefore, sort_by: sortBy, sort_direction: sortDirection, limit, offset, } = request;
+                const { query, state, source_channel: sourceChannel, session_type: sessionType, app_id: appId, include_sub_sessions: includeSubSessions, include_task_sessions: includeTaskSessions, aop_asset_id: aopAssetId, workspace_id: workspaceId, trigger_type: triggerType, created_after: createdAfter, created_before: createdBefore, sort_by: sortBy, sort_direction: sortDirection, limit, offset, } = request;
                 const _queryParams = {};
                 if (query !== undefined) {
                     _queryParams.query = query;
@@ -65,6 +65,9 @@ export class SessionsClient {
                 if (aopAssetId !== undefined) {
                     _queryParams.aop_asset_id = aopAssetId;
                 }
+                if (workspaceId !== undefined) {
+                    _queryParams.workspace_id = workspaceId;
+                }
                 if (triggerType !== undefined) {
                     _queryParams.trigger_type = toJson(triggerType);
                 }
@@ -308,4 +311,156 @@ export class SessionsClient {
             }
         });
     }
+    /**
+     * Record that the calling user has read the session as of now, clearing its unread indicator. Idempotent: repeated calls only move the read receipt forward.
+     *
+     * @param {AthenaIntelligence.MarkReadSessionsRequest} request
+     * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.markRead({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    markRead(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__markRead(request, requestOptions));
+    }
+    __markRead(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { asset_id: assetId } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/sessions/${core.url.encodePathParam(assetId)}/read`),
+                method: "POST",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.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 401:
+                        throw new AthenaIntelligence.UnauthorizedError(_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 POST /api/v0/sessions/{asset_id}/read.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Clear the calling user's read receipt so the session shows as unread again. Idempotent: repeated calls leave the session unread.
+     *
+     * @param {AthenaIntelligence.MarkUnreadSessionsRequest} request
+     * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.sessions.markUnread({
+     *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+     *     })
+     */
+    markUnread(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__markUnread(request, requestOptions));
+    }
+    __markUnread(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { asset_id: assetId } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/sessions/${core.url.encodePathParam(assetId)}/unread`),
+                method: "POST",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.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 401:
+                        throw new AthenaIntelligence.UnauthorizedError(_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 POST /api/v0/sessions/{asset_id}/unread.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
 }

package/dist/esm/api/resources/sessions/client/requests/ListSessionsRequest.d.mts

@@ -25,6 +25,8 @@ export interface ListSessionsRequest {
     include_task_sessions?: boolean;
     /** Only include task sessions originating from this AOP asset identifier */
     aop_asset_id?: string | null;
+    /** Workspace to list sessions from. Defaults to the caller's current workspace; any other workspace the caller is a member of can be requested explicitly. */
+    workspace_id?: string | null;
     /** Trigger type(s) to filter by (e.g. 'schedule', 'api', 'email'). Repeat the parameter or pass a comma-separated list. */
     trigger_type?: string[] | null;
     /** Only include sessions created at or after this ISO 8601 timestamp */

package/dist/esm/api/resources/sessions/client/requests/MarkReadSessionsRequest.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+ *     }
+ */
+export interface MarkReadSessionsRequest {
+    /** Unique identifier of the session asset to mark as read */
+    asset_id: string;
+}

package/dist/esm/api/resources/sessions/client/requests/MarkReadSessionsRequest.mjs

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

package/dist/esm/api/resources/sessions/client/requests/MarkUnreadSessionsRequest.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+ *     }
+ */
+export interface MarkUnreadSessionsRequest {
+    /** Unique identifier of the session asset to mark as unread */
+    asset_id: string;
+}

package/dist/esm/api/resources/sessions/client/requests/MarkUnreadSessionsRequest.mjs

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

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

@@ -1,3 +1,5 @@
 export type { DownloadSessionsRequest } from "./DownloadSessionsRequest.mjs";
 export type { GetSessionsRequest } from "./GetSessionsRequest.mjs";
 export type { ListSessionsRequest } from "./ListSessionsRequest.mjs";
+export type { MarkReadSessionsRequest } from "./MarkReadSessionsRequest.mjs";
+export type { MarkUnreadSessionsRequest } from "./MarkUnreadSessionsRequest.mjs";

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

@@ -22,6 +22,8 @@ export interface SessionOut {
     id: string;
     /** Whether this is a branched sub-session of another session */
     is_sub_session?: boolean;
+    /** Whether the session is unread for the calling user: it changed since they last opened it, or they never opened it and it did not originate from the web app */
+    is_unread?: boolean;
     /** Plain-text preview of the most recent message, when available */
     last_message_preview?: string | null;
     /** Model the session ran with, when set */

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2127";
+export declare const SDK_VERSION = "4.3.2129";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2127";
+export const SDK_VERSION = "4.3.2129";

package/package.json

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

package/reference.md

@@ -2836,7 +2836,7 @@ await client.semanticModel.query({
 <dl>
 <dd>
 
-Retrieve a paginated list of agent sessions (conversations) with optional title search, state filtering, source channel filtering, date range filtering, and sorting. By default, AOP/workflow runs and branched sub-sessions are excluded.
+Retrieve a paginated list of agent sessions (conversations) with optional title search, state filtering, source channel filtering, date range filtering, and sorting. By default, AOP/workflow runs and branched sub-sessions are excluded, and only sessions in the caller's current workspace are visible — pass `workspace_id` to list sessions in another workspace the caller belongs to.
 </dd>
 </dl>
 </dd>
@@ -3035,6 +3035,136 @@ await client.sessions.download({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">markRead</a>({ ...params }) -> AthenaIntelligence.SessionOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Record that the calling user has read the session as of now, clearing its unread indicator. Idempotent: repeated calls only move the read receipt forward.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.sessions.markRead({
+    asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.MarkReadSessionsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SessionsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.sessions.<a href="/src/api/resources/sessions/client/Client.ts">markUnread</a>({ ...params }) -> AthenaIntelligence.SessionOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Clear the calling user's read receipt so the session shows as unread again. Idempotent: repeated calls leave the session unread.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.sessions.markUnread({
+    asset_id: "asset_92492920-d118-42d3-95b4-00eccfe0754f"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.MarkUnreadSessionsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SessionsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>