@instructure/athena-api-client 4.5.1 → 4.6.0

package/dist/models/AdminConceptMediaReviewNotification.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Athena API
+ * REST API for the Athena system
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * A media row the reviewer agent flagged, claimed once for the admin notification email.
+ * @export
+ * @interface AdminConceptMediaReviewNotification
+ */
+export interface AdminConceptMediaReviewNotification {
+    /**
+     *
+     * @type {string}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    reviewId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    mediaKind: AdminConceptMediaReviewNotificationMediaKindEnum;
+    /**
+     * The concept image or diagram id, per mediaKind
+     * @type {string}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    mediaId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    conceptId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    conceptName: string;
+    /**
+     * The diagram's title; null for an image
+     * @type {string}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    mediaTitle: string | null;
+    /**
+     * The diagram's description, or the image's alt text
+     * @type {string}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    mediaDescription: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    reason: AdminConceptMediaReviewNotificationReasonEnum;
+    /**
+     * The agent's explanation for an admin
+     * @type {string}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    details: string;
+    /**
+     * What the flag did: hidden and flagged_again changed the row; already_hidden (admin drafts start hidden) and already_flagged did not.
+     * @type {string}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    flagOutcome: AdminConceptMediaReviewNotificationFlagOutcomeEnum | null;
+    /**
+     *
+     * @type {Date}
+     * @memberof AdminConceptMediaReviewNotification
+     */
+    completedAt: Date;
+}
+/**
+ * @export
+ */
+export declare const AdminConceptMediaReviewNotificationMediaKindEnum: {
+    readonly Image: "image";
+    readonly Diagram: "diagram";
+};
+export type AdminConceptMediaReviewNotificationMediaKindEnum = typeof AdminConceptMediaReviewNotificationMediaKindEnum[keyof typeof AdminConceptMediaReviewNotificationMediaKindEnum];
+/**
+ * @export
+ */
+export declare const AdminConceptMediaReviewNotificationReasonEnum: {
+    readonly Inaccurate: "inaccurate";
+    readonly HardToRead: "hard_to_read";
+    readonly Irrelevant: "irrelevant";
+    readonly Inappropriate: "inappropriate";
+    readonly NotHelpful: "not_helpful";
+    readonly Other: "other";
+};
+export type AdminConceptMediaReviewNotificationReasonEnum = typeof AdminConceptMediaReviewNotificationReasonEnum[keyof typeof AdminConceptMediaReviewNotificationReasonEnum];
+/**
+ * @export
+ */
+export declare const AdminConceptMediaReviewNotificationFlagOutcomeEnum: {
+    readonly Hidden: "hidden";
+    readonly AlreadyHidden: "already_hidden";
+    readonly FlaggedAgain: "flagged_again";
+    readonly AlreadyFlagged: "already_flagged";
+    readonly NotFound: "not_found";
+};
+export type AdminConceptMediaReviewNotificationFlagOutcomeEnum = typeof AdminConceptMediaReviewNotificationFlagOutcomeEnum[keyof typeof AdminConceptMediaReviewNotificationFlagOutcomeEnum];
+/**
+ * Check if a given object implements the AdminConceptMediaReviewNotification interface.
+ */
+export declare function instanceOfAdminConceptMediaReviewNotification(value: object): value is AdminConceptMediaReviewNotification;
+export declare function AdminConceptMediaReviewNotificationFromJSON(json: any): AdminConceptMediaReviewNotification;
+export declare function AdminConceptMediaReviewNotificationFromJSONTyped(json: any, ignoreDiscriminator: boolean): AdminConceptMediaReviewNotification;
+export declare function AdminConceptMediaReviewNotificationToJSON(json: any): AdminConceptMediaReviewNotification;
+export declare function AdminConceptMediaReviewNotificationToJSONTyped(value?: AdminConceptMediaReviewNotification | null, ignoreDiscriminator?: boolean): any;

package/dist/models/AdminConceptMediaReviewNotification.js

