@pitcher/js-api 1.26.1 → 1.27.1

package/lib/composables/useCanvasRendererExcludedTags.d.ts

@@ -0,0 +1,15 @@
+interface CanvasRendererTabConfig {
+    name: string;
+    canvas_tag: string;
+}
+interface CanvasRendererRouteConfig {
+    canvas_tag?: string;
+    tabs?: CanvasRendererTabConfig[];
+}
+export declare function extractCanvasTagsFromConfig(routesConfig: Record<string, CanvasRendererRouteConfig>): string[];
+export default function useCanvasRendererExcludedTags(): {
+    excludedTags: import('vue').Ref<string[], string[]>;
+    isLoading: import('vue').Ref<boolean, boolean>;
+    fetchExcludedTags: () => Promise<string[]>;
+};
+export {};

package/lib/composables/useCanvasRendererExcludedTags.spec.d.ts

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

package/lib/composables/useThemeVars.d.ts

@@ -23,6 +23,7 @@ declare const _default: () => import('vue').Ref<{
     info: string;
     info2: string;
     info3: string;
+    info4: string;
     boxShadow: string;
     boxShadow2: string;
     boxShadow3: string;
@@ -51,6 +52,7 @@ declare const _default: () => import('vue').Ref<{
     info: string;
     info2: string;
     info3: string;
+    info4: string;
     boxShadow: string;
     boxShadow2: string;
     boxShadow3: string;

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

@@ -39,6 +39,7 @@ export declare const CLIENT_TYPE: {
     readonly impact: "impact";
     readonly dsr: "dsr";
     readonly impactCanvasHome: "impact-canvas-home";
+    readonly course: "course";
 };
 export declare const DSR_TYPE: {
     readonly file: "file";

package/lib/main.lib.d.ts

@@ -48,6 +48,7 @@ export { default as CSwitch } from './components/CSwitch/CSwitch.vue';
 export { default as CFeedback } from './components/CFeedback/CFeedback.vue';
 export { default as CHelpText } from './components/CHelpText/CHelpText.vue';
 export { default as CPillSelect } from './components/CPillSelect/CPillSelect.vue';
+export { default as AITaskOutputFallback } from './components/AITaskOutputFallback/AITaskOutputFallback.vue';
 export { default as CConfirmationModal } from './components/CConfirmationModal/CConfirmationModal.vue';
 export { default as CConfirmationHeader } from './components/CConfirmation/CConfirmationHeader.vue';
 export { default as CConfirmationContent } from './components/CConfirmation/CConfirmationContent.vue';
@@ -84,7 +85,7 @@ export { default as CSavedCanvasesManagement } from './components/savedCanvases/
 export { default as CAssignedCanvasesManagement } from './components/assignedCanvases/CAssignedCanvasesManagement.vue';
 export { default as CAssignedCanvasesManagementToolbar } from './components/assignedCanvases/CAssignedCanvasesManagementToolbar.vue';
 export { default as useShareCanvas } from './components/savedCanvases/CSavedCanvasesManagementShareCanvas.use';
-export { getFreezeStatus, type FreezeStatus } from './components/savedCanvases/CSavedCanvasesManagement.use';
+export { getFreezeStatus, SYSTEM_EXCLUDED_TAGS, type FreezeStatus } from './components/savedCanvases/CSavedCanvasesManagement.use';
 export { default as CConfigEditor } from './components/CConfigEditor/CConfigEditor.vue';
 export { default as CTableInput } from './components/CTableInput/CTableInput.vue';
 export { default as CTableTag } from './components/CTableTag/CTableTag.vue';
@@ -170,6 +171,7 @@ export { default as useMetadataTemplates } from './composables/useMetadataTempla
 export { default as useMetadataSearch } from './composables/useMetadataSearch';
 export * from './composables/appsDb.use';
 export { default as useCanvasLocks } from './composables/useCanvasLocks';
+export { default as useCanvasRendererExcludedTags, extractCanvasTagsFromConfig, } from './composables/useCanvasRendererExcludedTags';
 export { useCommentTracking } from './composables/useCommentTracking';
 export { useSharedCommentsStorage } from './composables/useSharedCommentsStorage';
 export { usePolling } from './composables/usePolling';
@@ -207,6 +209,7 @@ export * from './util/userAgents';
 export * from './util/pitcher-settings.util';
 export * from './util/eval';
 export * from './util/storage.util';
+export { sanitizeHtml, sanitizeUserHtml } from './util/string';
 export * from './util/handlebars';
 export * from './apps/collection-selector/utils/content-selector-adapter.util';
 export * from './util/soql.util.ts';
@@ -245,6 +248,7 @@ export * from './types/launchDarkly.types';
 export * from './types/toast';
 export * from './types/instanceSettings.types';
 export * from './types/organizationSettings.types';
+export * from './types/ai-tasks.const';
 export * from './components/CConfigEditor/CConfigEditor.types';
 export * from './types/search';
 export * from './types/selections';

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

@@ -123,6 +123,9 @@ export declare function createHighLevelApi(options?: ApiOptions): {
      * @returns {Promise<void>}
      */
     unsubscribe: () => Promise<any>;
+    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>;
     open(payload?: import('../payload.types').OpenRequestPayload): Promise<string>;
     openExternalUrl(payload: import('../payload.types').OpenExternalUrlRequestPayload): Promise<void>;
     getEnv(): Promise<import('../interfaces').PitcherEnv>;
@@ -152,7 +155,21 @@ 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;
     }): Promise<import('../../main.lib').CanvasRetrieve>;
+    getSectionsByIds(payload: {
+        canvas_id: import('../../main.lib').CanvasRetrieve["id"];
+        section_ids: string[];
+        exclude_drafts?: boolean;
+        include_expired_files?: boolean;
+        include_pending_files?: boolean;
+    }): Promise<{
+        sections: import('../../main.lib').CanvasSection[];
+    }>;
     shareCanvas(payload: {
         id: import('../../main.lib').CanvasRetrieve["id"];
     }): Promise<import('../../main.lib').SharedLink>;

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

@@ -0,0 +1,52 @@
+import { AICompletePayload, AICompleteResult, AIRuntimeCapabilities, PiaSearchAnswerPayload, PiaSearchAnswerResult } from '../../payload.types';
+/**
+ * Capabilities of the AI completion runtime on the current platform.
+ *
+ * On iOS this asks the native on-device bridge (`ai.get_capabilities`); on web
+ * it resolves statically to the online (Bedrock) runtime — no postMessage
+ * round-trip.
+ *
+ * @returns {Promise<AIRuntimeCapabilities>} - Promise resolving with the runtime capabilities.
+ *
+ * @example
+ * const capabilities = await api.aiGetCapabilities()
+ * if (capabilities.available) { ... }
+ */
+export declare function aiGetCapabilities(): Promise<AIRuntimeCapabilities>;
+/**
+ * Run an AI completion on the on-device model (iOS only). On web the host
+ * rejects with a clear error — use `piaSearchAnswer` (or the next-core AI
+ * routes) for online inference instead.
+ *
+ * The payload is the EXACT iOS wire contract: `{ prompt, max_tokens?, stream? }`
+ * → `{ text, tokens_generated, elapsed_seconds, time_to_first_token_seconds }`.
+ *
+ * @param {AICompletePayload} payload - The completion payload.
+ * @returns {Promise<AICompleteResult>} - Promise resolving with the completion.
+ *
+ * @example
+ * const completion = await api.aiComplete({ prompt: 'Summarize ...', max_tokens: 256 })
+ * console.log(completion.text)
+ */
+export declare function aiComplete(payload: AICompletePayload): Promise<AICompleteResult>;
+/**
+ * Answer a rep's natural-language question over the instance's content — the
+ * ONE high-level PIA Search call (PIT-6863). Routing follows the
+ * `pia_search_config` flag mode (see `resolvePiaSearchMode`):
+ *
+ * - `on_device` on iOS with an available local model → `aiComplete` over the
+ *   caller-assembled `context_text` (the Hub has the file metadata
+ *   client-side). Unavailable/downloading models fall through to online.
+ * - `online` (or any on-device fallback) → POST to the next-core
+ *   `pia-prepare/pia-search` Bedrock route, which assembles its own candidate
+ *   context server-side.
+ * - `off` → rejects.
+ *
+ * @param {PiaSearchAnswerPayload} payload - The question + optional context/narrowing.
+ * @returns {Promise<PiaSearchAnswerResult>} - Unified answer with the serving `source`.
+ *
+ * @example
+ * const result = await api.piaSearchAnswer({ query: 'What is our pricing for oncology?' })
+ * console.log(result.answer, result.cited_file_ids, result.source)
+ */
+export declare function piaSearchAnswer(payload: PiaSearchAnswerPayload): Promise<PiaSearchAnswerResult>;

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

@@ -1,4 +1,4 @@
-import { CanvasRetrieve, CanvasCreateRequest, PatchedCanvasUpdateRequest, SharedLink, Instance, CanvasRecommendedFiles } from '../../../../types/openapi';
+import { CanvasRetrieve, CanvasCreateRequest, PatchedCanvasUpdateRequest, SharedLink, Instance, CanvasRecommendedFiles, CanvasSection } from '../../../../types/openapi';
 import { GetCanvasesParams, CanvasIndicator } from '../../../types/canvases';
 import { PaginatedData } from '../../../types/paginatedData';
 import { CanvasThemeRetrieve } from '../../../types/canvasTheme';
@@ -70,10 +70,51 @@ export declare function updateCanvasIndicators(payload: {
     id: CanvasRetrieve['id'];
     instance_id?: Instance['id'];
 }): Promise<CanvasRetrieve>;
+/**
+ * Fetches a single canvas by ID.
+ *
+ * Pass `lazy_sections: true` to request the opt-in lazy "shell": when the
+ * org/instance `lazy_load_sections` setting is also on, the response returns
+ * ordered `section_ids` instead of the heavy inline `sections`, and you hydrate
+ * section bodies on demand via {@link getSectionsByIds}. With the setting off
+ * (or the param omitted) the response is the legacy fully-expanded canvas.
+ */
 export declare function getCanvas(payload: {
     id: CanvasRetrieve['id'];
     fields?: string;
+    lazy_sections?: boolean;
 }): Promise<CanvasRetrieve>;
+/**
+ * Batch-hydrate section bodies for a canvas fetched as a lazy shell.
+ *
+ * Companion to `getCanvas({ lazy_sections: true })`: pass the canvas ID and a
+ * slice of its `section_ids` (≤100 per call) and receive the full section
+ * bodies, serialized identically to a normal canvas retrieve's inline
+ * `sections`. Only sections actually referenced by the canvas are returned.
+ *
+ * Pass the SAME `exclude_drafts` / `include_expired_files` / `include_pending_files`
+ * the shell was fetched with so hydration filters identically to the shell that
+ * advertised the IDs — otherwise admin decks (fetched with `exclude_drafts:false`,
+ * expired/pending on) list draft/expired sections the batch would silently drop,
+ * leaving them blank. Omit them to get the rep defaults (drafts excluded,
+ * expired/pending off). `include_expired_files`/`include_pending_files` are
+ * server-side role-gated (admin/editor only), matching the inline retrieve.
+ *
+ * @example
+ * const { sections } = await api.getSectionsByIds({
+ *   canvas_id: '01HH4RCBH631K4JDHWAQB0RPR6',
+ *   section_ids: ['01SEC...', '02SEC...'],
+ * })
+ */
+export declare function getSectionsByIds(payload: {
+    canvas_id: CanvasRetrieve['id'];
+    section_ids: string[];
+    exclude_drafts?: boolean;
+    include_expired_files?: boolean;
+    include_pending_files?: boolean;
+}): Promise<{
+    sections: CanvasSection[];
+}>;
 export declare function shareCanvas(payload: {
     id: CanvasRetrieve['id'];
 }): Promise<SharedLink>;

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

@@ -1,3 +1,4 @@
+export * from './ai';
 export * from './open';
 export * from './env';
 export * from './languages';

package/lib/sdk/interfaces.d.ts

@@ -118,6 +118,16 @@ export interface StartCallPitcherEvent {
     post_action?: string;
     post_action_path?: string;
 }
+/**
+ * Preselects an account in the meeting bar without starting a call.
+ * Used by the SFDC passthrough Prepare flow.
+ */
+export interface SelectAccountPitcherEvent {
+    account?: {
+        id: string;
+        name?: string;
+    };
+}
 export interface RouteChangedPitcherEvent {
     route_name: string;
     route_path: string;
@@ -171,7 +181,8 @@ export declare enum PitcherBroadcastedEventName {
 export declare enum PitcherExternalEventName {
     CREATE_AND_OPEN_CANVAS = "create_and_open_canvas",
     OPEN_CANVAS = "open_canvas",
-    START_CALL = "start_call"
+    START_CALL = "start_call",
+    SELECT_ACCOUNT = "select_account"
 }
 /**
  * Base interface for update location actions.
@@ -512,6 +523,7 @@ export interface PitcherEventMap {
     [PitcherExternalEventName.OPEN_CANVAS]: OpenCanvasPitcherEvent;
     [PitcherExternalEventName.START_CALL]: StartCallPitcherEvent;
     [PitcherExternalEventName.CREATE_AND_OPEN_CANVAS]: CreateAndOpenCanvasEvent;
+    [PitcherExternalEventName.SELECT_ACCOUNT]: SelectAccountPitcherEvent;
 }
 export interface PitcherEvent {
     type: keyof PitcherEventMap;

package/lib/sdk/main.d.ts

@@ -195,6 +195,9 @@ export declare function useApi(options?: ApiOptions): {
     broadcastToWebviews: (event: import('./interfaces').PitcherEvent) => Promise<any>;
     subscribe: () => Promise<any>;
     unsubscribe: () => Promise<any>;
+    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>;
     open(payload?: import('./payload.types').OpenRequestPayload): Promise<string>;
     openExternalUrl(payload: import('./payload.types').OpenExternalUrlRequestPayload): Promise<void>;
     getEnv(): Promise<import('./interfaces').PitcherEnv>;
@@ -224,7 +227,17 @@ export declare function useApi(options?: ApiOptions): {
     getCanvas(payload: {
         id: import('../main.lib').CanvasRetrieve["id"];
         fields?: string;
+        lazy_sections?: boolean;
     }): Promise<import('../main.lib').CanvasRetrieve>;
+    getSectionsByIds(payload: {
+        canvas_id: import('../main.lib').CanvasRetrieve["id"];
+        section_ids: string[];
+        exclude_drafts?: boolean;
+        include_expired_files?: boolean;
+        include_pending_files?: boolean;
+    }): Promise<{
+        sections: import('../main.lib').CanvasSection[];
+    }>;
     shareCanvas(payload: {
         id: import('../main.lib').CanvasRetrieve["id"];
     }): Promise<import('../main.lib').SharedLink>;
@@ -475,6 +488,9 @@ export declare function useApi(options?: ApiOptions): {
         broadcastToWebviews: (event: import('./interfaces').PitcherEvent) => Promise<any>;
         subscribe: () => Promise<any>;
         unsubscribe: () => Promise<any>;
+        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>;
         open(payload?: import('./payload.types').OpenRequestPayload): Promise<string>;
         openExternalUrl(payload: import('./payload.types').OpenExternalUrlRequestPayload): Promise<void>;
         getEnv(): Promise<import('./interfaces').PitcherEnv>;
@@ -504,7 +520,17 @@ export declare function useApi(options?: ApiOptions): {
         getCanvas(payload: {
             id: import('../main.lib').CanvasRetrieve["id"];
             fields?: string;
+            lazy_sections?: boolean;
         }): Promise<import('../main.lib').CanvasRetrieve>;
+        getSectionsByIds(payload: {
+            canvas_id: import('../main.lib').CanvasRetrieve["id"];
+            section_ids: string[];
+            exclude_drafts?: boolean;
+            include_expired_files?: boolean;
+            include_pending_files?: boolean;
+        }): Promise<{
+            sections: import('../main.lib').CanvasSection[];
+        }>;
         shareCanvas(payload: {
             id: import('../main.lib').CanvasRetrieve["id"];
         }): Promise<import('../main.lib').SharedLink>;
@@ -701,6 +727,9 @@ export declare function useApi(options?: ApiOptions): {
     broadcastToWebviews: (event: import('./interfaces').PitcherEvent) => Promise<any>;
     subscribe: () => Promise<any>;
     unsubscribe: () => Promise<any>;
+    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>;
     openExternalUrl(payload: import('./payload.types').OpenExternalUrlRequestPayload): Promise<void>;
     getEnv(): Promise<import('./interfaces').PitcherEnv>;
     updateMyUser(payload: {
@@ -724,7 +753,17 @@ export declare function useApi(options?: ApiOptions): {
     getCanvas(payload: {
         id: import('../main.lib').CanvasRetrieve["id"];
         fields?: string;
+        lazy_sections?: boolean;
     }): Promise<import('../main.lib').CanvasRetrieve>;
+    getSectionsByIds(payload: {
+        canvas_id: import('../main.lib').CanvasRetrieve["id"];
+        section_ids: string[];
+        exclude_drafts?: boolean;
+        include_expired_files?: boolean;
+        include_pending_files?: boolean;
+    }): Promise<{
+        sections: import('../main.lib').CanvasSection[];
+    }>;
     shareCanvas(payload: {
         id: import('../main.lib').CanvasRetrieve["id"];
     }): Promise<import('../main.lib').SharedLink>;

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

@@ -468,3 +468,124 @@ export interface CRMLayoutPayload {
      */
     service?: CRMServiceType;
 }
+/**
+ * Capabilities of the AI runtime serving `ai.complete` on the current platform.
+ * On iOS this is the native on-device (Gemma) bridge answer — snake_case wire
+ * fields come straight from the native handler. On web there is no local model;
+ * the SDK answers statically with the online (Bedrock) runtime.
+ */
+export interface AIRuntimeCapabilities {
+    /**
+     * Whether an AI completion runtime is available right now.
+     */
+    available: boolean;
+    /**
+     * Whether the runtime works offline (true for the iOS on-device model).
+     */
+    offline?: boolean;
+    /**
+     * Serving runtime hint, e.g. 'bedrock-online' (web) — iOS reports its model
+     * via `llm_model` instead.
+     */
+    runtime?: string;
+    /**
+     * The on-device model identifier (iOS only).
+     */
+    llm_model?: string;
+    /**
+     * Whether the on-device model is currently downloading (iOS only).
+     */
+    model_downloading?: boolean;
+    /**
+     * Download progress 0-100 while `model_downloading` (iOS only).
+     */
+    download_progress_percent?: number;
+    /**
+     * Whether an on-device model can be downloaded for this instance (iOS only).
+     */
+    model_available_for_download?: boolean;
+    /**
+     * Why the runtime is unavailable, when `available` is false (iOS only).
+     */
+    unavailability_reason?: string;
+}
+/**
+ * Payload for an on-device AI completion (`ai.complete`, iOS only). The exact
+ * iOS wire contract — keys are already snake_case, do not rename.
+ */
+export interface AICompletePayload {
+    /**
+     * The full prompt to complete.
+     */
+    prompt: string;
+    /**
+     * Maximum number of tokens to generate.
+     */
+    max_tokens?: number;
+    /**
+     * Whether to stream the completion (v1 SDK callers should omit/false).
+     */
+    stream?: boolean;
+}
+/**
+ * Result of an on-device AI completion (`ai.complete`, iOS only).
+ */
+export interface AICompleteResult {
+    /**
+     * The generated completion text.
+     */
+    text: string;
+    tokens_generated?: number;
+    elapsed_seconds?: number;
+    time_to_first_token_seconds?: number;
+}
+/**
+ * Payload for `piaSearchAnswer` — one high-level question-answering call over
+ * the instance's content, routed on-device (iOS Gemma) or online (next-core
+ * Bedrock route) based on the `pia_search_config` flag mode.
+ */
+export interface PiaSearchAnswerPayload {
+    /**
+     * The rep's natural-language question.
+     */
+    query: string;
+    /**
+     * Instance to search in. Defaults to the env's active instance.
+     */
+    instance_id?: string;
+    /**
+     * Client-assembled content context (file names/tags/summaries). Used ONLY by
+     * the on-device path — the online route assembles its own context
+     * server-side.
+     */
+    context_text?: string;
+    /**
+     * Optional narrowing of the online route's candidate pool to these file ids.
+     */
+    file_ids?: string[];
+    /**
+     * Token budget for the on-device completion.
+     */
+    max_tokens?: number;
+}
+/**
+ * Unified `piaSearchAnswer` result across both serving paths.
+ */
+export interface PiaSearchAnswerResult {
+    /**
+     * The answer text.
+     */
+    answer: string;
+    /**
+     * File ids (from the candidate context) the answer drew on. Online path only.
+     */
+    cited_file_ids?: string[];
+    /**
+     * Model self-reported confidence. Online path only.
+     */
+    confidence?: 'high' | 'medium' | 'low';
+    /**
+     * Which runtime produced the answer.
+     */
+    source: 'on_device' | 'online';
+}

package/lib/theme/light.d.ts

@@ -25,6 +25,7 @@ export declare const lightPalette: import('vue').Ref<{
     info: string;
     info2: string;
     info3: string;
+    info4: string;
     boxShadow: string;
     boxShadow2: string;
     boxShadow3: string;
@@ -53,6 +54,7 @@ export declare const lightPalette: import('vue').Ref<{
     info: string;
     info2: string;
     info3: string;
+    info4: string;
     boxShadow: string;
     boxShadow2: string;
     boxShadow3: string;

package/lib/theme/theme.types.d.ts

@@ -24,6 +24,7 @@ export type BasicPalette = {
     info: string;
     info2: string;
     info3: string;
+    info4: string;
     boxShadow: string;
     boxShadow2: string;
     boxShadow3: string;

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

@@ -0,0 +1,80 @@
+/**
+ * Shared AITask Registry (PIT-6047).
+ *
+ * Vue-FREE leaf module — imports nothing so it can be consumed as a plain
+ * type/const module by any backend (next-core Bedrock, iOS Gemma spec) without
+ * dragging in the Vue component bundle. next-core imports the TYPES only
+ * (`import type ...`) and keeps its OWN authoritative registry value; it must
+ * NOT import `AI_TASK_REGISTRY` at runtime (that would pull the Vue barrel into
+ * Node). See ADR-002.
+ *
+ * The four AITask ids (`meeting_prep`, `discussion_points`, `pitch_deck`,
+ * `post_call_summary`) are a LOCKED cross-backend wire contract shared with
+ * iOS — do NOT rename them.
+ *
+ * `account_insights` (PIT-6122) is a NEW, bedrock-only task added alongside the
+ * locked four (NOT a rename/removal of any). It is the richer PIA "4-section
+ * account brief" that replaces the generic `meeting_prep`, and it can absorb
+ * `discussion_points` later — it always emits `key_discussion_points`.
+ * Deprecating `discussion_points` via a 1-version dual-emit window is DEFERRED
+ * pending Joan's design-review confirm; `meeting_prep` + `discussion_points` are
+ * NOT deprecated here.
+ *
+ * `precall_notes` (PIT-6123) is another NEW task added alongside the locked four
+ * (NOT a rename/removal). One task that ENHANCES existing precall notes when
+ * present, else GENERATES them from CRM context + recent interactions (+ an
+ * optional pre-computed upstream `account_insights` output). Unlike
+ * `account_insights` it does NOT depend on the server-side content-recommendation
+ * engine — its context comes from the caller / iOS SmartStore — so it is
+ * offline/Gemma-capable (`backends: ['bedrock', 'gemma']`).
+ *
+ * `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
+ * summaries as context). Online it is served by the next-core Bedrock route;
+ * on-device (iOS) the SAME task is served client-side through the `ai.complete`
+ * Gemma bridge with a hub-assembled context — hence `backends:
+ * ['bedrock', 'gemma']`. `requires` is empty: its inputs (query + instance) are
+ * request-envelope fields, not AITaskRequirement vocabulary, and candidate
+ * retrieval happens server-side.
+ */
+/** 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';
+/**
+ * Vocabulary of declarative input requirements a task can depend on. A task's
+ * `requires` list is server-enforced in next-core (missing → 400
+ * `missing_requirement`) and documents to iOS what context to assemble before
+ * invoking. Not every value is used by every task.
+ */
+export type AITaskRequirement = 'crm_account' | 'crm_opportunity' | 'files_listing' | 'call_transcript' | 'content_engagement_90d' | 'content_metadata_rules' | 'data_cloud_insights';
+/** Backends that can serve a task. `bedrock` = next-core; `gemma` = iOS offline. */
+export type AITaskBackend = 'bedrock' | 'gemma';
+/**
+ * Public, backend-agnostic description of an AITask. This is the shape the
+ * next-core catalog endpoint (`GET /core/api/protected/ai-tasks/catalog`)
+ * serves. Runtime serving/logic (prompt template, output schema, extractor)
+ * lives ONLY in the next-core registry, never here.
+ */
+export type AITaskDefinition = {
+    id: AITask;
+    display_name: string;
+    description: string;
+    backends: AITaskBackend[];
+    requires: AITaskRequirement[];
+    /** Bumped when the task's structured output contract changes shape. */
+    output_schema_version: number;
+    /** next-core route that serves the task, if any. */
+    route?: string;
+    /**
+     * Whether this task may be exposed as a callable function in the future
+     * Function Catalog (PIA / MCP). Defaults to false in v1.
+     */
+    expose_as_function?: boolean;
+};
+/**
+ * Shared spec of the four tasks. iOS reads this at cold-start; next-core keeps
+ * a parallel authoritative registry (with templates/schemas/extractors) whose
+ * ids + requires MUST stay in lockstep with this list (asserted by a
+ * conformance test in next-core).
+ */
+export declare const AI_TASK_REGISTRY: AITaskDefinition[];

package/lib/types/instanceSettings.types.d.ts

@@ -53,6 +53,8 @@ export type InstanceSettings = OrganizationSettings & {
         hide_meeting_bar?: boolean;
         sync_from_template?: string[];
         show_home_template_in_create_canvas_modal?: boolean;
+        dynamic_content_date_created_field?: string;
+        dynamic_content_date_modified_field?: string;
     };
     custom_event?: string;
     enable_multipeer_connectivity?: boolean;