@pitcher/js-api 1.28.0 → 1.30.0

package/lib/apps/collection-player/stores/app.store.d.ts

@@ -10,6 +10,7 @@ import { ActionCallback, default as useKeyboardBindings } from '../composables/k
 import { default as useSlideDirection } from '../composables/slide-direction.use';
 import { useCacheNavigation } from '../composables/navigation-cache.use';
 import { useAnnotationLayer } from '../composables/annotation-layer.use';
+import { FlatSlidePosition } from '../composables/collection-navigation.util';
 export type RenderPageAsImage = (payload: {
     fileId: File['id'];
     documentId?: File['id'];
@@ -61,7 +62,9 @@ type StoreData = {
     hasManyGroups: ComputedRef<boolean>;
     activeSlide: Ref<CollectionSlide | null>;
     activeGroup: Ref<CollectionGroup | null>;
+    slidePosition: ComputedRef<FlatSlidePosition>;
     setActiveSlide: (group?: CollectionGroup, slide?: CollectionSlide) => void;
+    setActiveFlatPage: (page: number) => void;
     onSlideChange: (customEvent: CustomEvent<[swiper: Swiper]>) => void;
     activatePreviousGroup: () => void;
     activateNextGroup: () => void;

package/lib/apps/content-selector/components/Assets.uploaderRefresh.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/apps/content-selector/stores/app.d.ts

@@ -2,7 +2,7 @@ import { Ref, ComputedRef, UnwrapNestedRefs } from 'vue';
 import { FolderRetrieve, FolderFile, FileRetrieve, File, FolderFolder, FileContentTypeEnum } from '../../../../types/openapi';
 import { ApiStore } from './api';
 export type AppName = 'admin' | 'impact';
-export type SelectorType = 'content' | 'assets' | 'external_links' | 'ai_images' | 'pexels_images' | 'theme' | `multimedia-selector-${string}`;
+export type SelectorType = 'content' | 'assets' | 'external_links' | 'pexels_images' | 'theme' | `multimedia-selector-${string}`;
 export type SortOption = 'nameAsc' | 'nameDesc' | 'modifiedAsc' | 'modifiedDesc';
 export type SelectedPage = {
     id: string;

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.annotations.use.d.ts

@@ -1,7 +1,11 @@
 import { Ref, ComputedRef } from 'vue';
-import { Instance, AnnotationsUnion } from 'pspdfkit';
+import { Instance, AnnotationsUnion } from '@nutrient-sdk/viewer';
 import { CLIENT_TYPE } from '../../../constants/cdp.const';
 import { File } from '../../../../types/openapi';
+export declare function stripSdkWrapper(text: string): string;
+export declare function stripCorruption(text: string): string;
+export declare function normalizeText(text: string): string;
+export declare function needsCorruptionRepair(text: string): boolean;
 interface UseAnnotationsReturnType {
     annotations: Ref<AnnotationsUnion[]>;
     areAnnotationsModified: Ref<boolean>;

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.formFields.use.d.ts

@@ -0,0 +1,8 @@
+import { Ref, ComputedRef } from 'vue';
+import { Instance } from '@nutrient-sdk/viewer';
+interface UseFormFieldsReturnType {
+    areFormFieldValuesModified: ComputedRef<boolean>;
+    resetFormFieldChanges: () => void;
+}
+export declare function useFormFields(instance: Ref<Instance | undefined>): UseFormFieldsReturnType;
+export {};

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.link.use.d.ts

@@ -1,5 +1,5 @@
 import { Ref, ComputedRef } from 'vue';
-import { Instance, AnnotationsUnion, List } from 'pspdfkit';
+import { Instance, AnnotationsUnion, List } from '@nutrient-sdk/viewer';
 import { SaveLinkAnnotationPayload } from './CFileViewer.pdf.link.types';
 interface UseLinkAnnotationPayload {
     instance: Ref<Instance | undefined>;

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.overlayItems.use.d.ts

@@ -1,5 +1,5 @@
 import { Ref } from 'vue';
-import { Instance } from 'pspdfkit';
+import { Instance } from '@nutrient-sdk/viewer';
 import { FileRetrieve } from '../../../../types/openapi';
 interface UseOverlayItemsReturnType {
     setOverlayItemsForEmbeddedVideos: (currentPageIndex: number) => Promise<void>;

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.use.d.ts

@@ -1,6 +1,6 @@
 import { Ref, ComputedRef } from 'vue';
 import { I18n } from 'vue-i18n';
-import { Instance, AnnotationsUnion } from 'pspdfkit';
+import { Instance, AnnotationsUnion } from '@nutrient-sdk/viewer';
 import { AnnotationType } from '../CFileViewer.types';
 import { PitcherFile } from '../../../types/file.types';
 import { MiniPage, File, FileRetrieve } from '../../../../types/openapi';
@@ -27,6 +27,7 @@ interface FileViewerPdfReturnType {
     updateFileViewerSettings: (settings: Partial<typeof fileViewerSettings.value>) => void;
     cleanupPspdfKit: () => void;
     resetAnnotationChanges: () => void;
+    resetFormFieldChanges: () => void;
     isSearchOpen: Ref<boolean>;
     isThumbnailsOpen: Ref<boolean>;
     isTextAnnotationOpen: Ref<boolean>;
@@ -34,6 +35,7 @@ interface FileViewerPdfReturnType {
     currentPageIndex: Ref<number>;
     isAnnotationOpen: Ref<boolean>;
     areAnnotationsModified: Ref<boolean>;
+    areFormFieldValuesModified: ComputedRef<boolean>;
     selectedAnnotationType: Ref<Exclude<AnnotationType, 'text'>>;
     isSwitchingInteractionMode: Ref<boolean>;
     fileViewerSettings: typeof fileViewerSettings;
@@ -45,7 +47,7 @@ interface FileViewerPdfReturnType {
     onSaveLinkAnnotation: (data: SaveLinkAnnotationPayload) => void;
     hasHotspotsOnCurrentPage: Ref<boolean>;
 }
-declare const _default: ({ pdfViewerEl, bottomBarRef, i18n, appLocale, actions, assetsPrefix, clientType, context, pitcherSettings, launchDarkly, emit, fileId, fetchFileById, fetchDocumentInfo, }: {
+declare const _default: ({ pdfViewerEl, bottomBarRef, i18n, appLocale, actions, assetsPrefix, clientType, context, pitcherSettings, launchDarkly, emit, fileId, fetchFileById, }: {
     pdfViewerEl: Ref<HTMLElement | null>;
     bottomBarRef: Ref<InstanceType<typeof CFileViewerBottomPdf> | null>;
     i18n: I18n;
@@ -59,12 +61,5 @@ declare const _default: ({ pdfViewerEl, bottomBarRef, i18n, appLocale, actions,
     fileId: ComputedRef<File["id"] | undefined>;
     emit: (name: string, ...args: any[]) => void;
     fetchFileById?: (id: FileRetrieve["id"]) => Promise<FileRetrieve>;
-    fetchDocumentInfo?: (id: File["id"]) => Promise<{
-        pageCount: number;
-        pages?: Array<{
-            width: number;
-            height: number;
-        }>;
-    }>;
 }) => FileViewerPdfReturnType;
 export default _default;

package/lib/components/CFileViewer/pdf/CFileViewer.pdf.util.d.ts

@@ -1,4 +1,4 @@
-import { default as PSPDFKitType } from 'pspdfkit';
+import { default as PSPDFKitType } from '@nutrient-sdk/viewer';
 /**
  * Tear down a PSPDFKit instance for a container without ever throwing.
  *

package/lib/components/CFileViewer/pdf/CFileViewerFullscreen.pdf.use.d.ts

@@ -1,6 +1,6 @@
 import { Ref } from 'vue';
 import { MaybeRef } from '@vueuse/core';
-import { Instance } from 'pspdfkit';
+import { Instance } from '@nutrient-sdk/viewer';
 import { default as CFileViewerBottomPdf } from './CFileViewerBottom.pdf.vue';
 declare const _default: ({ pdfViewerEl, bottomBarRef, instance, isThumbnailsOpen, isSearchOpen, }: {
     pdfViewerEl: MaybeRef<HTMLElement | null>;

package/lib/components/CFileViewer/pdf/__tests__/CFileViewer.pdf.annotations.text.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/components/savedCanvases/CSavedCanvasesManagement.use.d.ts

@@ -4,6 +4,7 @@ export type FreezeStatus = 'active' | 'expired' | null;
 export declare function getFreezeStatus(canvas: Pick<CanvasRetrieve, 'metadata'>): FreezeStatus;
 export declare const SYSTEM_EXCLUDED_TAGS: readonly ["home", "share", "sharebox"];
 export declare function hasHidingTag(tags?: string[], dynamicTags?: string[]): boolean;
+export declare function isTemplateHiddenFromReps(canvas: Pick<CanvasRetrieve, 'tags' | 'template'>, rendererExcludedTags?: string[]): boolean;
 export declare function useCSavedCanvasesManagement(): {
     statusOptions: {
         label: string;

package/lib/composables/useCourseOnlyApps.d.ts

@@ -7,5 +7,5 @@ import { AppFile } from '../types/app';
  */
 export declare function useCourseOnlyApps(): {
     allowCourseOnlyApps: boolean;
-    isAppAllowed: (app: AppFile) => boolean;
+    isAppAllowedInHost: (app: AppFile) => boolean;
 };

package/lib/composables/usePdfInterpolation.d.ts

@@ -1,7 +1,7 @@
-import { default as PSPDFKitType, ServerConfiguration } from 'pspdfkit';
+import { default as PSPDFKitType, Configuration } from '@nutrient-sdk/viewer';
 declare function annotationsInterpolation({ PSPDFKit, config, data, }: {
     PSPDFKit: typeof PSPDFKitType;
-    config: ServerConfiguration;
+    config: Configuration;
     data: Record<string, string>;
 }): Promise<void>;
 export default function usePdfInterpolation(strategy?: 'annotations' | 'text'): typeof annotationsInterpolation;

package/lib/composables/useWindowEvents.d.ts

@@ -9,7 +9,7 @@ export type InactiveEventPayload = {
     file_id?: string;
     [key: string]: any;
 };
-export default function (track: (eventName: string, payload: any) => void, pitcherApi?: ReturnType<typeof usePitcherApi>, flushTrack?: (eventName: string, payload: any) => void): {
+export default function (track: (eventName: string, payload: any) => void, pitcherApi?: ReturnType<typeof usePitcherApi>, flushTrack?: (eventName: string, payload: any) => void, heartbeatIntervalMs?: number): {
     registerInactiveEvent: ({ id, payload, enterEvent, exitEvent, type, }: {
         id: string;
         payload: InactiveEventPayload | ((type?: EventLifecycle) => InactiveEventPayload);

package/lib/constants/cdp.const.d.ts

@@ -10,6 +10,7 @@ export declare const CDP_EVENT_TYPE: {
     readonly appExited: "App Exited";
     readonly canvasEntered: "Canvas Entered";
     readonly canvasExited: "Canvas Exited";
+    readonly canvasHeartbeat: "Canvas Heartbeat";
     readonly wizardEntered: "Wizard Entered";
     readonly wizardExited: "Wizard Exited";
     readonly canvasShared: "Canvas Shared";

package/lib/constants/translationLanguages.const.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Target languages offered by the content-translation feature.
+ *
+ * ⚠️ MIRROR — the single source of truth is
+ * `packages/next-core/src/services/translation/languages.ts`
+ * (`TRANSLATION_LANGUAGES`). next-core cannot be imported from canvas-ui or the
+ * admin client, so the list is duplicated here for the UI pickers only. Keep the
+ * `locale` values byte-identical with that file: the backend resolves the DeepL
+ * target code and the English language name from the locale we post, so a locale
+ * that exists here and not there is rejected by the route.
+ *
+ * The admin client imports this from `@pitcher/canvas-ui` rather than keeping a
+ * third copy, so there are exactly two lists to reconcile, never more.
+ *
+ * `label` is intentionally NOT an i18n key: language names are shown in their own
+ * language (the endonym), which is what every locale picker in the product does,
+ * and it keeps the list free of the dynamic-key lookups the i18n extractor strips.
+ */
+export interface TranslationLanguageOption {
+    /** Platform locale, matching the locale JSON filenames. Posted to the backend. */
+    locale: string;
+    /** Endonym shown in the picker. */
+    label: string;
+    /** Uppercase suffix the backend appends to a translated record's name. */
+    suffix: string;
+}
+export declare const TRANSLATION_LANGUAGES: readonly TranslationLanguageOption[];
+/**
+ * Uppercase language suffix of a TRANSLATED record, read from the provenance stamp
+ * `metadata.pitcher.translation.language` that the duplicate-translate route writes.
+ * Returns undefined for an untranslated record or an unrecognised locale, so a caller
+ * can use the result directly as the "show a badge" condition.
+ */
+export declare function translatedLanguageSuffix(metadata: unknown): string | undefined;
+/**
+ * File extensions the row action and the upload picker offer.
+ *
+ * ⚠️ MIRROR — the source of truth is `DEEPL_SUPPORTED_EXTENSIONS` in
+ * `packages/next-core/src/services/deepl.service.ts`, which is what the
+ * `files/translate` route actually validates against. Every entry here MUST exist
+ * there, or the UI offers a translation the route answers with
+ * `400 invalid_request`.
+ *
+ * Legacy `.doc` and `.ppt` are deliberately absent: DeepL rejects the legacy
+ * binary formats, so offering them only produced that 400. The DeepL list is a
+ * superset (it also accepts `xlf`, `xliff`, `srt`); those stay out of the UI until
+ * there is a reason to surface localisation-interchange formats to admins, and a
+ * subset is safe in a way a superset is not.
+ */
+export declare const TRANSLATABLE_FILE_EXTENSIONS: readonly string[];
+export declare function isTranslatableFileExtension(extension?: string | null): boolean;
+/**
+ * Extension of a file record, resolved the way the route resolves it.
+ *
+ * ⚠️ MIRROR of `resolveExtension` in
+ * `packages/next-core/src/app/api/protected/files/translate/route.ts`: prefer the
+ * explicit extension field, fall back to parsing the name. A UI gate that only
+ * read the explicit field hid the action on records whose extension column is
+ * empty even though the route would have accepted them. The API field is called
+ * `extension` on the detail serializer and `original_extension` on the compact
+ * one the browser list uses, so both are accepted here.
+ */
+export declare function resolveFileExtension(file?: {
+    name?: string | null;
+    extension?: string | null;
+    original_extension?: string | null;
+} | null): string;
+/** Naive UI / CSelect option shape for the language pickers. */
+export declare function translationLanguageOptions(): {
+    label: string;
+    value: string;
+}[];

package/lib/main.lib.d.ts

@@ -178,6 +178,7 @@ export { usePolling } from './composables/usePolling';
 export { default as useBroadcastRouteChange } from './composables/useBroadcastRouteChange';
 export * from './plugins/vueQuery';
 export * from './apps/canvas-builder/util/canvas.util';
+export * from './apps/canvas-builder/util/completionWizard.util';
 export * from './apps/canvas-builder/util/tree';
 export * from './apps/canvas-builder/util/print.util';
 export * from './components/filters/filter.util';
@@ -267,6 +268,7 @@ export * from './constants/conventions.const';
 export * from './constants/config.const';
 export * from './constants/pitcherSettings.const';
 export * from './constants/appsDb.const';
+export * from './constants/translationLanguages.const';
 export * from './apps/canvas-builder/constants/theme.const';
 export * from './constants/roles.const';
 export type { RolePermissions } from './constants/roles.const';

package/lib/sdk/api/HighLevelApi.d.ts

@@ -1,6 +1,5 @@
 import { LowLevelApi } from './LowLevelApi';
 import { PitcherEvent, ApiOptions } from '../interfaces';
-import * as modules from './modules';
 /**
  * Creates a high-level API instance and caches it. Reterns a new instance only if new options are provided.
  */
@@ -123,9 +122,11 @@ export declare function createHighLevelApi(options?: ApiOptions): {
      * @returns {Promise<void>}
      */
     unsubscribe: () => Promise<any>;
+    postJsonWithTimeout<T>(url: string, body: unknown, accessToken: string, timeoutMs: number, label: string): Promise<T>;
     aiGetCapabilities(): Promise<import('../payload.types').AIRuntimeCapabilities>;
     aiComplete(payload: import('../payload.types').AICompletePayload): Promise<import('../payload.types').AICompleteResult>;
     piaSearchAnswer(payload: import('../payload.types').PiaSearchAnswerPayload): Promise<import('../payload.types').PiaSearchAnswerResult>;
+    weeklyFocusRank(payload: import('../payload.types').WeeklyFocusRankPayload): Promise<import('../payload.types').WeeklyFocusRankResult>;
     appsDbGetEntries(payload: import('../payload.types').AppsDbGetEntriesPayload): Promise<import('../payload.types').AppsDbEntriesResult>;
     appsDbUpsertEntry(payload: import('../payload.types').AppsDbUpsertEntryPayload): Promise<import('../payload.types').AppsDbEntry>;
     appsDbDeleteEntry(payload: import('../payload.types').AppsDbDeleteEntryPayload): Promise<void>;
@@ -134,10 +135,9 @@ export declare function createHighLevelApi(options?: ApiOptions): {
     openExternalUrl(payload: import('../payload.types').OpenExternalUrlRequestPayload): Promise<void>;
     getEnv(): Promise<import('../interfaces').PitcherEnv>;
     updateMyUser(payload: {
-        language?: import('../../main.lib').LanguageEnum | undefined;
+        language?: string | undefined;
     }): Promise<import('../../main.lib').User>;
     isOffline(): Promise<boolean>;
-    getLanguages(): Promise<modules.Language[]>;
     getCanvases(payload: import('../../main.lib').GetCanvasesParams & {
         filters?: Record<string, any>;
         fields?: string;
@@ -149,7 +149,20 @@ export declare function createHighLevelApi(options?: ApiOptions): {
     updateCanvas(payload: import('../../main.lib').PatchedCanvasUpdateRequest & {
         id: import('../../main.lib').CanvasRetrieve["id"];
         instance_id?: import('../../main.lib').Instance["id"];
-        fields?: string;
+        fields
+        /**
+         * Make the entire CatalogIQ fullscreen.
+         *
+         * @example
+         * usePitcherApi().enterFullscreen()
+         */
+        ? /**
+         * Make the entire CatalogIQ fullscreen.
+         *
+         * @example
+         * usePitcherApi().enterFullscreen()
+         */: string;
+        lazy_sections?: boolean;
     }): Promise<import('../../main.lib').CanvasRetrieve>;
     updateCanvasIndicators(payload: {
         indicators: Record<string, import('../../main.lib').CanvasIndicator>;
@@ -159,11 +172,7 @@ export declare function createHighLevelApi(options?: ApiOptions): {
     getCanvas(payload: {
         id: import('../../main.lib').CanvasRetrieve["id"];
         fields?: string;
-        lazy_sections? /**
-         * Subscribe to updates.
-         *
-         * @returns {Promise<void>}
-         */: boolean;
+        lazy_sections?: boolean;
     }): Promise<import('../../main.lib').CanvasRetrieve>;
     getSectionsByIds(payload: {
         canvas_id: import('../../main.lib').CanvasRetrieve["id"];
@@ -305,5 +314,13 @@ export declare function createHighLevelApi(options?: ApiOptions): {
         canvas_id: import('../../main.lib').CanvasRetrieve["id"];
         theme_id: import('../../main.lib').CanvasThemeRetrieve["id"];
     }>;
+    sttStart(payload: import('../payload.types').SttStartPayload): Promise<void>;
+    sttAvailability(): Promise<import('../payload.types').SttAvailabilityResult>;
+    sttWarmup(): Promise<void>;
+    sttStop(payload: import('../payload.types').SttStopPayload): Promise<import('../payload.types').SttStopResult>;
+    sttErrorCode(error: unknown): import('../payload.types').SttErrorCode | undefined;
+    ttsSpeak(payload: import('../payload.types').TtsSpeakPayload): Promise<import('../payload.types').TtsSpeakResult>;
+    ttsStop(): Promise<void>;
+    ttsErrorCode(error: unknown): import('../payload.types').TtsErrorCode | undefined;
     API: LowLevelApi;
 };

package/lib/sdk/api/modules/admin/types.admin.d.ts

@@ -254,6 +254,7 @@ export type AdminEnv = {
     mode?: PitcherEnv['mode'];
     pitcher: PitcherEnv['pitcher'];
     launch_darkly?: LaunchDarklyEnv;
+    ui_locale?: PitcherEnv['ui_locale'];
     client_type?: (typeof CLIENT_TYPE)[keyof typeof CLIENT_TYPE];
     crm_shape?: Record<string, any>;
     state?: PitcherEnv['state'];

package/lib/sdk/api/modules/ai.d.ts

@@ -1,4 +1,17 @@
-import { AICompletePayload, AICompleteResult, AIRuntimeCapabilities, PiaSearchAnswerPayload, PiaSearchAnswerResult } from '../../payload.types';
+import { AICompletePayload, AICompleteResult, AIRuntimeCapabilities, PiaSearchAnswerPayload, PiaSearchAnswerResult, WeeklyFocusRankPayload, WeeklyFocusRankResult } from '../../payload.types';
+/**
+ * POST JSON to a next-core route with a hard deadline, returning the parsed body.
+ * The shared scaffold behind the SDK's online AI calls (`piaSearchAnswer`,
+ * `weeklyFocusRank`).
+ *
+ * Bounds the WHOLE request including the body read: `fetch()` resolves on headers
+ * alone, so reading `.json()` INSIDE the timed window (and letting the abort
+ * cancel that read too — hence `clearTimeout` in `finally`) is what stops a
+ * response that stalls mid-body from hanging unbounded. `label` names the route
+ * in BOTH the non-2xx error (`<label> <status>`) and the timeout error, so each
+ * caller keeps its exact error strings.
+ */
+export declare function postJsonWithTimeout<T>(url: string, body: unknown, accessToken: string, timeoutMs: number, label: string): Promise<T>;
 /**
  * Capabilities of the AI completion runtime on the current platform.
  *
@@ -50,3 +63,32 @@ export declare function aiComplete(payload: AICompletePayload): Promise<AIComple
  * console.log(result.answer, result.cited_file_ids, result.source)
  */
 export declare function piaSearchAnswer(payload: PiaSearchAnswerPayload): Promise<PiaSearchAnswerResult>;
+/**
+ * Rank the rep's next-7-days meetings by how much preparation they need — the
+ * ONE high-level Weekly Focus call (PIT-7257), the `weekly_focus` AITask.
+ *
+ * The on-device path runs the prompt, window, parser and ordinal resolver from
+ * `@lib/ai-tasks/weekly-focus`; the online route runs next-core's parallel copy
+ * of the same logic. The two are kept in lockstep by matching test suites, not a
+ * shared import (see that module's header / ADR-002), so the two paths produce
+ * the same shape:
+ *
+ * - iOS with an available local model → `aiComplete` over the caller-supplied
+ *   meetings + account context. Unavailable models / unusable output fall through.
+ * - Otherwise → POST to the next-core Bedrock route.
+ *
+ * The model picks meetings by ORDINAL and the resolver maps them back to
+ * event_ids, dropping out-of-range ones — so a returned id can only come from
+ * the `meetings` passed in.
+ *
+ * This does NOT cache, lock or prewarm: an app that generates on a schedule (as
+ * pre-call-brief does) owns those mechanics and calls this underneath.
+ *
+ * @param {WeeklyFocusRankPayload} payload - The meetings + optional account context.
+ * @returns {Promise<WeeklyFocusRankResult>} - Ranking with the serving `source`.
+ *
+ * @example
+ * const focus = await api.weeklyFocusRank({ meetings, context })
+ * console.log(focus.hero, focus.top, focus.collapsed_count)
+ */
+export declare function weeklyFocusRank(payload: WeeklyFocusRankPayload): Promise<WeeklyFocusRankResult>;

package/lib/sdk/api/modules/ai.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/sdk/api/modules/canvas.d.ts

@@ -44,6 +44,14 @@ export declare function updateCanvas(payload: PatchedCanvasUpdateRequest & {
     id: CanvasRetrieve['id'];
     instance_id?: Instance['id'];
     fields?: string;
+    /**
+     * Request the lazy "shell" on the PATCH response (section stubs +
+     * `section_ids` instead of expanded bodies). No-op unless the instance's
+     * `lazy_load_sections` setting is on (server-side double-gate). With a
+     * `fields` list that excludes `sections`, the response is byte-identical —
+     * only the server-side cost drops (PIT-7073).
+     */
+    lazy_sections?: boolean;
 }): Promise<CanvasRetrieve>;
 /**
  * Updates canvas indicators by canvas ID. It merges the passed object into existing canvas indicators adding new keys if they were empty and overriding pre-existing keys.

package/lib/sdk/api/modules/index.d.ts

@@ -2,7 +2,6 @@ export * from './ai';
 export * from './appsDb';
 export * from './open';
 export * from './env';
-export * from './languages';
 export * from './canvas';
 export * from './files';
 export * from './filesRevisions';
@@ -21,3 +20,5 @@ export * from './feedback';
 export * from './webView';
 export * from './share';
 export * from './theme';
+export * from './stt';
+export * from './tts';

package/lib/sdk/api/modules/stt.d.ts

@@ -0,0 +1,65 @@
+import { SttAvailabilityResult, SttErrorCode, SttStartPayload, SttStopPayload, SttStopResult } from '../../payload.types';
+export declare function sttStart(payload: SttStartPayload): Promise<void>;
+/**
+ * Check whether dictation can be offered — a side-effect-free capability probe
+ * to gate a mic button. Does NOT prompt for the microphone or download a model.
+ * Answered by the native bridge on iOS and the Impact host on web.
+ *
+ * @returns {Promise<SttAvailabilityResult>} `{ available, engine, reason? }` —
+ *   `available` is true only when the feature is enabled AND an engine can run;
+ *   `engine` is what would answer {@link sttStart} (`"webspeech"` sends audio
+ *   off-device); `reason` is `"disabled"` or `"unsupported"` when not available.
+ *
+ * @example
+ * const { available, engine } = await api.sttAvailability()
+ * if (available) showMicButton({ warnCloud: engine === 'webspeech' })
+ */
+export declare function sttAvailability(): Promise<SttAvailabilityResult>;
+/**
+ * Pre-load the on-device dictation model so a later {@link sttStart} resolves
+ * instantly (and the mic-permission prompt appears immediately instead of after
+ * a download). **Web only** — on iOS the native side manages its own model
+ * lifecycle, so the bridge has no `stt.warmup` type and calling it there rejects
+ * `requestTypeDoesNotExists`.
+ *
+ * Fire-and-forget: don't block your UI on it and ignore rejections. It is
+ * idempotent (repeated / concurrent calls collapse to a single download) and a
+ * no-op when the feature is disabled or the engine has nothing to warm (Web
+ * Speech fallback). Call it right after {@link sttAvailability} reports
+ * `available` with `engine === 'whisper'`.
+ *
+ * @returns {Promise<void>} Resolves once the model is ready (or immediately when
+ *   there's nothing to warm).
+ *
+ * @example
+ * const { available, engine } = await api.sttAvailability()
+ * if (available) {
+ *   showMicButton()
+ *   if (engine === 'whisper') api.sttWarmup().catch(() => {}) // background, non-blocking
+ * }
+ */
+export declare function sttWarmup(): Promise<void>;
+/**
+ * Finalize a dictation session. Resolves with the final full transcript;
+ * rejects with `STT_NOT_RECORDING` if the session isn't active.
+ *
+ * @param {SttStopPayload} payload
+ * @param {string} payload.session_id - The id passed to the matching {@link sttStart}.
+ * @returns {Promise<SttStopResult>} The final `{ transcript }`.
+ *
+ * @example
+ * const { transcript } = await api.sttStop({ session_id: 'notes-1' })
+ */
+export declare function sttStop(payload: SttStopPayload): Promise<SttStopResult>;
+/**
+ * Extract the {@link SttErrorCode} from a rejected `sttStart` / `sttStop`,
+ * normalizing across hosts: the iOS bridge rejection (`error_code` /
+ * `errorCode`) and Impact web's `{ reason }` / error `message` string. Returns
+ * `undefined` if no known code is present.
+ *
+ * @example
+ * try { await api.sttStart({ session_id }) } catch (err) {
+ *   if (api.sttErrorCode(err) === 'STT_BUSY') showMicInUseHint()
+ * }
+ */
+export declare function sttErrorCode(error: unknown): SttErrorCode | undefined;

package/lib/sdk/api/modules/stt.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/sdk/api/modules/tts.d.ts

@@ -0,0 +1,41 @@
+import { TtsErrorCode, TtsSpeakPayload, TtsSpeakResult } from '../../payload.types';
+/**
+ * Speak text on the device speaker. Resolves when the utterance FINISHES;
+ * rejects with a {@link TtsErrorCode}.
+ *
+ * @param {TtsSpeakPayload} payload
+ * @param {string} payload.text - Text to speak. Empty/whitespace rejects with `TTS_EMPTY_TEXT`.
+ * @param {string} [payload.language] - BCP-47/ISO tag (e.g. `"en-US"`); requires
+ *   an installed offline voice, else rejects with `TTS_VOICE_UNAVAILABLE`. Omit
+ *   for the system voice.
+ * @param {number} [payload.rate] - Speech rate; clamped to the platform min…max.
+ * @param {number} [payload.pitch] - Speech pitch; clamped `0.5`…`2.0` (`1.0` = normal).
+ * @returns {Promise<TtsSpeakResult>} `{ completed }` — `true` if it finished
+ *   naturally, `false` if stopped or replaced by a newer `ttsSpeak`.
+ *
+ * @example
+ * const { completed } = await api.ttsSpeak({ text: 'Meeting summary saved.', language: 'en-US' })
+ */
+export declare function ttsSpeak(payload: TtsSpeakPayload): Promise<TtsSpeakResult>;
+/**
+ * Stop any in-flight speech. The in-flight {@link ttsSpeak} resolves with
+ * `{ completed: false }`.
+ *
+ * @returns {Promise<void>}
+ *
+ * @example
+ * await api.ttsStop()
+ */
+export declare function ttsStop(): Promise<void>;
+/**
+ * Extract the {@link TtsErrorCode} from a rejected {@link ttsSpeak}, normalizing
+ * across hosts: the iOS bridge APIError (`code` / `error_code` / `errorCode`)
+ * and a host `{ reason }` / error `message` string. Returns `undefined` if no
+ * known code is present.
+ *
+ * @example
+ * try { await api.ttsSpeak({ text, language }) } catch (err) {
+ *   if (api.ttsErrorCode(err) === 'TTS_VOICE_UNAVAILABLE') promptVoiceDownload()
+ * }
+ */
+export declare function ttsErrorCode(error: unknown): TtsErrorCode | undefined;

package/lib/sdk/api/modules/tts.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/sdk/api/modules/ui/types.ui.d.ts

@@ -58,6 +58,13 @@ export declare const UI_MESSAGE_TYPES: {
 export declare const UI_NATIVE_MESSAGE_TYPES: readonly ["ui_app_set_data", "ui_app_update_data", "ui_canvas_updated"];
 export type UiBroadcastRequest = Record<string, any>;
 export type UiSelectContentRequest = {
+    /**
+     * Named sub-embedding of the content selector, forwarded verbatim to the selector app's
+     * `window.initialize` payload so ONE selector app can present itself differently per
+     * caller (PIT-7510: `ng-wizard` for the pitchdeck wizard). `embed_location` itself is set
+     * by the HOST and always wins, so a caller-specific context needs its own field.
+     */
+    embed_variant?: string;
     /** Array of selections */
     selections?: Selection[];
     content_type?: 'file' | 'slide' | 'content';

package/lib/sdk/interfaces.d.ts

@@ -5,6 +5,7 @@ import { PitcherInstance } from '../types/instance.types';
 import { LaunchDarklyEnv } from '../types/launchDarkly.types';
 import { CDP_EVENT_TYPE, CLIENT_TYPE } from '../constants/cdp.const';
 import { PeerConnectivityEvent } from './peer-connectivity';
+import { SttPartialEvent, SttInterruptedEvent } from './payload.types';
 export declare const PITCHER_EVENT: "PITCHER_EVENT";
 export declare enum PitcherMessageType {
     REQUEST = "PITCHER_REQUEST",
@@ -71,6 +72,10 @@ export interface PitcherEnv {
         active_canvas_id?: CanvasRetrieve['id'];
         canvas_correlation_id?: string;
     };
+    /** Locale the user picked in the Pitcher shell. Web only — iOS has no picker
+     * and reports `device_locale` instead. Apps should prefer this and fall back:
+     * `ui_locale || device_locale`. */
+    ui_locale?: string;
     device_locale?: string;
     sync_badge_value?: number;
 }
@@ -113,6 +118,12 @@ export interface StartCallPitcherEvent {
      * instead of "Unscheduled".
      */
     meeting_id?: string;
+    /**
+     * PIT-7462: start and immediately stop the call, opening the postcall form.
+     * The host seeds the call's eventDate from the scheduled meeting record
+     * (StartDateTime/EndDateTime) so the form never shows a 0-second duration.
+     */
+    jump_to_postcall?: boolean;
     canvas_id?: string;
     edit_mode?: 'true' | 'false';
     post_action?: string;
@@ -166,7 +177,9 @@ export declare enum PitcherEventName {
     ITEM_SHAREBOX_ADD_COMPLETED = "item_sharebox_add_completed",
     SYNC_BADGE_VALUE_REPORTED = "sync_badge_value_reported",
     SYNC_BOX_RESOLVE_ERROR_TAPPED = "sync_box_resolve_error_tapped",
-    PEER_CONNECTIVITY_EVENT = "peer_connectivity_event"
+    PEER_CONNECTIVITY_EVENT = "peer_connectivity_event",
+    STT_PARTIAL = "stt.partial",
+    STT_INTERRUPTED = "stt.interrupted"
 }
 export declare enum PitcherBroadcastedEventName {
     UI_SHOW_MODAL = "ui:show-modal",
@@ -487,6 +500,18 @@ export interface PitcherEventMap {
         last_error: string;
     };
     [PitcherEventName.PEER_CONNECTIVITY_EVENT]: PeerConnectivityEvent;
+    /**
+     * Speech-to-text dictation partial (PITCHER_REQUEST `stt.start` session).
+     * Cross-platform (iOS bridge and the web host engine). `text` is the FULL
+     * transcript so far — replace, don't append.
+     */
+    [PitcherEventName.STT_PARTIAL]: SttPartialEvent;
+    /**
+     * Speech-to-text dictation session ended WITHOUT a `stt.stop` (e.g. a call
+     * recording preempted the mic on iOS, or a fatal capture error on web). Stop
+     * waiting for partials and reset the field. Cross-platform.
+     */
+    [PitcherEventName.STT_INTERRUPTED]: SttInterruptedEvent;
     [PitcherBroadcastedEventName.UI_SHOW_MODAL]: void;
     [PitcherBroadcastedEventName.UI_HIDE_MODAL]: void;
     [PitcherBroadcastedEventName.FILE_DOWNLOAD]: {