@superbuilders/primer-tives 5.1.0 → 6.0.0

package/README.md

@@ -19,7 +19,7 @@ bun add @superbuilders/primer-tives
 
 ## Version
 
-The current SDK version is `5.1.0`.
+The current SDK version is `6.0.0`.
 
 ## Entrypoints
 
@@ -50,6 +50,7 @@ import {
 const options = {
 	publishableKey: "pk_...",
 	subject: "math",
+	mode: "drill",
 	supportedPcis: ["urn:primer:pci:fraction-input"],
 	logger
 } satisfies PrimerOptionsWithManagedAuth<"math", readonly ["urn:primer:pci:fraction-input"]>
@@ -57,6 +58,19 @@ const options = {
 let state = await start(options)
 ```
 
+Primer exposes drill and curriculum as separate product surfaces behind the same SDK state machine. Version 6 callers must pass `mode: "drill"` for practice drill progression or `mode: "curriculum"` for curriculum DAG progression. Older clients that omit mode continue to enter drill behavior on the server.
+
+```ts
+const options = {
+	publishableKey: "pk_...",
+	subject: "science",
+	mode: "curriculum",
+	logger
+} satisfies PrimerOptionsWithManagedAuth<"science">
+
+let state = await start(options)
+```
+
 If your application already has a learner access token, pass it directly. `start` uses that token for the learning runtime.
 
 ```ts
@@ -64,6 +78,7 @@ const options = {
 	publishableKey: "pk_...",
 	accessToken,
 	subject: "math",
+	mode: "drill",
 	supportedPcis: ["urn:primer:pci:fraction-input"],
 	logger
 } satisfies PrimerOptionsWithAccessToken<"math", readonly ["urn:primer:pci:fraction-input"]>
@@ -98,6 +113,7 @@ Vocabulary and science currently have no required PCI capabilities, so `supporte
 const options = {
 	publishableKey: "pk_...",
 	subject: "vocabulary",
+	mode: "drill",
 	logger
 } satisfies PrimerOptionsWithManagedAuth<"vocabulary">
 
@@ -109,6 +125,7 @@ Omitting `subject` means the SDK asks Primer for the all-subject runtime scope.
 ```ts
 const options = {
 	publishableKey: "pk_...",
+	mode: "drill",
 	supportedPcis: ["urn:primer:pci:fraction-input"],
 	logger
 } satisfies PrimerOptionsWithManagedAuth<undefined, readonly ["urn:primer:pci:fraction-input"]>
@@ -159,6 +176,7 @@ const options = {
 	publishableKey,
 	accessToken,
 	subject: "math",
+	mode: "drill",
 	supportedPcis: ["urn:primer:pci:fraction-input"],
 	logger
 } satisfies PrimerOptionsWithAccessToken<"math", readonly ["urn:primer:pci:fraction-input"]>
@@ -180,6 +198,7 @@ if (state.phase === "fatal") {
 type PrimerOptions<S extends Subject | undefined = undefined, Supported extends readonly PciId[] = []> = {
 	readonly publishableKey: string
 	readonly origin?: string
+	readonly mode: "drill" | "curriculum"
 	readonly subject?: S
 	readonly supportedPcis: subject-dependent
 	readonly fetch?: typeof globalThis.fetch
@@ -200,6 +219,7 @@ type PrimerOptionsWithManagedAuth<S, Supported> = PrimerOptions<S, Supported> &
 | --- | --- | --- |
 | `publishableKey` | Yes | Public key identifying the Primer frontend your runtime belongs to. |
 | `origin` | No | Primer origin. Defaults to `https://primerlearn.dev`. |
+| `mode` | Yes | Product surface. Use `"drill"` for practice drill progression or `"curriculum"` for curriculum DAG progression and generated support behavior. |
 | `accessToken` | Mode-dependent | Learner access token. When present, `start` uses access-token mode. When absent, `start` uses managed hosted-auth mode. |
 | `subject` | No | Public content scope: `"math"`, `"vocabulary"`, or `"science"`. Omitted means all-subject scope. |
 | `supportedPcis` | Subject-dependent | Renderer capabilities for Portable Custom Interactions. Required when the chosen scope can emit required PCIs. |
@@ -230,7 +250,7 @@ sessionStorage["primer:access-token:<publishableKey>"]
 
 This is intentionally zero config. There is no storage selector and no persistence flag. Managed-auth mode always uses `globalThis.sessionStorage`; if `sessionStorage` is unavailable, `start` returns `AuthUnavailableState`.
 
-The cache stores only the final Primer access token returned by hosted Timeback sign-in. OAuth transaction state, nonce, verifier, and callback validation state are not stored in browser storage; those remain server-managed by Primer.
+The cache stores only the final Primer access token returned by hosted sign-in. OAuth transaction state, nonce, verifier, and callback validation state are not stored in browser storage; those remain server-managed by Primer.
 
 Managed-auth startup behavior is:
 
@@ -246,8 +266,6 @@ Access-token mode bypasses this cache entirely. If `accessToken` is present in `
 
 The cached value is a bearer credential. Browser-only consumers get reload convenience from this default, but any script that can read the page can read the token. Host applications must maintain normal XSS protections and should use access-token mode if they need to own token storage themselves.
 
-The canonical managed sign-in endpoint is `/api/auth/timeback/start`. Legacy `/auth/timeback` URLs are not part of the PrimerTives 4.0.5 contract.
-
 ## Auth Semantics
 
 An access token is expected to be JWS-shaped: it starts with `eyJ` and contains exactly two dots. If a provided token does not match that shape, `start` returns `FatalState` with `ErrMalformedAccessToken`.
@@ -341,6 +359,7 @@ This fails at compile time because math can emit a required PCI:
 await start({
 	publishableKey,
 	subject: "math",
+	mode: "drill",
 	logger
 })
 ```
@@ -351,6 +370,7 @@ This passes:
 const options = {
 	publishableKey,
 	subject: "math",
+	mode: "drill",
 	supportedPcis: ["urn:primer:pci:fraction-input"],
 	logger
 } satisfies PrimerOptionsWithManagedAuth<"math", readonly ["urn:primer:pci:fraction-input"]>
@@ -806,7 +826,7 @@ if (state.phase === "interaction" && state.kind === "portable-custom") {
 ## `FeedbackState`
 
 ```ts
-type AssessmentOutcomeValue = "correct" | "incorrect" | "revisionRequested"
+type AssessmentOutcomeValue = "correct" | "incorrect"
 
 type AssessmentOutcome = {
 	cardinality: "single"
@@ -1433,6 +1453,7 @@ import { start, type PrimerOptionsWithManagedAuth } from "@superbuilders/primer-
 const options = {
 	publishableKey,
 	subject: "vocabulary",
+	mode: "drill",
 	logger
 } satisfies PrimerOptionsWithManagedAuth<"vocabulary">
 
@@ -1489,6 +1510,7 @@ const options = {
 	publishableKey: "pk_test",
 	accessToken: "eyJ.test.token",
 	subject: "vocabulary",
+	mode: "drill",
 	fetch: fetchMock,
 	logger
 } satisfies PrimerOptionsWithAccessToken<"vocabulary">

package/dist/client/extended-text-state.d.ts

@@ -3,8 +3,13 @@ import type { InteractionFeedback, Journey, PrimerState } from "./types";
 import type { ContentBlock } from "../contracts/content";
 import type { PciId } from "../contracts/pci";
 import type { RendererStimulus, StandardRendererInteraction } from "../contracts/types";
+interface ExtendedTextStateOptions {
+    readonly initialValue?: string;
+    readonly initialValues?: string[];
+    readonly nextSubmissionRole?: "revision";
+}
 declare function extendedTextState<Pcis extends PciId>(ctx: SessionContext<Pcis>, journey: Journey, body: ContentBlock[], stimulus: RendererStimulus | null, interaction: Extract<StandardRendererInteraction, {
     type: "extended-text";
-}>, feedback: InteractionFeedback | null): PrimerState<Pcis>;
+}>, feedback: InteractionFeedback | null, options?: ExtendedTextStateOptions): PrimerState<Pcis>;
 export { extendedTextState };
 //# sourceMappingURL=extended-text-state.d.ts.map

package/dist/client/extended-text-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extended-text-state.d.ts","sourceRoot":"","sources":["../../src/client/extended-text-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EACX,mBAAmB,EACnB,OAAO,EACP,WAAW,EACX,MAAM,0CAA0C,CAAA;AAKjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,KAAK,EACX,gBAAgB,EAChB,2BAA2B,EAC3B,MAAM,6CAA6C,CAAA;AAGpD,iBAAS,iBAAiB,CAAC,IAAI,SAAS,KAAK,EAC5C,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,OAAO,CAAC,2BAA2B,EAAE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,EAC5E,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAClC,WAAW,CAAC,IAAI,CAAC,CA2KnB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"extended-text-state.d.ts","sourceRoot":"","sources":["../../src/client/extended-text-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,oDAAoD,CAAA;AACpG,OAAO,KAAK,EACX,mBAAmB,EACnB,OAAO,EACP,WAAW,EACX,MAAM,0CAA0C,CAAA;AAKjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,KAAK,EAEX,gBAAgB,EAChB,2BAA2B,EAC3B,MAAM,6CAA6C,CAAA;AAGpD,UAAU,wBAAwB;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,UAAU,CAAA;CACxC;AAYD,iBAAS,iBAAiB,CAAC,IAAI,SAAS,KAAK,EAC5C,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,OAAO,CAAC,2BAA2B,EAAE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,EAC5E,QAAQ,EAAE,mBAAmB,GAAG,IAAI,EACpC,OAAO,GAAE,wBAA6B,GACpC,WAAW,CAAC,IAAI,CAAC,CAiLnB;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/client/feedback-state.d.ts

@@ -1,10 +1,10 @@
 import type { SessionContext } from "./session-context";
-import type { AssessmentOutcome, Journey, PrimerState } from "./types";
+import type { Journey, PrimerState } from "./types";
 import type { ContentBlock, ContentInline } from "../contracts/content";
 import type { PciId } from "../contracts/pci";
 import type { InteractionReview } from "../contracts/review";
 import type { RendererInteraction, RendererStimulus, RendererSubmission } from "../contracts/types";
-declare function submittedFeedbackState<Pcis extends PciId>(ctx: SessionContext<Pcis>, journey: Journey, body: ContentBlock[], stimulus: RendererStimulus | null, interaction: RendererInteraction<Pcis>, submission: RendererSubmission<Pcis>, assessmentOutcome: AssessmentOutcome, feedbackContent: ContentInline[], review: InteractionReview<Pcis> | null): PrimerState<Pcis>;
+declare function submittedFeedbackState<Pcis extends PciId>(ctx: SessionContext<Pcis>, journey: Journey, body: ContentBlock[], stimulus: RendererStimulus | null, interaction: RendererInteraction<Pcis>, submission: RendererSubmission<Pcis>, isCorrect: boolean, feedbackContent: ContentInline[], review: InteractionReview<Pcis> | null): PrimerState<Pcis>;
 declare function timedOutFeedbackState<Pcis extends PciId>(ctx: SessionContext<Pcis>, journey: Journey, body: ContentBlock[], stimulus: RendererStimulus | null, interaction: RendererInteraction<Pcis>, feedbackContent: ContentInline[]): PrimerState<Pcis>;
 export { submittedFeedbackState, timedOutFeedbackState };
 //# sourceMappingURL=feedback-state.d.ts.map

package/dist/client/feedback-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feedback-state.d.ts","sourceRoot":"","sources":["../../src/client/feedback-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EACX,iBAAiB,EACjB,OAAO,EACP,WAAW,EACX,MAAM,0CAA0C,CAAA;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAA;AAChG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAA;AACrF,OAAO,KAAK,EACX,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,6CAA6C,CAAA;AAapD,iBAAS,sBAAsB,CAAC,IAAI,SAAS,KAAK,EACjD,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC,EACtC,UAAU,EAAE,kBAAkB,CAAC,IAAI,CAAC,EACpC,iBAAiB,EAAE,iBAAiB,EACpC,eAAe,EAAE,aAAa,EAAE,EAChC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,IAAI,GACpC,WAAW,CAAC,IAAI,CAAC,CAenB;AAED,iBAAS,qBAAqB,CAAC,IAAI,SAAS,KAAK,EAChD,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC,EACtC,eAAe,EAAE,aAAa,EAAE,GAC9B,WAAW,CAAC,IAAI,CAAC,CAYnB;AAED,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAA"}
+{"version":3,"file":"feedback-state.d.ts","sourceRoot":"","sources":["../../src/client/feedback-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAA;AACxF,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAA;AAChG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAA;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAA;AACrF,OAAO,KAAK,EACX,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,6CAA6C,CAAA;AAapD,iBAAS,sBAAsB,CAAC,IAAI,SAAS,KAAK,EACjD,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC,EACtC,UAAU,EAAE,kBAAkB,CAAC,IAAI,CAAC,EACpC,SAAS,EAAE,OAAO,EAClB,eAAe,EAAE,aAAa,EAAE,EAChC,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAAG,IAAI,GACpC,WAAW,CAAC,IAAI,CAAC,CAenB;AAED,iBAAS,qBAAqB,CAAC,IAAI,SAAS,KAAK,EAChD,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,EACzB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,EAAE,EACpB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EACjC,WAAW,EAAE,mBAAmB,CAAC,IAAI,CAAC,EACtC,eAAe,EAAE,aAAa,EAAE,GAC9B,WAAW,CAAC,IAAI,CAAC,CAYnB;AAED,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,CAAA"}

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-export type { PrimerOptions, PrimerOptionsWithAccessToken, PrimerOptionsWithManagedAuth } from "./start";
+export type { AdvanceMode, PrimerOptions, PrimerOptionsWithAccessToken, PrimerOptionsWithManagedAuth } from "./start";
 export { start } from "./start";
-export type { AccessTokenStartState, AssessmentOutcome, AssessmentOutcomeValue, AuthConfigInvalidState, AuthUnavailableState, ChoiceState, CompletedState, ErroredState, ExtendedTextMultipleState, ExtendedTextSingleState, ExtendedTextState, FatalState, FeedbackKind, FeedbackState, InteractionFeedback, InteractionState, ManagedStartState, MatchState, NonRetriableErroredState, NonSerializable, ObservationState, OrderState, PciInteractionState, PciPendingRenderProps, PciRenderProps, PciSubmittedRenderProps, Journey, JourneyProgress, PrimerState, RetriableErroredState, RuntimeState, SignInFailedState, SignInRequiredState, SubmittedFeedbackState, TextEntryState, TimedOutFeedbackState } from "./types";
+export type { AccessTokenStartState, AuthConfigInvalidState, AuthUnavailableState, ChoiceState, CompletedState, ErroredState, ExtendedTextMultipleState, ExtendedTextSingleState, ExtendedTextState, FatalState, FeedbackKind, FeedbackState, InteractionFeedback, InteractionState, ManagedStartState, MatchState, NonRetriableErroredState, NonSerializable, ObservationState, OrderState, PciInteractionState, PciPendingRenderProps, PciRenderProps, PciSubmittedRenderProps, Journey, JourneyProgress, PrimerState, RetriableErroredState, RuntimeState, SignInFailedState, SignInRequiredState, SubmittedFeedbackState, TextEntryState, TimedOutFeedbackState } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,aAAa,EACb,4BAA4B,EAC5B,4BAA4B,EAC5B,MAAM,0CAA0C,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,0CAA0C,CAAA;AAEhE,YAAY,EACX,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,OAAO,EACP,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,MAAM,0CAA0C,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,WAAW,EACX,aAAa,EACb,4BAA4B,EAC5B,4BAA4B,EAC5B,MAAM,0CAA0C,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,0CAA0C,CAAA;AAEhE,YAAY,EACX,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,OAAO,EACP,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,MAAM,0CAA0C,CAAA"}

package/dist/client/index.js

@@ -7289,7 +7289,6 @@ var FORBIDDEN_JOURNEY_KEYS = new Set([
   "handle",
   "cursor",
   "delta",
-  "revision",
   "standard",
   "prerequisite",
   "theme",
@@ -7518,27 +7517,37 @@ function choiceState(ctx, journey, body, stimulus, interaction, options, maxChoi
 
 // src/client/extended-text-state.ts
 import * as errors6 from "@superbuilders/errors";
-function extendedTextState(ctx, journey, body, stimulus, interaction, feedback) {
+function extendedTextIntent(submission, nextSubmissionRole) {
+  if (nextSubmissionRole === "revision") {
+    return { kind: "interaction", submission, submissionRole: "revision" };
+  }
+  return { kind: "interaction", submission };
+}
+function extendedTextState(ctx, journey, body, stimulus, interaction, feedback, options = {}) {
   if (interaction.cardinality === "single") {
     let submitText = function(value) {
-      const submission = { type: "extended-text", values: [value] };
+      const submission = {
+        type: "extended-text",
+        values: [value]
+      };
+      const intent = extendedTextIntent(submission, options.nextSubmissionRole);
       const key = JSON.stringify(submission);
       if (timeoutPending2) {
-        return Promise.resolve(ctx.errored(errors6.wrap(ErrConflict, "cannot submit while timeout is in flight"), "interaction", { kind: "interaction", submission }));
+        return Promise.resolve(ctx.errored(errors6.wrap(ErrConflict, "cannot submit while timeout is in flight"), "interaction", intent));
       }
       if (submitPending2) {
         if (submitKey2 === key) {
           return submitPending2;
         }
-        return Promise.resolve(ctx.errored(errors6.wrap(ErrConflict, "cannot submit a different extended-text payload while submit is in flight"), "interaction", { kind: "interaction", submission }));
+        return Promise.resolve(ctx.errored(errors6.wrap(ErrConflict, "cannot submit a different extended-text payload while submit is in flight"), "interaction", intent));
       }
       const validation = validateSubmissionForInteraction(interaction, submission);
       if (!validation.ok) {
         ctx.logger.error({ value, issues: validation.issues }, "extended-text submit invalid");
-        return Promise.resolve(ctx.errored(errors6.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", { kind: "interaction", submission }));
+        return Promise.resolve(ctx.errored(errors6.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", intent));
       }
       submitKey2 = key;
-      submitPending2 = ctx.execute({ kind: "interaction", submission }, "interaction").finally(function clearPending() {
+      submitPending2 = ctx.execute(intent, "interaction").finally(function clearPending() {
         submitPending2 = undefined;
         submitKey2 = undefined;
       });
@@ -7568,6 +7577,7 @@ function extendedTextState(ctx, journey, body, stimulus, interaction, feedback)
       stimulus,
       interaction,
       feedback,
+      initialValue: options.initialValue,
       submitText,
       timeout: timeout2,
       toJSON: poisonToJSON
@@ -7578,24 +7588,28 @@ function extendedTextState(ctx, journey, body, stimulus, interaction, feedback)
   let submitKey;
   let timeoutPending;
   function submitTexts(values) {
-    const submission = { type: "extended-text", values };
+    const submission = {
+      type: "extended-text",
+      values
+    };
+    const intent = extendedTextIntent(submission, options.nextSubmissionRole);
     const key = JSON.stringify(submission);
     if (timeoutPending) {
-      return Promise.resolve(ctx.errored(errors6.wrap(ErrConflict, "cannot submit while timeout is in flight"), "interaction", { kind: "interaction", submission }));
+      return Promise.resolve(ctx.errored(errors6.wrap(ErrConflict, "cannot submit while timeout is in flight"), "interaction", intent));
     }
     if (submitPending) {
       if (submitKey === key) {
         return submitPending;
       }
-      return Promise.resolve(ctx.errored(errors6.wrap(ErrConflict, "cannot submit a different extended-text payload while submit is in flight"), "interaction", { kind: "interaction", submission }));
+      return Promise.resolve(ctx.errored(errors6.wrap(ErrConflict, "cannot submit a different extended-text payload while submit is in flight"), "interaction", intent));
     }
     const validation = validateSubmissionForInteraction(multi, submission);
     if (!validation.ok) {
       ctx.logger.error({ values, issues: validation.issues }, "extended-text submit invalid");
-      return Promise.resolve(ctx.errored(errors6.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", { kind: "interaction", submission }));
+      return Promise.resolve(ctx.errored(errors6.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", intent));
     }
     submitKey = key;
-    submitPending = ctx.execute({ kind: "interaction", submission }, "interaction").finally(function clearPending() {
+    submitPending = ctx.execute(intent, "interaction").finally(function clearPending() {
       submitPending = undefined;
       submitKey = undefined;
     });
@@ -7623,6 +7637,7 @@ function extendedTextState(ctx, journey, body, stimulus, interaction, feedback)
     stimulus,
     interaction: multi,
     feedback,
+    initialValues: options.initialValues,
     maxStrings: multi.maxStrings,
     minStrings: multi.minStrings,
     submitTexts,
@@ -7642,7 +7657,7 @@ function createAdvance(ctx) {
     return pending;
   };
 }
-function submittedFeedbackState(ctx, journey, body, stimulus, interaction, submission, assessmentOutcome, feedbackContent, review) {
+function submittedFeedbackState(ctx, journey, body, stimulus, interaction, submission, isCorrect, feedbackContent, review) {
   return {
     phase: "feedback",
     feedbackKind: "submitted",
@@ -7651,7 +7666,7 @@ function submittedFeedbackState(ctx, journey, body, stimulus, interaction, submi
     stimulus,
     interaction,
     submission,
-    assessmentOutcome,
+    isCorrect,
     feedbackContent,
     review,
     advance: createAdvance(ctx),
@@ -7871,29 +7886,39 @@ function pciInteractionState(ctx, journey, body, stimulus, interaction, feedback
 
 // src/client/text-entry-state.ts
 import * as errors10 from "@superbuilders/errors";
-function textEntryState(ctx, journey, body, stimulus, interaction, feedback) {
+function textEntryIntent(submission, nextSubmissionRole) {
+  if (nextSubmissionRole === "revision") {
+    return { kind: "interaction", submission, submissionRole: "revision" };
+  }
+  return { kind: "interaction", submission };
+}
+function textEntryState(ctx, journey, body, stimulus, interaction, feedback, options = {}) {
   let submitPending;
   let submitKey;
   let timeoutPending;
   function submitText(value) {
-    const submission = { type: "text-entry", value };
+    const submission = {
+      type: "text-entry",
+      value
+    };
+    const intent = textEntryIntent(submission, options.nextSubmissionRole);
     const key = JSON.stringify(submission);
     if (timeoutPending) {
-      return Promise.resolve(ctx.errored(errors10.wrap(ErrConflict, "cannot submit while timeout is in flight"), "interaction", { kind: "interaction", submission }));
+      return Promise.resolve(ctx.errored(errors10.wrap(ErrConflict, "cannot submit while timeout is in flight"), "interaction", intent));
     }
     if (submitPending) {
       if (submitKey === key) {
         return submitPending;
       }
-      return Promise.resolve(ctx.errored(errors10.wrap(ErrConflict, "cannot submit a different text payload while submit is in flight"), "interaction", { kind: "interaction", submission }));
+      return Promise.resolve(ctx.errored(errors10.wrap(ErrConflict, "cannot submit a different text payload while submit is in flight"), "interaction", intent));
     }
     const validation = validateSubmissionForInteraction(interaction, submission);
     if (!validation.ok) {
       ctx.logger.error({ value, issues: validation.issues }, "text-entry submit invalid");
-      return Promise.resolve(ctx.errored(errors10.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", { kind: "interaction", submission }));
+      return Promise.resolve(ctx.errored(errors10.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", intent));
     }
     submitKey = key;
-    submitPending = ctx.execute({ kind: "interaction", submission }, "interaction").finally(function clearPending() {
+    submitPending = ctx.execute(intent, "interaction").finally(function clearPending() {
       submitPending = undefined;
       submitKey = undefined;
     });
@@ -7920,6 +7945,7 @@ function textEntryState(ctx, journey, body, stimulus, interaction, feedback) {
     stimulus,
     interaction,
     feedback,
+    initialValue: options.initialValue,
     submitText,
     timeout,
     toJSON: poisonToJSON
@@ -7955,11 +7981,29 @@ function isRetriableError(err) {
 function makeSession(sc) {
   const logger = sc.logger;
   let latestJourney = ONBOARDING_JOURNEY;
-  function resolve(result) {
+  function advancedPreservedSubmission(result, intent) {
+    if (result.outcome !== "advanced") {
+      return;
+    }
+    if (result.frame.feedback === null) {
+      return;
+    }
+    if (intent.kind !== "interaction") {
+      return;
+    }
+    if (intent.submission.type === "text-entry" || intent.submission.type === "extended-text") {
+      return intent.submission;
+    }
+    return;
+  }
+  function resolve(result, intent) {
     latestJourney = result.journey;
     switch (result.outcome) {
-      case "advanced":
-        return fromAdvanced(result.journey, result.frame.body, result.frame.stimulus, result.frame.interaction, result.frame.feedback);
+      case "advanced": {
+        const preservedSubmission = advancedPreservedSubmission(result, intent);
+        const nextSubmissionRole = preservedSubmission === undefined ? undefined : "revision";
+        return fromAdvanced(result.journey, result.frame.body, result.frame.stimulus, result.frame.interaction, result.frame.feedback, preservedSubmission, nextSubmissionRole);
+      }
       case "submitted": {
         const interaction = result.frame.interaction;
         if (interaction === null) {
@@ -7972,14 +8016,7 @@ function makeSession(sc) {
             toJSON: poisonToJSON
           };
         }
-        if (result.assessmentOutcome.value === "revisionRequested") {
-          const feedback = {
-            assessmentOutcome: result.assessmentOutcome,
-            feedbackContent: result.feedbackContent
-          };
-          return fromAdvanced(result.journey, result.frame.body, result.frame.stimulus, interaction, feedback);
-        }
-        return submittedFeedbackState(ctx, result.journey, result.frame.body, result.frame.stimulus, interaction, result.submission, result.assessmentOutcome, result.feedbackContent, result.review);
+        return submittedFeedbackState(ctx, result.journey, result.frame.body, result.frame.stimulus, interaction, result.submission, result.isCorrect, result.feedbackContent, result.review);
       }
       case "timedOut": {
         const interaction = result.frame.interaction;
@@ -8032,10 +8069,12 @@ function makeSession(sc) {
     logger.debug({
       phase,
       intentKind: intent.kind,
-      subject: sc.subject
+      subject: sc.subject,
+      mode: sc.mode
     }, "session execute");
     const body = {
       subject: sc.subject,
+      mode: sc.mode,
       intent
     };
     const result = await sc.transport(body);
@@ -8065,7 +8104,7 @@ function makeSession(sc) {
       }, "retriable transport error");
       return errored(result.error, phase, intent);
     }
-    const next = resolve(result.data);
+    const next = resolve(result.data, intent);
     logger.debug({
       phase,
       intentKind: intent.kind,
@@ -8082,7 +8121,7 @@ function makeSession(sc) {
     }
     return false;
   }
-  function fromAdvanced(journey, body, stimulus, interaction, feedback) {
+  function fromAdvanced(journey, body, stimulus, interaction, feedback, preservedSubmission, nextSubmissionRole) {
     if (interaction === null) {
       return observationState(ctx, journey, body, stimulus);
     }
@@ -8098,9 +8137,9 @@ function makeSession(sc) {
         };
       }
     }
-    return pendingInteractionState(journey, body, stimulus, interaction, feedback);
+    return pendingInteractionState(journey, body, stimulus, interaction, feedback, preservedSubmission, nextSubmissionRole);
   }
-  function extendedTextInteractionState(journey, body, stimulus, interaction, feedback) {
+  function extendedTextInteractionState(journey, body, stimulus, interaction, feedback, preservedSubmission, nextSubmissionRole) {
     if (!("cardinality" in interaction)) {
       logger.error("extended-text interaction is unsupported");
       return {
@@ -8112,16 +8151,39 @@ function makeSession(sc) {
       };
     }
     const extendedInteraction = interaction;
-    return extendedTextState(ctx, journey, body, stimulus, extendedInteraction, feedback);
+    if (preservedSubmission?.type === "extended-text") {
+      if (extendedInteraction.cardinality === "single") {
+        const [initialValue] = preservedSubmission.values;
+        return extendedTextState(ctx, journey, body, stimulus, extendedInteraction, feedback, {
+          initialValue,
+          nextSubmissionRole
+        });
+      }
+      return extendedTextState(ctx, journey, body, stimulus, extendedInteraction, feedback, {
+        initialValues: preservedSubmission.values,
+        nextSubmissionRole
+      });
+    }
+    return extendedTextState(ctx, journey, body, stimulus, extendedInteraction, feedback, {
+      nextSubmissionRole
+    });
   }
-  function pendingInteractionState(journey, body, stimulus, interaction, feedback) {
+  function pendingInteractionState(journey, body, stimulus, interaction, feedback, preservedSubmission, nextSubmissionRole) {
     switch (interaction.type) {
       case "choice":
         return choiceState(ctx, journey, body, stimulus, interaction, interaction.options, interaction.maxChoices, interaction.minChoices, feedback);
       case "text-entry":
-        return textEntryState(ctx, journey, body, stimulus, interaction, feedback);
+        if (preservedSubmission?.type === "text-entry") {
+          return textEntryState(ctx, journey, body, stimulus, interaction, feedback, {
+            initialValue: preservedSubmission.value,
+            nextSubmissionRole
+          });
+        }
+        return textEntryState(ctx, journey, body, stimulus, interaction, feedback, {
+          nextSubmissionRole
+        });
       case "extended-text":
-        return extendedTextInteractionState(journey, body, stimulus, interaction, feedback);
+        return extendedTextInteractionState(journey, body, stimulus, interaction, feedback, preservedSubmission, nextSubmissionRole);
       case "order":
         return orderState(ctx, journey, body, stimulus, interaction, feedback);
       case "match":
@@ -8138,11 +8200,21 @@ function makeSession(sc) {
 import * as errors12 from "@superbuilders/errors";
 
 // src/version.ts
-var SDK_VERSION = "5.1.0";
+var SDK_VERSION = "6.0.0";
 var NPM_PACKAGE_URL = "https://www.npmjs.com/package/@superbuilders/primer-tives";
 
 // src/client/transport.ts
 var ADVANCE_PATH = "/api/v0/advance";
+function readNumberField(value, key) {
+  if (!(key in value)) {
+    return;
+  }
+  const v = Reflect.get(value, key);
+  if (typeof v !== "number") {
+    return;
+  }
+  return v;
+}
 function readStringField(value, key) {
   if (!(key in value)) {
     return;
@@ -8176,9 +8248,9 @@ function parseAdvanceErrorBody(body) {
   if (detail !== undefined) {
     result.detail = detail;
   }
-  const minimumSdkVersion = readStringField(raw, "minimumSdkVersion");
-  if (minimumSdkVersion !== undefined) {
-    result.minimumSdkVersion = minimumSdkVersion;
+  const minimumSdkMajor = readNumberField(raw, "minimumSdkMajor");
+  if (minimumSdkMajor !== undefined) {
+    result.minimumSdkMajor = minimumSdkMajor;
   }
   const receivedSdkVersion = readStringField(raw, "receivedSdkVersion");
   if (receivedSdkVersion !== undefined) {
@@ -8251,22 +8323,24 @@ function buildSdkUpgradeRequiredError(sentinel, text, logger) {
   if (parsed === null) {
     logger.error({
       receivedSdkVersion: null,
-      minimumSdkVersion: "<unknown>",
+      minimumSdkMajor: "<unknown>",
       upgradeUrl: NPM_PACKAGE_URL
     }, "sdk upgrade required");
-    const message2 = `<missing> < <unknown>; bump @superbuilders/primer-tives at ${NPM_PACKAGE_URL}`;
+    const message2 = `major < <unknown>; bump @superbuilders/primer-tives at ${NPM_PACKAGE_URL}`;
     return errors12.wrap(sentinel, message2);
   }
-  const minimumSdkVersion = parsed.minimumSdkVersion === undefined ? "<unknown>" : parsed.minimumSdkVersion;
+  let minimumSdkMajor = "<unknown>";
+  if (parsed.minimumSdkMajor !== undefined) {
+    minimumSdkMajor = String(parsed.minimumSdkMajor);
+  }
   const receivedSdkVersion = parsed.receivedSdkVersion === undefined ? null : parsed.receivedSdkVersion;
-  const receivedDisplay = receivedSdkVersion === null ? "<missing>" : receivedSdkVersion;
   const upgradeUrl = parsed.upgradeUrl === undefined ? NPM_PACKAGE_URL : parsed.upgradeUrl;
   logger.error({
     receivedSdkVersion,
-    minimumSdkVersion,
+    minimumSdkMajor,
     upgradeUrl
   }, "sdk upgrade required");
-  const message = `${receivedDisplay} < ${minimumSdkVersion}; bump @superbuilders/primer-tives at ${upgradeUrl}`;
+  const message = `major < ${minimumSdkMajor}; bump @superbuilders/primer-tives at ${upgradeUrl}`;
   return errors12.wrap(sentinel, message);
 }
 function isAbortError(err) {
@@ -8291,7 +8365,8 @@ function createTransport(tc) {
   async function transport(body) {
     logger.debug({
       intentKind: body.intent.kind,
-      subject: body.subject
+      subject: body.subject,
+      mode: body.mode
     }, "transport request");
     const fetchResult = await fetchFn(advanceUrl, {
       method: "POST",
@@ -8403,6 +8478,7 @@ async function startRuntime(config, resolved) {
     accessToken: resolved.accessToken,
     publishableKey: config.publishableKey,
     subject: config.subject,
+    mode: config.mode,
     origin: config.origin,
     fetch: config.fetch,
     abort: config.abort,
@@ -8410,6 +8486,7 @@ async function startRuntime(config, resolved) {
   });
   const session = makeSession({
     subject: config.subject,
+    mode: config.mode,
     supportedPcis: config.supportedPcis,
     logger: config.logger,
     transport,
@@ -8462,6 +8539,7 @@ async function start(options) {
     publishableKey: options.publishableKey,
     origin,
     authOrigin: primerAuthOrigin(options.authOrigin, origin),
+    mode: options.mode,
     fetch: options.fetch,
     abort: options.abort,
     logger,
@@ -8495,4 +8573,4 @@ export {
   start
 };
 
-//# debugId=5A8CDF1A8AF453E464756E2164756E21
+//# debugId=E581CF63700F9E9F64756E2164756E21