@altnovatrail/contracts 0.8.2 → 0.8.4

package/novatrail/api/v1/cause_pb.d.ts

@@ -4,8 +4,10 @@
 
 // The causes of the contract between `app` and `api`: one list for its refusals and for the
 // outcomes of its calls of AI, the refusal that a method's error carries, and the outcome that its
-// answer carries. What they mean, and how `app` reads a cause it does not know, are the rules of
-// contracts/README.md, section 15.
+// answer carries; and the values that come both in answers and in the data of a refusal: why an
+// attempt was closed, how a lesson run ended, and the engine's choice, with the list of its reason
+// codes, which the adult's progress alone carries. What they mean, and how `app` reads a cause it
+// does not know, are the rules of contracts/README.md, section 15.
 
 import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
 import type { Message } from "@bufbuild/protobuf";
@@ -74,6 +76,24 @@ export declare type Refusal = Message<"novatrail.api.v1.Refusal"> & {
      */
     value: number;
     case: "maxAuthAgeSeconds";
+  } | {
+    /**
+     * Beside `CAUSE_RUN_ENDED`: how the lesson run ended, and the engine's choice when this request
+     * ended it.
+     *
+     * @generated from field: novatrail.api.v1.RunEnd run_end = 7;
+     */
+    value: RunEnd;
+    case: "runEnd";
+  } | {
+    /**
+     * Beside `CAUSE_SEGMENTS_NOT_ENDED` and `CAUSE_SEGMENT_UNAVAILABLE`: the task segments of the
+     * lesson run that have ended.
+     *
+     * @generated from field: novatrail.api.v1.EndedSegments ended_segments = 8;
+     */
+    value: EndedSegments;
+    case: "endedSegments";
   } | { case: undefined; value?: undefined };
 };
 
