@pie-players/pie-assessment-toolkit 0.3.3 → 0.3.5

package/dist/services/ToolkitCoordinator.d.ts

@@ -14,7 +14,7 @@
  * Part of PIE Assessment Toolkit.
  */
 import type { AccessibilityCatalog } from "@pie-players/pie-players-shared/types";
-import { type CanonicalToolsConfig, type ToolPlacementConfig, type ToolPolicyConfig, type ToolProvidersConfig } from "./tools-config-normalizer.js";
+import { type CanonicalToolsConfig, type ToolPlacementConfig, type ToolPolicyConfig, type ToolProviderConfig, type ToolProvidersConfig } from "./tools-config-normalizer.js";
 import { AccessibilityCatalogResolver } from "./AccessibilityCatalogResolver.js";
 import { ElementToolStateStore } from "./ElementToolStateStore.js";
 import { HighlightCoordinator } from "./HighlightCoordinator.js";
@@ -22,15 +22,17 @@ import { ToolCoordinator } from "./ToolCoordinator.js";
 import { TTSService } from "./TTSService.js";
 import { ToolProviderRegistry } from "./tool-providers/index.js";
 import type { IToolProvider } from "./tool-providers/IToolProvider.js";
-import type { DesmosToolProviderConfig, MathJsToolProviderConfig, TIToolProviderConfig, TTSToolProviderConfig } from "./tool-providers/index.js";
-import type { SectionControllerContext, SectionControllerFactoryDefaults, SectionControllerHandle, SectionControllerKey, SectionControllerPersistenceStrategy, SectionPersistenceFactoryDefaults } from "./section-controller-types.js";
-export type { SectionControllerContext, SectionControllerFactoryDefaults, SectionControllerHandle, SectionControllerKey, SectionControllerPersistenceStrategy, SectionPersistenceFactoryDefaults, } from "./section-controller-types.js";
+import type { TTSToolProviderConfig } from "./tool-providers/index.js";
+import type { SectionControllerContext, SectionControllerEvent, SectionControllerEventType, SectionControllerFactoryDefaults, SectionControllerHandle, SectionControllerKey, SectionControllerPersistenceStrategy, SectionPersistenceFactoryDefaults } from "./section-controller-types.js";
+export type { SectionControllerContext, SectionControllerEvent, SectionControllerEventType, SectionControllerFactoryDefaults, SectionControllerHandle, SectionControllerKey, SectionControllerPersistenceStrategy, SectionControllerRuntimeState, SectionControllerSessionState, SectionPersistenceFactoryDefaults, } from "./section-controller-types.js";
 /**
  * Generic tool configuration
  */
 export interface ToolConfig {
     enabled?: boolean;
-    [key: string]: any;
+    provider?: unknown;
+    settings?: Record<string, unknown>;
+    [key: string]: unknown;
 }
 /**
  * TTS tool configuration
@@ -56,28 +58,10 @@ export interface TTSToolConfig extends ToolConfig {
 export interface AnswerEliminatorToolConfig extends ToolConfig {
     strategy?: "strikethrough" | "hide";
 }
-/**
- * Calculator tool configuration
- */
-export interface CalculatorToolConfig extends ToolConfig {
-    provider?: "desmos" | "ti" | "mathjs";
-    authFetcher?: () => Promise<Partial<DesmosToolProviderConfig | TIToolProviderConfig | MathJsToolProviderConfig>>;
-}
-/**
- * Floating tools configuration (calculator, graph, etc.)
- */
-export interface FloatingToolsConfig extends ToolConfig {
-    enabledTools?: string[];
-    calculator?: CalculatorToolConfig;
-}
 export interface ToolkitToolsConfig extends CanonicalToolsConfig {
     policy: ToolPolicyConfig;
     placement: Required<ToolPlacementConfig>;
-    providers: ToolProvidersConfig & {
-        tts?: TTSToolConfig;
-        calculator?: CalculatorToolConfig;
-        annotationToolbar?: ToolConfig;
-    };
+    providers: ToolProvidersConfig;
 }
 /**
  * Configuration for ToolkitCoordinator
@@ -138,10 +122,11 @@ export interface SectionControllerLifecycleEvent {
     controller?: SectionControllerHandle;
 }
 export interface SectionEventSubscriptionArgs {
-    sectionId: string;
+    sectionId?: string;
     attemptId?: string;
-    listener: (event: unknown) => void;
-    eventTypes?: readonly string[];
+    listener: (event: SectionControllerEvent) => void;
+    eventTypes?: readonly SectionControllerEventType[];
+    itemIds?: readonly string[];
 }
 export interface ToolkitCoordinatorHooks {
     onError?: (error: Error, context: ToolkitErrorContext) => void;
@@ -221,6 +206,7 @@ export declare class ToolkitCoordinator {
     private coordinatorReadyPromise?;
     private coordinatorReadyNotified;
     private readonly providerInitPromises;
+    private readonly packagedToolRegistry;
     private readonly sectionControllers;
     private readonly sectionControllerKeys;
     private readonly sectionControllerInitPromises;
@@ -245,6 +231,8 @@ export declare class ToolkitCoordinator {
      * Register tool providers in the registry
      */
     private _registerToolProviders;
