@pitcher/js-api 1.29.0 → 1.30.0

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

@@ -122,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>;
@@ -147,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>;
@@ -157,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"];

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/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/main.d.ts

@@ -195,9 +195,11 @@ export declare function useApi(options?: ApiOptions): {
     broadcastToWebviews: (event: import('./interfaces').PitcherEvent) => Promise<any>;
     subscribe: () => Promise<any>;
     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>;
@@ -221,6 +223,7 @@ export declare function useApi(options?: ApiOptions): {
         id: import('../main.lib').CanvasRetrieve["id"];
         instance_id?: import('../main.lib').Instance["id"];
         fields?: string;
+        lazy_sections?: boolean;
     }): Promise<import('../main.lib').CanvasRetrieve>;
     updateCanvasIndicators(payload: {
         indicators: Record<string, import('../main.lib').CanvasIndicator>;
@@ -499,9 +502,11 @@ export declare function useApi(options?: ApiOptions): {
         broadcastToWebviews: (event: import('./interfaces').PitcherEvent) => Promise<any>;
         subscribe: () => Promise<any>;
         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>;
@@ -525,6 +530,7 @@ export declare function useApi(options?: ApiOptions): {
             id: import('../main.lib').CanvasRetrieve["id"];
             instance_id?: import('../main.lib').Instance["id"];
             fields?: string;
+            lazy_sections?: boolean;
         }): Promise<import('../main.lib').CanvasRetrieve>;
         updateCanvasIndicators(payload: {
             indicators: Record<string, import('../main.lib').CanvasIndicator>;
@@ -749,9 +755,11 @@ export declare function useApi(options?: ApiOptions): {
     broadcastToWebviews: (event: import('./interfaces').PitcherEvent) => Promise<any>;
     subscribe: () => Promise<any>;
     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>;

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.
      */
@@ -842,3 +858,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/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/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/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_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_collections' | '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;

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,10 @@ 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_toc_open_by_default?: boolean;
+        use_canvas_exit_confirmation?: boolean;
         locks_polling_interval?: number;
         shared_link?: {
             title?: string;
@@ -117,15 +122,20 @@ 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;
     launch_in_present_mode_on_creation?: boolean;
     slotty_ui_route_config?: {
         name: string;

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.30.0",
   "type": "module",
   "main": "js-api.umd.min.js",
   "module": "js-api.esm.js",

package/types/openapi/models/DeletedEnvironment.d.ts

@@ -2,7 +2,6 @@ import { MiniUser } from './MiniUser';
 export type DeletedEnvironment = {
     readonly id: number;
     name: string;
-    next_environment_ids?: Array<number>;
     color?: string | null;
     readonly created_at: string;
     readonly created_by: MiniUser;

package/types/openapi/models/Environment.d.ts

@@ -2,7 +2,6 @@ import { MiniUser } from './MiniUser';
 export type Environment = {
     readonly id: number;
     name: string;
-    next_environment_ids?: Array<number>;
     color?: string | null;
     readonly created_at: string;
     readonly created_by: MiniUser;

package/types/openapi/models/EnvironmentRequest.d.ts

@@ -1,5 +1,4 @@
 export type EnvironmentRequest = {
     name: string;
-    next_environment_ids?: Array<number>;
     color?: string | null;
 };