@@ -0,0 +1,119 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Athena API
+ * REST API for the Athena system
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminConceptMediaReviewNotificationFlagOutcomeEnum = exports.AdminConceptMediaReviewNotificationReasonEnum = exports.AdminConceptMediaReviewNotificationMediaKindEnum = void 0;
+exports.instanceOfAdminConceptMediaReviewNotification = instanceOfAdminConceptMediaReviewNotification;
+exports.AdminConceptMediaReviewNotificationFromJSON = AdminConceptMediaReviewNotificationFromJSON;
+exports.AdminConceptMediaReviewNotificationFromJSONTyped = AdminConceptMediaReviewNotificationFromJSONTyped;
+exports.AdminConceptMediaReviewNotificationToJSON = AdminConceptMediaReviewNotificationToJSON;
+exports.AdminConceptMediaReviewNotificationToJSONTyped = AdminConceptMediaReviewNotificationToJSONTyped;
+/**
+ * @export
+ */
+exports.AdminConceptMediaReviewNotificationMediaKindEnum = {
+    Image: 'image',
+    Diagram: 'diagram'
+};
+/**
+ * @export
+ */
+exports.AdminConceptMediaReviewNotificationReasonEnum = {
+    Inaccurate: 'inaccurate',
+    HardToRead: 'hard_to_read',
+    Irrelevant: 'irrelevant',
+    Inappropriate: 'inappropriate',
+    NotHelpful: 'not_helpful',
+    Other: 'other'
+};
+/**
+ * @export
+ */
+exports.AdminConceptMediaReviewNotificationFlagOutcomeEnum = {
+    Hidden: 'hidden',
+    AlreadyHidden: 'already_hidden',
+    FlaggedAgain: 'flagged_again',
+    AlreadyFlagged: 'already_flagged',
+    NotFound: 'not_found'
+};
+/**
+ * Check if a given object implements the AdminConceptMediaReviewNotification interface.
+ */
+function instanceOfAdminConceptMediaReviewNotification(value) {
+    if (!('reviewId' in value) || value['reviewId'] === undefined)
+        return false;
+    if (!('mediaKind' in value) || value['mediaKind'] === undefined)
+        return false;
+    if (!('mediaId' in value) || value['mediaId'] === undefined)
+        return false;
+    if (!('conceptId' in value) || value['conceptId'] === undefined)
+        return false;
+    if (!('conceptName' in value) || value['conceptName'] === undefined)
+        return false;
+    if (!('mediaTitle' in value) || value['mediaTitle'] === undefined)
+        return false;
+    if (!('mediaDescription' in value) || value['mediaDescription'] === undefined)
+        return false;
+    if (!('reason' in value) || value['reason'] === undefined)
+        return false;
+    if (!('details' in value) || value['details'] === undefined)
+        return false;
+    if (!('flagOutcome' in value) || value['flagOutcome'] === undefined)
+        return false;
+    if (!('completedAt' in value) || value['completedAt'] === undefined)
+        return false;
+    return true;
+}
+function AdminConceptMediaReviewNotificationFromJSON(json) {
+    return AdminConceptMediaReviewNotificationFromJSONTyped(json, false);
+}
+function AdminConceptMediaReviewNotificationFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'reviewId': json['reviewId'],
+        'mediaKind': json['mediaKind'],
+        'mediaId': json['mediaId'],
+        'conceptId': json['conceptId'],
+        'conceptName': json['conceptName'],
+        'mediaTitle': json['mediaTitle'],
+        'mediaDescription': json['mediaDescription'],
+        'reason': json['reason'],
+        'details': json['details'],
+        'flagOutcome': json['flagOutcome'],
+        'completedAt': (new Date(json['completedAt'])),
+    };
+}
+function AdminConceptMediaReviewNotificationToJSON(json) {
+    return AdminConceptMediaReviewNotificationToJSONTyped(json, false);
+}
+function AdminConceptMediaReviewNotificationToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'reviewId': value['reviewId'],
+        'mediaKind': value['mediaKind'],
+        'mediaId': value['mediaId'],
+        'conceptId': value['conceptId'],
+        'conceptName': value['conceptName'],
+        'mediaTitle': value['mediaTitle'],
+        'mediaDescription': value['mediaDescription'],
+        'reason': value['reason'],
+        'details': value['details'],
+        'flagOutcome': value['flagOutcome'],
+        'completedAt': value['completedAt'].toISOString(),
+    };
+}

