@pie-players/pie-assessment-toolkit 0.2.5 → 0.2.9

package/README.md

@@ -32,8 +32,15 @@ player.toolCoordinator = toolCoordinator;
 const toolkitCoordinator = new ToolkitCoordinator({
   assessmentId: 'my-assessment',
   tools: {
-    tts: { enabled: true },
-    answerEliminator: { enabled: true }
+    providers: {
+      tts: { enabled: true, backend: 'browser' },
+      calculator: { enabled: true, provider: 'desmos' }
+    },
+    placement: {
+      section: ['calculator', 'graph', 'periodicTable', 'protractor', 'lineReader', 'ruler'],
+      item: ['calculator', 'textToSpeech', 'answerEliminator'],
+      passage: ['textToSpeech']
+    }
   }
 });
 
@@ -76,8 +83,15 @@ import { ToolkitCoordinator } from '@pie-players/pie-assessment-toolkit';
 const coordinator = new ToolkitCoordinator({
   assessmentId: 'demo-assessment',
   tools: {
-    tts: { enabled: true, defaultVoice: 'en-US' },
-    answerEliminator: { enabled: true }
+    providers: {
+      tts: { enabled: true, backend: 'browser', defaultVoice: 'en-US' },
+      calculator: { enabled: true, provider: 'desmos' }
+    },
+    placement: {
+      section: ['calculator', 'graph', 'periodicTable', 'protractor', 'lineReader', 'ruler'],
+      item: ['calculator', 'textToSpeech', 'answerEliminator'],
+      passage: ['textToSpeech']
+    }
   },
   accessibility: {
     catalogs: assessment.accessibilityCatalogs || [],
@@ -122,18 +136,61 @@ player.toolCoordinator = toolCoordinator;
 // ...
 ```
 
-## Tool Architecture: Item-Level vs Floating Tools
+## Tool Configuration Model
+
+The toolkit uses one canonical `tools` model with three concerns:
+
+- `policy`: allow/block constraints (global gates)
+- `placement`: where tools appear (`assessment`, `section`, `item`, `passage`, `rubric`, plus custom registered levels)
+- `providers`: provider/runtime options (calculator, tts, etc.)
+
+Example:
+
+```typescript
+tools: {
+  policy: {
+    allowed: ['calculator', 'textToSpeech', 'answerEliminator', 'graph', 'periodicTable'],
+    blocked: ['graph']
+  },
+  placement: {
+    assessment: [],
+    section: ['calculator', 'graph', 'periodicTable', 'protractor', 'lineReader', 'ruler'],
+    item: ['calculator', 'textToSpeech', 'answerEliminator'],
+    passage: ['textToSpeech'],
+    rubric: []
+  },
+  providers: {
+    calculator: { provider: 'desmos', authFetcher: async () => ({ apiKey: '...' }) },
+    tts: { enabled: true, backend: 'browser', defaultVoice: 'en-US' }
+  }
+}
+```
+
+### Scope and Lifecycle
+
+The runtime still distinguishes between contextual (`item`/`passage`) and section-wide tools:
+
+Tool instances use structured IDs so scope is explicit:
+
+```text
+<toolId>:<scopeLevel>:<scopeId>[:inline]
+```
 
-The toolkit distinguishes between two fundamentally different categories of tools based on their scope and lifecycle:
+Examples:
+- `calculator:section:section-1`
+- `calculator:item:item-42`
+- `textToSpeech:passage:passage-1`
+- `highlighter:rubric:rubric-3`
 
-### Item-Level Tools (`tools` configuration)
+### Item-Level Tools (`tools.placement.item`)
 
 Tools that operate **within the context of a specific question/item**:
 
 ```typescript
 tools: {
-  tts: { enabled: true },           // Reads this question's text
-  answerEliminator: { enabled: true } // Strikes through this item's choices
+  placement: {
+    item: ['calculator', 'textToSpeech', 'answerEliminator']
+  }
 }
 ```
 
@@ -152,24 +209,22 @@ tools: {
 **Example Use Case:**
 A student uses answer eliminator on Question 3 to cross out choices B and D. When they navigate to Question 4, they see fresh, uneliminated choices. When they return to Question 3, their eliminations are restored.
 
-### Section-Level Floating Tools (`floatingTools` configuration)
+### Section-Level Tools (`tools.placement.section`)
 
 Tools that **float above the entire assessment** and persist across questions:
 
 ```typescript
-floatingTools: {
-  calculator: {
-    enabled: true,
-    provider: 'desmos',
-    authFetcher: async () => { /* ... */ }
+tools: {
+  placement: {
+    section: ['calculator', 'graph', 'periodicTable', 'protractor', 'lineReader', 'ruler', 'colorScheme']
   },
-  graph: { enabled: true },
-  periodicTable: { enabled: true },
-  protractor: { enabled: true },
-  ruler: { enabled: true },
-  lineReader: { enabled: true },
-  magnifier: { enabled: true },
-  colorScheme: { enabled: true }
+  providers: {
+    calculator: {
+      enabled: true,
+      provider: 'desmos',
+      authFetcher: async () => { /* ... */ }
+    }
+  }
 }
 ```
 
@@ -215,27 +270,24 @@ Complete example showing both types:
 const coordinator = new ToolkitCoordinator({
   assessmentId: 'math-exam',
   tools: {
-    // Item-level: Different for each question
-    tts: { enabled: true },
-    answerEliminator: { enabled: true }
-  },
-  floatingTools: {
-    // Section-level: Shared across all questions
-    calculator: {
-      enabled: true,
-      provider: 'desmos',
-      authFetcher: async () => {
-        const response = await fetch('/api/tools/desmos/auth');
-        return response.json();
-      }
+    placement: {
+      // Contextual placement
+      item: ['calculator', 'textToSpeech', 'answerEliminator'],
+      passage: ['textToSpeech'],
+      // Section-level utilities
+      section: ['calculator', 'graph', 'periodicTable', 'protractor', 'lineReader', 'ruler', 'colorScheme']
     },
-    graph: { enabled: true },
-    periodicTable: { enabled: true },
-    protractor: { enabled: true },
-    ruler: { enabled: true },
-    lineReader: { enabled: true },
-    magnifier: { enabled: true },
-    colorScheme: { enabled: true }
+    providers: {
+      calculator: {
+        enabled: true,
+        provider: 'desmos',
+        authFetcher: async () => {
+          const response = await fetch('/api/tools/desmos/auth');
+          return response.json();
+        }
+      },
+      tts: { enabled: true, backend: 'browser' }
+    }
   },
   accessibility: {
     catalogs: [],
@@ -252,24 +304,50 @@ For most use cases, simply enable all available tools:
 const coordinator = new ToolkitCoordinator({
   assessmentId: 'my-assessment',
   tools: {
-    tts: { enabled: true },
-    answerEliminator: { enabled: true }
-  },
-  floatingTools: {
-    calculator: { enabled: true, provider: 'desmos' },
-    graph: { enabled: true },
-    periodicTable: { enabled: true },
-    protractor: { enabled: true },
-    ruler: { enabled: true },
-    lineReader: { enabled: true },
-    magnifier: { enabled: true },
-    colorScheme: { enabled: true }
+    placement: {
+      section: ['calculator', 'graph', 'periodicTable', 'protractor', 'lineReader', 'ruler'],
+      item: ['calculator', 'textToSpeech', 'answerEliminator'],
+      passage: ['textToSpeech']
+    },
+    providers: {
+      calculator: { enabled: true, provider: 'desmos' },
+      tts: { enabled: true, backend: 'browser' }
+    }
   }
 });
 ```
 
 The ToolkitCoordinator handles all internal complexity (service initialization, provider management, state coordination). The only special configuration is `authFetcher` for Desmos calculator (optional - falls back to local calculator if not provided).
 
+## Test Attempt Session Adapter (pie backend)
+
+The toolkit exposes a canonical `TestAttemptSession` runtime and a deterministic adapter for pie backend activity payloads from `../../kds/pie-api-aws`.
+
+```typescript
+import {
+  mapActivityToTestAttemptSession,
+  toItemSessionsRecord,
+  buildActivitySessionPatchFromTestAttemptSession
+} from "@pie-players/pie-assessment-toolkit";
+
+const testAttemptSession = mapActivityToTestAttemptSession({
+  activityDefinition,
+  activitySession
+});
+
+// Use in section-player handoff (same item session shape as item players expect)
+const itemSessions = toItemSessionsRecord(testAttemptSession);
+
+// Host-owned backend persistence payload
+const patch = buildActivitySessionPatchFromTestAttemptSession(testAttemptSession);
+```
+
+### Integration Boundary
+
+- `@pie-players/pie-section-player` stays backend-agnostic and emits session/state changes.
+- Host applications own backend I/O to pie backend (`../../kds/pie-api-aws`).
+- Hosts decide persistence policy (immediate, debounced, checkpoint, submit).
+
 ## Implementation Status
 
 ### ✅ Core Infrastructure
@@ -315,18 +393,30 @@ The toolkit integrates seamlessly with the **PIE Section Player**:
 export interface ToolkitCoordinatorConfig {
   assessmentId: string;  // Required: unique assessment identifier
   tools?: {
-    tts?: {
-      enabled?: boolean;
-      defaultVoice?: string;
-      rate?: number;
-      provider?: 'browser' | 'server';
+    policy?: {
+      allowed?: string[];
+      blocked?: string[];
     };
-    answerEliminator?: {
-      enabled?: boolean;
-      strategy?: 'strikethrough' | 'hide';
+    placement?: {
+      assessment?: string[];
+      section?: string[];
+      item?: string[];
+      passage?: string[];
+      rubric?: string[];
+    };
+    providers?: {
+      tts?: {
+        enabled?: boolean;
+        backend?: 'browser' | 'polly' | 'google' | 'server';
+        defaultVoice?: string;
+        rate?: number;
+      };
+      calculator?: {
+        enabled?: boolean;
+        provider?: 'desmos' | 'ti' | 'mathjs';
+        authFetcher?: () => Promise<Record<string, unknown>>;
+      };
     };
-    highlighter?: { enabled?: boolean };
-    // ... other tools
   };
   accessibility?: {
     catalogs?: any[];
@@ -565,7 +655,14 @@ The section player provides automatic ToolkitCoordinator integration:
   // Create coordinator
   const coordinator = new ToolkitCoordinator({
     assessmentId: 'my-assessment',
-    tools: { tts: { enabled: true } }
+    tools: {
+      providers: { tts: { enabled: true, backend: 'browser' } },
+      placement: {
+        section: ['calculator', 'graph', 'periodicTable', 'protractor', 'lineReader', 'ruler'],
+        item: ['calculator', 'textToSpeech', 'answerEliminator'],
+        passage: ['textToSpeech']
+      }
+    }
   });
 
   // Pass to player
@@ -576,12 +673,41 @@ The section player provides automatic ToolkitCoordinator integration:
   // Player automatically:
   // - Extracts services from coordinator
   // - Generates section ID
-  // - Passes services to all child components
+  // - Provides runtime context to child components
   // - Manages SSML extraction
   // - Handles catalog lifecycle
 </script>
 ```
 
+### Runtime Context Contract
+
+The toolkit now exports a shared context key used by section-player and toolkit
+components:
+
+```typescript
+import {
+  assessmentToolkitRuntimeContext,
+  type AssessmentToolkitRuntimeContext
+} from "@pie-players/pie-assessment-toolkit";
+```
+
+`AssessmentToolkitRuntimeContext` carries ambient orchestration dependencies
+that should not be prop-drilled through intermediate components:
+
+- `toolkitCoordinator`
+- `toolCoordinator`
+- `ttsService`
+- `highlightCoordinator`
+- `catalogResolver`
+- `elementToolStateStore`
+- `assessmentId`
+- `sectionId`
+
+These runtime fields are expected to be present once the section-player
+provider is established (host-supplied coordinator or lazily created by
+section-player). Use explicit props/events for direct content contracts, and
+use runtime context for cross-cutting orchestration scope.
+
 ### Standalone Sections (No Coordinator Provided)
 
 If no coordinator is provided, the section player creates a default one:
@@ -593,7 +719,14 @@ player.section = mySection;
 // Internally creates:
 // new ToolkitCoordinator({
 //   assessmentId: 'anon_...',  // auto-generated
-//   tools: { tts: { enabled: true }, answerEliminator: { enabled: true } }
+//   tools: {
+//     providers: { tts: { enabled: true, backend: 'browser' }, calculator: { enabled: true, provider: 'desmos' } },
+//     placement: {
+//       section: ['calculator', 'graph', 'periodicTable', 'protractor', 'lineReader', 'ruler'],
+//       item: ['calculator', 'textToSpeech', 'answerEliminator'],
+//       passage: ['textToSpeech']
+//     }
+//   }
 // })
 ```
 

package/dist/attempt/TestSession.d.ts

@@ -3,12 +3,12 @@ export interface StorageLike {
     setItem(key: string, value: string): void;
     removeItem(key: string): void;
 }
-export interface TestSessionNavigationState {
+export interface TestAttemptSessionNavigationState {
     currentItemIndex: number;
     visitedItemIdentifiers: string[];
     currentSectionIdentifier?: string;
 }
-export interface TestSessionRealization {
+export interface TestAttemptSessionRealization {
     /**
      * Deterministic seed for shuffling/selection.
      * (Future: use for QTI ordering.shuffle / selection rules.)
@@ -19,7 +19,7 @@ export interface TestSessionRealization {
      */
     itemIdentifiers: string[];
 }
-export interface ItemSession {
+export interface TestAttemptItemSession {
     /**
      * QTI assessmentItemRef identifier (same as questionRef.identifier).
      */
@@ -33,23 +33,24 @@ export interface ItemSession {
     startedAt?: string;
     updatedAt?: string;
     completedAt?: string;
+    session?: unknown;
 }
-export interface TestSession {
+export interface TestAttemptSession {
     version: 1;
     /**
      * QTI-like identifier for the delivery attempt (administration).
      */
-    testSessionIdentifier: string;
+    testAttemptSessionIdentifier: string;
     assessmentId: string;
     startedAt: string;
     updatedAt: string;
     completedAt?: string;
-    navigationState: TestSessionNavigationState;
-    realization: TestSessionRealization;
+    navigationState: TestAttemptSessionNavigationState;
+    realization: TestAttemptSessionRealization;
     /**
      * Keyed by QTI item identifier (questionRef.identifier).
      */
-    itemSessions: Record<string, ItemSession>;
+    itemSessions: Record<string, TestAttemptItemSession>;
     /**
      * QTI 3.0 context variables (global assessment-level variables).
      * Managed by ContextVariableStore.
@@ -59,32 +60,33 @@ export interface TestSession {
 export declare function createMemoryStorage(initial?: Record<string, string>): StorageLike;
 export declare function getBrowserLocalStorage(): StorageLike | null;
 export declare function getOrCreateAnonymousDeviceId(storage: StorageLike): string;
-export declare function createTestSessionIdentifier(args: {
+export declare function createTestAttemptSessionIdentifier(args: {
     assessmentId: string;
     assignmentId?: string | null;
     userId?: string | null;
     storage: StorageLike;
 }): {
-    testSessionIdentifier: string;
+    testAttemptSessionIdentifier: string;
     seed: string;
 };
-export declare function getTestSessionStorageKey(testSessionIdentifier: string): string;
-export declare function loadTestSession(storage: StorageLike, testSessionIdentifier: string): TestSession | null;
-export declare function saveTestSession(storage: StorageLike, session: TestSession): void;
-export declare function createNewTestSession(args: {
-    testSessionIdentifier: string;
+export declare function getTestAttemptSessionStorageKey(testAttemptSessionIdentifier: string): string;
+export declare function loadTestAttemptSession(storage: StorageLike, testAttemptSessionIdentifier: string): TestAttemptSession | null;
+export declare function saveTestAttemptSession(storage: StorageLike, session: TestAttemptSession): void;
+export declare function createNewTestAttemptSession(args: {
+    testAttemptSessionIdentifier: string;
     assessmentId: string;
     seed: string;
     itemIdentifiers: string[];
-}): TestSession;
-export declare function upsertVisitedItem(session: TestSession, itemIdentifier: string): TestSession;
-export declare function setCurrentPosition(session: TestSession, args: {
+}): TestAttemptSession;
+export declare function upsertVisitedItem(session: TestAttemptSession, itemIdentifier: string): TestAttemptSession;
+export declare function setCurrentPosition(session: TestAttemptSession, args: {
     currentItemIndex: number;
     currentSectionIdentifier?: string;
-}): TestSession;
-export declare function upsertItemSessionFromPieSessionChange(session: TestSession, args: {
+}): TestAttemptSession;
+export declare function upsertItemSessionFromPieSessionChange(session: TestAttemptSession, args: {
     itemIdentifier: string;
     pieSessionId: string;
     isCompleted?: boolean;
-}): TestSession;
+    session?: unknown;
+}): TestAttemptSession;
 //# sourceMappingURL=TestSession.d.ts.map

package/dist/attempt/TestSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TestSession.d.ts","sourceRoot":"","sources":["../../src/attempt/TestSession.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TestSession.d.ts","sourceRoot":"","sources":["../../src/attempt/TestSession.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,iCAAiC;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,6BAA6B;IAC7C;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,CAAC,CAAC;IAEX;;OAEG;IACH,4BAA4B,EAAE,MAAM,CAAC;IAErC,YAAY,EAAE,MAAM,CAAC;IAErB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,eAAe,EAAE,iCAAiC,CAAC;IACnD,WAAW,EAAE,6BAA6B,CAAC;IAE3C;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAErD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC;AAMD,wBAAgB,mBAAmB,CAClC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,WAAW,CAWb;AAED,wBAAgB,sBAAsB,IAAI,WAAW,GAAG,IAAI,CAW3D;AAiCD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAMzE;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;CACrB,GAAG;IAAE,4BAA4B,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAYzD;AAED,wBAAgB,+BAA+B,CAC9C,4BAA4B,EAAE,MAAM,GAClC,MAAM,CAER;AAED,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,WAAW,EACpB,4BAA4B,EAAE,MAAM,GAClC,kBAAkB,GAAG,IAAI,CAe3B;AAED,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,kBAAkB,GACzB,IAAI,CASN;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IACjD,4BAA4B,EAAE,MAAM,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,EAAE,CAAC;CAC1B,GAAG,kBAAkB,CAkBrB;AAED,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,kBAAkB,EAC3B,cAAc,EAAE,MAAM,GACpB,kBAAkB,CAWpB;AAED,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE;IACL,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,CAAC,EAAE,MAAM,CAAC;CAClC,GACC,kBAAkB,CASpB;AAED,wBAAgB,qCAAqC,CACpD,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE;IACL,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,GACC,kBAAkB,CAkCpB"}

package/dist/attempt/TestSession.js

@@ -1,5 +1,5 @@
-const TEST_SESSION_VERSION = 1;
-const STORAGE_PREFIX = "pieoneer:testSession:v1:";
+const TEST_ATTEMPT_SESSION_VERSION = 1;
+const STORAGE_PREFIX = "pieoneer:testAttemptSession:v1:";
 const ANON_DEVICE_ID_KEY = "pieoneer:anonymousDeviceId:v1";
 export function createMemoryStorage(initial = {}) {
     const store = new Map(Object.entries(initial));
@@ -64,7 +64,7 @@ export function getOrCreateAnonymousDeviceId(storage) {
     storage.setItem(ANON_DEVICE_ID_KEY, created);
     return created;
 }
-export function createTestSessionIdentifier(args) {
+export function createTestAttemptSessionIdentifier(args) {
     const { assessmentId, assignmentId, userId, storage } = args;
     if (!assessmentId) {
         throw new Error("assessmentId is required to create a TestSession identifier");
@@ -72,39 +72,40 @@ export function createTestSessionIdentifier(args) {
     const subject = userId || getOrCreateAnonymousDeviceId(storage);
     const source = `v1|${assessmentId}|${assignmentId || ""}|${subject}`;
     const seed = fnv1a32Hex(source);
-    return { testSessionIdentifier: `ts_v1_${seed}`, seed };
+    return { testAttemptSessionIdentifier: `tas_v1_${seed}`, seed };
 }
-export function getTestSessionStorageKey(testSessionIdentifier) {
-    return `${STORAGE_PREFIX}${testSessionIdentifier}`;
+export function getTestAttemptSessionStorageKey(testAttemptSessionIdentifier) {
+    return `${STORAGE_PREFIX}${testAttemptSessionIdentifier}`;
 }
-export function loadTestSession(storage, testSessionIdentifier) {
-    const raw = storage.getItem(getTestSessionStorageKey(testSessionIdentifier));
+export function loadTestAttemptSession(storage, testAttemptSessionIdentifier) {
+    const raw = storage.getItem(getTestAttemptSessionStorageKey(testAttemptSessionIdentifier));
     if (!raw)
         return null;
     try {
         const parsed = JSON.parse(raw);
-        if (!parsed || parsed.version !== TEST_SESSION_VERSION)
+        if (!parsed || parsed.version !== TEST_ATTEMPT_SESSION_VERSION)
             return null;
-        if (parsed.testSessionIdentifier !== testSessionIdentifier)
+        if (parsed.testAttemptSessionIdentifier !== testAttemptSessionIdentifier) {
             return null;
+        }
         return parsed;
     }
     catch {
         return null;
     }
 }
-export function saveTestSession(storage, session) {
+export function saveTestAttemptSession(storage, session) {
     const updated = {
         ...session,
         updatedAt: nowIso(),
     };
-    storage.setItem(getTestSessionStorageKey(session.testSessionIdentifier), JSON.stringify(updated));
+    storage.setItem(getTestAttemptSessionStorageKey(session.testAttemptSessionIdentifier), JSON.stringify(updated));
 }
-export function createNewTestSession(args) {
+export function createNewTestAttemptSession(args) {
     const startedAt = nowIso();
     return {
-        version: TEST_SESSION_VERSION,
-        testSessionIdentifier: args.testSessionIdentifier,
+        version: TEST_ATTEMPT_SESSION_VERSION,
+        testAttemptSessionIdentifier: args.testAttemptSessionIdentifier,
         assessmentId: args.assessmentId,
         startedAt,
         updatedAt: startedAt,
@@ -162,6 +163,7 @@ export function upsertItemSessionFromPieSessionChange(session, args) {
         startedAt: existing?.startedAt || now,
         updatedAt: now,
         completedAt: completed ? existing?.completedAt || now : undefined,
+        session: args.session ?? existing?.session,
     };
     return {
         ...session,

package/dist/attempt/TestSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"TestSession.js","sourceRoot":"","sources":["../../src/attempt/TestSession.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TestSession.js","sourceRoot":"","sources":["../../src/attempt/TestSession.ts"],"names":[],"mappings":"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"}

package/dist/attempt/adapters/activity-to-test-attempt-session.d.ts

@@ -0,0 +1,50 @@
+import type { TestAttemptSession } from "../TestSession.js";
+export interface PieBackendActivityItemRef {
+    identifier?: string;
+    item?: {
+        id?: string;
+        identifier?: string;
+    };
+}
+export interface PieBackendActivityDefinition {
+    id?: string;
+    identifier?: string;
+    assessmentId?: string;
+    assessmentItemRefs?: PieBackendActivityItemRef[];
+}
+export interface PieBackendActivitySession {
+    id?: string;
+    activitySessionId?: string;
+    startedAt?: string;
+    updatedAt?: string;
+    completedAt?: string;
+    currentItemIndex?: number;
+    currentSectionIdentifier?: string;
+    visitedItemIdentifiers?: string[];
+    itemSessions?: Record<string, unknown>;
+}
+export interface MapActivityToTestAttemptSessionArgs {
+    activityDefinition?: PieBackendActivityDefinition | null;
+    activitySession?: PieBackendActivitySession | null;
+    itemRefs?: PieBackendActivityItemRef[];
+    itemSessionsByItemIdentifier?: Record<string, unknown>;
+    assessmentId?: string;
+    testAttemptSessionIdentifier?: string;
+}
+export interface ActivitySessionPatchPayload {
+    activitySession: {
+        id: string;
+        startedAt?: string;
+        updatedAt?: string;
+        completedAt?: string;
+        currentItemIndex: number;
+        currentSectionIdentifier?: string;
+        visitedItemIdentifiers: string[];
+        itemSessions: Record<string, unknown>;
+    };
+}
+export declare function mapActivityToTestAttemptSession(args: MapActivityToTestAttemptSessionArgs): TestAttemptSession;
+export declare function toItemSessionsRecord(testAttemptSession: TestAttemptSession): Record<string, unknown>;
+export declare function buildActivitySessionPatchFromTestAttemptSession(testAttemptSession: TestAttemptSession): ActivitySessionPatchPayload;
+export declare function buildActivitySessionItemUpdate(testAttemptSession: TestAttemptSession, itemIdentifier: string): ActivitySessionPatchPayload;
+//# sourceMappingURL=activity-to-test-attempt-session.d.ts.map

package/dist/attempt/adapters/activity-to-test-attempt-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-to-test-attempt-session.d.ts","sourceRoot":"","sources":["../../../src/attempt/adapters/activity-to-test-attempt-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,kBAAkB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,yBAAyB;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACF;AAED,MAAM,WAAW,4BAA4B;IAC5C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,yBAAyB,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,yBAAyB;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,mCAAmC;IACnD,kBAAkB,CAAC,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACzD,eAAe,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACvC,4BAA4B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC3C,eAAe,EAAE;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,sBAAsB,EAAE,MAAM,EAAE,CAAC;QACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;CACF;AAsGD,wBAAgB,+BAA+B,CAC9C,IAAI,EAAE,mCAAmC,GACvC,kBAAkB,CAgCpB;AAED,wBAAgB,oBAAoB,CACnC,kBAAkB,EAAE,kBAAkB,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,+CAA+C,CAC9D,kBAAkB,EAAE,kBAAkB,GACpC,2BAA2B,CAgB7B;AAED,wBAAgB,8BAA8B,CAC7C,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,MAAM,GACpB,2BAA2B,CAc7B"}