@superbuilders/primer-tives 1.2.0 → 2.2.0

package/dist/client/index.js

@@ -3,6 +3,7 @@ import * as errors from "@superbuilders/errors";
 var ErrNetwork = errors.new("network");
 var ErrJsonParse = errors.new("json parse");
 var ErrUnsupportedPci = errors.new("unsupported pci");
+var ErrMissingRequiredPci = errors.new("missing required pci");
 var ErrInvalidAccessToken = errors.new("invalid access token");
 var ErrMalformedAccessToken = errors.new("malformed access token");
 var ErrTokenExpired = errors.new("access token expired");
@@ -12,16 +13,12 @@ var ErrTimeout = errors.new("timeout");
 var ErrForbidden = errors.new("forbidden");
 var ErrNotFound = errors.new("not found");
 var ErrConflict = errors.new("conflict");
-var ErrExternalAuthorityRequired = errors.new("external authority required");
 var ErrRateLimited = errors.new("rate limited");
 var ErrServiceUnavailable = errors.new("service unavailable");
 var ErrNotSerializable = errors.new("PrimerState is live in-memory state and must not be serialized or stored");
 var ErrInvalidSubmission = errors.new("invalid submission");
 var ErrInvalidSecretKey = errors.new("invalid secret key");
-var ErrStudentNotFound = errors.new("student not found");
-var ErrUnsupportedGrade = errors.new("unsupported grade");
-var ErrTimebackUnavailable = errors.new("timeback unavailable");
-var ErrNeedsHints = errors.new("student needs hints set before /advance");
+var ErrSdkUpgradeRequired = errors.new("sdk upgrade required");
 // src/contracts/content.ts
 function inlinesToPlainText(nodes) {
   const parts = [];
@@ -46,31 +43,44 @@ function blocksToPlainText(blocks) {
   }).join(`
 `);
 }
+// src/contracts/pci.ts
+var PCI_IDS = ["urn:primer:pci:fraction-input"];
+function isPciId(value) {
+  for (const id of PCI_IDS) {
+    if (id === value) {
+      return true;
+    }
+  }
+  return false;
+}
 // src/contracts/validation.ts
 import { z as z2 } from "zod";
 
 // src/contracts/pci-schemas.ts
 import { z } from "zod";