package/dist/models/AdminConceptMediaReviewNotifications.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Athena API
+ * REST API for the Athena system
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { AdminConceptMediaReviewNotification } from './AdminConceptMediaReviewNotification';
+/**
+ *
+ * @export
+ * @interface AdminConceptMediaReviewNotifications
+ */
+export interface AdminConceptMediaReviewNotifications {
+    /**
+     * Flagged reviews claimed by this call, oldest first. Each is returned by exactly one call; empty when none are waiting.
+     * @type {Array<AdminConceptMediaReviewNotification>}
+     * @memberof AdminConceptMediaReviewNotifications
+     */
+    data: Array<AdminConceptMediaReviewNotification>;
+}
+/**
+ * Check if a given object implements the AdminConceptMediaReviewNotifications interface.
+ */
+export declare function instanceOfAdminConceptMediaReviewNotifications(value: object): value is AdminConceptMediaReviewNotifications;
+export declare function AdminConceptMediaReviewNotificationsFromJSON(json: any): AdminConceptMediaReviewNotifications;
+export declare function AdminConceptMediaReviewNotificationsFromJSONTyped(json: any, ignoreDiscriminator: boolean): AdminConceptMediaReviewNotifications;
+export declare function AdminConceptMediaReviewNotificationsToJSON(json: any): AdminConceptMediaReviewNotifications;
+export declare function AdminConceptMediaReviewNotificationsToJSONTyped(value?: AdminConceptMediaReviewNotifications | null, ignoreDiscriminator?: boolean): any;

package/dist/models/AdminConceptMediaReviewNotifications.js

@@ -0,0 +1,51 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Athena API
+ * REST API for the Athena system
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfAdminConceptMediaReviewNotifications = instanceOfAdminConceptMediaReviewNotifications;
+exports.AdminConceptMediaReviewNotificationsFromJSON = AdminConceptMediaReviewNotificationsFromJSON;
+exports.AdminConceptMediaReviewNotificationsFromJSONTyped = AdminConceptMediaReviewNotificationsFromJSONTyped;
+exports.AdminConceptMediaReviewNotificationsToJSON = AdminConceptMediaReviewNotificationsToJSON;
+exports.AdminConceptMediaReviewNotificationsToJSONTyped = AdminConceptMediaReviewNotificationsToJSONTyped;
+const AdminConceptMediaReviewNotification_1 = require("./AdminConceptMediaReviewNotification");
+/**
+ * Check if a given object implements the AdminConceptMediaReviewNotifications interface.
+ */
+function instanceOfAdminConceptMediaReviewNotifications(value) {
+    if (!('data' in value) || value['data'] === undefined)
+        return false;
+    return true;
+}
+function AdminConceptMediaReviewNotificationsFromJSON(json) {
+    return AdminConceptMediaReviewNotificationsFromJSONTyped(json, false);
+}
+function AdminConceptMediaReviewNotificationsFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'data': (json['data'].map(AdminConceptMediaReviewNotification_1.AdminConceptMediaReviewNotificationFromJSON)),
+    };
+}
+function AdminConceptMediaReviewNotificationsToJSON(json) {
+    return AdminConceptMediaReviewNotificationsToJSONTyped(json, false);
+}
+function AdminConceptMediaReviewNotificationsToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'data': (value['data'].map(AdminConceptMediaReviewNotification_1.AdminConceptMediaReviewNotificationToJSON)),
+    };
+}

package/dist/models/AdminConceptMediaReviewStats.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Athena API
+ * REST API for the Athena system
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { AdminConceptMediaReviewKindStats } from './AdminConceptMediaReviewKindStats';
+/**
+ * How the concept media reviewer agent has performed over a window: volume, flag rate, latency, and spend, per media kind.
+ * @export
+ * @interface AdminConceptMediaReviewStats
+ */
+export interface AdminConceptMediaReviewStats {
+    /**
+     * The window, in days
+     * @type {number}
+     * @memberof AdminConceptMediaReviewStats
+     */
+    days: number;
+    /**
+     * Start of the window: reviews created at or after this
+     * @type {Date}
+     * @memberof AdminConceptMediaReviewStats
+     */
+    since: Date;
+    /**
+     * One entry per kind, image then diagram, even when empty
+     * @type {Array<AdminConceptMediaReviewKindStats>}
+     * @memberof AdminConceptMediaReviewStats
+     */
+    kinds: Array<AdminConceptMediaReviewKindStats>;
+    /**
+     * Sum of known review costs in USD across both kinds
+     * @type {number}
+     * @memberof AdminConceptMediaReviewStats
+     */
+    totalCostUsd: number;
+}
+/**
+ * Check if a given object implements the AdminConceptMediaReviewStats interface.
+ */
+export declare function instanceOfAdminConceptMediaReviewStats(value: object): value is AdminConceptMediaReviewStats;
+export declare function AdminConceptMediaReviewStatsFromJSON(json: any): AdminConceptMediaReviewStats;
+export declare function AdminConceptMediaReviewStatsFromJSONTyped(json: any, ignoreDiscriminator: boolean): AdminConceptMediaReviewStats;
+export declare function AdminConceptMediaReviewStatsToJSON(json: any): AdminConceptMediaReviewStats;
+export declare function AdminConceptMediaReviewStatsToJSONTyped(value?: AdminConceptMediaReviewStats | null, ignoreDiscriminator?: boolean): any;

