@instructure/athena-api-client 3.0.5 → 3.1.1

package/README.md

@@ -95,6 +95,7 @@ All URIs are relative to *http://localhost:3000*
 *LearningMomentsApi* | [**getLearningMomentsCount**](docs/LearningMomentsApi.md#getlearningmomentscount) | **GET** /api/v1/learning-moments/count | Get learning moments count
 *LearningMomentsApi* | [**listLearningMoments**](docs/LearningMomentsApi.md#listlearningmoments) | **GET** /api/v1/learning-moments | List learning moments
 *LearningSessionEvaluationsApi* | [**listLearningSessionEvaluations**](docs/LearningSessionEvaluationsApi.md#listlearningsessionevaluations) | **GET** /api/v1/chats/{chatId}/learning-session-evaluations | List learning session evaluations for a chat
+*LearningSessionEvaluationsApi* | [**listLearningSessionEvaluationsForConcept**](docs/LearningSessionEvaluationsApi.md#listlearningsessionevaluationsforconcept) | **GET** /api/v1/user-concepts/{conceptId}/learning-session-evaluations | List learning session evaluations for a concept
 *LearningStreakApi* | [**getLearningStreak**](docs/LearningStreakApi.md#getlearningstreak) | **GET** /api/v1/learning-streak | Get learning streak
 *MessagesApi* | [**createChatMessages**](docs/MessagesApi.md#createchatmessages) | **POST** /api/v1/chats/{chatId}/messages | Save messages to a chat
 *MessagesApi* | [**deleteMessages**](docs/MessagesApi.md#deletemessages) | **DELETE** /api/v1/chats/{chatId}/messages | Delete messages from timestamp
@@ -141,8 +142,10 @@ All URIs are relative to *http://localhost:3000*
 *TaxonomyEnrollmentsApi* | [**enrollInTaxonomy**](docs/TaxonomyEnrollmentsApi.md#enrollintaxonomy) | **POST** /api/v1/taxonomy_enrollments/{id} | Enroll in a taxonomy
 *TaxonomyEnrollmentsApi* | [**listMyEnrollments**](docs/TaxonomyEnrollmentsApi.md#listmyenrollments) | **GET** /api/v1/taxonomy_enrollments | List current user\'s active enrollments
 *TaxonomyEnrollmentsApi* | [**unenrollFromTaxonomy**](docs/TaxonomyEnrollmentsApi.md#unenrollfromtaxonomy) | **DELETE** /api/v1/taxonomy_enrollments/{id} | Unenroll from a taxonomy
+*UserConceptsApi* | [**ensureUserConceptTracked**](docs/UserConceptsApi.md#ensureuserconcepttracked) | **PUT** /api/v1/user-concepts/{conceptId} | Ensure a user concept is tracked by concept id
 *UserConceptsApi* | [**getUserConcept**](docs/UserConceptsApi.md#getuserconcept) | **GET** /api/v1/user-concepts/{conceptId} | Get a user concept by concept id
 *UserConceptsApi* | [**listUserConcepts**](docs/UserConceptsApi.md#listuserconcepts) | **GET** /api/v1/user-concepts | List user concepts
+*UserConceptsApi* | [**listUserConceptsByIds**](docs/UserConceptsApi.md#listuserconceptsbyids) | **GET** /api/v1/user-concepts/by-ids | Batch read user concepts by concept ids
 *UserConceptsApi* | [**upsertUserConceptByName**](docs/UserConceptsApi.md#upsertuserconceptbynameoperation) | **POST** /api/v1/user-concepts | Upsert user concept by name
 *UserContextApi* | [**getUserContext**](docs/UserContextApi.md#getusercontext) | **GET** /api/v1/user-context | Get user context
 *UserContextApi* | [**upsertUserContext**](docs/UserContextApi.md#upsertusercontextoperation) | **PUT** /api/v1/user-context | Create or update user context

package/dist/apis/LearningSessionEvaluationsApi.d.ts

@@ -15,6 +15,10 @@ export interface ListLearningSessionEvaluationsRequest {
     chatId: string;
     xUserId: string;
 }
+export interface ListLearningSessionEvaluationsForConceptRequest {
+    conceptId: string;
+    xUserId: string;
+}
 /**
  *
  */
@@ -29,4 +33,14 @@ export declare class LearningSessionEvaluationsApi extends runtime.BaseAPI {
      * List learning session evaluations for a chat
      */
     listLearningSessionEvaluations(requestParameters: ListLearningSessionEvaluationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<LearningSessionEvaluation>>;
+    /**
+     * Returns every per-turn evaluator signal (the learning evidence) across all of the authenticated account user\'s learning-session chats (chatType \'level-up\' or \'quick-practice\') where the supplied concept is the chat\'s primary concept. Aggregates a concept\'s evidence across sessions; each row carries its chatId so callers can group by session. Account-user-scoped — only the caller\'s own chats are considered, never another user\'s. Rows are returned in (createdAt, id) ascending order — a chronological evidence stream. Returns an empty array when the caller has no primary-concept session for the concept (the normal \'no evidence yet\' signal); it intentionally does not assert that the concept exists.
+     * List learning session evaluations for a concept
+     */
+    listLearningSessionEvaluationsForConceptRaw(requestParameters: ListLearningSessionEvaluationsForConceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<LearningSessionEvaluation>>>;
+    /**
+     * Returns every per-turn evaluator signal (the learning evidence) across all of the authenticated account user\'s learning-session chats (chatType \'level-up\' or \'quick-practice\') where the supplied concept is the chat\'s primary concept. Aggregates a concept\'s evidence across sessions; each row carries its chatId so callers can group by session. Account-user-scoped — only the caller\'s own chats are considered, never another user\'s. Rows are returned in (createdAt, id) ascending order — a chronological evidence stream. Returns an empty array when the caller has no primary-concept session for the concept (the normal \'no evidence yet\' signal); it intentionally does not assert that the concept exists.
+     * List learning session evaluations for a concept
+     */
+    listLearningSessionEvaluationsForConcept(requestParameters: ListLearningSessionEvaluationsForConceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<LearningSessionEvaluation>>;
 }

package/dist/apis/LearningSessionEvaluationsApi.js

@@ -70,5 +70,46 @@ class LearningSessionEvaluationsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Returns every per-turn evaluator signal (the learning evidence) across all of the authenticated account user\'s learning-session chats (chatType \'level-up\' or \'quick-practice\') where the supplied concept is the chat\'s primary concept. Aggregates a concept\'s evidence across sessions; each row carries its chatId so callers can group by session. Account-user-scoped — only the caller\'s own chats are considered, never another user\'s. Rows are returned in (createdAt, id) ascending order — a chronological evidence stream. Returns an empty array when the caller has no primary-concept session for the concept (the normal \'no evidence yet\' signal); it intentionally does not assert that the concept exists.
+     * List learning session evaluations for a concept
+     */
+    listLearningSessionEvaluationsForConceptRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['conceptId'] == null) {
+                throw new runtime.RequiredError('conceptId', 'Required parameter "conceptId" was null or undefined when calling listLearningSessionEvaluationsForConcept().');
+            }
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling listLearningSessionEvaluationsForConcept().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/user-concepts/{conceptId}/learning-session-evaluations`;
+            urlPath = urlPath.replace(`{${"conceptId"}}`, encodeURIComponent(String(requestParameters['conceptId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(index_1.LearningSessionEvaluationFromJSON));
+        });
+    }
+    /**
+     * Returns every per-turn evaluator signal (the learning evidence) across all of the authenticated account user\'s learning-session chats (chatType \'level-up\' or \'quick-practice\') where the supplied concept is the chat\'s primary concept. Aggregates a concept\'s evidence across sessions; each row carries its chatId so callers can group by session. Account-user-scoped — only the caller\'s own chats are considered, never another user\'s. Rows are returned in (createdAt, id) ascending order — a chronological evidence stream. Returns an empty array when the caller has no primary-concept session for the concept (the normal \'no evidence yet\' signal); it intentionally does not assert that the concept exists.
+     * List learning session evaluations for a concept
+     */
+    listLearningSessionEvaluationsForConcept(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.listLearningSessionEvaluationsForConceptRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
 }
 exports.LearningSessionEvaluationsApi = LearningSessionEvaluationsApi;

package/dist/apis/UserConceptsApi.d.ts

@@ -11,6 +11,10 @@
  */
 import * as runtime from '../runtime';
 import type { PaginatedUserConcepts, UpsertUserConceptByNameRequest, UserConcept } from '../models/index';
+export interface EnsureUserConceptTrackedRequest {
+    conceptId: string;
+    xUserId: string;
+}
 export interface GetUserConceptRequest {
     conceptId: string;
     xUserId: string;
@@ -21,6 +25,10 @@ export interface ListUserConceptsRequest {
     cursor?: string;
     sortBy?: ListUserConceptsSortByEnum;
 }
+export interface ListUserConceptsByIdsRequest {
+    conceptIds: Array<string>;
+    xUserId: string;
+}
 export interface UpsertUserConceptByNameOperationRequest {
     xUserId: string;
     upsertUserConceptByNameRequest: UpsertUserConceptByNameRequest;
@@ -29,6 +37,16 @@ export interface UpsertUserConceptByNameOperationRequest {
  *
  */
 export declare class UserConceptsApi extends runtime.BaseAPI {
+    /**
+     * Find-or-creates the calling account user\'s user-concept row for an existing global concept id, seeding strength and confidence of 0.000 when absent, and returns it joined with concept metadata. Idempotent: re-calling returns the existing row unchanged and never resets an in-progress strength, so it is safe to call before launching a learning session on a concept the learner hasn\'t engaged yet. Concurrency-safe — simultaneous calls resolve to a single row. Always responds 200 (both the fresh-create and returning-existing paths are successful). Unlike the by-name upsert this never creates a concept; an id that doesn\'t resolve to a real concept returns 404.
+     * Ensure a user concept is tracked by concept id
+     */
+    ensureUserConceptTrackedRaw(requestParameters: EnsureUserConceptTrackedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<UserConcept>>;
+    /**
+     * Find-or-creates the calling account user\'s user-concept row for an existing global concept id, seeding strength and confidence of 0.000 when absent, and returns it joined with concept metadata. Idempotent: re-calling returns the existing row unchanged and never resets an in-progress strength, so it is safe to call before launching a learning session on a concept the learner hasn\'t engaged yet. Concurrency-safe — simultaneous calls resolve to a single row. Always responds 200 (both the fresh-create and returning-existing paths are successful). Unlike the by-name upsert this never creates a concept; an id that doesn\'t resolve to a real concept returns 404.
+     * Ensure a user concept is tracked by concept id
+     */
+    ensureUserConceptTracked(requestParameters: EnsureUserConceptTrackedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<UserConcept>;
     /**
      * Returns the single user-concept row for the calling account user and the supplied concept id, joined with concept metadata. 404s when the caller has no user-concept row for that concept (i.e. they don\'t track it yet). Use this to look up a single user-concept directly when the concept id is already known — avoids list-and-scan over the full paginated user-concept set.
      * Get a user concept by concept id
@@ -49,6 +67,16 @@ export declare class UserConceptsApi extends runtime.BaseAPI {
      * List user concepts
      */
     listUserConcepts(requestParameters: ListUserConceptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedUserConcepts>;
+    /**
+     * Returns the calling account user\'s mastery for a supplied set of concept ids, joined with concept metadata. Only the tracked subset is returned — ids the caller has no user-concept row for are omitted (callers treat an absent id as \'not assessed\'), so the result may be shorter than the requested id list and is empty when none are tracked. Account-user-scoped: never surfaces another learner\'s rows. Capped at 100 ids per request (over-cap, empty, or non-uuid → 400). Use this to enrich a known set of concepts (e.g. a study objective\'s extracted concepts) with per-concept mastery in a single call instead of N single lookups.
+     * Batch read user concepts by concept ids
+     */
+    listUserConceptsByIdsRaw(requestParameters: ListUserConceptsByIdsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<UserConcept>>>;
+    /**
+     * Returns the calling account user\'s mastery for a supplied set of concept ids, joined with concept metadata. Only the tracked subset is returned — ids the caller has no user-concept row for are omitted (callers treat an absent id as \'not assessed\'), so the result may be shorter than the requested id list and is empty when none are tracked. Account-user-scoped: never surfaces another learner\'s rows. Capped at 100 ids per request (over-cap, empty, or non-uuid → 400). Use this to enrich a known set of concepts (e.g. a study objective\'s extracted concepts) with per-concept mastery in a single call instead of N single lookups.
+     * Batch read user concepts by concept ids
+     */
+    listUserConceptsByIds(requestParameters: ListUserConceptsByIdsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<UserConcept>>;
     /**
      * Finds or creates a concept matching the supplied name (case-insensitive, whitespace-normalized) and ensures a user-concept row exists for the calling account user. Returns the (possibly pre-existing) user-concept joined with its concept. Always responds 200 — both fresh creates and returning-existing-row paths are successful and idempotent. New user-concept rows are seeded with strength and confidence of 0.000; no user_concept_history row is written.
      * Upsert user concept by name

package/dist/apis/UserConceptsApi.js

@@ -29,6 +29,47 @@ const index_1 = require("../models/index");
  *
  */
 class UserConceptsApi extends runtime.BaseAPI {
+    /**
+     * Find-or-creates the calling account user\'s user-concept row for an existing global concept id, seeding strength and confidence of 0.000 when absent, and returns it joined with concept metadata. Idempotent: re-calling returns the existing row unchanged and never resets an in-progress strength, so it is safe to call before launching a learning session on a concept the learner hasn\'t engaged yet. Concurrency-safe — simultaneous calls resolve to a single row. Always responds 200 (both the fresh-create and returning-existing paths are successful). Unlike the by-name upsert this never creates a concept; an id that doesn\'t resolve to a real concept returns 404.
+     * Ensure a user concept is tracked by concept id
+     */
+    ensureUserConceptTrackedRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['conceptId'] == null) {
+                throw new runtime.RequiredError('conceptId', 'Required parameter "conceptId" was null or undefined when calling ensureUserConceptTracked().');
+            }
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling ensureUserConceptTracked().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/user-concepts/{conceptId}`;
+            urlPath = urlPath.replace(`{${"conceptId"}}`, encodeURIComponent(String(requestParameters['conceptId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'PUT',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.UserConceptFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Find-or-creates the calling account user\'s user-concept row for an existing global concept id, seeding strength and confidence of 0.000 when absent, and returns it joined with concept metadata. Idempotent: re-calling returns the existing row unchanged and never resets an in-progress strength, so it is safe to call before launching a learning session on a concept the learner hasn\'t engaged yet. Concurrency-safe — simultaneous calls resolve to a single row. Always responds 200 (both the fresh-create and returning-existing paths are successful). Unlike the by-name upsert this never creates a concept; an id that doesn\'t resolve to a real concept returns 404.
+     * Ensure a user concept is tracked by concept id
+     */
+    ensureUserConceptTracked(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.ensureUserConceptTrackedRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Returns the single user-concept row for the calling account user and the supplied concept id, joined with concept metadata. 404s when the caller has no user-concept row for that concept (i.e. they don\'t track it yet). Use this to look up a single user-concept directly when the concept id is already known — avoids list-and-scan over the full paginated user-concept set.
      * Get a user concept by concept id
@@ -116,6 +157,49 @@ class UserConceptsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Returns the calling account user\'s mastery for a supplied set of concept ids, joined with concept metadata. Only the tracked subset is returned — ids the caller has no user-concept row for are omitted (callers treat an absent id as \'not assessed\'), so the result may be shorter than the requested id list and is empty when none are tracked. Account-user-scoped: never surfaces another learner\'s rows. Capped at 100 ids per request (over-cap, empty, or non-uuid → 400). Use this to enrich a known set of concepts (e.g. a study objective\'s extracted concepts) with per-concept mastery in a single call instead of N single lookups.
+     * Batch read user concepts by concept ids
+     */
+    listUserConceptsByIdsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['conceptIds'] == null) {
+                throw new runtime.RequiredError('conceptIds', 'Required parameter "conceptIds" was null or undefined when calling listUserConceptsByIds().');
+            }
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling listUserConceptsByIds().');
+            }
+            const queryParameters = {};
+            if (requestParameters['conceptIds'] != null) {
+                queryParameters['conceptIds'] = requestParameters['conceptIds'];
+            }
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/user-concepts/by-ids`;
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(index_1.UserConceptFromJSON));
+        });
+    }
+    /**
+     * Returns the calling account user\'s mastery for a supplied set of concept ids, joined with concept metadata. Only the tracked subset is returned — ids the caller has no user-concept row for are omitted (callers treat an absent id as \'not assessed\'), so the result may be shorter than the requested id list and is empty when none are tracked. Account-user-scoped: never surfaces another learner\'s rows. Capped at 100 ids per request (over-cap, empty, or non-uuid → 400). Use this to enrich a known set of concepts (e.g. a study objective\'s extracted concepts) with per-concept mastery in a single call instead of N single lookups.
+     * Batch read user concepts by concept ids
+     */
+    listUserConceptsByIds(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.listUserConceptsByIdsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Finds or creates a concept matching the supplied name (case-insensitive, whitespace-normalized) and ensures a user-concept row exists for the calling account user. Returns the (possibly pre-existing) user-concept joined with its concept. Always responds 200 — both fresh creates and returning-existing-row paths are successful and idempotent. New user-concept rows are seeded with strength and confidence of 0.000; no user_concept_history row is written.
      * Upsert user concept by name

package/dist/esm/apis/LearningSessionEvaluationsApi.d.ts

@@ -15,6 +15,10 @@ export interface ListLearningSessionEvaluationsRequest {
     chatId: string;
     xUserId: string;
 }
+export interface ListLearningSessionEvaluationsForConceptRequest {
+    conceptId: string;
+    xUserId: string;
+}
 /**
  *
  */
@@ -29,4 +33,14 @@ export declare class LearningSessionEvaluationsApi extends runtime.BaseAPI {
      * List learning session evaluations for a chat
      */
     listLearningSessionEvaluations(requestParameters: ListLearningSessionEvaluationsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<LearningSessionEvaluation>>;
+    /**
+     * Returns every per-turn evaluator signal (the learning evidence) across all of the authenticated account user\'s learning-session chats (chatType \'level-up\' or \'quick-practice\') where the supplied concept is the chat\'s primary concept. Aggregates a concept\'s evidence across sessions; each row carries its chatId so callers can group by session. Account-user-scoped — only the caller\'s own chats are considered, never another user\'s. Rows are returned in (createdAt, id) ascending order — a chronological evidence stream. Returns an empty array when the caller has no primary-concept session for the concept (the normal \'no evidence yet\' signal); it intentionally does not assert that the concept exists.
+     * List learning session evaluations for a concept
+     */
+    listLearningSessionEvaluationsForConceptRaw(requestParameters: ListLearningSessionEvaluationsForConceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<LearningSessionEvaluation>>>;
+    /**
+     * Returns every per-turn evaluator signal (the learning evidence) across all of the authenticated account user\'s learning-session chats (chatType \'level-up\' or \'quick-practice\') where the supplied concept is the chat\'s primary concept. Aggregates a concept\'s evidence across sessions; each row carries its chatId so callers can group by session. Account-user-scoped — only the caller\'s own chats are considered, never another user\'s. Rows are returned in (createdAt, id) ascending order — a chronological evidence stream. Returns an empty array when the caller has no primary-concept session for the concept (the normal \'no evidence yet\' signal); it intentionally does not assert that the concept exists.
+     * List learning session evaluations for a concept
+     */
+    listLearningSessionEvaluationsForConcept(requestParameters: ListLearningSessionEvaluationsForConceptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<LearningSessionEvaluation>>;
 }

package/dist/esm/apis/LearningSessionEvaluationsApi.js

@@ -67,4 +67,45 @@ export class LearningSessionEvaluationsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Returns every per-turn evaluator signal (the learning evidence) across all of the authenticated account user\'s learning-session chats (chatType \'level-up\' or \'quick-practice\') where the supplied concept is the chat\'s primary concept. Aggregates a concept\'s evidence across sessions; each row carries its chatId so callers can group by session. Account-user-scoped — only the caller\'s own chats are considered, never another user\'s. Rows are returned in (createdAt, id) ascending order — a chronological evidence stream. Returns an empty array when the caller has no primary-concept session for the concept (the normal \'no evidence yet\' signal); it intentionally does not assert that the concept exists.
+     * List learning session evaluations for a concept
+     */
+    listLearningSessionEvaluationsForConceptRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['conceptId'] == null) {
+                throw new runtime.RequiredError('conceptId', 'Required parameter "conceptId" was null or undefined when calling listLearningSessionEvaluationsForConcept().');
+            }
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling listLearningSessionEvaluationsForConcept().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/user-concepts/{conceptId}/learning-session-evaluations`;
+            urlPath = urlPath.replace(`{${"conceptId"}}`, encodeURIComponent(String(requestParameters['conceptId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(LearningSessionEvaluationFromJSON));
+        });
+    }
+    /**
+     * Returns every per-turn evaluator signal (the learning evidence) across all of the authenticated account user\'s learning-session chats (chatType \'level-up\' or \'quick-practice\') where the supplied concept is the chat\'s primary concept. Aggregates a concept\'s evidence across sessions; each row carries its chatId so callers can group by session. Account-user-scoped — only the caller\'s own chats are considered, never another user\'s. Rows are returned in (createdAt, id) ascending order — a chronological evidence stream. Returns an empty array when the caller has no primary-concept session for the concept (the normal \'no evidence yet\' signal); it intentionally does not assert that the concept exists.
+     * List learning session evaluations for a concept
+     */
+    listLearningSessionEvaluationsForConcept(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.listLearningSessionEvaluationsForConceptRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
 }

package/dist/esm/apis/UserConceptsApi.d.ts

@@ -11,6 +11,10 @@
  */
 import * as runtime from '../runtime';
 import type { PaginatedUserConcepts, UpsertUserConceptByNameRequest, UserConcept } from '../models/index';
+export interface EnsureUserConceptTrackedRequest {
+    conceptId: string;
+    xUserId: string;
+}
 export interface GetUserConceptRequest {
     conceptId: string;
     xUserId: string;
@@ -21,6 +25,10 @@ export interface ListUserConceptsRequest {
     cursor?: string;
     sortBy?: ListUserConceptsSortByEnum;
 }
+export interface ListUserConceptsByIdsRequest {
+    conceptIds: Array<string>;
+    xUserId: string;
+}
 export interface UpsertUserConceptByNameOperationRequest {
     xUserId: string;
     upsertUserConceptByNameRequest: UpsertUserConceptByNameRequest;
@@ -29,6 +37,16 @@ export interface UpsertUserConceptByNameOperationRequest {
  *
  */
 export declare class UserConceptsApi extends runtime.BaseAPI {
+    /**
+     * Find-or-creates the calling account user\'s user-concept row for an existing global concept id, seeding strength and confidence of 0.000 when absent, and returns it joined with concept metadata. Idempotent: re-calling returns the existing row unchanged and never resets an in-progress strength, so it is safe to call before launching a learning session on a concept the learner hasn\'t engaged yet. Concurrency-safe — simultaneous calls resolve to a single row. Always responds 200 (both the fresh-create and returning-existing paths are successful). Unlike the by-name upsert this never creates a concept; an id that doesn\'t resolve to a real concept returns 404.
+     * Ensure a user concept is tracked by concept id
+     */
+    ensureUserConceptTrackedRaw(requestParameters: EnsureUserConceptTrackedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<UserConcept>>;
+    /**
+     * Find-or-creates the calling account user\'s user-concept row for an existing global concept id, seeding strength and confidence of 0.000 when absent, and returns it joined with concept metadata. Idempotent: re-calling returns the existing row unchanged and never resets an in-progress strength, so it is safe to call before launching a learning session on a concept the learner hasn\'t engaged yet. Concurrency-safe — simultaneous calls resolve to a single row. Always responds 200 (both the fresh-create and returning-existing paths are successful). Unlike the by-name upsert this never creates a concept; an id that doesn\'t resolve to a real concept returns 404.
+     * Ensure a user concept is tracked by concept id
+     */
+    ensureUserConceptTracked(requestParameters: EnsureUserConceptTrackedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<UserConcept>;
     /**
      * Returns the single user-concept row for the calling account user and the supplied concept id, joined with concept metadata. 404s when the caller has no user-concept row for that concept (i.e. they don\'t track it yet). Use this to look up a single user-concept directly when the concept id is already known — avoids list-and-scan over the full paginated user-concept set.
      * Get a user concept by concept id
@@ -49,6 +67,16 @@ export declare class UserConceptsApi extends runtime.BaseAPI {
      * List user concepts
      */
     listUserConcepts(requestParameters: ListUserConceptsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedUserConcepts>;
+    /**
+     * Returns the calling account user\'s mastery for a supplied set of concept ids, joined with concept metadata. Only the tracked subset is returned — ids the caller has no user-concept row for are omitted (callers treat an absent id as \'not assessed\'), so the result may be shorter than the requested id list and is empty when none are tracked. Account-user-scoped: never surfaces another learner\'s rows. Capped at 100 ids per request (over-cap, empty, or non-uuid → 400). Use this to enrich a known set of concepts (e.g. a study objective\'s extracted concepts) with per-concept mastery in a single call instead of N single lookups.
+     * Batch read user concepts by concept ids
+     */
+    listUserConceptsByIdsRaw(requestParameters: ListUserConceptsByIdsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<UserConcept>>>;
+    /**
+     * Returns the calling account user\'s mastery for a supplied set of concept ids, joined with concept metadata. Only the tracked subset is returned — ids the caller has no user-concept row for are omitted (callers treat an absent id as \'not assessed\'), so the result may be shorter than the requested id list and is empty when none are tracked. Account-user-scoped: never surfaces another learner\'s rows. Capped at 100 ids per request (over-cap, empty, or non-uuid → 400). Use this to enrich a known set of concepts (e.g. a study objective\'s extracted concepts) with per-concept mastery in a single call instead of N single lookups.
+     * Batch read user concepts by concept ids
+     */
+    listUserConceptsByIds(requestParameters: ListUserConceptsByIdsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<UserConcept>>;
     /**
      * Finds or creates a concept matching the supplied name (case-insensitive, whitespace-normalized) and ensures a user-concept row exists for the calling account user. Returns the (possibly pre-existing) user-concept joined with its concept. Always responds 200 — both fresh creates and returning-existing-row paths are successful and idempotent. New user-concept rows are seeded with strength and confidence of 0.000; no user_concept_history row is written.
      * Upsert user concept by name

package/dist/esm/apis/UserConceptsApi.js

@@ -26,6 +26,47 @@ import { PaginatedUserConceptsFromJSON, UpsertUserConceptByNameRequestToJSON, Us
  *
  */
 export class UserConceptsApi extends runtime.BaseAPI {
+    /**
+     * Find-or-creates the calling account user\'s user-concept row for an existing global concept id, seeding strength and confidence of 0.000 when absent, and returns it joined with concept metadata. Idempotent: re-calling returns the existing row unchanged and never resets an in-progress strength, so it is safe to call before launching a learning session on a concept the learner hasn\'t engaged yet. Concurrency-safe — simultaneous calls resolve to a single row. Always responds 200 (both the fresh-create and returning-existing paths are successful). Unlike the by-name upsert this never creates a concept; an id that doesn\'t resolve to a real concept returns 404.
+     * Ensure a user concept is tracked by concept id
+     */
+    ensureUserConceptTrackedRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['conceptId'] == null) {
+                throw new runtime.RequiredError('conceptId', 'Required parameter "conceptId" was null or undefined when calling ensureUserConceptTracked().');
+            }
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling ensureUserConceptTracked().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/user-concepts/{conceptId}`;
+            urlPath = urlPath.replace(`{${"conceptId"}}`, encodeURIComponent(String(requestParameters['conceptId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'PUT',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => UserConceptFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Find-or-creates the calling account user\'s user-concept row for an existing global concept id, seeding strength and confidence of 0.000 when absent, and returns it joined with concept metadata. Idempotent: re-calling returns the existing row unchanged and never resets an in-progress strength, so it is safe to call before launching a learning session on a concept the learner hasn\'t engaged yet. Concurrency-safe — simultaneous calls resolve to a single row. Always responds 200 (both the fresh-create and returning-existing paths are successful). Unlike the by-name upsert this never creates a concept; an id that doesn\'t resolve to a real concept returns 404.
+     * Ensure a user concept is tracked by concept id
+     */
+    ensureUserConceptTracked(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.ensureUserConceptTrackedRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Returns the single user-concept row for the calling account user and the supplied concept id, joined with concept metadata. 404s when the caller has no user-concept row for that concept (i.e. they don\'t track it yet). Use this to look up a single user-concept directly when the concept id is already known — avoids list-and-scan over the full paginated user-concept set.
      * Get a user concept by concept id
@@ -113,6 +154,49 @@ export class UserConceptsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Returns the calling account user\'s mastery for a supplied set of concept ids, joined with concept metadata. Only the tracked subset is returned — ids the caller has no user-concept row for are omitted (callers treat an absent id as \'not assessed\'), so the result may be shorter than the requested id list and is empty when none are tracked. Account-user-scoped: never surfaces another learner\'s rows. Capped at 100 ids per request (over-cap, empty, or non-uuid → 400). Use this to enrich a known set of concepts (e.g. a study objective\'s extracted concepts) with per-concept mastery in a single call instead of N single lookups.
+     * Batch read user concepts by concept ids
+     */
+    listUserConceptsByIdsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['conceptIds'] == null) {
+                throw new runtime.RequiredError('conceptIds', 'Required parameter "conceptIds" was null or undefined when calling listUserConceptsByIds().');
+            }
+            if (requestParameters['xUserId'] == null) {
+                throw new runtime.RequiredError('xUserId', 'Required parameter "xUserId" was null or undefined when calling listUserConceptsByIds().');
+            }
+            const queryParameters = {};
+            if (requestParameters['conceptIds'] != null) {
+                queryParameters['conceptIds'] = requestParameters['conceptIds'];
+            }
+            const headerParameters = {};
+            if (requestParameters['xUserId'] != null) {
+                headerParameters['X-User-Id'] = String(requestParameters['xUserId']);
+            }
+            if (this.configuration && this.configuration.apiKey) {
+                headerParameters["X-Auth-Token"] = yield this.configuration.apiKey("X-Auth-Token"); // AuthToken authentication
+            }
+            let urlPath = `/api/v1/user-concepts/by-ids`;
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(UserConceptFromJSON));
+        });
+    }
+    /**
+     * Returns the calling account user\'s mastery for a supplied set of concept ids, joined with concept metadata. Only the tracked subset is returned — ids the caller has no user-concept row for are omitted (callers treat an absent id as \'not assessed\'), so the result may be shorter than the requested id list and is empty when none are tracked. Account-user-scoped: never surfaces another learner\'s rows. Capped at 100 ids per request (over-cap, empty, or non-uuid → 400). Use this to enrich a known set of concepts (e.g. a study objective\'s extracted concepts) with per-concept mastery in a single call instead of N single lookups.
+     * Batch read user concepts by concept ids
+     */
+    listUserConceptsByIds(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.listUserConceptsByIdsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Finds or creates a concept matching the supplied name (case-insensitive, whitespace-normalized) and ensures a user-concept row exists for the calling account user. Returns the (possibly pre-existing) user-concept joined with its concept. Always responds 200 — both fresh creates and returning-existing-row paths are successful and idempotent. New user-concept rows are seeded with strength and confidence of 0.000; no user_concept_history row is written.
      * Upsert user concept by name

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@instructure/athena-api-client",
   "private": false,
-  "version": "3.0.5",
+  "version": "3.1.1",
   "description": "OpenAPI client for the Athena API",
   "author": "Instructure",
   "repository": {