-var DivisionRemainderPropsSchema = z.object({
-  dividend: z.number(),
-  divisor: z.number()
-});
-var DivisionRemainderSubmissionSchema = z.object({
-  quotient: z.string(),
-  remainder: z.string()
-});
-var FractionOperandSchema = z.object({
-  numerator: z.number(),
-  denominator: z.number()
-});
-var FractionAdditionPropsSchema = z.object({
-  left: FractionOperandSchema,
-  right: FractionOperandSchema
-});
-var FractionAdditionSubmissionSchema = z.object({
-  numerator: z.string(),
-  denominator: z.string()
+var FractionInputPropsSchema = z.object({
+  form: z.enum(["whole", "proper", "improper", "mixed"]),
+  requireSimplified: z.boolean()
 });
+var FractionInputSubmissionSchema = z.discriminatedUnion("form", [
+  z.object({ form: z.literal("whole"), whole: z.string() }),
+  z.object({
+    form: z.literal("proper"),
+    numerator: z.string(),
+    denominator: z.string()
+  }),
+  z.object({
+    form: z.literal("improper"),
+    numerator: z.string(),
+    denominator: z.string()
+  }),
+  z.object({
+    form: z.literal("mixed"),
+    whole: z.string(),
+    numerator: z.string(),
+    denominator: z.string()
+  })
+]);
 
 // src/contracts/validation.ts
 var MatchPairSchema = z2.object({
@@ -97,15 +107,10 @@ var MatchSubmissionSchema = z2.object({
   type: z2.literal("match"),
   pairs: z2.array(MatchPairSchema)
 });
-var DivisionRemainderPciSubmissionSchema = z2.object({
-  type: z2.literal("portable-custom"),
-  pciId: z2.literal("urn:primer:pci:division-remainder"),
-  value: DivisionRemainderSubmissionSchema
-});
-var FractionAdditionPciSubmissionSchema = z2.object({
+var FractionInputPciSubmissionSchema = z2.object({
   type: z2.literal("portable-custom"),
-  pciId: z2.literal("urn:primer:pci:fraction-addition"),
-  value: FractionAdditionSubmissionSchema
+  pciId: z2.literal("urn:primer:pci:fraction-input"),
+  value: FractionInputSubmissionSchema
 });
 var RendererSubmissionSchema = z2.union([
   ChoiceSubmissionSchema,
@@ -113,8 +118,7 @@ var RendererSubmissionSchema = z2.union([
   ExtendedTextSubmissionSchema,
   OrderSubmissionSchema,
   MatchSubmissionSchema,
-  DivisionRemainderPciSubmissionSchema,
-  FractionAdditionPciSubmissionSchema
+  FractionInputPciSubmissionSchema
 ]);
 function duplicates(values, keyOf) {
   const seen = new Set;
@@ -166,10 +170,8 @@ function validateUsageBounds(choices, counts, side) {
 }
 function pciSubmissionSchema(pciId) {
   switch (pciId) {
-    case "urn:primer:pci:division-remainder":
-      return DivisionRemainderSubmissionSchema;
-    case "urn:primer:pci:fraction-addition":
-      return FractionAdditionSubmissionSchema;
+    case "urn:primer:pci:fraction-input":
+      return FractionInputSubmissionSchema;
   }
   const exhaustiveCheck = pciId;
   return exhaustiveCheck;
@@ -331,23 +333,29 @@ function validateSubmissionForInteraction(interaction, submission) {
 function submissionValidationMessage(result) {
   return result.issues.join("; ");
 }
+// src/subject.ts
+var SUBJECTS = ["math", "vocabulary", "science"];
 // src/client/create.ts
 import * as errors10 from "@superbuilders/errors";
 
 // src/client/transport.ts
 import * as errors2 from "@superbuilders/errors";
+
+// src/version.ts
+var SDK_VERSION = "2.2.0";
+var NPM_PACKAGE_URL = "https://www.npmjs.com/package/@superbuilders/primer-tives";
+
+// src/client/transport.ts
 var ADVANCE_PATH = "/api/v0/advance";
-function isAdvanceErrorBody(value) {
-  if (typeof value !== "object" || value === null) {
-    return false;
-  }
-  if ("error" in value && value.error !== undefined && typeof value.error !== "string") {
-    return false;
+function readStringField(value, key) {
+  if (!(key in value)) {
+    return;
   }
-  if ("detail" in value && value.detail !== undefined && typeof value.detail !== "string") {
-    return false;
+  const v = Reflect.get(value, key);
+  if (typeof v !== "string") {
+    return;
   }
-  return true;
+  return v;
 }
 function parseAdvanceErrorBody(body) {
   if (body.length === 0) {
@@ -359,13 +367,39 @@ function parseAdvanceErrorBody(body) {
   if (parsed.error) {
     return null;
   }
-  if (!isAdvanceErrorBody(parsed.data)) {
+  const raw = parsed.data;
+  if (typeof raw !== "object" || raw === null) {
     return null;
   }
-  return parsed.data;
+  const result = {};
+  const error = readStringField(raw, "error");
+  if (error !== undefined) {
+    result.error = error;
+  }
+  const detail = readStringField(raw, "detail");
+  if (detail !== undefined) {
+    result.detail = detail;
+  }
+  const minimumSdkVersion = readStringField(raw, "minimumSdkVersion");
+  if (minimumSdkVersion !== undefined) {
+    result.minimumSdkVersion = minimumSdkVersion;
+  }
+  const receivedSdkVersion = readStringField(raw, "receivedSdkVersion");
+  if (receivedSdkVersion !== undefined) {
+    result.receivedSdkVersion = receivedSdkVersion;
+  }
+  const upgradeUrl = readStringField(raw, "upgradeUrl");
+  if (upgradeUrl !== undefined) {
+    result.upgradeUrl = upgradeUrl;
+  }
+  return result;
 }
 function httpSentinel(status, body) {
   if (status === 400) {
+    const parsed = parseAdvanceErrorBody(body);
+    if (parsed?.error === "sdk_upgrade_required") {
+      return ErrSdkUpgradeRequired;
+    }
     return ErrBadRequest;
   }
   if (status === 401) {
@@ -384,9 +418,6 @@ function httpSentinel(status, body) {
   if (status === 409) {
     return ErrConflict;
   }
-  if (status === 412) {
-    return ErrNeedsHints;
-  }
   if (status === 429) {
     return ErrRateLimited;
   }
@@ -395,6 +426,29 @@ function httpSentinel(status, body) {
   }
   return ErrServerError;
 }
+function buildSdkUpgradeRequiredError(sentinel, text, logger) {
+  const parsed = parseAdvanceErrorBody(text);
+  if (parsed === null) {
+    logger.error("sdk upgrade required", {
+      receivedSdkVersion: null,
+      minimumSdkVersion: "<unknown>",
+      upgradeUrl: NPM_PACKAGE_URL
+    });
+    const message2 = `<missing> < <unknown>; bump @superbuilders/primer-tives at ${NPM_PACKAGE_URL}`;
+    return errors2.wrap(sentinel, message2);
+  }
+  const minimumSdkVersion = parsed.minimumSdkVersion === undefined ? "<unknown>" : parsed.minimumSdkVersion;
+  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("sdk upgrade required", {
+    receivedSdkVersion,
+    minimumSdkVersion,
+    upgradeUrl
+  });
+  const message = `${receivedDisplay} < ${minimumSdkVersion}; bump @superbuilders/primer-tives at ${upgradeUrl}`;
+  return errors2.wrap(sentinel, message);
+}
 function isAbortError(err) {
   if (err instanceof DOMException && err.name === "AbortError") {
     return true;
@@ -406,7 +460,7 @@ function isAbortError(err) {
 }
 function createTransport(tc) {
   const fetchFn = tc.fetch ? tc.fetch : globalThis.fetch;
-  const log = tc.log;
+  const logger = tc.logger;
   function transportSignal() {
     if (tc.abort) {
       return tc.abort.signal;
@@ -414,7 +468,7 @@ function createTransport(tc) {
     return;
   }
   async function transport(body) {
-    log?.debug("transport request", {
+    logger.debug("transport request", {
       intentKind: body.intent.kind,
       subject: body.subject
     });
@@ -423,7 +477,8 @@ function createTransport(tc) {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        Authorization: `Bearer ${tc.accessToken}`
+        Authorization: `Bearer ${tc.accessToken}`,
+        "X-Primer-SDK-Version": SDK_VERSION
       },
       body: JSON.stringify(body),
       signal: transportSignal()
@@ -434,12 +489,12 @@ function createTransport(tc) {
     });
     if (!fetchResult.ok) {
       if (isAbortError(fetchResult.error)) {
-        log?.error("transport timeout", {
+        logger.error("transport timeout", {
           intentKind: body.intent.kind
         });
         return { ok: false, error: errors2.wrap(ErrTimeout, fetchResult.error.message) };
       }
-      log?.error("transport network error", {
+      logger.error("transport network error", {
         error: fetchResult.error
       });
       return { ok: false, error: errors2.wrap(ErrNetwork, fetchResult.error.message) };
@@ -449,8 +504,11 @@ function createTransport(tc) {
       const text = await res.text().catch(function fallback() {
         return "";
       });
-      const sentinel = res.status === 422 ? ErrUnsupportedPci : httpSentinel(res.status, text);
-      log?.error("transport http error", {
+      const sentinel = httpSentinel(res.status, text);
+      if (errors2.is(sentinel, ErrSdkUpgradeRequired)) {
+        return { ok: false, error: buildSdkUpgradeRequiredError(sentinel, text, logger) };
+      }
+      logger.error("transport http error", {
         status: res.status
       });
       return { ok: false, error: errors2.wrap(sentinel, text) };
@@ -461,12 +519,12 @@ function createTransport(tc) {
       return { ok: false, error: err };
     });
     if (!jsonResult.ok) {
-      log?.error("transport json parse failed", {
+      logger.error("transport json parse failed", {
         error: jsonResult.error
       });
       return { ok: false, error: errors2.wrap(ErrJsonParse, jsonResult.error.message) };
     }
-    log?.debug("transport success", {
+    logger.debug("transport success", {
       intentKind: body.intent.kind
     });
     return { ok: true, data: jsonResult.data };
@@ -484,7 +542,7 @@ function poisonToJSON() {
 
 // src/client/choice-state.ts
 import * as errors3 from "@superbuilders/errors";
-function choiceState(ctx, stimulus, interaction, options, maxChoices, minChoices) {
+function choiceState(ctx, body, stimulus, interaction, options, maxChoices, minChoices) {
   let submitPending;
   let submitKey;
   let timeoutPending;
@@ -502,7 +560,7 @@ function choiceState(ctx, stimulus, interaction, options, maxChoices, minChoices
     }
     const validation = validateSubmissionForInteraction(interaction, submission);
     if (!validation.ok) {
-      ctx.log?.error("choice submit invalid", { selectedKeys, issues: validation.issues });
+      ctx.logger.error("choice submit invalid", { selectedKeys, issues: validation.issues });
       return Promise.resolve(ctx.errored(errors3.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", { kind: "interaction", submission }));
     }
     submitKey = key;
@@ -528,6 +586,7 @@ function choiceState(ctx, stimulus, interaction, options, maxChoices, minChoices
   return {
     phase: "interaction",
     kind: "choice",
+    body,
     stimulus,
     interaction,
     options,
@@ -541,7 +600,7 @@ function choiceState(ctx, stimulus, interaction, options, maxChoices, minChoices
 
 // src/client/extended-text-state.ts
 import * as errors4 from "@superbuilders/errors";
-function extendedTextState(ctx, stimulus, interaction) {
+function extendedTextState(ctx, body, stimulus, interaction) {
   if (interaction.cardinality === "single") {
     let submitText = function(value) {
       const submission = { type: "extended-text", values: [value] };
@@ -557,7 +616,7 @@ function extendedTextState(ctx, stimulus, interaction) {
       }
       const validation = validateSubmissionForInteraction(interaction, submission);
       if (!validation.ok) {
-        ctx.log?.error("extended-text submit invalid", { value, issues: validation.issues });
+        ctx.logger.error("extended-text submit invalid", { value, issues: validation.issues });
         return Promise.resolve(ctx.errored(errors4.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", { kind: "interaction", submission }));
       }
       submitKey2 = key;
@@ -586,6 +645,7 @@ function extendedTextState(ctx, stimulus, interaction) {
       phase: "interaction",
       kind: "extended-text",
       cardinality: "single",
+      body,
       stimulus,
       interaction,
       submitText,
@@ -611,7 +671,7 @@ function extendedTextState(ctx, stimulus, interaction) {
     }
     const validation = validateSubmissionForInteraction(multi, submission);
     if (!validation.ok) {
-      ctx.log?.error("extended-text submit invalid", { values, issues: validation.issues });
+      ctx.logger.error("extended-text submit invalid", { values, issues: validation.issues });
       return Promise.resolve(ctx.errored(errors4.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", { kind: "interaction", submission }));
     }
     submitKey = key;
@@ -638,6 +698,7 @@ function extendedTextState(ctx, stimulus, interaction) {
     phase: "interaction",
     kind: "extended-text",
     cardinality: "multiple",
+    body,
     stimulus,
     interaction: multi,
     maxStrings: multi.maxStrings,
@@ -649,10 +710,11 @@ function extendedTextState(ctx, stimulus, interaction) {
 }
 
 // src/client/feedback-state.ts
-function feedbackState(ctx, stimulus, interaction, submission, isCorrect, feedbackContent, review) {
+function feedbackState(ctx, body, stimulus, interaction, submission, isCorrect, feedbackContent, review) {
   let pending;
   return {
     phase: "feedback",
+    body,
     stimulus,
     interaction,
     submission,
@@ -672,7 +734,7 @@ function feedbackState(ctx, stimulus, interaction, submission, isCorrect, feedba
 
 // src/client/match-state.ts
 import * as errors5 from "@superbuilders/errors";
-function matchState(ctx, stimulus, interaction) {
+function matchState(ctx, body, stimulus, interaction) {
   let submitPending;
   let submitKey;
   let timeoutPending;
@@ -690,7 +752,7 @@ function matchState(ctx, stimulus, interaction) {
     }
     const validation = validateSubmissionForInteraction(interaction, submission);
     if (!validation.ok) {
-      ctx.log?.error("match submit invalid", { pairs, issues: validation.issues });
+      ctx.logger.error("match submit invalid", { pairs, issues: validation.issues });
       return Promise.resolve(ctx.errored(errors5.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", { kind: "interaction", submission }));
     }
     submitKey = key;
@@ -716,6 +778,7 @@ function matchState(ctx, stimulus, interaction) {
   return {
     phase: "interaction",
     kind: "match",
+    body,
     stimulus,
     interaction,
     sourceChoices: interaction.sourceChoices,
@@ -729,10 +792,11 @@ function matchState(ctx, stimulus, interaction) {
 }
 
 // src/client/observation-state.ts
-function observationState(ctx, stimulus) {
+function observationState(ctx, body, stimulus) {
   let pending;
   return {
     phase: "observation",
+    body,
     stimulus,
     advance: function advance() {
       if (pending) {
@@ -747,7 +811,7 @@ function observationState(ctx, stimulus) {
 
 // src/client/order-state.ts
 import * as errors6 from "@superbuilders/errors";
-function orderState(ctx, stimulus, interaction) {
+function orderState(ctx, body, stimulus, interaction) {
   let submitPending;
   let submitKey;
   let timeoutPending;
@@ -765,7 +829,7 @@ function orderState(ctx, stimulus, interaction) {
     }
     const validation = validateSubmissionForInteraction(interaction, submission);
     if (!validation.ok) {
-      ctx.log?.error("order submit invalid", { orderedKeys, issues: validation.issues });
+      ctx.logger.error("order submit invalid", { orderedKeys, issues: validation.issues });
       return Promise.resolve(ctx.errored(errors6.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", { kind: "interaction", submission }));
     }
     submitKey = key;
@@ -791,6 +855,7 @@ function orderState(ctx, stimulus, interaction) {
   return {
     phase: "interaction",
     kind: "order",
+    body,
     stimulus,
     interaction,
     choices: interaction.choices,
@@ -804,7 +869,7 @@ function orderState(ctx, stimulus, interaction) {
 
 // src/client/pci-state.ts
 import * as errors7 from "@superbuilders/errors";
-function pciInteractionState(ctx, stimulus, interaction) {
+function pciInteractionState(ctx, body, stimulus, interaction) {
   let submitPending;
   let submitKey;
   let timeoutPending;
@@ -821,7 +886,7 @@ function pciInteractionState(ctx, stimulus, interaction) {
       }
       return Promise.resolve(ctx.errored(errors7.wrap(ErrConflict, "cannot submit a different pci payload while submit is in flight"), "interaction", { kind: "interaction", submission }));
     }
-    ctx.log?.debug("pci submit", { pciId });
+    ctx.logger.debug("pci submit", { pciId });
     submitKey = key;
     submitPending = ctx.execute({ kind: "interaction", submission }, "interaction").finally(function clearPending() {
       submitPending = undefined;
@@ -837,7 +902,7 @@ function pciInteractionState(ctx, stimulus, interaction) {
     if (timeoutPending) {
       return timeoutPending;
     }
-    ctx.log?.debug("pci timeout", { pciId });
+    ctx.logger.debug("pci timeout", { pciId });
     timeoutPending = ctx.execute(intent, "timeout").finally(function clearPending() {
       timeoutPending = undefined;
     });
@@ -846,6 +911,7 @@ function pciInteractionState(ctx, stimulus, interaction) {
   return {
     phase: "interaction",
     kind: "portable-custom",
+    body,
     stimulus,
     interaction,
     pciId,
@@ -858,7 +924,7 @@ function pciInteractionState(ctx, stimulus, interaction) {
 
 // src/client/text-entry-state.ts
 import * as errors8 from "@superbuilders/errors";
-function textEntryState(ctx, stimulus, interaction) {
+function textEntryState(ctx, body, stimulus, interaction) {
   let submitPending;
   let submitKey;
   let timeoutPending;
@@ -876,7 +942,7 @@ function textEntryState(ctx, stimulus, interaction) {
     }
     const validation = validateSubmissionForInteraction(interaction, submission);
     if (!validation.ok) {
-      ctx.log?.error("text-entry submit invalid", { value, issues: validation.issues });
+      ctx.logger.error("text-entry submit invalid", { value, issues: validation.issues });
       return Promise.resolve(ctx.errored(errors8.wrap(ErrInvalidSubmission, submissionValidationMessage(validation)), "interaction", { kind: "interaction", submission }));
     }
     submitKey = key;
@@ -902,6 +968,7 @@ function textEntryState(ctx, stimulus, interaction) {
   return {
     phase: "interaction",
     kind: "text-entry",
+    body,
     stimulus,
     interaction,
     submitText,
@@ -917,7 +984,7 @@ var FATAL_SENTINELS = [
   ErrTokenExpired,
   ErrForbidden,
   ErrNotFound,
-  ErrNeedsHints,
+  ErrSdkUpgradeRequired,
   ErrUnsupportedPci
 ];
 function isFatalError(err) {
@@ -932,13 +999,24 @@ function isRetriableError(err) {
   return !errors9.is(err, ErrInvalidSubmission);
 }
 function makeSession(sc) {
-  const log = sc.log;
+  const logger = sc.logger;
   function resolve(result) {
     switch (result.outcome) {
       case "advanced":
-        return fromAdvanced(result.stimulus, result.interaction);
-      case "submitted":
-        return feedbackState(ctx, result.stimulus, result.interaction, result.submission, result.isCorrect, result.feedbackContent, result.review);
+        return fromAdvanced(result.frame.body, result.frame.stimulus, result.frame.interaction);
+      case "submitted": {
+        const interaction = result.frame.interaction;
+        if (interaction === null) {
+          logger.error("submitted result without interaction");
+          return {
+            phase: "fatal",
+            error: errors9.wrap(ErrBadRequest, "submitted result missing interaction"),
+            retriable: false,
+            toJSON: poisonToJSON
+          };
+        }
+        return feedbackState(ctx, result.frame.body, result.frame.stimulus, interaction, result.submission, result.isCorrect, result.feedbackContent, result.review);
+      }
       case "completed":
         return { phase: "completed", toJSON: poisonToJSON };
     }
@@ -952,13 +1030,13 @@ function makeSession(sc) {
       retriable,
       retry: function retry() {
         if (!retriable) {
-          log?.debug("retry ignored for non-retriable error", { failedPhase });
+          logger.debug("retry ignored for non-retriable error", { failedPhase });
           return Promise.resolve(state);
         }
         if (pending) {
           return pending;
         }
-        log?.debug("retrying from errored state", { failedPhase });
+        logger.debug("retrying from errored state", { failedPhase });
         pending = execute(intent, failedPhase);
         return pending;
       },
@@ -968,14 +1046,13 @@ function makeSession(sc) {
   }
   async function execute(intent, phase) {
     const body = {
-      supportedPcis: sc.supportedPcis,
-      intent,
-      subject: sc.subject
+      subject: sc.subject,
+      intent
     };
     const result = await sc.transport(body);
     if (!result.ok) {
       if (isFatalError(result.error)) {
-        log?.error("fatal transport error", { error: result.error, phase });
+        logger.error("fatal transport error", { error: result.error, phase });
         return { phase: "fatal", error: result.error, retriable: false, toJSON: poisonToJSON };
       }
       return errored(result.error, phase, intent);
@@ -990,13 +1067,13 @@ function makeSession(sc) {
     }
     return false;
   }
-  function fromAdvanced(stimulus, interaction) {
+  function fromAdvanced(body, stimulus, interaction) {
     if (interaction === null) {
-      return observationState(ctx, stimulus);
+      return observationState(ctx, body, stimulus);
     }
     if (interaction.type === "portable-custom") {
       if (!isPciSupported(interaction.pciId)) {
-        log?.error("unsupported pci in frame", { pciId: interaction.pciId });
+        logger.error("unsupported pci in frame", { pciId: interaction.pciId });
         return {
           phase: "fatal",
           error: errors9.wrap(ErrUnsupportedPci, `pci '${interaction.pciId}'`),
@@ -1005,28 +1082,59 @@ function makeSession(sc) {
         };
       }
     }
-    return pendingInteractionState(stimulus, interaction);
+    return pendingInteractionState(body, stimulus, interaction);
   }
-  function pendingInteractionState(stimulus, interaction) {
+  function pendingInteractionState(body, stimulus, interaction) {
     switch (interaction.type) {
       case "choice":
-        return choiceState(ctx, stimulus, interaction, interaction.options, interaction.maxChoices, interaction.minChoices);
+        return choiceState(ctx, body, stimulus, interaction, interaction.options, interaction.maxChoices, interaction.minChoices);
       case "text-entry":
-        return textEntryState(ctx, stimulus, interaction);
+        return textEntryState(ctx, body, stimulus, interaction);
       case "extended-text":
-        return extendedTextState(ctx, stimulus, interaction);
+        return extendedTextState(ctx, body, stimulus, interaction);
       case "order":
-        return orderState(ctx, stimulus, interaction);
+        return orderState(ctx, body, stimulus, interaction);
       case "match":
-        return matchState(ctx, stimulus, interaction);
+        return matchState(ctx, body, stimulus, interaction);
       case "portable-custom":
-        return pciInteractionState(ctx, stimulus, interaction);
+        return pciInteractionState(ctx, body, stimulus, interaction);
     }
   }
-  const ctx = { log, execute, errored };
+  const ctx = { logger, execute, errored };
   return { execute };
 }
 
+// src/subject-pcis.ts
+var REQUIRED_PCIS_BY_SUBJECT = {
+  math: ["urn:primer:pci:fraction-input"],
+  vocabulary: [],
+  science: []
+};
+function requiredPcisForSubject(subject) {
+  if (subject === "all") {
+    const all = [];
+    for (const s of SUBJECTS) {
+      for (const pci of REQUIRED_PCIS_BY_SUBJECT[s]) {
+        if (!all.includes(pci)) {
+          all.push(pci);
+        }
+      }
+    }
+    return all;
+  }
+  return REQUIRED_PCIS_BY_SUBJECT[subject];
+}
+function missingPcisForSubject(subject, provided) {
+  const required = requiredPcisForSubject(subject);
+  const missing = [];
+  for (const pci of required) {
+    if (provided === undefined || !provided.includes(pci)) {
+      missing.push(pci);
+    }
+  }
+  return missing;
+}
+
 // src/client/create.ts
 var ACCESS_TOKEN_PREFIX = "eyJ";
 function isMalformedJws(token) {
@@ -1037,26 +1145,35 @@ function isMalformedJws(token) {
   return dotCount !== 2;
 }
 function create(config) {
-  const log = config.logger;
+  const logger = config.logger;
+  let supportedPcis = [];
+  if (config.supportedPcis !== undefined) {
+    supportedPcis = config.supportedPcis;
+  }
+  const missingPcis = missingPcisForSubject(config.subject, supportedPcis);
+  if (missingPcis.length > 0) {
+    logger.error("renderer missing required pcis", { subject: config.subject, missingPcis });
+    throw errors10.wrap(ErrMissingRequiredPci, `subject '${config.subject}'`);
+  }
   if (isMalformedJws(config.accessToken)) {
-    log?.error("malformed access token", { prefix: ACCESS_TOKEN_PREFIX });
+    logger.error("malformed access token", { prefix: ACCESS_TOKEN_PREFIX });
     throw errors10.wrap(ErrMalformedAccessToken, `token must start with '${ACCESS_TOKEN_PREFIX}' and contain two dots`);
   }
   const transport = createTransport({
     accessToken: config.accessToken,
-    supportedPcis: config.supportedPcis,
+    subject: config.subject,
     origin: config.origin,
     fetch: config.fetch,
     abort: config.abort,
-    log
+    logger
   });
   let startPromise;
   async function doStart() {
-    log?.debug("start", { subject: config.subject });
+    logger.debug("start");
     const s = makeSession({
-      supportedPcis: config.supportedPcis,
       subject: config.subject,
-      log,
+      supportedPcis,
+      logger,
       transport
     });
     return s.execute({ kind: "observation" }, "observation");
@@ -1064,7 +1181,7 @@ function create(config) {
   return {
     start() {
       if (startPromise) {
-        log?.debug("start already called");
+        logger.debug("start already called");
         return startPromise;
       }
       startPromise = doStart();
@@ -1076,4 +1193,4 @@ export {
   create
 };
 
-//# debugId=EA813B14A6F0A81364756E2164756E21
+//# debugId=81BED1C3D30435C964756E2164756E21