package/dist/models/AdminConceptMediaReviewStats.js

@@ -0,0 +1,63 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Athena API
+ * REST API for the Athena system
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfAdminConceptMediaReviewStats = instanceOfAdminConceptMediaReviewStats;
+exports.AdminConceptMediaReviewStatsFromJSON = AdminConceptMediaReviewStatsFromJSON;
+exports.AdminConceptMediaReviewStatsFromJSONTyped = AdminConceptMediaReviewStatsFromJSONTyped;
+exports.AdminConceptMediaReviewStatsToJSON = AdminConceptMediaReviewStatsToJSON;
+exports.AdminConceptMediaReviewStatsToJSONTyped = AdminConceptMediaReviewStatsToJSONTyped;
+const AdminConceptMediaReviewKindStats_1 = require("./AdminConceptMediaReviewKindStats");
+/**
+ * Check if a given object implements the AdminConceptMediaReviewStats interface.
+ */
+function instanceOfAdminConceptMediaReviewStats(value) {
+    if (!('days' in value) || value['days'] === undefined)
+        return false;
+    if (!('since' in value) || value['since'] === undefined)
+        return false;
+    if (!('kinds' in value) || value['kinds'] === undefined)
+        return false;
+    if (!('totalCostUsd' in value) || value['totalCostUsd'] === undefined)
+        return false;
+    return true;
+}
+function AdminConceptMediaReviewStatsFromJSON(json) {
+    return AdminConceptMediaReviewStatsFromJSONTyped(json, false);
+}
+function AdminConceptMediaReviewStatsFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'days': json['days'],
+        'since': (new Date(json['since'])),
+        'kinds': (json['kinds'].map(AdminConceptMediaReviewKindStats_1.AdminConceptMediaReviewKindStatsFromJSON)),
+        'totalCostUsd': json['totalCostUsd'],
+    };
+}
+function AdminConceptMediaReviewStatsToJSON(json) {
+    return AdminConceptMediaReviewStatsToJSONTyped(json, false);
+}
+function AdminConceptMediaReviewStatsToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'days': value['days'],
+        'since': value['since'].toISOString(),
+        'kinds': (value['kinds'].map(AdminConceptMediaReviewKindStats_1.AdminConceptMediaReviewKindStatsToJSON)),
+        'totalCostUsd': value['totalCostUsd'],
+    };
+}

package/dist/models/AdminShownConceptDiagram.d.ts

@@ -9,6 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import type { AdminConceptMediaAgentReview } from './AdminConceptMediaAgentReview';
 import type { AdminConceptMediaConcept } from './AdminConceptMediaConcept';
 import type { AdminConceptMediaHistoryEntry } from './AdminConceptMediaHistoryEntry';
 import type { AdminConceptMediaActor } from './AdminConceptMediaActor';