@@ -84,7 +104,8 @@ export declare type Refusal = Message<"novatrail.api.v1.Refusal"> & {
 export declare const RefusalSchema: GenMessage<Refusal>;
 
 /**
- * An outcome: what a call of AI came to when the answer holds no reading, or no words, of AI.
+ * An outcome: what a call of AI came to when the answer holds no reading, or no words, of AI; and
+ * why the engine's choice gives nothing, when the AI that checks the tasks is closed to the learner.
  *
  * @generated from message novatrail.api.v1.Outcome
  */
@@ -93,7 +114,9 @@ export declare type Outcome = Message<"novatrail.api.v1.Outcome"> & {
    * The outcome: `CAUSE_AI_FAILURE`, `CAUSE_QUOTA`, `CAUSE_PLATFORM_LIMIT`,
    * `CAUSE_NOT_ADMITTED`, `CAUSE_LIMIT_REACHED`, `CAUSE_KEY_REFUSED` or `CAUSE_NO_OTHER_WORDS`.
    * "Explain differently" makes no call without the reserve of the quota: there the quota, the limit
-   * of platform AI and no admission are refusals, and the right to it on the rung stays.
+   * of platform AI and no admission are refusals, and the right to it on the rung stays. Beside an
+   * engine's choice that gives nothing: `CAUSE_QUOTA`, `CAUSE_PLATFORM_LIMIT` or
+   * `CAUSE_NOT_ADMITTED`.
    *
    * @generated from field: novatrail.api.v1.Cause cause = 1;
    */
@@ -147,6 +170,96 @@ export declare type OwnKeyLimit = Message<"novatrail.api.v1.OwnKeyLimit"> & {
  */
 export declare const OwnKeyLimitSchema: GenMessage<OwnKeyLimit>;
 
+/**
+ * The engine's choice: what the learner is given next — a lesson, or a task outside a lesson — or
+ * that there is nothing to give (concepts 12). A choice begins nothing: `app` opens a lesson by
+ * `OpenLesson` and begins a task by `BeginAttempt`, each naming the choice. Its reason code is not
+ * here: a child is not told it, and it goes to the adult's progress alone, `AttemptRecord`.
+ *
+ * @generated from message novatrail.api.v1.EngineChoice
+ */
+export declare type EngineChoice = Message<"novatrail.api.v1.EngineChoice"> & {
+  /**
+   * The ID of the choice: empty beside `CHOICE_KIND_NOTHING`.
+   *
+   * @generated from field: string choice_id = 1;
+   */
+  choiceId: string;
+
+  /**
+   * What the choice gives.
+   *
+   * @generated from field: novatrail.api.v1.ChoiceKind kind = 2;
+   */
+  kind: ChoiceKind;
+
+  /**
+   * Beside `CHOICE_KIND_NOTHING`, when the AI that checks the tasks is closed to the learner and no
+   * task that a tap checks is left: `CAUSE_QUOTA`, with when the next family day begins,
+   * `CAUSE_PLATFORM_LIMIT` or `CAUSE_NOT_ADMITTED`. Absent when there is nothing to give for
+   * another reason, such as no module connected with a current version.
+   *
+   * @generated from field: novatrail.api.v1.Outcome outcome = 3;
+   */
+  outcome?: Outcome | undefined;
+};
+
+/**
+ * Describes the message novatrail.api.v1.EngineChoice.
+ * Use `create(EngineChoiceSchema)` to create a new message.
+ */
+export declare const EngineChoiceSchema: GenMessage<EngineChoice>;
+
+/**
+ * How a lesson run ended.
+ *
+ * @generated from message novatrail.api.v1.RunEnd
+ */
+export declare type RunEnd = Message<"novatrail.api.v1.RunEnd"> & {
+  /**
+   * Why it ended.
+   *
+   * @generated from field: novatrail.api.v1.RunEndReason reason = 1;
+   */
+  reason: RunEndReason;
+
+  /**
+   * The engine's choice that the end gave: when the request that carries it ended the run — "lesson
+   * done", or a request that found the run's package no longer given, the lesson unsuitable, or the
+   * run abandoned —, and on a repeat of the "lesson done" that ended it. Absent when the run had
+   * ended before by anything else, such as a job of the operator: `app` then asks `ChooseNext`.
+   *
+   * @generated from field: novatrail.api.v1.EngineChoice choice = 2;
+   */
+  choice?: EngineChoice | undefined;
+};
+
+/**
+ * Describes the message novatrail.api.v1.RunEnd.
+ * Use `create(RunEndSchema)` to create a new message.
+ */
+export declare const RunEndSchema: GenMessage<RunEnd>;
+
+/**
+ * The task segments of a lesson run that have ended.
+ *
+ * @generated from message novatrail.api.v1.EndedSegments
+ */
+export declare type EndedSegments = Message<"novatrail.api.v1.EndedSegments"> & {
+  /**
+   * Their places among the segments of the lesson, from 1, in order.
+   *
+   * @generated from field: repeated int32 places = 1;
+   */
+  places: number[];
+};
+
+/**
+ * Describes the message novatrail.api.v1.EndedSegments.
+ * Use `create(EndedSegmentsSchema)` to create a new message.
+ */
+export declare const EndedSegmentsSchema: GenMessage<EndedSegments>;
+
 /**
  * Why a request was refused, or what a call of AI in it came to: one list for the whole contract
  * (R17 api). A refusal comes as the detail `Refusal` of an error of Connect, with the code that the
@@ -173,8 +286,11 @@ export enum Cause {
   NO_PROFILE = 1,
 
   /**
-   * The profile has no attempt with the ID named, or the account no consent with the ID named;
-   * another profile's, or another account's, is the same. Code `not_found`.
+   * The profile has no attempt, lesson run or engine's choice with the ID named, no module
+   * connected with the ID named, and no skill by the full ID named in the current version of a
+   * module connected to it; or the account has no consent with the ID named; or the pinned index
+   * of `api` has no module with the ID named. Another profile's, or another account's, is the
+   * same. Code `not_found`.
    *
    * @generated from enum value: CAUSE_NOT_FOUND = 2;
    */
@@ -206,16 +322,17 @@ export enum Cause {
   STILL_GOING = 5,
 
   /**
-   * The learner's own key came with a profile whose age category is not `adult`. Code
-   * `invalid_argument`.
+   * The learner's own key, or the provider of one at the beginning of an attempt, came with a
+   * profile whose age category is not `adult`. Code `invalid_argument`.
    *
    * @generated from enum value: CAUSE_KEY_NOT_FOR_PROFILE = 6;
    */
   KEY_NOT_FOR_PROFILE = 6,
 
   /**
-   * The quota of platform AI for the family day is spent. A refusal holds when the next family day
-   * begins; so does an outcome. Code `resource_exhausted`.
+   * The quota of platform AI for the family day is spent; at the beginning of an attempt on a task
+   * that platform AI checks, what is left of it is not enough for a typical task. A refusal holds
+   * when the next family day begins; so does an outcome. Code `resource_exhausted`.
    *
    * @generated from enum value: CAUSE_QUOTA = 7;
    */
@@ -364,8 +481,8 @@ export enum Cause {
   CODE_NOT_ACCEPTED = 25,
 
   /**
-   * What the request creates is there already: the account of the user, the owner's profile, or
-   * the profile of a consent. Code `already_exists`.
+   * What the request creates is there already: the account of the user, the owner's profile, the
+   * profile of a consent, or the attempt of an engine's choice of a task. Code `already_exists`.
    *
    * @generated from enum value: CAUSE_ALREADY_EXISTS = 26;
    */
@@ -409,6 +526,67 @@ export enum Cause {
    * @generated from enum value: CAUSE_NO_PIN = 31;
    */
   NO_PIN = 31,
+
+  /**
+   * An open view asked for by the digest of a package whose version the image of `api` no longer
+   * gives: its index marks the version withdrawn, or the version's module format is out of the
+   * window of formats that `api` reads. `app` asks `CheckPackages` about the digests it keeps,
+   * and erases what it keeps of the version. An attempt or a lesson run on such a version is closed
+   * or ended `unchecked` instead. Code `failed_precondition`.
+   *
+   * @generated from enum value: CAUSE_VERSION_NOT_GIVEN = 32;
+   */
+  VERSION_NOT_GIVEN = 32,
+
+  /**
+   * The index of the image of `api` does not know the package digest: a deployment is going on,
+   * and a repeat reaches the new image. Code `unavailable`.
+   *
+   * @generated from enum value: CAUSE_PACKAGE_UNKNOWN = 33;
+   */
+  PACKAGE_UNKNOWN = 33,
+
+  /**
+   * The module has no current version for the learner — none at all, or one whose audience the
+   * learner is not in — or its current version has no lesson or task by the ID named. Code
+   * `failed_precondition`.
+   *
+   * @generated from enum value: CAUSE_NO_CURRENT_VERSION = 34;
+   */
+  NO_CURRENT_VERSION = 34,
+
+  /**
+   * The lesson, one of its tasks, or the task does not suit the age category of the profile. Code
+   * `failed_precondition`.
+   *
+   * @generated from enum value: CAUSE_NOT_SUITABLE = 35;
+   */
+  NOT_SUITABLE = 35,
+
+  /**
+   * The lesson run has ended. The refusal holds how it ended, and the engine's choice when this
+   * request ended it. Code `failed_precondition`.
+   *
+   * @generated from enum value: CAUSE_RUN_ENDED = 36;
+   */
+  RUN_ENDED = 36,
+
+  /**
+   * "Lesson done" while a task segment of the lesson has not ended. The refusal holds the places
+   * of the task segments that have ended. Code `failed_precondition`.
+   *
+   * @generated from enum value: CAUSE_SEGMENTS_NOT_ENDED = 37;
+   */
+  SEGMENTS_NOT_ENDED = 37,
+
+  /**
+   * An attempt asked for on a segment out of order: a task segment before it has not ended, or it
+   * has ended itself. The refusal holds the places of the task segments that have ended. Code
+   * `failed_precondition`.
+   *
+   * @generated from enum value: CAUSE_SEGMENT_UNAVAILABLE = 38;
+   */
+  SEGMENT_UNAVAILABLE = 38,
 }
 
 /**
@@ -533,3 +711,180 @@ export enum CloseReason {
  */
 export declare const CloseReasonSchema: GenEnum<CloseReason>;
 
+/**
+ * What an engine's choice gives. A kind its build does not know `app` reads as
+ * `CHOICE_KIND_NOTHING`.
+ *
+ * @generated from enum novatrail.api.v1.ChoiceKind
+ */
+export enum ChoiceKind {
+  /**
+   * Not named: never sent.
+   *
+   * @generated from enum value: CHOICE_KIND_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * A lesson: `app` opens it by `OpenLesson`. It may be the lesson of a run that is open.
+   *
+   * @generated from enum value: CHOICE_KIND_LESSON = 1;
+   */
+  LESSON = 1,
+
+  /**
+   * A task outside a lesson: `app` begins it by `BeginAttempt`.
+   *
+   * @generated from enum value: CHOICE_KIND_TASK = 2;
+   */
+  TASK = 2,
+
+  /**
+   * Nothing to give.
+   *
+   * @generated from enum value: CHOICE_KIND_NOTHING = 3;
+   */
+  NOTHING = 3,
+}
+
+/**
+ * Describes the enum novatrail.api.v1.ChoiceKind.
+ */
+export declare const ChoiceKindSchema: GenEnum<ChoiceKind>;
+
+/**
+ * Why the engine gave what it chose: its reason code (concepts 12; R29; R100). The adult sees it
+ * in the progress of a profile, and a child is not told it: no answer to a learning request
+ * carries it. A choice has one code, that of the branch of the engine's rule that made it, a
+ * lesson's as a task's, and `ChoiceKind` says what it gave. A value never changes its meaning: a
+ * branch of the engine's rule that the list does not name comes as a new value, and the value of a
+ * branch the engine drops stays, its comment saying that it is no longer given. A code its build
+ * does not know `app` words as a reason it does not name.
+ *
+ * @generated from enum novatrail.api.v1.ReasonCode
+ */
+export enum ReasonCode {
+  /**
+   * No code: a choice of nothing, and an attempt that the learner began again.
+   *
+   * @generated from enum value: REASON_CODE_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * Consolidation: after a wrong answer, another task on the same skill, while the skill is within
+   * reach.
+   *
+   * @generated from enum value: REASON_CODE_CONSOLIDATION = 1;
+   */
+  CONSOLIDATION = 1,
+
+  /**
+   * A new skill: one not given before, whose prerequisites are mastered or which has none.
+   *
+   * @generated from enum value: REASON_CODE_NEW_SKILL = 2;
+   */
+  NEW_SKILL = 2,
+
+  /**
+   * The queue: of the skills within reach that were given before and are not mastered, the one
+   * not given for longest.
+   *
+   * @generated from enum value: REASON_CODE_QUEUE = 3;
+   */
+  QUEUE = 3,
+
+  /**
+   * Repetition: the review date of a mastered skill has come.
+   *
+   * @generated from enum value: REASON_CODE_REPETITION = 4;
+   */
+  REPETITION = 4,
+
+  /**
+   * A probe: a skill put aside comes back as a check.
+   *
+   * @generated from enum value: REASON_CODE_PROBE = 5;
+   */
+  PROBE = 5,
+
+  /**
+   * The learner chose the skill on the skill map, and the engine the lesson or the task on it,
+   * whatever else the skill would fit.
+   *
+   * @generated from enum value: REASON_CODE_SKILL_CHOSEN = 6;
+   */
+  SKILL_CHOSEN = 6,
+
+  /**
+   * The author's order: a skill with a rubric or without assessment comes next by the skill graph,
+   * without the learner model (concepts 4).
+   *
+   * @generated from enum value: REASON_CODE_AUTHOR_ORDER = 7;
+   */
+  AUTHOR_ORDER = 7,
+
+  /**
+   * The lesson of a run that is open, which the learner goes on with, whatever else its skills
+   * would fit.
+   *
+   * @generated from enum value: REASON_CODE_OPEN_RUN = 8;
+   */
+  OPEN_RUN = 8,
+}
+
+/**
+ * Describes the enum novatrail.api.v1.ReasonCode.
+ */
+export declare const ReasonCodeSchema: GenEnum<ReasonCode>;
+
+/**
+ * Why a lesson run ended (concepts 5). A reason its build does not know `app` reads as an end other
+ * than `RUN_END_REASON_PASSED`, and erases the state of the lesson as at every end.
+ *
+ * @generated from enum novatrail.api.v1.RunEndReason
+ */
+export enum RunEndReason {
+  /**
+   * Not ended: the run is open.
+   *
+   * @generated from enum value: RUN_END_REASON_UNSPECIFIED = 0;
+   */
+  UNSPECIFIED = 0,
+
+  /**
+   * The lesson is done: "lesson done" came once every task segment had ended.
+   *
+   * @generated from enum value: RUN_END_REASON_PASSED = 1;
+   */
+  PASSED = 1,
+
+  /**
+   * Unchecked: the run's version of the module is no longer given, withdrawn or out of the window
+   * of formats that `api` reads, or an attempt of the run was closed `CLOSE_REASON_UNCHECKED`.
+   *
+   * @generated from enum value: RUN_END_REASON_UNCHECKED = 2;
+   */
+  UNCHECKED = 2,
+
+  /**
+   * Not suitable: the module is no longer connected or has no current version for the learner, or
+   * the lesson or one of its tasks no longer suits the age category of the profile.
+   *
+   * @generated from enum value: RUN_END_REASON_NOT_SUITABLE = 3;
+   */
+  NOT_SUITABLE = 3,
+
+  /**
+   * Abandoned: no request on the run or its attempts for 30 days.
+   *
+   * @generated from enum value: RUN_END_REASON_ABANDONED = 4;
+   */
+  ABANDONED = 4,
+}
+
+/**
+ * Describes the enum novatrail.api.v1.RunEndReason.
+ */
+export declare const RunEndReasonSchema: GenEnum<RunEndReason>;
+

package/novatrail/api/v1/cause_pb.js

@@ -4,8 +4,10 @@
 
 // The causes of the contract between `app` and `api`: one list for its refusals and for the
 // outcomes of its calls of AI, the refusal that a method's error carries, and the outcome that its
-// answer carries. What they mean, and how `app` reads a cause it does not know, are the rules of
-// contracts/README.md, section 15.
+// answer carries; and the values that come both in answers and in the data of a refusal: why an
+// attempt was closed, how a lesson run ended, and the engine's choice, with the list of its reason
+// codes, which the adult's progress alone carries. What they mean, and how `app` reads a cause it
+// does not know, are the rules of contracts/README.md, section 15.
 
 import { enumDesc, fileDesc, messageDesc, tsEnum } from "@bufbuild/protobuf/codegenv2";
 import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
@@ -14,7 +16,7 @@ import { file_google_protobuf_timestamp } from "@bufbuild/protobuf/wkt";
  * Describes the file novatrail/api/v1/cause.proto.
  */
 export const file_novatrail_api_v1_cause = /*@__PURE__*/
-  fileDesc("Chxub3ZhdHJhaWwvYXBpL3YxL2NhdXNlLnByb3RvEhBub3ZhdHJhaWwuYXBpLnYxIpQCCgdSZWZ1c2FsEiYKBWNhdXNlGAEgASgOMhcubm92YXRyYWlsLmFwaS52MS5DYXVzZRI1CgxjbG9zZV9yZWFzb24YAiABKA4yHS5ub3ZhdHJhaWwuYXBpLnYxLkNsb3NlUmVhc29uSAASNQoPbmV4dF9mYW1pbHlfZGF5GAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEgAEhcKDXdyb25nX2Fuc3dlcnMYBCABKAVIABIyCgxsb2NrZWRfdW50aWwYBSABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wSAASHgoUbWF4X2F1dGhfYWdlX3NlY29uZHMYBiABKAVIAEIGCgRkYXRhIpwBCgdPdXRjb21lEiYKBWNhdXNlGAEgASgOMhcubm92YXRyYWlsLmFwaS52MS5DYXVzZRIzCg9uZXh0X2ZhbWlseV9kYXkYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjQKDW93bl9rZXlfbGltaXQYAyABKAsyHS5ub3ZhdHJhaWwuYXBpLnYxLk93bktleUxpbWl0Im4KC093bktleUxpbWl0EisKBWNhdXNlGAEgASgOMhwubm92YXRyYWlsLmFwaS52MS5MaW1pdENhdXNlEjIKDmFjY2Vzc19yZXR1cm5zGAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCqVBgoFQ2F1c2USFQoRQ0FVU0VfVU5TUEVDSUZJRUQQABIUChBDQVVTRV9OT19QUk9GSUxFEAESEwoPQ0FVU0VfTk9UX0ZPVU5EEAISGAoUQ0FVU0VfQVRURU1QVF9DTE9TRUQQAxIaChZDQVVTRV9LRVlfQUxSRUFEWV9VU0VEEAQSFQoRQ0FVU0VfU1RJTExfR09JTkcQBRIdChlDQVVTRV9LRVlfTk9UX0ZPUl9QUk9GSUxFEAYSDwoLQ0FVU0VfUVVPVEEQBxIYChRDQVVTRV9QTEFURk9STV9MSU1JVBAIEhYKEkNBVVNFX05PVF9BRE1JVFRFRBAJEhQKEENBVVNFX0FJX0ZBSUxVUkUQChIXChNDQVVTRV9MSU1JVF9SRUFDSEVEEAsSFQoRQ0FVU0VfS0VZX1JFRlVTRUQQDBIWChJDQVVTRV9BRFVMVF9ORUVERUQQDRIbChdDQVVTRV9MQURERVJfTk9UX1BBU1NFRBAOEhQKEENBVVNFX05PX1NIT1dJTkcQDxIRCg1DQVVTRV9OT19SVU5HEBASFwoTQ0FVU0VfQUxSRUFEWV9BU0tFRBAREhgKFENBVVNFX05PX09USEVSX1dPUkRTEBISFwoTQ0FVU0VfTk9fTU9SRV9XT1JEUxATEhcKE0NBVVNFX05PX1NVQk1JU1NJT04QFBIVChFDQVVTRV9OT1RfQ1VSUkVOVBAVEhMKD0NBVVNFX05PX0FDQ0VTUxAWEhYKEkNBVVNFX0FDQ09VTlRfR09ORRAXEh4KGkNBVVNFX0ZSRVNIX1NJR05fSU5fTkVFREVEEBgSGwoXQ0FVU0VfQ09ERV9OT1RfQUNDRVBURUQQGRIYChRDQVVTRV9BTFJFQURZX0VYSVNUUxAaEh4KGkNBVVNFX0NPVU5UUllfTk9UX0FDQ0VQVEVEEBsSFAoQQ0FVU0VfTk9fQ09OU0VOVBAcEhQKEENBVVNFX1BJTl9MT0NLRUQQHRIZChVDQVVTRV9QSU5fQUxSRUFEWV9TRVQQHhIQCgxDQVVTRV9OT19QSU4QHyqIAQoKTGltaXRDYXVzZRIbChdMSU1JVF9DQVVTRV9VTlNQRUNJRklFRBAAEhUKEUxJTUlUX0NBVVNFX0xJTUlUEAESFAoQTElNSVRfQ0FVU0VfVElFUhACEhcKE0xJTUlUX0NBVVNFX0JBTEFOQ0UQAxIXChNMSU1JVF9DQVVTRV9QQVlNRU5UEAQq6wEKC0Nsb3NlUmVhc29uEhwKGENMT1NFX1JFQVNPTl9VTlNQRUNJRklFRBAAEhgKFENMT1NFX1JFQVNPTl9DT1JSRUNUEAESHwobQ0xPU0VfUkVBU09OX1NPTFVUSU9OX1NIT1dOEAISFQoRQ0xPU0VfUkVBU09OX0xFRlQQAxIaChZDTE9TRV9SRUFTT05fQUJBTkRPTkVEEAQSGgoWQ0xPU0VfUkVBU09OX1VOQ0hFQ0tFRBAFEh0KGUNMT1NFX1JFQVNPTl9OT1RfU1VJVEFCTEUQBhIVChFDTE9TRV9SRUFTT05fRE9ORRAHQsMBChRjb20ubm92YXRyYWlsLmFwaS52MUIKQ2F1c2VQcm90b1ABWj1naXRodWIuY29tL2FsdG5vdmF0cmFpbC9zcGVjL2NvbnRyYWN0cy9ub3ZhdHJhaWwvYXBpL3YxO2FwaXYxogIDTkFYqgIQTm92YXRyYWlsLkFwaS5WMcoCEE5vdmF0cmFpbFxBcGlcVjHiAhxOb3ZhdHJhaWxcQXBpXFYxXEdQQk1ldGFkYXRh6gISTm92YXRyYWlsOjpBcGk6OlYxYgZwcm90bzM", [file_google_protobuf_timestamp]);
+  fileDesc("Chxub3ZhdHJhaWwvYXBpL3YxL2NhdXNlLnByb3RvEhBub3ZhdHJhaWwuYXBpLnYxIvwCCgdSZWZ1c2FsEiYKBWNhdXNlGAEgASgOMhcubm92YXRyYWlsLmFwaS52MS5DYXVzZRI1CgxjbG9zZV9yZWFzb24YAiABKA4yHS5ub3ZhdHJhaWwuYXBpLnYxLkNsb3NlUmVhc29uSAASNQoPbmV4dF9mYW1pbHlfZGF5GAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEgAEhcKDXdyb25nX2Fuc3dlcnMYBCABKAVIABIyCgxsb2NrZWRfdW50aWwYBSABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wSAASHgoUbWF4X2F1dGhfYWdlX3NlY29uZHMYBiABKAVIABIrCgdydW5fZW5kGAcgASgLMhgubm92YXRyYWlsLmFwaS52MS5SdW5FbmRIABI5Cg5lbmRlZF9zZWdtZW50cxgIIAEoCzIfLm5vdmF0cmFpbC5hcGkudjEuRW5kZWRTZWdtZW50c0gAQgYKBGRhdGEinAEKB091dGNvbWUSJgoFY2F1c2UYASABKA4yFy5ub3ZhdHJhaWwuYXBpLnYxLkNhdXNlEjMKD25leHRfZmFtaWx5X2RheRgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASNAoNb3duX2tleV9saW1pdBgDIAEoCzIdLm5vdmF0cmFpbC5hcGkudjEuT3duS2V5TGltaXQibgoLT3duS2V5TGltaXQSKwoFY2F1c2UYASABKA4yHC5ub3ZhdHJhaWwuYXBpLnYxLkxpbWl0Q2F1c2USMgoOYWNjZXNzX3JldHVybnMYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wInkKDEVuZ2luZUNob2ljZRIRCgljaG9pY2VfaWQYASABKAkSKgoEa2luZBgCIAEoDjIcLm5vdmF0cmFpbC5hcGkudjEuQ2hvaWNlS2luZBIqCgdvdXRjb21lGAMgASgLMhkubm92YXRyYWlsLmFwaS52MS5PdXRjb21lImgKBlJ1bkVuZBIuCgZyZWFzb24YASABKA4yHi5ub3ZhdHJhaWwuYXBpLnYxLlJ1bkVuZFJlYXNvbhIuCgZjaG9pY2UYAiABKAsyHi5ub3ZhdHJhaWwuYXBpLnYxLkVuZ2luZUNob2ljZSIfCg1FbmRlZFNlZ21lbnRzEg4KBnBsYWNlcxgBIAMoBSrVBwoFQ2F1c2USFQoRQ0FVU0VfVU5TUEVDSUZJRUQQABIUChBDQVVTRV9OT19QUk9GSUxFEAESEwoPQ0FVU0VfTk9UX0ZPVU5EEAISGAoUQ0FVU0VfQVRURU1QVF9DTE9TRUQQAxIaChZDQVVTRV9LRVlfQUxSRUFEWV9VU0VEEAQSFQoRQ0FVU0VfU1RJTExfR09JTkcQBRIdChlDQVVTRV9LRVlfTk9UX0ZPUl9QUk9GSUxFEAYSDwoLQ0FVU0VfUVVPVEEQBxIYChRDQVVTRV9QTEFURk9STV9MSU1JVBAIEhYKEkNBVVNFX05PVF9BRE1JVFRFRBAJEhQKEENBVVNFX0FJX0ZBSUxVUkUQChIXChNDQVVTRV9MSU1JVF9SRUFDSEVEEAsSFQoRQ0FVU0VfS0VZX1JFRlVTRUQQDBIWChJDQVVTRV9BRFVMVF9ORUVERUQQDRIbChdDQVVTRV9MQURERVJfTk9UX1BBU1NFRBAOEhQKEENBVVNFX05PX1NIT1dJTkcQDxIRCg1DQVVTRV9OT19SVU5HEBASFwoTQ0FVU0VfQUxSRUFEWV9BU0tFRBAREhgKFENBVVNFX05PX09USEVSX1dPUkRTEBISFwoTQ0FVU0VfTk9fTU9SRV9XT1JEUxATEhcKE0NBVVNFX05PX1NVQk1JU1NJT04QFBIVChFDQVVTRV9OT1RfQ1VSUkVOVBAVEhMKD0NBVVNFX05PX0FDQ0VTUxAWEhYKEkNBVVNFX0FDQ09VTlRfR09ORRAXEh4KGkNBVVNFX0ZSRVNIX1NJR05fSU5fTkVFREVEEBgSGwoXQ0FVU0VfQ09ERV9OT1RfQUNDRVBURUQQGRIYChRDQVVTRV9BTFJFQURZX0VYSVNUUxAaEh4KGkNBVVNFX0NPVU5UUllfTk9UX0FDQ0VQVEVEEBsSFAoQQ0FVU0VfTk9fQ09OU0VOVBAcEhQKEENBVVNFX1BJTl9MT0NLRUQQHRIZChVDQVVTRV9QSU5fQUxSRUFEWV9TRVQQHhIQCgxDQVVTRV9OT19QSU4QHxIbChdDQVVTRV9WRVJTSU9OX05PVF9HSVZFThAgEhkKFUNBVVNFX1BBQ0tBR0VfVU5LTk9XThAhEhwKGENBVVNFX05PX0NVUlJFTlRfVkVSU0lPThAiEhYKEkNBVVNFX05PVF9TVUlUQUJMRRAjEhMKD0NBVVNFX1JVTl9FTkRFRBAkEhwKGENBVVNFX1NFR01FTlRTX05PVF9FTkRFRBAlEh0KGUNBVVNFX1NFR01FTlRfVU5BVkFJTEFCTEUQJiqIAQoKTGltaXRDYXVzZRIbChdMSU1JVF9DQVVTRV9VTlNQRUNJRklFRBAAEhUKEUxJTUlUX0NBVVNFX0xJTUlUEAESFAoQTElNSVRfQ0FVU0VfVElFUhACEhcKE0xJTUlUX0NBVVNFX0JBTEFOQ0UQAxIXChNMSU1JVF9DQVVTRV9QQVlNRU5UEAQq6wEKC0Nsb3NlUmVhc29uEhwKGENMT1NFX1JFQVNPTl9VTlNQRUNJRklFRBAAEhgKFENMT1NFX1JFQVNPTl9DT1JSRUNUEAESHwobQ0xPU0VfUkVBU09OX1NPTFVUSU9OX1NIT1dOEAISFQoRQ0xPU0VfUkVBU09OX0xFRlQQAxIaChZDTE9TRV9SRUFTT05fQUJBTkRPTkVEEAQSGgoWQ0xPU0VfUkVBU09OX1VOQ0hFQ0tFRBAFEh0KGUNMT1NFX1JFQVNPTl9OT1RfU1VJVEFCTEUQBhIVChFDTE9TRV9SRUFTT05fRE9ORRAHKnAKCkNob2ljZUtpbmQSGwoXQ0hPSUNFX0tJTkRfVU5TUEVDSUZJRUQQABIWChJDSE9JQ0VfS0lORF9MRVNTT04QARIUChBDSE9JQ0VfS0lORF9UQVNLEAISFwoTQ0hPSUNFX0tJTkRfTk9USElORxADKoMCCgpSZWFzb25Db2RlEhsKF1JFQVNPTl9DT0RFX1VOU1BFQ0lGSUVEEAASHQoZUkVBU09OX0NPREVfQ09OU09MSURBVElPThABEhkKFVJFQVNPTl9DT0RFX05FV19TS0lMTBACEhUKEVJFQVNPTl9DT0RFX1FVRVVFEAMSGgoWUkVBU09OX0NPREVfUkVQRVRJVElPThAEEhUKEVJFQVNPTl9DT0RFX1BST0JFEAUSHAoYUkVBU09OX0NPREVfU0tJTExfQ0hPU0VOEAYSHAoYUkVBU09OX0NPREVfQVVUSE9SX09SREVSEAcSGAoUUkVBU09OX0NPREVfT1BFTl9SVU4QCCqmAQoMUnVuRW5kUmVhc29uEh4KGlJVTl9FTkRfUkVBU09OX1VOU1BFQ0lGSUVEEAASGQoVUlVOX0VORF9SRUFTT05fUEFTU0VEEAESHAoYUlVOX0VORF9SRUFTT05fVU5DSEVDS0VEEAISHwobUlVOX0VORF9SRUFTT05fTk9UX1NVSVRBQkxFEAMSHAoYUlVOX0VORF9SRUFTT05fQUJBTkRPTkVEEARCwwEKFGNvbS5ub3ZhdHJhaWwuYXBpLnYxQgpDYXVzZVByb3RvUAFaPWdpdGh1Yi5jb20vYWx0bm92YXRyYWlsL3NwZWMvY29udHJhY3RzL25vdmF0cmFpbC9hcGkvdjE7YXBpdjGiAgNOQViqAhBOb3ZhdHJhaWwuQXBpLlYxygIQTm92YXRyYWlsXEFwaVxWMeICHE5vdmF0cmFpbFxBcGlcVjFcR1BCTWV0YWRhdGHqAhJOb3ZhdHJhaWw6OkFwaTo6VjFiBnByb3RvMw", [file_google_protobuf_timestamp]);
 
 /**
  * Describes the message novatrail.api.v1.Refusal.
@@ -37,6 +39,27 @@ export const OutcomeSchema = /*@__PURE__*/
 export const OwnKeyLimitSchema = /*@__PURE__*/
   messageDesc(file_novatrail_api_v1_cause, 2);
 
+/**
+ * Describes the message novatrail.api.v1.EngineChoice.
+ * Use `create(EngineChoiceSchema)` to create a new message.
+ */
+export const EngineChoiceSchema = /*@__PURE__*/
+  messageDesc(file_novatrail_api_v1_cause, 3);
+
+/**
+ * Describes the message novatrail.api.v1.RunEnd.
+ * Use `create(RunEndSchema)` to create a new message.
+ */
+export const RunEndSchema = /*@__PURE__*/
+  messageDesc(file_novatrail_api_v1_cause, 4);
+
+/**
+ * Describes the message novatrail.api.v1.EndedSegments.
+ * Use `create(EndedSegmentsSchema)` to create a new message.
+ */
+export const EndedSegmentsSchema = /*@__PURE__*/
+  messageDesc(file_novatrail_api_v1_cause, 5);
+
 /**
  * Describes the enum novatrail.api.v1.Cause.
  */
@@ -84,3 +107,53 @@ export const CloseReasonSchema = /*@__PURE__*/
 export const CloseReason = /*@__PURE__*/
   tsEnum(CloseReasonSchema);
 
+/**
+ * Describes the enum novatrail.api.v1.ChoiceKind.
+ */
+export const ChoiceKindSchema = /*@__PURE__*/
+  enumDesc(file_novatrail_api_v1_cause, 3);
+
+/**
+ * What an engine's choice gives. A kind its build does not know `app` reads as
+ * `CHOICE_KIND_NOTHING`.
+ *
+ * @generated from enum novatrail.api.v1.ChoiceKind
+ */
+export const ChoiceKind = /*@__PURE__*/
+  tsEnum(ChoiceKindSchema);
+
+/**
+ * Describes the enum novatrail.api.v1.ReasonCode.
+ */
+export const ReasonCodeSchema = /*@__PURE__*/
+  enumDesc(file_novatrail_api_v1_cause, 4);
+
+/**
+ * Why the engine gave what it chose: its reason code (concepts 12; R29; R100). The adult sees it
+ * in the progress of a profile, and a child is not told it: no answer to a learning request
+ * carries it. A choice has one code, that of the branch of the engine's rule that made it, a
+ * lesson's as a task's, and `ChoiceKind` says what it gave. A value never changes its meaning: a
+ * branch of the engine's rule that the list does not name comes as a new value, and the value of a
+ * branch the engine drops stays, its comment saying that it is no longer given. A code its build
+ * does not know `app` words as a reason it does not name.
+ *
+ * @generated from enum novatrail.api.v1.ReasonCode
+ */
+export const ReasonCode = /*@__PURE__*/
+  tsEnum(ReasonCodeSchema);
+
+/**
+ * Describes the enum novatrail.api.v1.RunEndReason.
+ */
+export const RunEndReasonSchema = /*@__PURE__*/
+  enumDesc(file_novatrail_api_v1_cause, 5);
+
+/**
+ * Why a lesson run ended (concepts 5). A reason its build does not know `app` reads as an end other
+ * than `RUN_END_REASON_PASSED`, and erases the state of the lesson as at every end.
+ *
+ * @generated from enum novatrail.api.v1.RunEndReason
+ */
+export const RunEndReason = /*@__PURE__*/
+  tsEnum(RunEndReasonSchema);
+