@pitcher/js-api 1.29.0 → 1.31.0

package/lib/sdk/payload.types.d.ts

@@ -563,6 +563,22 @@ export interface PiaSearchAnswerPayload {
      * Optional narrowing of the online route's candidate pool to these file ids.
      */
     file_ids?: string[];
+    /**
+     * Opt in to server-side document grounding: the online route fetches the
+     * transcripts of `file_ids` and adds query-relevant verbatim passages to the
+     * prompt. Requires `file_ids`; ignored without them.
+     *
+     * Explicit rather than inferred from `file_ids` so that a caller which
+     * already narrows by ids keeps its exact prompt. Online path only — the
+     * on-device token budget cannot absorb document excerpts.
+     */
+    include_document_text?: boolean;
+    /**
+     * Client-derived synonym terms for the query. Used only to choose WHICH
+     * passages of `file_ids` are excerpted — they can never add a file, and the
+     * server re-validates them. Ignored unless `include_document_text` is set.
+     */
+    expansion_terms?: string[];
     /**
      * Token budget for the on-device completion.
      */
@@ -641,6 +657,38 @@ export interface AppsDbDeleteEntryPayload {
 export interface AppsDbPsqlPayload {
     query: string;
 }
+/**
+ * Page-level attribution for ONE cited file (PIT-8062).
+ *
+ * `page_indices` is **0-based** — the same base `openFile(fileId, pageIndex)`
+ * and the iOS `page_index` → `pdfPageIndex` bridge take, so a consumer passes
+ * the value straight through and only adds 1 for a user-facing label. The model
+ * emits 1-based page numbers (it echoes the label it was shown); next-core's
+ * pia-search route converts them exactly once, server-side.
+ */
+export interface PiaSearchCitation {
+    /**
+     * A file id that also appears in `cited_file_ids`.
+     *
+     * That superset relation is a **server guarantee**, not something this SDK
+     * enforces: next-core's pia-search route builds `cited_file_ids` as the union
+     * of the model's own list and every citation's `file_id`, so a file can be
+     * added by a citation but never removed by one. The SDK coerces the two
+     * fields independently and does not cross-check them — it has no way to tell a
+     * contract violation from a backend newer than itself.
+     */
+    file_id: string;
+    /**
+     * 0-based viewer page indices.
+     *
+     * The route emits them ascending, deduped, one entry per file and at most 5
+     * per file. Those are again **server** guarantees, restated here so a consumer
+     * knows what to expect; this SDK passes the array through untouched rather
+     * than re-normalizing it, so it cannot drift from whatever the route decides.
+     * A consumer that renders fixed-width chips should still cap what it draws.
+     */
+    page_indices: number[];
+}
 /**
  * Unified `piaSearchAnswer` result across both serving paths.
  */
@@ -653,6 +701,19 @@ export interface PiaSearchAnswerResult {
      * File ids (from the candidate context) the answer drew on. Online path only.
      */
     cited_file_ids?: string[];
+    /**
+     * Which page(s) of each cited file the answer was grounded in (PIT-8062).
+     * Online, document-grounded path only, and only when the instance has the
+     * `pia_search_page_citations` flag on.
+     *
+     * **Optional at RUNTIME, not merely in the types.** Consumers load this SDK
+     * from an unversioned CDN tag, so the bundle a rep runs may predate the field
+     * entirely; and a backend with the flag off omits it from the body. The key is
+     * absent in those cases — never `null`, never `[]`. A cited file with no page
+     * information still appears in `cited_file_ids`: degrade to a file-level
+     * citation, never to an empty state.
+     */
+    citations?: PiaSearchCitation[];
     /**
      * Model self-reported confidence. Online path only.
      */
@@ -842,3 +903,91 @@ export interface TtsSpeakResult {
      */
     completed: boolean;
 }
+/**
+ * Payload for `weeklyFocusRank` — one high-level call that ranks the rep's
+ * next-7-days meetings, routed on-device (iOS Gemma) or online (next-core
+ * Bedrock route). Calendar fetching stays caller-side: the caller owns the
+ * meeting list and passes it in.
+ */
+export interface WeeklyFocusRankPayload {
+    /**
+     * The rep's meetings. Windowed to today + 6 days by the SDK/route — send the
+     * whole calendar if that is what you have.
+     */
+    meetings: WeeklyFocusRankMeeting[];
+    /**
+     * One CRM context bundle per UNIQUE account, keyed by `account_id` (open
+     * tasks, opportunity state, recent calls — whatever the admin mapped).
+     */
+    context?: Record<string, WeeklyFocusRankAccountContext>;
+    /**
+     * Instance to rank in. Defaults to the env's active instance.
+     */
+    instance_id?: string;
+    /**
+     * IANA zone the 7-day window is measured in. Defaults to the device's zone,
+     * which is the rep's zone on-device; ALWAYS sent to the online route, whose
+     * server clock is UTC.
+     */
+    time_zone?: string;
+    /**
+     * How many meetings to pick (1-8, default 5).
+     */
+    max_picks?: number;
+    /**
+     * Keep at most one pick per account. Default true.
+     */
+    one_per_account?: boolean;
+}
+export interface WeeklyFocusRankMeeting {
+    event_id: string;
+    account_id: string;
+    account_name: string;
+    meeting_subject: string;
+    /** ISO datetime, or a date-only 'YYYY-MM-DD'. */
+    meeting_time: string;
+    attendee_count?: number;
+}
+export interface WeeklyFocusRankAccountContext {
+    sections: Array<{
+        label: string;
+        items: Array<{
+            title: string;
+            fields?: Array<{
+                label: string;
+                value: string;
+            }>;
+            days_ago?: number | null;
+        }>;
+        fields_curated?: boolean;
+    }>;
+}
+/** One ranked pick, resolved back to a real meeting id. */
+export interface WeeklyFocusRankPick {
+    event_id: string;
+    /** 1 = highest priority; unique and contiguous from 1. */
+    rank: number;
+    reason: string;
+}
+/**
+ * Unified `weeklyFocusRank` result across both serving paths.
+ */
+export interface WeeklyFocusRankResult {
+    /**
+     * One or two sentences summarising the week. Empty when the week is empty.
+     */
+    hero: string;
+    /**
+     * The picked meetings, highest priority first.
+     */
+    top: WeeklyFocusRankPick[];
+    /**
+     * Meetings in the 7-day window that were NOT picked — including those the
+     * ranking never saw. The surface renders this as "+N more this week".
+     */
+    collapsed_count: number;
+    /**
+     * Which runtime produced the ranking.
+     */
+    source: 'on_device' | 'online';
+}

package/lib/sdk/platform.d.ts

@@ -0,0 +1,27 @@
+import { PLATFORM_TYPE } from '../constants/cdp.const';
+import { PitcherEnv } from './interfaces';
+export type PitcherMode = PitcherEnv['mode'];
+export type PitcherPlatformType = (typeof PLATFORM_TYPE)[keyof typeof PLATFORM_TYPE];
+/** The one value a browser reports. Every other `mode` comes from a native shell's bridge. */
+export declare const WEB_MODE = "WEB";
+/**
+ * Is this host a NATIVE shell rather than a browser?
+ *
+ * `env.mode` names the platform (`WEB`, `IOS`, `MACOS`, `WINDOWS`, `ANDROID`). Only the browser
+ * builds (Impact web, Admin) ever say `WEB`; every other value is a shell that answers `getEnv`
+ * over a JS bridge and keeps an offline mirror. The distinction most platform branches actually
+ * want is "bridge + offline mirror or plain HTTP", NOT "iPad" — for years there was only one
+ * native host, so the two were spelled the same (`mode === 'IOS'`).
+ *
+ * **Backward and forward compatible by construction:** the check is `mode !== 'WEB'`, not a
+ * lookup in a closed list. An SDK or Slotty bundle built today keeps treating a host it has never
+ * heard of (a future `LINUX`, say) as native, so a new host never needs a lockstep web deploy to
+ * keep its offline paths, and an old host reporting `IOS` is unchanged.
+ *
+ * Use this wherever the branch means "the host answers this over its bridge / has local files /
+ * has no on-demand fetch". Keep a literal `mode === 'IOS'` ONLY for iPad HARDWARE — Multipeer
+ * peer session, the Salesforce Mobile SDK's SmartStore, on-device inference — which no other
+ * host implements and which answer `requestTypeDoesNotExists` there.
+ */
+export declare function isNativeHost(mode: PitcherMode | string | null | undefined): boolean;
+export declare function platformTypeForMode(mode: PitcherMode | string | null | undefined): PitcherPlatformType | undefined;

package/lib/sdk/platform.spec.d.ts

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

package/lib/sdk/singleton-scope.spec.d.ts

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

package/lib/sdk/utils/httpFetch.spec.d.ts

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

package/lib/theme/canvasUiUnoPreset.test.d.ts

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

package/lib/types/ai-tasks.const.d.ts

@@ -28,6 +28,19 @@
  * engine — its context comes from the caller / iOS SmartStore — so it is
  * offline/Gemma-capable (`backends: ['bedrock', 'gemma']`).
  *
+ * `weekly_focus` (PIT-7257) is another NEW task added alongside the locked four
+ * (NOT a rename/removal). It ranks the rep's next-7-days meetings by how much
+ * they need preparation, using each account's CRM context. Unlike every other
+ * task it is a PORT of a shipped implementation: it has been running on-device
+ * (Gemma `ai.complete`) inside the pre-call-brief app since PIT-6305, so
+ * `backends: ['bedrock', 'gemma']` is validated in practice rather than aspired
+ * to. `requires` is empty for the same reason as `pia_search`: the meeting list
+ * and per-account context are request-envelope fields, not AITaskRequirement
+ * vocabulary. Its prompt/window/parser are implemented twice — in
+ * `src/lib/ai-tasks/weekly-focus.ts` (SDK + app) and in next-core's
+ * `prompts/weekly-focus.ts` (Bedrock route) — kept behaviourally in lockstep by
+ * each side's tests, since next-core imports canvas-ui types only (ADR-002).
+ *
  * `pia_search` (PIT-6863) is another NEW task added alongside the locked four
  * (NOT a rename/removal). It answers a rep's natural-language question over the
  * instance's content + metadata (Postgres/Django candidates + aiAnalysis
@@ -37,9 +50,34 @@
  * ['bedrock', 'gemma']`. `requires` is empty: its inputs (query + instance) are
  * request-envelope fields, not AITaskRequirement vocabulary, and candidate
  * retrieval happens server-side.
+ *
+ * `content_metadata` (cluster F / R137) is another NEW task added alongside the
+ * locked four (NOT a rename/removal). It proposes metadata field values and tags
+ * for ONE content file, constrained to the instance's own metadata template —
+ * Django validates `File.metadata` writes against that template, so select
+ * fields must stay inside the template's allowed option values. `backends:
+ * ['bedrock']` only: it is an admin-context bulk operation, with no on-device
+ * (Gemma) serving. `requires` is empty for the same reason as `pia_search`: the
+ * file facts and template fields are request-envelope inputs, not
+ * AITaskRequirement vocabulary.
+ *
+ * `translate` (Gartner R128 / cluster G) is another NEW task added alongside the
+ * locked four (NOT a rename/removal). It translates keyed prose segments of a
+ * canvas template into ONE target language — N segments in, N translations out,
+ * keyed, with per-segment error isolation: a segment whose translation loses a
+ * Handlebars placeholder or an HTML tag keeps its source text and is reported,
+ * rather than failing the whole template. It is the FIRST task whose output must
+ * line up 1:1 with its input, and because JSON Schema cannot express that, the
+ * parity guarantee lives in next-core code (`reconcileTranslations`, called
+ * route-side after the model call) and not in the output schema. `backends:
+ * ['bedrock']` only: it is an admin-context content-governance operation with no
+ * on-device (Gemma) serving, and binary documents take the DeepL document path
+ * instead, which is not an AITask. `requires` is empty for the same reason as
+ * `pia_search`: the segments and the target language are request-envelope inputs,
+ * not AITaskRequirement vocabulary.
  */
 /** Locked cross-backend task ids. AITask id === the wire-contract string. */
-export type AITask = 'meeting_prep' | 'discussion_points' | 'pitch_deck' | 'post_call_summary' | 'account_insights' | 'precall_notes' | 'pia_search';
+export type AITask = 'meeting_prep' | 'discussion_points' | 'pitch_deck' | 'post_call_summary' | 'account_insights' | 'precall_notes' | 'pia_search' | 'weekly_focus' | 'content_metadata' | 'translate';
 /**
  * Vocabulary of declarative input requirements a task can depend on. A task's
  * `requires` list is server-enforced in next-core (missing → 400

package/lib/types/app.d.ts

@@ -73,7 +73,9 @@ type AppTypeJsonOptions = {
         width?: number | string;
         height?: number | string;
     };
-    placement?: 'top-left' | 'top-center' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+    placement?: 'top-left' | 'top-center' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom-center' | 'bottom-right'
+    /** canvas-popup only: full-width sheet sliding up from the bottom (the presentation-tools shell); `dimensions` are ignored. ui-global-popup apps fall back to `center`. */
+     | 'bottom-sheet';
     mode_config?: {
         fullscreen?: {
             show?: boolean;
@@ -92,6 +94,57 @@ type AppTypeJsonOptions = {
         };
     };
 };
+/**
+ * One field of an app's `secrets_schema`.
+ *
+ * `type` drives how Admin renders the input, and the rules differ by schema shape — see
+ * `client/src/admin/util/appSecrets.ts` and the vocabulary table in next-core's
+ * `api/protected/apps/[app_name]/secrets/README.md`. In short: a flat schema masks everything
+ * except an explicit `'text'`; a `_strategy` schema treats `'string'` as readable and `'password'`
+ * as masked. `required` is absent-means-true — only `false` marks a field optional.
+ */
+export type SecretFieldSchema = {
+    type?: 'string' | 'password' | 'text' | 'select';
+    description?: string;
+    required?: boolean;
+    /** `type: 'select'` only. */
+    options?: {
+        label: string;
+        value: string;
+    }[];
+};
+/** The `_strategy` entry: lets one app offer alternative credential sets (e.g. user/pass vs ECA). */
+export type SecretStrategySchema = {
+    key: string;
+    label: string;
+    default: string;
+    options: Record<string, {
+        label: string;
+    }>;
+};
+/** A schema with no `_strategy`: every entry is a field. The common case. */
+export type FlatSecretsSchema = Record<string, SecretFieldSchema>;
+/**
+ * A schema that offers alternative credential sets: the `_strategy` entry, plus one GROUP of
+ * fields per strategy key (e.g. `user_pass` and `eca` in sfdc-activity-tracking).
+ */
+export type StrategySecretsSchema = {
+    _strategy: SecretStrategySchema;
+    [group: string]: SecretStrategySchema | FlatSecretsSchema;
+};
+/**
+ * An app's `secrets_schema`, in either shape.
+ *
+ * A UNION, not an intersection: the two shapes disagree about what a value is, and `_strategy`
+ * cannot be both a {@link SecretFieldSchema} and a {@link SecretStrategySchema} — `options` alone
+ * is an array of `{label, value}` in one and a `Record<string, {label}>` in the other. Modelling it
+ * as one indexed object made every strategy schema unconstructible without a cast.
+ *
+ * Narrow with `secretsStrategyOf()` in `client/src/admin/util/appSecrets.ts` rather than testing
+ * `_strategy` for truthiness: under {@link FlatSecretsSchema} a field could legitimately be NAMED
+ * `_strategy`, and a truthiness test would then read that field as strategy config.
+ */
+export type SecretsSchema = FlatSecretsSchema | StrategySecretsSchema;
 export type AppJson = {
     name: string;
     display_name: string;
@@ -108,6 +161,7 @@ export type AppJson = {
     order_override?: number;
     has_multiple_routes?: boolean;
     configure_entry?: string;
+    secrets_schema?: SecretsSchema;
 };
 export type AppFile = File & {
     app_metadata?: AppJson;

package/lib/types/call.d.ts

@@ -54,5 +54,19 @@ export interface Call {
     presentationHistory?: CallPresentationHistory;
     presentationHistoryMetadata?: CallPresentationHistoryMetadata;
     recentAccounts?: SfAccount[];
+    /**
+     * Context accounts beyond the primary.
+     *
+     * The React meeting bar's "Set context" overlay is **single-select** — it writes exactly one
+     * account — so it no longer produces entries here; the field is kept because other flows (CRM
+     * Hub launches, passthrough, cross-account attendees) and calls persisted by older bundles can
+     * still carry them. `selectedAccount` stays the primary and remains the only account the
+     * single-account consumers see (the meeting-notes recording bridge, recents, and the deck
+     * scope), so this is purely additive — nothing existing reads it.
+     *
+     * Optional because `Call` is persisted in localStorage: a call object written by an older
+     * bundle has no such key.
+     */
+    additionalAccounts?: SfAccountMini[];
 }
 export declare const INITIAL_CALL_STATE: Call;

package/lib/types/canvases.d.ts

@@ -4,6 +4,7 @@ export interface GetCanvasesParams {
     instance_id?: string;
     is_draft?: boolean;
     is_editable?: boolean;
+    is_master?: boolean;
     is_section?: boolean;
     is_template?: boolean;
     is_default?: boolean;
@@ -16,6 +17,20 @@ export interface GetCanvasesParams {
     id__in?: string;
     access_type?: string;
     template__id?: string;
+    /**
+     * `'member'` resolves visibility as a plain member even for admins/editors —
+     * only canvases distributed to the caller's groups, public ones, or their own
+     * are returned (PIT-8022). Honored by the next-core distributed endpoint;
+     * ignored (harmless) by the Django list endpoint and the iOS bridge.
+     */
+    scope?: 'member';
+    /**
+     * Skips the `COUNT(DISTINCT c.id)` pagination query. The response then
+     * reports `count: 0`, so only pass it when the caller does not paginate.
+     * Honored by the next-core distributed endpoint; ignored (harmless)
+     * elsewhere.
+     */
+    skip_count?: boolean;
 }
 export interface CanvasMetadataRetrieve {
     config: Record<string, any> & {

package/lib/types/launchDarkly.types.d.ts

@@ -1,4 +1,4 @@
-export type LaunchDarklyBooleanFlagKey = 'ai_image_generation_model' | 'ai_video_generation_model' | 'allow_ai_prompts_in_canvas_text' | 'allow_bulk_actions_canvases_files' | 'allow_content_grid_autofill' | 'allow_canvas_duplication' | 'allow_canvases_tables_columns_settings' | 'allow_table_column_resizing' | 'allow_creating_canvas_with_no_template' | 'allow_dynamic_data_table_for_scribble_component' | 'allow_html_for_scribble_component' | 'allow_embeddable_for_scribble_component' | 'allow_embeddable_hiding' | 'allow_multimedia_for_scribble_component' | 'allow_note_taking' | 'allow_rep_canvas_metadata_edit' | 'allow_rep_file_distributions' | 'allow_rep_file_rating' | 'allow_rep_file_upload' | 'allow_saving_annotations_in_personal_layer' | 'allow_user_to_edit_font_size_and_color_in_canvas_tokens' | 'are_sections_system_controlled' | 'enable_canvas_core_distributions' | 'copy_context_to_canvas' | 'copy_template_metadata_to_canvas' | 'disable_canvas_edit_for_reps' | 'disable_custom_tooltips' | 'disable_file_edit_content' | 'enable_inline_wopi_edit_button' | 'disable_fullscreen_canvas_builder' | 'disable_impact_web_browser_fullscreen' | 'disable_user_invitations' | 'display_section_list_name' | 'disable_download_canvas' | 'enable_ai_generated_thumbnails' | 'enable_analytics' | 'enable_app_developer_role' | 'enable_algolia_search' | 'enable_background_image_theme_options' | 'enable_better_canvas_builder_control_bars_on_zoom' | 'enable_bulk_update_file_attributes' | 'enable_canvas_as_home' | 'enable_canvas_blocks' | 'enable_canvas_node_debugging' | 'enable_canvas_freeze' | 'enable_canvas_locks' | 'enable_canvas_template_edit_in_impact' | 'enable_canvas_tokens' | 'enable_collaborations' | 'enable_collection_player_data_accessor' | 'enable_content_grid_data_accessor' | 'enable_content_type_change_in_content_selector' | 'enable_cross_tab_instance_reload_for_ld_sync' | 'enable_create_section_from_section_template' | 'enable_custom_display_overrides' | 'enable_default_crm_shape' | 'enable_detailed_date_format' | 'enable_dsr_readonly_annotations' | 'enable_dnd_html_editor' | 'enable_dynamic_content_component' | 'enable_dynamic_data_table_component' | 'enable_custom_data_tables' | 'enable_embedded_video_autoplay' | 'enable_embedded_video' | 'enable_enhanced_canvas_drawer_app' | 'enable_enhanced_indicators' | 'enable_enhanced_section_execution_states' | 'enable_experimental_canvas_builder_dnd' | 'enable_extra_file_data' | 'enable_file_copy' | 'enable_file_pages_metadata' | 'enable_file_revisions' | 'enable_file_divisible_permission' | 'enable_folder_details_edit' | 'enable_folder_distributions' | 'enable_handlebar_template_support' | 'enable_height_in_component_theming' | 'enable_home_customization' | 'enable_hotspot_visibility' | 'enable_improved_canvas_node_updating' | 'enable_individual_users_in_file_distribution' | 'enable_inline_filter_options' | 'enable_insearch_in_section_selector' | 'enable_instance_cloner' | 'enable_advanced_cloner' | 'enable_content_promotion' | 'enable_instance_editor_role' | 'enable_instance_navigation_from_management' | 'enable_knock_notifications' | 'enable_maintain_section_theme_control' | 'enable_metadata_in_file_uploads_with_default_values' | 'enable_more_intuitive_component_spacing' | 'enable_multi_destination_upload' | 'enable_multimedia_component_ai_images' | 'enable_new_meeting_bar' | 'enable_provider_agnostic_meeting_bar' | 'enable_original_pdf_link' | 'enable_scale_content' | 'enable_sorting_in_tiptap_table' | 'enable_stt_dictation' | 'enable_cloud_stt_fallback' | 'enable_theme_assets' | 'enable_toc_enhancements_to_support_same_section_in_section_list' | 'enable_pia_assistant' | 'enable_pipe_character_multi_search' | 'enable_popup_apps' | 'enable_pre_send_validation' | 'enable_reorder_search' | 'enable_reorder_scribble_isolation' | 'enable_reorder_component_options_menu' | 'enable_resizable_multimedia_component' | 'enable_responsive_scribble_component' | 'enable_saved_canvases_filters' | 'enable_short_tag_column_in_tables' | 'enable_scribble_component' | 'enable_scribble_content_as_background' | 'enable_search_and_filters_in_multimedia_component' | 'enable_section_context_in_dsr' | 'enable_selectors_dnd' | 'enable_section_selector_edit_section' | 'enable_smart_folders' | 'enable_smart_folders_for_sections' | 'enable_smart_folders_in_section_selector' | 'enable_smart_folders_in_files' | 'enable_sorting_in_sections' | 'enable_suggested_tags' | 'enable_template_component_permissions' | 'enable_template_folders' | 'enable_theme_options_border_radius' | 'enable_themes' | 'hide_asset_uploader' | 'hide_user_feedback_widget' | 'include_files_content_in_print' | 'interpolate_rep_canvases_on_edit_mode' | 'is_timeline_component_allowed' | 'launch_in_full_screen_on_present_mode' | 'prefer_online_handlers' | 'restrict_owned_files_from_admins' | 'show_asset_manager_for_multimedia' | 'show_clear_all_annotations_button' | 'show_content_selector_list_view' | 'show_metadata_filters_in_all_canvas_things' | 'show_only_preview_mode_for_html_component' | 'show_popularity_icons' | 'use_core_endpoint_for_analytics' | 'convert_pptx_to_section_with_scribble_pdfjs' | 'use_short_url_for_shared_link' | 'use_zoho_instead_of_ms_wopi' | 'enable_new_section_list' | 'enable_sharebox_apps' | 'enable_sharebox_bulk_filtering' | 'enable_back_to_previous_location_in_canvas' | 'enable_crm_shape_for_external_links' | 'enable_adaptive_popup_apps' | 'enable_file_version_polling' | 'skip_pspdfkit_wait_for_high_res_thumbs' | 'skip_pspdfkit_tile_size_workaround' | 'enable_reactive_scribble_component_toolbar' | 'enable_embeddable_full_screen_mode' | 'enable_enhanced_user_management' | 'enable_impersonation' | 'enable_instance_admin_user_assignment' | 'keep_static_pptx_editable' | 'enable_canvas_pdf_dimensions' | 'enable_editable_pptx_of_canvas' | 'enable_editable_pptx_of_canvas_with_fonts' | 'enable_aspose_pptx_of_canvas' | 'enable_canvas_control_bars_collapse' | 'enable_rep_app_visibility_order' | 'enable_file_sharing_print_permissions' | 'enable_section_sharing_print_permissions' | 'enable_marketplace_tab' | 'enable_sfdc_account_visibility_for_canvases' | 'sfdc_offline_enabled' | 'enable_granular_permissions' | 'enable_hub_collections' | 'enable_hub_recommended_smart_folder' | 'enable_custom_user_properties';
+export type LaunchDarklyBooleanFlagKey = 'allow_ai_prompts_in_canvas_text' | 'allow_bulk_actions_canvases_files' | 'allow_content_grid_autofill' | 'allow_canvas_duplication' | 'allow_canvases_tables_columns_settings' | 'allow_table_column_resizing' | 'allow_creating_canvas_with_no_template' | 'allow_dynamic_data_table_for_scribble_component' | 'allow_html_for_scribble_component' | 'allow_embeddable_for_scribble_component' | 'allow_embeddable_hiding' | 'allow_multimedia_for_scribble_component' | 'allow_note_taking' | 'allow_rep_canvas_metadata_edit' | 'allow_rep_file_distributions' | 'allow_rep_file_rating' | 'allow_rep_file_upload' | 'allow_saving_annotations_in_personal_layer' | 'allow_user_to_edit_font_size_and_color_in_canvas_tokens' | 'are_sections_system_controlled' | 'enable_canvas_core_distributions' | 'copy_context_to_canvas' | 'copy_template_metadata_to_canvas' | 'disable_canvas_edit_for_reps' | 'disable_custom_tooltips' | 'disable_file_edit_content' | 'enable_inline_wopi_edit_button' | 'disable_fullscreen_canvas_builder' | 'disable_impact_web_browser_fullscreen' | 'disable_user_invitations' | 'display_section_list_name' | 'disable_download_canvas' | 'enable_ai_generated_thumbnails' | 'enable_analytics' | 'enable_app_developer_role' | 'enable_algolia_search' | 'enable_background_image_theme_options' | 'enable_better_canvas_builder_control_bars_on_zoom' | 'enable_bulk_update_file_attributes' | 'enable_canvas_as_home' | 'enable_canvas_blocks' | 'enable_canvas_node_debugging' | 'enable_canvas_freeze' | 'enable_canvas_locks' | 'enable_canvas_template_edit_in_impact' | 'enable_canvas_tokens' | 'enable_collaborations' | 'enable_collection_player_data_accessor' | 'enable_content_grid_data_accessor' | 'enable_content_translation' | 'enable_content_type_change_in_content_selector' | 'enable_cross_tab_instance_reload_for_ld_sync' | 'enable_create_section_from_section_template' | 'enable_custom_display_overrides' | 'enable_default_crm_shape' | 'enable_detailed_date_format' | 'enable_dsr_readonly_annotations' | 'enable_dnd_html_editor' | 'enable_dynamic_content_component' | 'enable_dynamic_data_table_component' | 'enable_custom_data_tables' | 'enable_embedded_video_autoplay' | 'enable_embedded_video' | 'enable_enhanced_canvas_drawer_app' | 'enable_enhanced_indicators' | 'enable_enhanced_section_execution_states' | 'enable_experimental_canvas_builder_dnd' | 'enable_extra_file_data' | 'enable_file_copy' | 'enable_file_pages_metadata' | 'enable_file_revisions' | 'enable_file_divisible_permission' | 'enable_folder_details_edit' | 'enable_folder_distributions' | 'enable_handlebar_template_support' | 'enable_height_in_component_theming' | 'enable_home_customization' | 'enable_hotspot_visibility' | 'enable_improved_canvas_node_updating' | 'enable_individual_users_in_file_distribution' | 'enable_inline_filter_options' | 'enable_insearch_in_section_selector' | 'enable_instance_cloner' | 'enable_advanced_cloner' | 'enable_content_promotion' | 'enable_instance_editor_role' | 'enable_instance_navigation_from_management' | 'enable_knock_notifications' | 'enable_maintain_section_theme_control' | 'enable_master_pitchdecks' | 'enable_metadata_in_file_uploads_with_default_values' | 'enable_more_intuitive_component_spacing' | 'enable_multi_destination_upload' | 'enable_new_meeting_bar' | 'enable_provider_agnostic_meeting_bar' | 'enable_original_pdf_link' | 'enable_scale_content' | 'enable_sorting_in_tiptap_table' | 'enable_stt_dictation' | 'enable_cloud_stt_fallback' | 'enable_theme_assets' | 'enable_toc_enhancements_to_support_same_section_in_section_list' | 'enable_pia_assistant' | 'enable_pipe_character_multi_search' | 'enable_popup_apps' | 'enable_pre_send_validation' | 'enable_reorder_search' | 'enable_reorder_scribble_isolation' | 'enable_reorder_component_options_menu' | 'enable_resizable_multimedia_component' | 'enable_responsive_scribble_component' | 'enable_saved_canvases_filters' | 'enable_short_tag_column_in_tables' | 'enable_scribble_component' | 'enable_scribble_content_as_background' | 'enable_search_and_filters_in_multimedia_component' | 'enable_section_context_in_dsr' | 'enable_selectors_dnd' | 'enable_section_selector_edit_section' | 'enable_smart_folders' | 'enable_smart_folders_for_sections' | 'enable_smart_folders_in_section_selector' | 'enable_smart_folders_in_files' | 'enable_sorting_in_sections' | 'enable_suggested_tags' | 'enable_template_component_permissions' | 'enable_template_folders' | 'enable_theme_options_border_radius' | 'enable_themes' | 'hide_asset_uploader' | 'hide_user_feedback_widget' | 'include_files_content_in_print' | 'interpolate_rep_canvases_on_edit_mode' | 'is_timeline_component_allowed' | 'launch_in_full_screen_on_present_mode' | 'prefer_online_handlers' | 'restrict_owned_files_from_admins' | 'show_asset_manager_for_multimedia' | 'show_clear_all_annotations_button' | 'show_content_selector_list_view' | 'show_metadata_filters_in_all_canvas_things' | 'show_only_preview_mode_for_html_component' | 'show_popularity_icons' | 'use_core_endpoint_for_analytics' | 'convert_pptx_to_section_with_scribble_pdfjs' | 'use_short_url_for_shared_link' | 'use_zoho_instead_of_ms_wopi' | 'enable_new_section_list' | 'enable_sharebox_apps' | 'enable_sharebox_bulk_filtering' | 'enable_back_to_previous_location_in_canvas' | 'enable_crm_shape_for_external_links' | 'enable_adaptive_popup_apps' | 'enable_file_version_polling' | 'skip_pspdfkit_wait_for_high_res_thumbs' | 'enable_reactive_scribble_component_toolbar' | 'enable_embeddable_full_screen_mode' | 'enable_enhanced_user_management' | 'enable_impersonation' | 'enable_instance_admin_user_assignment' | 'keep_static_pptx_editable' | 'enable_canvas_pdf_dimensions' | 'enable_editable_pptx_of_canvas' | 'enable_editable_pptx_of_canvas_with_fonts' | 'enable_aspose_pptx_of_canvas' | 'enable_canvas_control_bars_collapse' | 'enable_rep_app_visibility_order' | 'enable_file_sharing_print_permissions' | 'enable_section_sharing_print_permissions' | 'enable_marketplace_tab' | 'enable_sfdc_account_visibility_for_canvases' | 'sfdc_offline_enabled' | 'enable_granular_permissions' | 'enable_hub_recommended_smart_folder' | 'enable_custom_user_properties';
 export type LaunchDarklyNumberFlagKey = 'canvas_section_selector_page_size' | 'canvas_section_selector_selected_items_with_thumbnail_size';
 /** How PIA Search serves inference (PIT-6863). */
 export type PiaSearchMode = 'off' | 'on_device' | 'online';
@@ -29,8 +29,6 @@ declare const _LaunchDarklyStringFlags: {
     readonly pspdfkit_client_version: readonly ["", "pspdfkit-web/2024.6.0/pspdfkit.js", "pspdfkit-web/1.14.0/nutrient-viewer.js"];
     readonly slotty_ui_remote_script_url: readonly ["https://anyvalidurl.xyz", ""];
     readonly dsr_remote_script_url: readonly ["https://anyvalidurl.xyz", ""];
-    readonly ai_image_generation_model: readonly ["minimax/image-01", ""];
-    readonly ai_video_generation_model: readonly ["minimax/video-01", ""];
     readonly sharebox_format: readonly ["content-grid", "content-grid-default", "collection-player-default"];
 };
 type LaunchDarklyStringFlagValue<K extends LaunchDarklyStringFlagKey = LaunchDarklyStringFlagKey> = K extends LaunchDarklyStringFlagKey ? (typeof _LaunchDarklyStringFlags)[K][number] : never;
@@ -47,6 +45,13 @@ export type CanvasManagerTableColumns = {
     canvases: CanvasManagerVisibility;
     section_templates: CanvasManagerVisibility;
     sections: CanvasManagerVisibility;
+    /**
+     * PIT-7488 — the master pitchdeck tab. Optional because the LD flag predates it and no
+     * environment configures it yet; `getVisibleColumns` degrades to "show every column" when the
+     * key is absent, so masters must NOT inherit the `canvases` config (hiding a column on the
+     * Pitchdecks tab would otherwise silently hide it here too).
+     */
+    master_canvases?: CanvasManagerVisibility;
 };
 export type LaunchDarklyEnv = {
     [K in LaunchDarklyBooleanFlagKey]?: boolean;

package/lib/types/organizationSettings.types.d.ts

@@ -10,6 +10,7 @@ export type ContentMatchRule = {
     target_metadata_key: string;
     required?: boolean;
 };
+export type FullscreenMode = 'focus' | 'fullscreen';
 type SmartFolderRuleAttribute = {
     name: string;
     type: 'string' | 'boolean' | 'number' | 'date' | 'array';
@@ -37,6 +38,14 @@ export type OrganizationSettings = {
         enable_read_only_canvas_creation_account?: boolean;
         scribble_file_renderer?: 'image' | 'pdfjs' | 'pspdfkit';
         enable_wizard_preview_button?: boolean;
+        enable_edit_opens_completion_wizard?: boolean;
+        enable_react_completion_wizard?: boolean;
+        enable_wizard_add_group?: boolean;
+        enable_presentation_tools?: boolean;
+        enable_hub_bottom_sheet?: boolean;
+        presentation_tools_frameless?: boolean;
+        enable_toc_open_by_default?: boolean;
+        use_canvas_exit_confirmation?: boolean;
         locks_polling_interval?: number;
         shared_link?: {
             title?: string;
@@ -55,6 +64,26 @@ export type OrganizationSettings = {
             }>;
         };
     };
+    /**
+     * PIT-7682 — open-ended list of brands the rep can pick from when creating a shared link.
+     * Supersedes the single-value `shared_link_brand_slug` / `canvas_dot_page_subdomain_to_use`
+     * keys, which stay readable as a fallback while instances are migrated.
+     *
+     * An instance-level list REPLACES the org-level one wholesale (that is how Django merges
+     * settings — its deep merge recurses into objects only), so never resolve it through
+     * `createPitcherSettings`, whose lodash `merge` combines arrays element-wise instead.
+     *
+     * Per entry: `id` is the stable reference sent to the API as `brand_id`, `name` is the
+     * rep-facing label, and at least one of `subdomain` (needs one-time Rebrandly setup) or
+     * `slug` (self-serve) must be set or the entry is skipped. `subdomain` wins over `slug`.
+     */
+    shared_link_brands?: {
+        id: string;
+        name?: string;
+        subdomain?: string;
+        slug?: string;
+        is_default?: boolean;
+    }[];
     allow_dsr_forwarding?: boolean;
     allow_revoke_shared_link?: boolean;
     enable_slotty_ui_asset_manager?: boolean;
@@ -76,6 +105,7 @@ export type OrganizationSettings = {
     minimum_event_duration_in_call?: number;
     enable_content_rating_in_call?: boolean;
     enable_speaker_notes?: boolean;
+    enable_account_only_meeting_notes?: boolean;
     display_metadata_filters_in_modal?: boolean;
     enable_js_api_recommended_files?: boolean;
     metadata_highlight_properties?: MetadataHighlightProperty[];
@@ -117,15 +147,24 @@ export type OrganizationSettings = {
     location_prompt_message?: string;
     use_collection_player_with_annotations?: boolean;
     disable_core_canvas_metadata?: boolean;
+    enable_account_widgets?: boolean;
     enable_folder_description_via_name?: boolean;
     enable_download_original_file_in_impact?: boolean;
     alternative_canvas_fullscreen?: boolean;
+    enable_impact_web_presentation_browser_fullscreen?: boolean;
+    default_presentation_fullscreen_mode?: FullscreenMode;
     enable_presentation_annotations?: boolean;
     max_files_limit?: number;
     is_meeting_bar_account_selection_disabled?: boolean;
     meeting_bar_show_account_context?: 'off' | 'no-call-only' | 'always';
     meeting_bar_allow_attendee_edit_on_existing_events?: boolean;
     disable_postcall?: boolean;
+    preserve_account_after_call_stop?: boolean;
+    meeting_bar_show_meetings?: boolean;
+    postcall_event_hooks?: {
+        on_submit?: Record<string, string | number | boolean | null>;
+        on_cancel?: Record<string, string | number | boolean | null>;
+    };
     launch_in_present_mode_on_creation?: boolean;
     slotty_ui_route_config?: {
         name: string;

package/lib/util/aiSummary.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Parse a stored `metadata.aiAnalysis.summary` value into plain display text.
+ *
+ * `next-core`'s file-analysis.parse.ts prompts the model for a fenced
+ * ```json block and extracts `summary` on a successful JSON.parse — but on a
+ * JSON.parse failure (malformed model output) it falls back to storing the
+ * RAW text (the fence and all, sliced to 200 chars) directly as `summary`.
+ * That raw-fallback shape is what showed up as a literal ```json blob in the
+ * Hub's Summary section (PIT-8049). Handles three shapes:
+ *  (a) a plain string — the common, already-clean case
+ *  (b) a string containing a ```json fenced blob (complete OR truncated/
+ *      unterminated) whose JSON has a `summary` key
+ *  (c) an object carrying a `summary` field directly (recurses, so a
+ *      double-wrapped value is also unwrapped)
+ *
+ * This function's body (and its test suite) is identical to the Hub's
+ * `utils/fileMetadata.ts` copy — Hub (React) and canvas-ui (Vue) share no
+ * runtime code, so it's duplicated rather than shared. The surrounding FILES
+ * differ (helper order, doc comments); only `parseAiSummary` itself and the
+ * tests must stay in lockstep.
+ */
+export declare function parseAiSummary(value: unknown): string | undefined;
+/**
+ * Normalize a file's AI key messages to a string array. Prefers the newer
+ * `metadata.aiAnalysis.keyPoints`, falls back to legacy `metadata.key_messages`.
+ *
+ * Ported from the Hub's `utils/fileMetadata.ts` (PIT-8049 round 2) — data-only,
+ * no React/Vue-specific logic, so a straight copy.
+ */
+export declare function normalizeKeyMessages(metadata: Record<string, any> | null | undefined): string[];

package/lib/util/aiSummary.spec.d.ts

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

package/lib/util/network.d.ts

@@ -1,5 +1,40 @@
 import { PaginatedData } from '../types/paginatedData';
+/** What the `*WithStatus` fetchers return: the rows, plus whether they are all of them. */
+export interface FetchAllResult<T> {
+    /** The fetched rows, capped at `maxLimit`. */
+    items: T[];
+    /** True when the server had more rows than the cap allowed us to fetch. */
+    truncated: boolean;
+    /** The server-reported total, regardless of the cap. */
+    total: number;
+}
+/**
+ * `fetchAll`, but the caller can tell whether it got everything.
+ *
+ * The cap has always been silent — a Sentry message nobody sees at the call
+ * site, and a plain array indistinguishable from a complete one, so callers
+ * that persist or present the result treat 2000 of 5000 rows as the whole
+ * library (PIT-8408). Use this wherever "is this all of it?" changes what the
+ * caller should do or show; `fetchAll` stays the shorthand for the rest.
+ */
+export declare const fetchAllWithStatus: <T>(reqFunction: (reqParams: any) => Promise<PaginatedData<T>>, reqParams?: any, maxLimit?: number) => Promise<FetchAllResult<T>>;
 export declare const fetchAll: <T>(reqFunction: (reqParams: any) => Promise<PaginatedData<T>>, reqParams?: any, maxLimit?: number) => Promise<T[]>;
+/**
+ * `fetchAllWithOffset`, but the caller can tell whether it got everything.
+ *
+ * The offset-based twin of `fetchAllWithStatus`, and it carried the same silent
+ * cap: a Sentry message nobody sees at the call site, and a plain array that a
+ * caller cannot distinguish from a complete one (PIT-8408). Use this wherever
+ * "is this all of it?" changes what the caller should do or show.
+ */
+export declare const fetchAllWithOffsetStatus: <T>(reqFunction: (reqParams: any) => Promise<{
+    pagination: {
+        limit: number;
+        offset: number;
+        total: number;
+    };
+    data: T[];
+}>, reqParams?: any, maxLimit?: number) => Promise<FetchAllResult<T>>;
 export declare const fetchAllWithOffset: <T>(reqFunction: (reqParams: any) => Promise<{
     pagination: {
         limit: number;

package/lib/util/user.d.ts

@@ -1,3 +1,4 @@
+import { User } from '../../types/openapi';
 export declare const splitUserName: (name?: string) => {
     first_name: string;
     last_name: string;
@@ -51,4 +52,21 @@ export declare function pickTemplateUserFields<T extends Record<string, any>>(us
  * without per-app code changes.
  */
 export declare function flattenUserProperties<T extends Record<string, any>>(user: T | null | undefined, schema?: CustomUserPropertiesSchema | null): T | null;
+export interface CrmServiceLink {
+    /** Absolute URL opening the CRM web UI (e.g. the Salesforce custom domain). */
+    url: string;
+    /** Brand display name shown as the menu label — brand names are not translated. */
+    label: string;
+    /** Font Awesome icon name (without the `fa-` prefix). */
+    icon: string;
+    faType: 'fab' | 'far';
+    provider: string;
+}
+/**
+ * Resolve a browser link to the user's connected CRM from `connected_services`
+ * (the `/users/me/` response — `urls` is only populated on the `me`/`token` actions).
+ * Returns the first CRM service with a usable URL, or `null` when the user has
+ * no CRM connection to link to.
+ */
+export declare function getCrmServiceLink(user: Pick<User, 'connected_services'> | null | undefined): CrmServiceLink | null;
 export {};

package/lib/util/user.test.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pitcher/js-api",
-  "version": "1.29.0",
+  "version": "1.31.0",
   "type": "module",
   "main": "js-api.umd.min.js",
   "module": "js-api.esm.js",