@@ -80,7 +81,7 @@ export interface AdminShownConceptDiagram {
      */
     hiddenBy: AdminConceptMediaActor | null;
     /**
-     * True when the current hide came from a learner's thumbs-down flag rather than an admin. False when visible or hidden by an admin. List these with state=flagged.
+     * True when the current hide came from a flag (a learner's thumbs-down, or the reviewer agent's; see flaggedByAgent) rather than an admin. False when visible or hidden by an admin. List these with state=flagged.
      * @type {boolean}
      * @memberof AdminShownConceptDiagram
      */
@@ -98,7 +99,19 @@ export interface AdminShownConceptDiagram {
      */
     approvedBy: AdminConceptMediaActor | null;
     /**
-     * When a learner first flagged it after an admin approved it. The flag leaves an approved row visible, so this is what puts it back in state=flagged for re-review. Null when no flag has come in since the last admin show or hide; cleared by show, hide, restore, and by showing another version with hideOtherVersions.
+     * True while a concept media reviewer agent flag awaits an admin's review: the flag hid the row (hiddenByFlag), queued an approved row for re-review (flaggedAfterApprovalAt), or found the row hidden and unapproved (e.g. an admin draft) and left it hidden. Such rows list under state=flagged; agentReview carries the reason. hiddenBy is null for an agent hide. Cleared by show, hide, and showing another version with hideOtherVersions; restore keeps it on a row that stays hidden. Never set on a row a learner's flag hid.
+     * @type {boolean}
+     * @memberof AdminShownConceptDiagram
+     */
+    flaggedByAgent: boolean;
+    /**
+     * The reviewer agent's latest review of this row; null when none has run (the review is off, or still pending).
+     * @type {AdminConceptMediaAgentReview}
+     * @memberof AdminShownConceptDiagram
+     */
+    agentReview: AdminConceptMediaAgentReview | null;
+    /**
+     * When a learner (or the reviewer agent, see flaggedByAgent) first flagged it after an admin approved it. The flag leaves an approved row visible, so this is what puts it back in state=flagged for re-review. Null when no flag has come in since the last admin show or hide; cleared by show, hide, restore, and by showing another version with hideOtherVersions.
      * @type {Date}
      * @memberof AdminShownConceptDiagram
      */

package/dist/models/AdminShownConceptDiagram.js

@@ -19,6 +19,7 @@ exports.AdminShownConceptDiagramFromJSON = AdminShownConceptDiagramFromJSON;
 exports.AdminShownConceptDiagramFromJSONTyped = AdminShownConceptDiagramFromJSONTyped;
 exports.AdminShownConceptDiagramToJSON = AdminShownConceptDiagramToJSON;
 exports.AdminShownConceptDiagramToJSONTyped = AdminShownConceptDiagramToJSONTyped;
+const AdminConceptMediaAgentReview_1 = require("./AdminConceptMediaAgentReview");
 const AdminConceptMediaConcept_1 = require("./AdminConceptMediaConcept");
 const AdminConceptMediaHistoryEntry_1 = require("./AdminConceptMediaHistoryEntry");
 const AdminConceptMediaActor_1 = require("./AdminConceptMediaActor");
@@ -68,6 +69,10 @@ function instanceOfAdminShownConceptDiagram(value) {
         return false;
     if (!('approvedBy' in value) || value['approvedBy'] === undefined)
         return false;
+    if (!('flaggedByAgent' in value) || value['flaggedByAgent'] === undefined)
+        return false;
+    if (!('agentReview' in value) || value['agentReview'] === undefined)
+        return false;
     if (!('flaggedAfterApprovalAt' in value) || value['flaggedAfterApprovalAt'] === undefined)
         return false;
     if (!('deletedAt' in value) || value['deletedAt'] === undefined)
@@ -131,6 +136,8 @@ function AdminShownConceptDiagramFromJSONTyped(json, ignoreDiscriminator) {
         'hiddenByFlag': json['hiddenByFlag'],
         'approvedAt': (json['approvedAt'] == null ? null : new Date(json['approvedAt'])),
         'approvedBy': (0, AdminConceptMediaActor_1.AdminConceptMediaActorFromJSON)(json['approvedBy']),
+        'flaggedByAgent': json['flaggedByAgent'],
+        'agentReview': (0, AdminConceptMediaAgentReview_1.AdminConceptMediaAgentReviewFromJSON)(json['agentReview']),
         'flaggedAfterApprovalAt': (json['flaggedAfterApprovalAt'] == null ? null : new Date(json['flaggedAfterApprovalAt'])),
         'deletedAt': (json['deletedAt'] == null ? null : new Date(json['deletedAt'])),
         'deletedBy': (0, AdminConceptMediaActor_1.AdminConceptMediaActorFromJSON)(json['deletedBy']),
@@ -174,6 +181,8 @@ function AdminShownConceptDiagramToJSONTyped(value, ignoreDiscriminator = false)
         'hiddenByFlag': value['hiddenByFlag'],
         'approvedAt': value['approvedAt'] == null ? value['approvedAt'] : value['approvedAt'].toISOString(),
         'approvedBy': (0, AdminConceptMediaActor_1.AdminConceptMediaActorToJSON)(value['approvedBy']),
+        'flaggedByAgent': value['flaggedByAgent'],
+        'agentReview': (0, AdminConceptMediaAgentReview_1.AdminConceptMediaAgentReviewToJSON)(value['agentReview']),
         'flaggedAfterApprovalAt': value['flaggedAfterApprovalAt'] == null ? value['flaggedAfterApprovalAt'] : value['flaggedAfterApprovalAt'].toISOString(),
         'deletedAt': value['deletedAt'] == null ? value['deletedAt'] : value['deletedAt'].toISOString(),
         'deletedBy': (0, AdminConceptMediaActor_1.AdminConceptMediaActorToJSON)(value['deletedBy']),

package/dist/models/AdminShownConceptImage.d.ts

@@ -9,6 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import type { AdminConceptMediaAgentReview } from './AdminConceptMediaAgentReview';
 import type { AdminConceptMediaConcept } from './AdminConceptMediaConcept';
 import type { AdminConceptMediaHistoryEntry } from './AdminConceptMediaHistoryEntry';
 import type { AdminConceptMediaActor } from './AdminConceptMediaActor';
@@ -80,7 +81,7 @@ export interface AdminShownConceptImage {
      */
     hiddenBy: AdminConceptMediaActor | null;
     /**
-     * True when the current hide came from a learner's thumbs-down flag rather than an admin. False when visible or hidden by an admin. List these with state=flagged.
+     * True when the current hide came from a flag (a learner's thumbs-down, or the reviewer agent's; see flaggedByAgent) rather than an admin. False when visible or hidden by an admin. List these with state=flagged.
      * @type {boolean}
      * @memberof AdminShownConceptImage
      */
@@ -98,7 +99,19 @@ export interface AdminShownConceptImage {
      */
     approvedBy: AdminConceptMediaActor | null;
     /**
-     * When a learner first flagged it after an admin approved it. The flag leaves an approved row visible, so this is what puts it back in state=flagged for re-review. Null when no flag has come in since the last admin show or hide; cleared by show, hide, restore, and by showing another version with hideOtherVersions.
+     * True while a concept media reviewer agent flag awaits an admin's review: the flag hid the row (hiddenByFlag), queued an approved row for re-review (flaggedAfterApprovalAt), or found the row hidden and unapproved (e.g. an admin draft) and left it hidden. Such rows list under state=flagged; agentReview carries the reason. hiddenBy is null for an agent hide. Cleared by show, hide, and showing another version with hideOtherVersions; restore keeps it on a row that stays hidden. Never set on a row a learner's flag hid.
+     * @type {boolean}
+     * @memberof AdminShownConceptImage
+     */
+    flaggedByAgent: boolean;
+    /**
+     * The reviewer agent's latest review of this row; null when none has run (the review is off, or still pending).
+     * @type {AdminConceptMediaAgentReview}
+     * @memberof AdminShownConceptImage
+     */
+    agentReview: AdminConceptMediaAgentReview | null;
+    /**
+     * When a learner (or the reviewer agent, see flaggedByAgent) first flagged it after an admin approved it. The flag leaves an approved row visible, so this is what puts it back in state=flagged for re-review. Null when no flag has come in since the last admin show or hide; cleared by show, hide, restore, and by showing another version with hideOtherVersions.
      * @type {Date}
      * @memberof AdminShownConceptImage
      */

package/dist/models/AdminShownConceptImage.js

@@ -19,6 +19,7 @@ exports.AdminShownConceptImageFromJSON = AdminShownConceptImageFromJSON;
 exports.AdminShownConceptImageFromJSONTyped = AdminShownConceptImageFromJSONTyped;
 exports.AdminShownConceptImageToJSON = AdminShownConceptImageToJSON;
 exports.AdminShownConceptImageToJSONTyped = AdminShownConceptImageToJSONTyped;
+const AdminConceptMediaAgentReview_1 = require("./AdminConceptMediaAgentReview");
 const AdminConceptMediaConcept_1 = require("./AdminConceptMediaConcept");
 const AdminConceptMediaHistoryEntry_1 = require("./AdminConceptMediaHistoryEntry");
 const AdminConceptMediaActor_1 = require("./AdminConceptMediaActor");
@@ -68,6 +69,10 @@ function instanceOfAdminShownConceptImage(value) {
         return false;
     if (!('approvedBy' in value) || value['approvedBy'] === undefined)
         return false;
+    if (!('flaggedByAgent' in value) || value['flaggedByAgent'] === undefined)
+        return false;
+    if (!('agentReview' in value) || value['agentReview'] === undefined)
+        return false;
     if (!('flaggedAfterApprovalAt' in value) || value['flaggedAfterApprovalAt'] === undefined)
         return false;
     if (!('deletedAt' in value) || value['deletedAt'] === undefined)
@@ -137,6 +142,8 @@ function AdminShownConceptImageFromJSONTyped(json, ignoreDiscriminator) {
         'hiddenByFlag': json['hiddenByFlag'],
         'approvedAt': (json['approvedAt'] == null ? null : new Date(json['approvedAt'])),
         'approvedBy': (0, AdminConceptMediaActor_1.AdminConceptMediaActorFromJSON)(json['approvedBy']),
+        'flaggedByAgent': json['flaggedByAgent'],
+        'agentReview': (0, AdminConceptMediaAgentReview_1.AdminConceptMediaAgentReviewFromJSON)(json['agentReview']),
         'flaggedAfterApprovalAt': (json['flaggedAfterApprovalAt'] == null ? null : new Date(json['flaggedAfterApprovalAt'])),
         'deletedAt': (json['deletedAt'] == null ? null : new Date(json['deletedAt'])),
         'deletedBy': (0, AdminConceptMediaActor_1.AdminConceptMediaActorFromJSON)(json['deletedBy']),
@@ -183,6 +190,8 @@ function AdminShownConceptImageToJSONTyped(value, ignoreDiscriminator = false) {
         'hiddenByFlag': value['hiddenByFlag'],
         'approvedAt': value['approvedAt'] == null ? value['approvedAt'] : value['approvedAt'].toISOString(),
         'approvedBy': (0, AdminConceptMediaActor_1.AdminConceptMediaActorToJSON)(value['approvedBy']),
+        'flaggedByAgent': value['flaggedByAgent'],
+        'agentReview': (0, AdminConceptMediaAgentReview_1.AdminConceptMediaAgentReviewToJSON)(value['agentReview']),
         'flaggedAfterApprovalAt': value['flaggedAfterApprovalAt'] == null ? value['flaggedAfterApprovalAt'] : value['flaggedAfterApprovalAt'].toISOString(),
         'deletedAt': value['deletedAt'] == null ? value['deletedAt'] : value['deletedAt'].toISOString(),
         'deletedBy': (0, AdminConceptMediaActor_1.AdminConceptMediaActorToJSON)(value['deletedBy']),

package/dist/models/ConceptMediaFlagResult.d.ts

@@ -21,7 +21,23 @@ export interface ConceptMediaFlagResult {
      * @memberof ConceptMediaFlagResult
      */
     hidden: boolean;
+    /**
+     * What this flag did. hidden: it hid the item. flagged_again: the item is admin-approved, so it stayed visible and was queued for admin re-review. already_hidden: the item was already hidden or removed; nothing changed. already_flagged: the item is admin-approved and was already queued for re-review; nothing changed. Only hidden and flagged_again changed anything, so only they warrant telling admins.
+     * @type {string}
+     * @memberof ConceptMediaFlagResult
+     */
+    outcome: ConceptMediaFlagResultOutcomeEnum;
 }
+/**
+ * @export
+ */
+export declare const ConceptMediaFlagResultOutcomeEnum: {
+    readonly Hidden: "hidden";
+    readonly AlreadyHidden: "already_hidden";
+    readonly FlaggedAgain: "flagged_again";
+    readonly AlreadyFlagged: "already_flagged";
+};
+export type ConceptMediaFlagResultOutcomeEnum = typeof ConceptMediaFlagResultOutcomeEnum[keyof typeof ConceptMediaFlagResultOutcomeEnum];
 /**
  * Check if a given object implements the ConceptMediaFlagResult interface.
  */