+    private getProviderDescriptorTools;
+    private registerProviderFromTool;
     private registerProvider;
     ensureProviderReady(providerId: string): Promise<IToolProvider>;
     setHooks(hooks: ToolkitCoordinatorHooks): void;
@@ -288,6 +276,7 @@ export declare class ToolkitCoordinator {
     waitUntilReady(): Promise<void>;
     isReady(): boolean;
     getInitStatus(): ToolkitInitStatus;
+    private resolveProviderConfigKey;
     /**
      * Check if a tool is enabled.
      * Tools are enabled by default unless explicitly disabled.
@@ -302,7 +291,7 @@ export declare class ToolkitCoordinator {
      * @param toolId Tool identifier
      * @returns Tool configuration or null if not configured
      */
-    getToolConfig(toolId: string): ToolConfig | null;
+    getToolConfig(toolId: string): ToolProviderConfig | null;
     /**
      * Update tool configuration.
      * Applies changes to underlying services.
@@ -310,7 +299,7 @@ export declare class ToolkitCoordinator {
      * @param toolId Tool identifier
      * @param updates Partial configuration updates
      */
-    updateToolConfig(toolId: string, updates: Partial<ToolConfig>): void;
+    updateToolConfig(toolId: string, updates: Partial<ToolProviderConfig>): void;
     /**
      * Update the enabled tools list for floating tools (calculator, graph, etc.).
      * Used for PNP profile changes or dynamic tool configuration.

package/dist/services/ToolkitCoordinator.d.ts.map

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

package/dist/services/ToolkitCoordinator.js

@@ -14,13 +14,15 @@
  * Part of PIE Assessment Toolkit.
  */
 import { normalizeToolsConfig, resolveToolsForLevel, } from "./tools-config-normalizer.js";
+import { DEFAULT_TOOL_ALIAS_MAP } from "./tool-config-defaults.js";
 import { AccessibilityCatalogResolver } from "./AccessibilityCatalogResolver.js";
 import { ElementToolStateStore } from "./ElementToolStateStore.js";
 import { HighlightCoordinator } from "./HighlightCoordinator.js";
 import { ToolCoordinator } from "./ToolCoordinator.js";
 import { TTSService } from "./TTSService.js";
 import { BrowserTTSProvider } from "./tts/browser-provider.js";
-import { ToolProviderRegistry, DesmosToolProvider, MathJsToolProvider, TIToolProvider, TTSToolProvider, } from "./tool-providers/index.js";
+import { ToolProviderRegistry } from "./tool-providers/index.js";
+import { createPackagedToolRegistry } from "./createDefaultToolRegistry.js";
 /**
  * ToolkitCoordinator - Orchestrates all assessment toolkit services
  *
@@ -65,6 +67,7 @@ export class ToolkitCoordinator {
     coordinatorReadyPromise;
     coordinatorReadyNotified = false;
     providerInitPromises = new Map();
+    packagedToolRegistry = createPackagedToolRegistry();
     sectionControllers = new Map();
     sectionControllerKeys = new Map();
     sectionControllerInitPromises = new Map();
@@ -82,10 +85,6 @@ export class ToolkitCoordinator {
                 enabled: true,
                 backend: "browser",
             },
-            calculator: {
-                enabled: true,
-                provider: "desmos",
-            },
             annotationToolbar: {
                 enabled: true,
             },
@@ -258,67 +257,39 @@ export class ToolkitCoordinator {
      * Register tool providers in the registry
      */
     _registerToolProviders() {
-        // Register TTS provider
-        const ttsConfig = this.config.tools?.providers?.tts;
-        if (ttsConfig?.enabled !== false) {
-            const backend = ttsConfig?.backend || "browser";
-            const serverProvider = ttsConfig?.serverProvider ||
-                ttsConfig?.provider ||
-                (backend === "polly" || backend === "google" ? backend : undefined);
-            void this.registerProvider("tts", {
-                provider: new TTSToolProvider(backend),
-                config: {
-                    backend,
-                    apiEndpoint: ttsConfig?.apiEndpoint,
-                    serverProvider,
-                    providerOptions: backend === "polly"
-                        ? {
-                            ...(ttsConfig?.engine ? { engine: ttsConfig.engine } : {}),
-                            ...(typeof ttsConfig?.sampleRate === "number"
-                                ? { sampleRate: ttsConfig.sampleRate }
-                                : {}),
-                            ...(ttsConfig?.format ? { format: ttsConfig.format } : {}),
-                            speechMarkTypes: ttsConfig?.speechMarksMode === "word+sentence"
-                                ? ["word", "sentence"]
-                                : ["word"],
-                        }
-                        : undefined,
-                    voice: ttsConfig?.defaultVoice,
-                    rate: ttsConfig?.rate,
-                    pitch: ttsConfig?.pitch,
-                },
-                lazy: true,
-                authFetcher: ttsConfig?.authFetcher,
-            });
-        }
-        // Register calculator providers
-        const calculatorConfig = this.config.tools?.providers?.calculator;
-        if (calculatorConfig?.enabled !== false) {
-            const provider = calculatorConfig?.provider || "desmos";
-            if (provider === "desmos") {
-                void this.registerProvider("calculator-desmos", {
-                    provider: new DesmosToolProvider(),
-                    config: {},
-                    lazy: true,
-                    authFetcher: calculatorConfig?.authFetcher,
-                });
-            }
-            else if (provider === "ti") {
-                void this.registerProvider("calculator-ti", {
-                    provider: new TIToolProvider(),
-                    config: {},
-                    lazy: true,
-                });
-            }
-            else if (provider === "mathjs") {
-                void this.registerProvider("calculator-mathjs", {
-                    provider: new MathJsToolProvider(),
-                    config: {},
-                    lazy: true,
-                });
-            }
+        const descriptorTools = this.getProviderDescriptorTools();
+        for (const tool of descriptorTools) {
+            void this.registerProviderFromTool(tool);
         }
     }
+    getProviderDescriptorTools() {
+        return this.packagedToolRegistry
+            .getAllTools()
+            .filter((tool) => !!tool.provider);
+    }
+    async registerProviderFromTool(tool) {
+        const descriptor = tool.provider;
+        if (!descriptor)
+            return;
+        const toolConfig = this.getToolConfig(tool.toolId) || undefined;
+        if (toolConfig?.enabled === false)
+            return;
+        const providerId = descriptor.getProviderId?.(toolConfig) ??
+            toolConfig?.provider?.id ??
+            tool.toolId;
+        if (this.toolProviderRegistry.has(providerId))
+            return;
+        const provider = descriptor.createProvider(toolConfig);
+        const initConfig = descriptor.getInitConfig?.(toolConfig) ?? toolConfig?.provider?.init ?? {};
+        const authFetcher = descriptor.getAuthFetcher?.(toolConfig) ??
+            toolConfig?.provider?.runtime?.authFetcher;
+        await this.registerProvider(providerId, {
+            provider,
+            config: initConfig,
+            lazy: descriptor.lazy ?? true,
+            authFetcher,
+        });
+    }
     async registerProvider(providerId, config) {
         try {
             this.toolProviderRegistry.register(providerId, config);
@@ -391,14 +362,31 @@ export class ToolkitCoordinator {
         return this.sectionControllers.get(this.getSectionControllerMapKey(key));
     }
     subscribeSectionEvents(args) {
-        const controllerEntry = this.resolveSectionControllerForSubscription({
-            sectionId: args.sectionId,
-            attemptId: args.attemptId,
-        });
-        const controller = controllerEntry?.controller;
-        const subscribe = controller?.subscribe;
-        if (!controller || !subscribe) {
-            return () => { };
+        let controllerEntry;
+        try {
+            controllerEntry = this.resolveSectionControllerForSubscription({
+                sectionId: args.sectionId,
+                attemptId: args.attemptId,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const isAmbiguousSectionWithoutAttempt = args.sectionId !== undefined &&
+                args.attemptId === undefined &&
+                message.includes("subscribeSectionEvents is ambiguous for section");
+            if (isAmbiguousSectionWithoutAttempt) {
+                console.warn(message);
+                return () => { };
+            }
+            throw error;
+        }
+        const controller = controllerEntry.controller;
+        const subscribe = controller.subscribe;
+        if (!subscribe) {
+            const resolvedKey = this.sectionControllerKeys.get(controllerEntry.mapKey);
+            const sectionLabel = resolvedKey?.sectionId || args.sectionId || "<unknown>";
+            const attemptLabel = resolvedKey?.attemptId || args.attemptId || "<default>";
+            throw new Error(`[ToolkitCoordinator] subscribeSectionEvents could not subscribe: resolved controller for section "${sectionLabel}" attempt "${attemptLabel}" does not expose subscribe().`);
         }
         const { mapKey } = controllerEntry;
         let listenerId = this.sectionEventListenerIds.get(args.listener);
@@ -412,19 +400,35 @@ export class ToolkitCoordinator {
         const eventTypeFilter = args.eventTypes
             ? new Set(args.eventTypes)
             : null;
+        const itemIdFilter = args.itemIds ? new Set(args.itemIds) : null;
         const unsubscribeController = subscribe.call(controller, (event) => {
-            if (!eventTypeFilter) {
-                args.listener(event);
-                return;
-            }
-            const eventType = typeof event === "object" &&
-                event !== null &&
-                "type" in event &&
-                typeof event.type === "string"
-                ? event.type
-                : null;
-            if (!eventType || !eventTypeFilter.has(eventType)) {
-                return;
+            if (eventTypeFilter || itemIdFilter) {
+                const eventType = event?.type || null;
+                if (eventTypeFilter && (!eventType || !eventTypeFilter.has(eventType))) {
+                    return;
+                }
+                if (itemIdFilter) {
+                    const eventItemCandidates = new Set();
+                    if ("itemId" in event && typeof event.itemId === "string") {
+                        eventItemCandidates.add(event.itemId);
+                    }
+                    if ("canonicalItemId" in event &&
+                        typeof event.canonicalItemId === "string") {
+                        eventItemCandidates.add(event.canonicalItemId);
+                    }
+                    if ("currentItemId" in event &&
+                        typeof event.currentItemId === "string") {
+                        eventItemCandidates.add(event.currentItemId);
+                    }
+                    if ("previousItemId" in event &&
+                        typeof event.previousItemId === "string") {
+                        eventItemCandidates.add(event.previousItemId);
+                    }
+                    const hasMatchingItem = Array.from(eventItemCandidates).some((itemId) => itemIdFilter.has(itemId));
+                    if (!hasMatchingItem) {
+                        return;
+                    }
+                }
             }
             args.listener(event);
         });
@@ -440,36 +444,57 @@ export class ToolkitCoordinator {
         return detach;
     }
     resolveSectionControllerForSubscription(args) {
-        const explicitKey = {
-            assessmentId: this.assessmentId,
-            sectionId: args.sectionId,
-            attemptId: args.attemptId,
-        };
-        const explicitMapKey = this.getSectionControllerMapKey(explicitKey);
-        const explicitController = this.sectionControllers.get(explicitMapKey);
-        if (explicitController) {
-            return { mapKey: explicitMapKey, controller: explicitController };
+        if (args.sectionId) {
+            const explicitKey = {
+                assessmentId: this.assessmentId,
+                sectionId: args.sectionId,
+                attemptId: args.attemptId,
+            };
+            const explicitMapKey = this.getSectionControllerMapKey(explicitKey);
+            const explicitController = this.sectionControllers.get(explicitMapKey);
+            if (explicitController) {
+                return { mapKey: explicitMapKey, controller: explicitController };
+            }
+            if (args.attemptId !== undefined) {
+                throw new Error(`[ToolkitCoordinator] subscribeSectionEvents could not resolve controller for section "${args.sectionId}" and attempt "${args.attemptId}".`);
+            }
+            const sectionMatches = [];
+            for (const [mapKey, key] of this.sectionControllerKeys.entries()) {
+                if (key.assessmentId !== this.assessmentId || key.sectionId !== args.sectionId) {
+                    continue;
+                }
+                const controller = this.sectionControllers.get(mapKey);
+                if (!controller)
+                    continue;
+                sectionMatches.push({ mapKey, controller });
+            }
+            if (sectionMatches.length === 1) {
+                return sectionMatches[0];
+            }
+            if (sectionMatches.length === 0) {
+                throw new Error(`[ToolkitCoordinator] subscribeSectionEvents found no active controller for section "${args.sectionId}".`);
+            }
+            throw new Error(`[ToolkitCoordinator] subscribeSectionEvents is ambiguous for section "${args.sectionId}" without attemptId; ${sectionMatches.length} controllers are active.`);
         }
         if (args.attemptId !== undefined) {
-            return null;
+            throw new Error(`[ToolkitCoordinator] subscribeSectionEvents requires sectionId when attemptId is provided ("${args.attemptId}").`);
         }
-        const matches = [];
+        const allMatches = [];
         for (const [mapKey, key] of this.sectionControllerKeys.entries()) {
-            if (key.assessmentId !== this.assessmentId || key.sectionId !== args.sectionId) {
+            if (key.assessmentId !== this.assessmentId)
                 continue;
-            }
             const controller = this.sectionControllers.get(mapKey);
             if (!controller)
                 continue;
-            matches.push({ mapKey, controller });
+            allMatches.push({ mapKey, controller });
         }
-        if (matches.length === 1) {
-            return matches[0];
+        if (allMatches.length === 1) {
+            return allMatches[0];
         }
-        if (matches.length > 1) {
-            console.warn(`[ToolkitCoordinator] subscribeSectionEvents is ambiguous for section "${args.sectionId}" without attemptId; ${matches.length} controllers are active.`);
+        if (allMatches.length === 0) {
+            throw new Error("[ToolkitCoordinator] subscribeSectionEvents found no active controllers; provide sectionId or initialize a section controller first.");
         }
-        return null;
+        throw new Error(`[ToolkitCoordinator] subscribeSectionEvents is ambiguous without sectionId; ${allMatches.length} active controllers are registered.`);
     }
     onSectionControllerLifecycle(listener) {
         this.sectionControllerLifecycleListeners.add(listener);
@@ -773,6 +798,18 @@ export class ToolkitCoordinator {
             providers,
         };
     }
+    resolveProviderConfigKey(toolId) {
+        const providers = this.config.tools
+            ?.providers || {};
+        if (toolId in providers)
+            return toolId;
+        for (const [alias, canonical] of Object.entries(DEFAULT_TOOL_ALIAS_MAP)) {
+            if (canonical === toolId && alias in providers) {
+                return alias;
+            }
+        }
+        return toolId;
+    }
     /**
      * Check if a tool is enabled.
      * Tools are enabled by default unless explicitly disabled.
@@ -781,7 +818,8 @@ export class ToolkitCoordinator {
      * @returns True if tool is enabled
      */
     isToolEnabled(toolId) {
-        const toolConfig = this.config.tools?.providers?.[toolId];
+        const configKey = this.resolveProviderConfigKey(toolId);
+        const toolConfig = this.config.tools?.providers?.[configKey];
         // Enabled by default unless explicitly set to false
         return toolConfig?.enabled !== false;
     }
@@ -792,7 +830,9 @@ export class ToolkitCoordinator {
      * @returns Tool configuration or null if not configured
      */
     getToolConfig(toolId) {
-        return this.config.tools?.providers?.[toolId] || null;
+        const configKey = this.resolveProviderConfigKey(toolId);
+        return (this.config.tools
+            ?.providers?.[configKey] || null);
     }
     /**
      * Update tool configuration.
@@ -803,6 +843,7 @@ export class ToolkitCoordinator {
      */
     updateToolConfig(toolId, updates) {
         // Update config
+        const configKey = this.resolveProviderConfigKey(toolId);
         const current = this.getToolConfig(toolId) || {};
         if (!this.config.tools) {
             this.config.tools = normalizeToolsConfig();
@@ -810,9 +851,9 @@ export class ToolkitCoordinator {
         if (!this.config.tools.providers) {
             this.config.tools.providers = {};
         }
-        this.config.tools.providers[toolId] = { ...current, ...updates };
+        this.config.tools.providers[configKey] = { ...current, ...updates };
         // Apply configuration changes to services
-        this._applyToolConfigChange(toolId, updates);
+        this._applyToolConfigChange(configKey, updates);
     }
     /**
      * Update the enabled tools list for floating tools (calculator, graph, etc.).
@@ -891,38 +932,12 @@ export class ToolkitCoordinator {
         if (this.toolProviderRegistry.has("tts")) {
             await this.toolProviderRegistry.unregister("tts");
         }
-        const ttsConfig = this.config.tools?.providers?.tts;
-        if (ttsConfig?.enabled === false)
+        const ttsRegistration = this
+            .getProviderDescriptorTools()
+            .find((tool) => tool.toolId === "textToSpeech");
+        if (!ttsRegistration)
             return;
-        const backend = ttsConfig?.backend || "browser";
-        const serverProvider = ttsConfig?.serverProvider ||
-            ttsConfig?.provider ||
-            (backend === "polly" || backend === "google" ? backend : undefined);
-        await this.registerProvider("tts", {
-            provider: new TTSToolProvider(backend),
-            config: {
-                backend,
-                apiEndpoint: ttsConfig?.apiEndpoint,
-                serverProvider,
-                providerOptions: backend === "polly"
-                    ? {
-                        ...(ttsConfig?.engine ? { engine: ttsConfig.engine } : {}),
-                        ...(typeof ttsConfig?.sampleRate === "number"
-                            ? { sampleRate: ttsConfig.sampleRate }
-                            : {}),
-                        ...(ttsConfig?.format ? { format: ttsConfig.format } : {}),
-                        speechMarkTypes: ttsConfig?.speechMarksMode === "word+sentence"
-                            ? ["word", "sentence"]
-                            : ["word"],
-                    }
-                    : undefined,
-                voice: ttsConfig?.defaultVoice,
-                rate: ttsConfig?.rate,
-                pitch: ttsConfig?.pitch,
-            },
-            lazy: true,
-            authFetcher: ttsConfig?.authFetcher,
-        });
+        await this.registerProviderFromTool(ttsRegistration);
     }
 }
 //# sourceMappingURL=ToolkitCoordinator.js.map