@pitcher/js-api 1.28.0 → 1.30.0

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>;
@@ -206,10 +208,9 @@ export declare function useApi(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<import('./api/modules').Language[]>;
     getCanvases(payload: import('../main.lib').GetCanvasesParams & {
         filters?: Record<string, any>;
         fields?: string;
@@ -222,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>;
@@ -373,6 +375,14 @@ export declare function useApi(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: import('./api/LowLevelApi').LowLevelApi;
 } | {
     getUsers(payload?: import('../main.lib').GetUsersParams): Promise<import('../main.lib').PaginatedData<import('../main.lib').User>>;
@@ -492,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>;
@@ -503,10 +515,9 @@ export declare function useApi(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<import('./api/modules').Language[]>;
         getCanvases(payload: import('../main.lib').GetCanvasesParams & {
             filters?: Record<string, any>;
             fields?: string;
@@ -519,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>;
@@ -670,6 +682,14 @@ export declare function useApi(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: import('./api/LowLevelApi').LowLevelApi;
     };
     openSharingSettings(payload: import('./api/modules/ui/types.ui').UiOpenSharingSettingsRequest): Promise<import('./api/modules/ui/types.ui').UiOpenSharingSettingsResponse>;
@@ -735,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>;
@@ -745,10 +767,9 @@ export declare function useApi(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<import('./api/modules').Language[]>;
     getCanvases(payload: import('../main.lib').GetCanvasesParams & {
         filters?: Record<string, any>;
         fields?: string;
@@ -903,6 +924,14 @@ export declare function useApi(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: import('./api/LowLevelApi').LowLevelApi;
 } | {
     broadcast: (event: import('./interfaces').PitcherEvent) => Promise<any>;

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.
      */
@@ -662,3 +678,271 @@ export interface PiaSearchAnswerResult {
      */
     source: 'on_device' | 'online';
 }
+/**
+ * Error codes returned on a rejected `stt.start` / `stt.stop` — cross-platform
+ * (iOS bridge AND the web host engines). Surfaced verbatim in the rejected
+ * request's error body (iOS: `error_code`/`errorCode`; web: the error `message` /
+ * `reason` string — read them uniformly via `api.sttErrorCode`).
+ *
+ * - `STT_DISABLED` — the `enable_stt_dictation` config flag is off for this instance.
+ * - `STT_DEVICE_UNSUPPORTED` — the device can't run the on-device model.
+ * - `STT_MODEL_NOT_READY` — the whisper model isn't downloaded yet. Trigger a
+ *   model download (`ai.download_model` with `"whisper"`), then retry `stt.start`.
+ * - `STT_BUSY` — the mic is held by another session (a live call recording, or
+ *   another dictation). Surface a "mic in use" hint / prompt to stop the other session.
+ * - `STT_MIC_PERMISSION_DENIED` — microphone permission was denied.
+ * - `STT_NOT_RECORDING` — `stt.stop` for a `session_id` that isn't active.
+ * - `STT_CAPTURE_FAILED` / `STT_ERROR` — generic capture / other failure.
+ */
+export type SttErrorCode = 'STT_DISABLED' | 'STT_DEVICE_UNSUPPORTED' | 'STT_MODEL_NOT_READY' | 'STT_BUSY' | 'STT_MIC_PERMISSION_DENIED' | 'STT_NOT_RECORDING' | 'STT_CAPTURE_FAILED' | 'STT_ERROR';
+/**
+ * Payload for `stt.start` — cross-platform (identical shape on iOS and web).
+ * Keys are already snake_case, so `LowLevelApi`'s `snakeCaseKeys` transform is a
+ * no-op (no `RAW_PAYLOAD_METHODS` entry needed; the `vocabulary` string values
+ * are left untouched by the key-only transform).
+ */
+export interface SttStartPayload {
+    /**
+     * Caller-chosen session id. All `stt.partial` / `stt.interrupted` events and
+     * the matching `stt.stop` are keyed by it. Re-starting with the same id
+     * replaces that session.
+     */
+    session_id: string;
+    /**
+     * ISO 639-1 code (e.g. `"en"`) to force a language. Omit/`null` for
+     * auto-detect (the default, like native iOS dictation).
+     */
+    language?: string | null;
+    /**
+     * Proper nouns likely to be spoken (the current call's CRM contact / account
+     * / product names). Biases recognition toward correct spelling (e.g.
+     * "Dr. Sarah O'Brien" instead of "Dr. Starwhop Brine"). Send the relevant
+     * names, not the whole CRM — it's length-capped on the native side.
+     */
+    vocabulary?: string[];
+}
+/**
+ * Payload for `stt.stop` — cross-platform.
+ */
+export interface SttStopPayload {
+    /**
+     * The `session_id` passed to the matching `stt.start`.
+     */
+    session_id: string;
+}
+/**
+ * Result of `stt.stop` — cross-platform.
+ */
+export interface SttStopResult {
+    /**
+     * The final, full transcript for the session.
+     */
+    transcript: string;
+}
+/**
+ * Body of the `stt.partial` event (host → JS; native bridge on iOS, the Impact
+ * host engine on web). Fires roughly every ~2s while recording.
+ */
+export interface SttPartialEvent {
+    /**
+     * Session the partial belongs to.
+     */
+    session_id: string;
+    /**
+     * The FULL transcript so far — NOT a delta. Replace the field's dictation
+     * content with it, don't append.
+     */
+    text: string;
+    /**
+     * Per-session monotonic counter (only advances when `text` changes) for
+     * ordering / de-dupe.
+     */
+    index: number;
+}
+/**
+ * Body of the `stt.interrupted` event (host → JS; native bridge on iOS, the
+ * Impact host engine on web). Fires only when a session ends WITHOUT a
+ * `stt.stop` — a normal `stt.stop` does NOT fire this.
+ */
+export interface SttInterruptedEvent {
+    /**
+     * Session that was interrupted.
+     */
+    session_id: string;
+    /**
+     * Why the session ended — an opaque, host-specific string; don't parse it,
+     * just stop waiting for partials and reset the field. Known values:
+     * - iOS: `"preempted"` — a higher-priority call recording took the mic.
+     * - web: `"error:capture_ended"` (mic/track ended), `"error:<code>"` (a fatal
+     *   Web Speech recognition error, e.g. `"error:network"`), `"error:restart_failed"`.
+     */
+    reason: string;
+}
+/**
+ * Which engine answers `stt.start` on the current platform: `"native"` (iOS
+ * on-device Speech), `"whisper"` (web on-device Whisper) or `"webspeech"` (web
+ * cloud fallback, audio leaves the device).
+ */
+export type SttEngineKind = 'native' | 'whisper' | 'webspeech';
+/**
+ * Why dictation is unavailable: `"disabled"` (the `enable_stt_dictation`
+ * instance flag is off) or `"unsupported"` (no engine can run on this device).
+ */
+export type SttUnavailableReason = 'disabled' | 'unsupported';
+/**
+ * Result of `stt.availability` — a side-effect-free capability check an app
+ * should call BEFORE offering a mic button. It does NOT prompt for the
+ * microphone or download any model; it only reports whether dictation could be
+ * started, so the UI can hide/disable the control up front.
+ */
+export interface SttAvailabilityResult {
+    /**
+     * Dictation can be started right now — the feature is enabled AND an engine
+     * can run on this device.
+     */
+    available: boolean;
+    /**
+     * The engine that would answer `stt.start`, or `null` when unavailable. Note
+     * `"webspeech"` sends audio off-device, so a UI may want to reflect that.
+     */
+    engine: SttEngineKind | null;
+    /**
+     * Present when `available` is `false`: `"disabled"` (feature flag off) or
+     * `"unsupported"` (no engine on this device / browser).
+     */
+    reason?: SttUnavailableReason;
+}
+/**
+ * Error codes returned on `tts.speak` — as a bridge APIError
+ * (`{ code, message, details }`) on iOS, or in the host `{ reason }` on web.
+ *
+ * - `TTS_EMPTY_TEXT` — no text was provided.
+ * - `TTS_VOICE_UNAVAILABLE` — a `language` was requested but no installed voice
+ *   matches. The message tells the user to download it (iOS Settings ›
+ *   Accessibility › Spoken Content › Voices) — surface it so the UI can prompt.
+ * - `TTS_ERROR` — unexpected fallback.
+ */
+export type TtsErrorCode = 'TTS_EMPTY_TEXT' | 'TTS_VOICE_UNAVAILABLE' | 'TTS_ERROR';
+/**
+ * Payload for `tts.speak`. The exact native wire contract — keys are single
+ * words, so LowLevelApi's `snakeCaseKeys` transform is a no-op; no
+ * `RAW_PAYLOAD_METHODS` entry is needed.
+ */
+export interface TtsSpeakPayload {
+    /**
+     * The text to speak. Empty/whitespace rejects with `TTS_EMPTY_TEXT`.
+     */
+    text: string;
+    /**
+     * BCP-47/ISO language tag (e.g. `"en-US"`). If given, an installed offline
+     * voice is required, else the call rejects with `TTS_VOICE_UNAVAILABLE`. Omit
+     * to use the system voice.
+     */
+    language?: string;
+    /**
+     * Speech rate; clamped to the platform min…max.
+     */
+    rate?: number;
+    /**
+     * Speech pitch; clamped `0.5`…`2.0` (`1.0` = normal).
+     */
+    pitch?: number;
+}
+/**
+ * Result of `tts.speak`. The promise resolves when the utterance FINISHES.
+ */
+export interface TtsSpeakResult {
+    /**
+     * `true` → finished speaking naturally; `false` → it was stopped (`tts.stop`)
+     * or replaced by a newer `tts.speak` (only one utterance is active at a time).
+     */
+    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/canvases.d.ts

@@ -1,4 +1,3 @@
-import { CanvasRetrieve, User } from '../../types/openapi';
 export interface GetCanvasesParams {
     search?: string;
     account__id?: string;
@@ -19,11 +18,9 @@ export interface GetCanvasesParams {
     template__id?: string;
 }
 export interface CanvasMetadataRetrieve {
-    canvas_id: CanvasRetrieve['id'];
     config: Record<string, any> & {
         presentation_component_metadata: Record<string, any>;
     };
-    owner_id: User['id'];
 }
 export declare enum CanvasesViewsTypes {
     SAVED = "saved",

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_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 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/types/sfdc.d.ts

@@ -96,6 +96,21 @@ export type SfContact = {
     MailingAddress?: string;
     Phone?: string;
 };
+/**
+ * Meeting-bar contacts live in a dual id-space: `Id` is the roster record the
+ * user picked — a standard Contact (`003…`) when the org's
+ * `contact_visibility_query` targets Contact, or a custom-object record (e.g.
+ * Demant's `Contact_Customer_Detail__c`, `a1i…`). `ContactMirrorId` is the
+ * standard Contact (`003…`) the roster record mirrors (its `Contact__r`
+ * lookup), when known — the only id that may ever be written to
+ * `Event.WhoId` / `EventWhoIds`. For standard-Contact rosters the roster id IS
+ * the mirror id. Hoisted in slotty-ui-ng's `resolveCustomAccountRelation`;
+ * synthetic (never written back to Salesforce), deliberately not `__c`-suffixed
+ * so it can't collide with a real custom field API name. PIT-7250.
+ */
+export type SfRosterContact = SfContact & {
+    ContactMirrorId?: string | null;
+};
 export interface SfContactBasic {
     AccountId: string;
     Email: string;