@altnovatrail/contracts 0.8.1 → 0.8.3

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

@@ -4,8 +4,9 @@
 
 // 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. 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";
@@ -58,6 +59,40 @@ export declare type Refusal = Message<"novatrail.api.v1.Refusal"> & {
      */
     value: number;
     case: "wrongAnswers";
+  } | {
+    /**
+     * Beside `CAUSE_PIN_LOCKED`: when the input of the PIN opens.
+     *
+     * @generated from field: google.protobuf.Timestamp locked_until = 5;
+     */
+    value: Timestamp;
+    case: "lockedUntil";
+  } | {
+    /**
+     * Beside `CAUSE_FRESH_SIGN_IN_NEEDED`: how old a sign-in may be, in seconds.
+     *
+     * @generated from field: int32 max_auth_age_seconds = 6;
+     */
+    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 };
 };
 
@@ -68,7 +103,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
  */
@@ -77,7 +113,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;
    */
@@ -131,6 +169,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, which
+ * the adult sees, is RUN.md's T65.
+ *
+ * @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
@@ -150,14 +278,18 @@ export enum Cause {
 
   /**
    * The profile named is not one of the account's, or there is no such profile. Code `not_found`.
+   * On `DeleteProfile` it means that the profile is deleted already.
    *
    * @generated from enum value: CAUSE_NO_PROFILE = 1;
    */
   NO_PROFILE = 1,
 
   /**
-   * The profile has no attempt with the ID named; another profile'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;
    */
@@ -173,7 +305,8 @@ export enum Cause {
   ATTEMPT_CLOSED = 3,
 
   /**
-   * The idempotency key was sent with another method or another attempt. Code `invalid_argument`.
+   * The idempotency key was sent with another method, another attempt or another request. Code
+   * `invalid_argument`.
    *
    * @generated from enum value: CAUSE_KEY_ALREADY_USED = 4;
    */
@@ -188,16 +321,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;
    */
@@ -312,6 +446,146 @@ export enum Cause {
    * @generated from enum value: CAUSE_NOT_CURRENT = 21;
    */
   NOT_CURRENT = 21,
+
+  /**
+   * The user of the sign-in service has no account: no invite code was redeemed, and the account
+   * was not created. Such a user may only create the account. Code `permission_denied`.
+   *
+   * @generated from enum value: CAUSE_NO_ACCESS = 22;
+   */
+  NO_ACCESS = 22,
+
+  /**
+   * The account is no longer there: it is being deleted or was deleted, or the sign-in service has
+   * no such user. `app` erases everything of the account on the device and signs out, without
+   * refreshing the token. Code `unauthenticated`.
+   *
+   * @generated from enum value: CAUSE_ACCOUNT_GONE = 23;
+   */
+  ACCOUNT_GONE = 23,
+
+  /**
+   * The action needs a fresh sign-in, and the sign-in of the token is older than the refusal allows.
+   * The refusal holds how old a sign-in may be, in seconds. Code `unauthenticated`.
+   *
+   * @generated from enum value: CAUSE_FRESH_SIGN_IN_NEEDED = 24;
+   */
+  FRESH_SIGN_IN_NEEDED = 24,
+
+  /**
+   * The invite code is not valid, or was redeemed already. Code `invalid_argument`.
+   *
+   * @generated from enum value: CAUSE_CODE_NOT_ACCEPTED = 25;
+   */
+  CODE_NOT_ACCEPTED = 25,
+
+  /**
+   * 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;
+   */
+  ALREADY_EXISTS = 26,
+
+  /**
+   * The deployment does not take learners from the country named (privacy 9, П-2). Code
+   * `failed_precondition`.
+   *
+   * @generated from enum value: CAUSE_COUNTRY_NOT_ACCEPTED = 27;
+   */
+  COUNTRY_NOT_ACCEPTED = 27,
+
+  /**
+   * The consent is not confirmed: a child's profile asked for by a consent that still waits, or a
+   * learning request of a profile without consent. Code `failed_precondition`.
+   *
+   * @generated from enum value: CAUSE_NO_CONSENT = 28;
+   */
+  NO_CONSENT = 28,
+
+  /**
+   * The input of the PIN is closed after too many wrong PINs. The refusal holds when it opens. Code
+   * `resource_exhausted`.
+   *
+   * @generated from enum value: CAUSE_PIN_LOCKED = 29;
+   */
+  PIN_LOCKED = 29,
+
+  /**
+   * The PIN is set already: it is changed by the PIN before it, or by a fresh sign-in. Code
+   * `failed_precondition`.
+   *
+   * @generated from enum value: CAUSE_PIN_ALREADY_SET = 30;
+   */
+  PIN_ALREADY_SET = 30,
+
+  /**
+   * The account has no PIN yet: it is set first. Code `failed_precondition`.
+   *
+   * @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,
 }
 
 /**
@@ -436,3 +710,94 @@ 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 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,9 @@
 
 // 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. 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 +15,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("Chxub3ZhdHJhaWwvYXBpL3YxL2NhdXNlLnByb3RvEhBub3ZhdHJhaWwuYXBpLnYxIsABCgdSZWZ1c2FsEiYKBWNhdXNlGAEgASgOMhcubm92YXRyYWlsLmFwaS52MS5DYXVzZRI1CgxjbG9zZV9yZWFzb24YAiABKA4yHS5ub3ZhdHJhaWwuYXBpLnYxLkNsb3NlUmVhc29uSAASNQoPbmV4dF9mYW1pbHlfZGF5GAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEgAEhcKDXdyb25nX2Fuc3dlcnMYBCABKAVIAEIGCgRkYXRhIpwBCgdPdXRjb21lEiYKBWNhdXNlGAEgASgOMhcubm92YXRyYWlsLmFwaS52MS5DYXVzZRIzCg9uZXh0X2ZhbWlseV9kYXkYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEjQKDW93bl9rZXlfbGltaXQYAyABKAsyHS5ub3ZhdHJhaWwuYXBpLnYxLk93bktleUxpbWl0Im4KC093bktleUxpbWl0EisKBWNhdXNlGAEgASgOMhwubm92YXRyYWlsLmFwaS52MS5MaW1pdENhdXNlEjIKDmFjY2Vzc19yZXR1cm5zGAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCqYBAoFQ2F1c2USFQoRQ0FVU0VfVU5TUEVDSUZJRUQQABIUChBDQVVTRV9OT19QUk9GSUxFEAESEwoPQ0FVU0VfTk9UX0ZPVU5EEAISGAoUQ0FVU0VfQVRURU1QVF9DTE9TRUQQAxIaChZDQVVTRV9LRVlfQUxSRUFEWV9VU0VEEAQSFQoRQ0FVU0VfU1RJTExfR09JTkcQBRIdChlDQVVTRV9LRVlfTk9UX0ZPUl9QUk9GSUxFEAYSDwoLQ0FVU0VfUVVPVEEQBxIYChRDQVVTRV9QTEFURk9STV9MSU1JVBAIEhYKEkNBVVNFX05PVF9BRE1JVFRFRBAJEhQKEENBVVNFX0FJX0ZBSUxVUkUQChIXChNDQVVTRV9MSU1JVF9SRUFDSEVEEAsSFQoRQ0FVU0VfS0VZX1JFRlVTRUQQDBIWChJDQVVTRV9BRFVMVF9ORUVERUQQDRIbChdDQVVTRV9MQURERVJfTk9UX1BBU1NFRBAOEhQKEENBVVNFX05PX1NIT1dJTkcQDxIRCg1DQVVTRV9OT19SVU5HEBASFwoTQ0FVU0VfQUxSRUFEWV9BU0tFRBAREhgKFENBVVNFX05PX09USEVSX1dPUkRTEBISFwoTQ0FVU0VfTk9fTU9SRV9XT1JEUxATEhcKE0NBVVNFX05PX1NVQk1JU1NJT04QFBIVChFDQVVTRV9OT1RfQ1VSUkVOVBAVKogBCgpMaW1pdENhdXNlEhsKF0xJTUlUX0NBVVNFX1VOU1BFQ0lGSUVEEAASFQoRTElNSVRfQ0FVU0VfTElNSVQQARIUChBMSU1JVF9DQVVTRV9USUVSEAISFwoTTElNSVRfQ0FVU0VfQkFMQU5DRRADEhcKE0xJTUlUX0NBVVNFX1BBWU1FTlQQBCrrAQoLQ2xvc2VSZWFzb24SHAoYQ0xPU0VfUkVBU09OX1VOU1BFQ0lGSUVEEAASGAoUQ0xPU0VfUkVBU09OX0NPUlJFQ1QQARIfChtDTE9TRV9SRUFTT05fU09MVVRJT05fU0hPV04QAhIVChFDTE9TRV9SRUFTT05fTEVGVBADEhoKFkNMT1NFX1JFQVNPTl9BQkFORE9ORUQQBBIaChZDTE9TRV9SRUFTT05fVU5DSEVDS0VEEAUSHQoZQ0xPU0VfUkVBU09OX05PVF9TVUlUQUJMRRAGEhUKEUNMT1NFX1JFQVNPTl9ET05FEAdCwwEKFGNvbS5ub3ZhdHJhaWwuYXBpLnYxQgpDYXVzZVByb3RvUAFaPWdpdGh1Yi5jb20vYWx0bm92YXRyYWlsL3NwZWMvY29udHJhY3RzL25vdmF0cmFpbC9hcGkvdjE7YXBpdjGiAgNOQViqAhBOb3ZhdHJhaWwuQXBpLlYxygIQTm92YXRyYWlsXEFwaVxWMeICHE5vdmF0cmFpbFxBcGlcVjFcR1BCTWV0YWRhdGHqAhJOb3ZhdHJhaWw6OkFwaTo6VjFiBnByb3RvMw", [file_google_protobuf_timestamp]);
+  fileDesc("Chxub3ZhdHJhaWwvYXBpL3YxL2NhdXNlLnByb3RvEhBub3ZhdHJhaWwuYXBpLnYxIvwCCgdSZWZ1c2FsEiYKBWNhdXNlGAEgASgOMhcubm92YXRyYWlsLmFwaS52MS5DYXVzZRI1CgxjbG9zZV9yZWFzb24YAiABKA4yHS5ub3ZhdHJhaWwuYXBpLnYxLkNsb3NlUmVhc29uSAASNQoPbmV4dF9mYW1pbHlfZGF5GAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEgAEhcKDXdyb25nX2Fuc3dlcnMYBCABKAVIABIyCgxsb2NrZWRfdW50aWwYBSABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wSAASHgoUbWF4X2F1dGhfYWdlX3NlY29uZHMYBiABKAVIABIrCgdydW5fZW5kGAcgASgLMhgubm92YXRyYWlsLmFwaS52MS5SdW5FbmRIABI5Cg5lbmRlZF9zZWdtZW50cxgIIAEoCzIfLm5vdmF0cmFpbC5hcGkudjEuRW5kZWRTZWdtZW50c0gAQgYKBGRhdGEinAEKB091dGNvbWUSJgoFY2F1c2UYASABKA4yFy5ub3ZhdHJhaWwuYXBpLnYxLkNhdXNlEjMKD25leHRfZmFtaWx5X2RheRgCIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASNAoNb3duX2tleV9saW1pdBgDIAEoCzIdLm5vdmF0cmFpbC5hcGkudjEuT3duS2V5TGltaXQibgoLT3duS2V5TGltaXQSKwoFY2F1c2UYASABKA4yHC5ub3ZhdHJhaWwuYXBpLnYxLkxpbWl0Q2F1c2USMgoOYWNjZXNzX3JldHVybnMYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wInkKDEVuZ2luZUNob2ljZRIRCgljaG9pY2VfaWQYASABKAkSKgoEa2luZBgCIAEoDjIcLm5vdmF0cmFpbC5hcGkudjEuQ2hvaWNlS2luZBIqCgdvdXRjb21lGAMgASgLMhkubm92YXRyYWlsLmFwaS52MS5PdXRjb21lImgKBlJ1bkVuZBIuCgZyZWFzb24YASABKA4yHi5ub3ZhdHJhaWwuYXBpLnYxLlJ1bkVuZFJlYXNvbhIuCgZjaG9pY2UYAiABKAsyHi5ub3ZhdHJhaWwuYXBpLnYxLkVuZ2luZUNob2ljZSIfCg1FbmRlZFNlZ21lbnRzEg4KBnBsYWNlcxgBIAMoBSrVBwoFQ2F1c2USFQoRQ0FVU0VfVU5TUEVDSUZJRUQQABIUChBDQVVTRV9OT19QUk9GSUxFEAESEwoPQ0FVU0VfTk9UX0ZPVU5EEAISGAoUQ0FVU0VfQVRURU1QVF9DTE9TRUQQAxIaChZDQVVTRV9LRVlfQUxSRUFEWV9VU0VEEAQSFQoRQ0FVU0VfU1RJTExfR09JTkcQBRIdChlDQVVTRV9LRVlfTk9UX0ZPUl9QUk9GSUxFEAYSDwoLQ0FVU0VfUVVPVEEQBxIYChRDQVVTRV9QTEFURk9STV9MSU1JVBAIEhYKEkNBVVNFX05PVF9BRE1JVFRFRBAJEhQKEENBVVNFX0FJX0ZBSUxVUkUQChIXChNDQVVTRV9MSU1JVF9SRUFDSEVEEAsSFQoRQ0FVU0VfS0VZX1JFRlVTRUQQDBIWChJDQVVTRV9BRFVMVF9ORUVERUQQDRIbChdDQVVTRV9MQURERVJfTk9UX1BBU1NFRBAOEhQKEENBVVNFX05PX1NIT1dJTkcQDxIRCg1DQVVTRV9OT19SVU5HEBASFwoTQ0FVU0VfQUxSRUFEWV9BU0tFRBAREhgKFENBVVNFX05PX09USEVSX1dPUkRTEBISFwoTQ0FVU0VfTk9fTU9SRV9XT1JEUxATEhcKE0NBVVNFX05PX1NVQk1JU1NJT04QFBIVChFDQVVTRV9OT1RfQ1VSUkVOVBAVEhMKD0NBVVNFX05PX0FDQ0VTUxAWEhYKEkNBVVNFX0FDQ09VTlRfR09ORRAXEh4KGkNBVVNFX0ZSRVNIX1NJR05fSU5fTkVFREVEEBgSGwoXQ0FVU0VfQ09ERV9OT1RfQUNDRVBURUQQGRIYChRDQVVTRV9BTFJFQURZX0VYSVNUUxAaEh4KGkNBVVNFX0NPVU5UUllfTk9UX0FDQ0VQVEVEEBsSFAoQQ0FVU0VfTk9fQ09OU0VOVBAcEhQKEENBVVNFX1BJTl9MT0NLRUQQHRIZChVDQVVTRV9QSU5fQUxSRUFEWV9TRVQQHhIQCgxDQVVTRV9OT19QSU4QHxIbChdDQVVTRV9WRVJTSU9OX05PVF9HSVZFThAgEhkKFUNBVVNFX1BBQ0tBR0VfVU5LTk9XThAhEhwKGENBVVNFX05PX0NVUlJFTlRfVkVSU0lPThAiEhYKEkNBVVNFX05PVF9TVUlUQUJMRRAjEhMKD0NBVVNFX1JVTl9FTkRFRBAkEhwKGENBVVNFX1NFR01FTlRTX05PVF9FTkRFRBAlEh0KGUNBVVNFX1NFR01FTlRfVU5BVkFJTEFCTEUQJiqIAQoKTGltaXRDYXVzZRIbChdMSU1JVF9DQVVTRV9VTlNQRUNJRklFRBAAEhUKEUxJTUlUX0NBVVNFX0xJTUlUEAESFAoQTElNSVRfQ0FVU0VfVElFUhACEhcKE0xJTUlUX0NBVVNFX0JBTEFOQ0UQAxIXChNMSU1JVF9DQVVTRV9QQVlNRU5UEAQq6wEKC0Nsb3NlUmVhc29uEhwKGENMT1NFX1JFQVNPTl9VTlNQRUNJRklFRBAAEhgKFENMT1NFX1JFQVNPTl9DT1JSRUNUEAESHwobQ0xPU0VfUkVBU09OX1NPTFVUSU9OX1NIT1dOEAISFQoRQ0xPU0VfUkVBU09OX0xFRlQQAxIaChZDTE9TRV9SRUFTT05fQUJBTkRPTkVEEAQSGgoWQ0xPU0VfUkVBU09OX1VOQ0hFQ0tFRBAFEh0KGUNMT1NFX1JFQVNPTl9OT1RfU1VJVEFCTEUQBhIVChFDTE9TRV9SRUFTT05fRE9ORRAHKnAKCkNob2ljZUtpbmQSGwoXQ0hPSUNFX0tJTkRfVU5TUEVDSUZJRUQQABIWChJDSE9JQ0VfS0lORF9MRVNTT04QARIUChBDSE9JQ0VfS0lORF9UQVNLEAISFwoTQ0hPSUNFX0tJTkRfTk9USElORxADKqYBCgxSdW5FbmRSZWFzb24SHgoaUlVOX0VORF9SRUFTT05fVU5TUEVDSUZJRUQQABIZChVSVU5fRU5EX1JFQVNPTl9QQVNTRUQQARIcChhSVU5fRU5EX1JFQVNPTl9VTkNIRUNLRUQQAhIfChtSVU5fRU5EX1JFQVNPTl9OT1RfU1VJVEFCTEUQAxIcChhSVU5fRU5EX1JFQVNPTl9BQkFORE9ORUQQBELDAQoUY29tLm5vdmF0cmFpbC5hcGkudjFCCkNhdXNlUHJvdG9QAVo9Z2l0aHViLmNvbS9hbHRub3ZhdHJhaWwvc3BlYy9jb250cmFjdHMvbm92YXRyYWlsL2FwaS92MTthcGl2MaICA05BWKoCEE5vdmF0cmFpbC5BcGkuVjHKAhBOb3ZhdHJhaWxcQXBpXFYx4gIcTm92YXRyYWlsXEFwaVxWMVxHUEJNZXRhZGF0YeoCEk5vdmF0cmFpbDo6QXBpOjpWMWIGcHJvdG8z", [file_google_protobuf_timestamp]);
 
 /**
  * Describes the message novatrail.api.v1.Refusal.
@@ -37,6 +38,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 +106,33 @@ 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.RunEndReason.
+ */
+export const RunEndReasonSchema = /*@__PURE__*/
+  enumDesc(file_novatrail_api_v1_cause, 4);
+
+/**
+ * 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);
+