@coveo/quantic 3.36.6 → 3.36.8

package/force-app/main/default/staticresources/coveoheadless/definitions/api/api-client-utils.d.ts

@@ -3,5 +3,5 @@ import type { BaseParam } from './platform-service-params.js';
 import type { AllSearchAPIResponse } from './search/search-api-client.js';
 import type { SearchAPIErrorWithStatusCode } from './search/search-api-error-response.js';
 import type { AuthenticationParam } from './search/search-api-params.js';
-export declare function pickNonBaseParams<Params extends BaseParam & AuthenticationParam>(req: Params): Omit<Params, "organizationId" | "accessToken" | "url" | "authentication">;
+export declare function pickNonBaseParams<Params extends BaseParam & AuthenticationParam>(req: Params): Omit<Params, "accessToken" | "organizationId" | "url" | "authentication">;
 export declare const unwrapError: (payload: PlatformResponse<AllSearchAPIResponse>) => SearchAPIErrorWithStatusCode;

package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/common/request.d.ts

@@ -29,11 +29,11 @@ export declare const getRequestOptions: (req: FilterableCommerceAPIRequest, path
         facets: import("../../../features/commerce/facets/facet-set/interfaces/request.js").AnyFacetRequest[] | undefined;
         sort: import("./sort.js").SortOption | undefined;
     };
-    method: import("../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../platform-client.js").HttpMethods;
     contentType: import("../../platform-client.js").HTTPContentType;
+    origin: import("../../preprocess-request.js").PlatformClientOrigin;
     requestMetadata?: import("../../preprocess-request.js").RequestMetadata | undefined;
 };
 export declare const baseRequest: (req: BaseCommerceAPIRequest, path: CommerceApiMethod) => Pick<PlatformClientCallOptions, "accessToken" | "method" | "contentType" | "url" | "origin" | "requestMetadata">;

package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/common/result.d.ts

@@ -25,10 +25,22 @@ export interface BaseSpotlightContent {
      * The name of the spotlight content.
      */
     name?: string;
+    /**
+     * The font color for the name text in hex format (e.g. `#ffffff`).
+     */
+    nameFontColor?: string;
     /**
      * The description of the spotlight content.
      */
     description?: string;
+    /**
+     * The font color for the description text in hex format (e.g. `#ffffff`).
+     */
+    descriptionFontColor?: string;
+    /**
+     * The accessibility text for the image.
+     */
+    altText?: string;
     /**
      * The ID of the response that returned the spotlight content.
      */

package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/product-enrichment/product-enrichment-request.d.ts

@@ -21,10 +21,10 @@ export declare const buildProductEnrichmentBadgesRequest: (req: ProductEnrichmen
             custom?: Record<string, unknown>;
         };
     };
-    method: import("../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../platform-client.js").HttpMethods;
     contentType: import("../../platform-client.js").HTTPContentType;
+    origin: import("../../preprocess-request.js").PlatformClientOrigin;
     requestMetadata?: import("../../preprocess-request.js").RequestMetadata | undefined;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/recommendations/recommendations-request.d.ts

@@ -25,10 +25,10 @@ export declare const buildRecommendationsRequest: (req: CommerceRecommendationsR
         page: number | undefined;
         perPage: number | undefined;
     };
-    method: import("../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../platform-client.js").HttpMethods;
     contentType: import("../../platform-client.js").HTTPContentType;
+    origin: import("../../preprocess-request.js").PlatformClientOrigin;
     requestMetadata?: import("../../preprocess-request.js").RequestMetadata | undefined;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/search/plan/plan-request.d.ts

@@ -22,10 +22,10 @@ export declare const getPlanRequestOptions: (req: CommercePlanRequest) => {
         country: string;
         currency: string;
     };
-    method: import("../../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     requestMetadata?: import("../../../preprocess-request.js").RequestMetadata | undefined;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/search/query-suggest/query-suggest-request.d.ts

@@ -22,10 +22,10 @@ export declare const getQuerySuggestRequestOptions: (req: QuerySuggestRequest) =
         country: string;
         currency: string;
     };
-    method: import("../../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     requestMetadata?: import("../../../preprocess-request.js").RequestMetadata | undefined;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/agents/answer-agent/head-answer-strategy.d.ts

@@ -1,6 +1,6 @@
 import type { AgentSubscriber } from '@ag-ui/client';
-import type { Dispatch } from '@reduxjs/toolkit';
+import type { ThunkDispatch, UnknownAction } from '@reduxjs/toolkit';
 /**
  * Creates an AgentSubscriber that handles answer streaming events
  */
-export declare const createHeadAnswerStrategy: (dispatch: Dispatch) => AgentSubscriber;
+export declare const createHeadAnswerStrategy: (dispatch: ThunkDispatch<unknown, unknown, UnknownAction>) => AgentSubscriber;

package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-slice.d.ts

@@ -1,7 +1,2 @@
 import { type BaseQueryFn, type FetchArgs, type FetchBaseQueryError } from '@reduxjs/toolkit/query';
-/**
- * `dynamicBaseQuery` is passed to the baseQuery of the createApi,
- * but note that the baseQuery will not be used if a queryFn is provided in the createApi endpoint
- */
-export declare const dynamicBaseQuery: BaseQueryFn<string | FetchArgs, unknown, FetchBaseQueryError>;
 export declare const answerSlice: import("@reduxjs/toolkit/query").Api<BaseQueryFn<string | FetchArgs, unknown, FetchBaseQueryError, {} & import("@reduxjs/toolkit/query").RetryOptions, {}>, {}, "answer", never, typeof import("@reduxjs/toolkit/query").coreModuleName>;

package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/stream-answer-api.d.ts

@@ -44,7 +44,7 @@ export declare const selectAnswer: (state: StreamAnswerAPIState) => ({
     originalArgs: AnswerApiQueryParams;
     requestId: string;
     data?: GeneratedAnswerStream | undefined;
-    error?: import("@reduxjs/toolkit/query").FetchBaseQueryError | import("@reduxjs/toolkit").SerializedError | undefined;
+    error?: import("@reduxjs/toolkit").SerializedError | import("@reduxjs/toolkit/query").FetchBaseQueryError | undefined;
     endpointName: string;
     startedTimeStamp: number;
     fulfilledTimeStamp?: number | undefined;
@@ -56,13 +56,13 @@ export declare const selectAnswer: (state: StreamAnswerAPIState) => ({
     isError: false;
 }) | ({
     status: import("@reduxjs/toolkit/query").QueryStatus.rejected;
-    data?: GeneratedAnswerStream | undefined;
     requestId: string;
+    data?: GeneratedAnswerStream | undefined;
     fulfilledTimeStamp?: number | undefined;
     originalArgs: AnswerApiQueryParams;
     endpointName: string;
     startedTimeStamp: number;
-    error: import("@reduxjs/toolkit/query").FetchBaseQueryError | import("@reduxjs/toolkit").SerializedError;
+    error: import("@reduxjs/toolkit").SerializedError | import("@reduxjs/toolkit/query").FetchBaseQueryError;
 } & {
     status: import("@reduxjs/toolkit/query").QueryStatus.rejected;
     isUninitialized: false;

package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/case-assist/get-case-classifications/get-case-classifications-request.d.ts

@@ -11,9 +11,9 @@ export declare const buildGetCaseClassificationsRequest: (req: GetCaseClassifica
             };
         };
     };
-    method: import("../../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/case-assist/get-document-suggestions/get-document-suggestions-request.d.ts

@@ -28,9 +28,9 @@ export declare const buildGetDocumentSuggestionsRequest: (req: GetDocumentSugges
             source?: string[];
         } | undefined;
     };
-    method: import("../../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/insight/get-interface/get-interface-config-request.d.ts

@@ -3,9 +3,9 @@ import { type InsightIdParam } from '../insight-params.js';
 export type GetInsightInterfaceConfigRequest = BaseParam & InsightIdParam;
 export declare const buildGetInsightInterfaceConfigRequest: (req: GetInsightInterfaceConfigRequest) => {
     requestParams: {};
-    method: import("../../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/insight/query/query-request.d.ts

@@ -8,17 +8,17 @@ export interface CaseContextParam {
 }
 export declare const buildInsightQueryRequest: (req: InsightQueryRequest) => {
     requestParams: {};
-    method: import("../../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };
 export declare const buildInsightQuerySuggestRequest: (req: InsightQuerySuggestRequest) => {
     requestParams: {};
-    method: import("../../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/insight/user-actions/user-actions-request.d.ts

@@ -10,10 +10,10 @@ export declare const buildInsightUserActionsRequest: (req: InsightUserActionsReq
     requestParams: {
         objectId: string;
     };
-    method: import("../../../platform-client.js").HttpMethods;
     accessToken: string;
-    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     url: string;
+    method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };
 export {};

package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/generated-answer/headless-core-generated-answer.d.ts

@@ -21,12 +21,24 @@ export interface GeneratedAnswer extends Controller {
     retry(): void;
     /**
      * Indicates that the generated answer met the user expectations.
+     * @deprecated The no-argument `like` method is deprecated and will be removed in a future major version. The method will now take a required `answerId` parameter to specify which answer is being liked, and will log the like action with the provided `answerId` for analytics.
      */
     like(): void;
+    /**
+     * Indicates that the generated answer met the user expectations.
+     * @param answerId - Answer Id of the liked answer.
+     */
+    like(answerId: string): void;
     /**
      * Marks the generated answer as not relevant to the end user.
+     * @deprecated The no-argument `dislike` method is deprecated and will be removed in a future major version. The method will now take a required `answerId` parameter to specify which answer is being disliked, and will log the dislike action with the provided `answerId` for analytics.
      */
     dislike(): void;
+    /**
+     * Marks the generated answer as not relevant to the end user.
+     * @param answerId - Answer Id of the disliked answer.
+     */
+    dislike(answerId: string): void;
     /**
      * Opens the modal to provide feedback about why the generated answer was not relevant.
      */
@@ -40,11 +52,6 @@ export interface GeneratedAnswer extends Controller {
      * @param feedback - The feedback that the end user wishes to send.
      */
     sendFeedback(feedback: GeneratedAnswerFeedback): void;
-    /**
-     * Logs a custom event indicating a cited source link was clicked.
-     * @param id - The ID of the clicked citation.
-     */
-    logCitationClick(id: string): void;
     /**
      * Displays the generated answer.
      */
@@ -71,24 +78,60 @@ export interface GeneratedAnswer extends Controller {
     disable(): void;
     /**
      * Logs a custom event indicating the generated answer was copied to the clipboard.
+     * @deprecated The `logCopyToClipboard` method is deprecated and will be removed in a future major version. The method will now take a required `answerId` parameter to specify which answer is being copied, and will log the copy action with the provided `answerId` for analytics.
      */
     logCopyToClipboard(): void;
     /**
-     * Logs a custom event indicating a cited source link was hovered.
+     * Logs a custom event indicating the generated answer was copied to the clipboard.
+     * @param answerId - Answer Id of the copied answer.
+     */
+    logCopyToClipboard(answerId: string): void;
+    /**
+     * Logs a custom event indicating a cited source link was clicked.
+     * @param citationId - The ID of the clicked citation.
+     * @deprecated The `logCitationClick` method is deprecated and will be removed in a future major version. The method will now take a required `answerId` parameter to specify which answer is being clicked, and will log the click action with the provided `answerId` for analytics.
+     */
+    logCitationClick(citationId: string): void;
+    /**
+     * Logs a custom event indicating a cited source link was clicked.
      * @param citationId - The ID of the clicked citation.
+     * @param answerId - Answer Id of the clicked citation's answer.
+     */
+    logCitationClick(citationId: string, answerId: string): void;
+    /**
+     * Logs a custom event indicating a cited source link was hovered.
+     * @param citationId - The ID of the hovered citation.
      * @param citationHoverTimeMs - The number of milliseconds spent hovering over the citation.
+     * @deprecated The `logCitationHover` method is deprecated and will be removed in a future major version. The method will now take a required `answerId` parameter to specify which answer is being hovered, and will log the hover action with the provided `answerId` for analytics.
      */
     logCitationHover(citationId: string, citationHoverTimeMs: number): void;
+    /**
+     * Logs a custom event indicating a cited source link was hovered.
+     * @param citationId - The ID of the hovered citation.
+     * @param citationHoverTimeMs - The number of milliseconds spent hovering over the citation.
+     * @param answerId - Answer Id of the hovered citation's answer.
+     */
+    logCitationHover(citationId: string, citationHoverTimeMs: number, answerId: string): void;
 }
 export interface GeneratedAnswerAnalyticsClient {
-    logLikeGeneratedAnswer: () => CustomAction;
-    logDislikeGeneratedAnswer: () => CustomAction;
+    /** @deprecated */
+    logLikeGeneratedAnswer(): CustomAction;
+    logLikeGeneratedAnswer(answerId?: string): CustomAction;
+    /** @deprecated */
+    logDislikeGeneratedAnswer(): CustomAction;
+    logDislikeGeneratedAnswer(answerId?: string): CustomAction;
     logGeneratedAnswerFeedback: (feedback: GeneratedAnswerFeedback) => CustomAction;
-    logOpenGeneratedAnswerSource: (citationId: string) => CustomAction;
-    logHoverCitation: (citationId: string, citationHoverTimeMs: number) => CustomAction;
+    /** @deprecated */
+    logOpenGeneratedAnswerSource(citationId: string): CustomAction;
+    logOpenGeneratedAnswerSource(citationId: string, answerId?: string): CustomAction;
+    /** @deprecated */
+    logHoverCitation(citationId: string, citationHoverTimeMs: number): CustomAction;
+    logHoverCitation(citationId: string, citationHoverTimeMs: number, answerId?: string): CustomAction;
     logGeneratedAnswerShowAnswers: () => CustomAction;
     logGeneratedAnswerHideAnswers: () => CustomAction;
-    logCopyGeneratedAnswer: () => CustomAction;
+    /** @deprecated */
+    logCopyGeneratedAnswer(): CustomAction;
+    logCopyGeneratedAnswer(answerId?: string): CustomAction;
     logRetryGeneratedAnswer: () => LegacySearchAction;
     logGeneratedAnswerExpand: () => CustomAction;
     logGeneratedAnswerCollapse: () => CustomAction;

package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/generated-answer/headless-core-interactive-citation.d.ts

@@ -7,6 +7,10 @@ export interface InteractiveCitationOptions extends InteractiveResultCoreOptions
      * The generated answer citation.
      */
     citation: GeneratedAnswerCitation;
+    /**
+     * The unique identifier of the generated answer associated with the citation.
+     */
+    answerId?: string;
 }
 export interface InteractiveCitationProps extends InteractiveResultCoreProps {
     /**
@@ -23,7 +27,7 @@ export interface InteractiveCitationProps extends InteractiveResultCoreProps {
 export interface InteractiveCitation extends InteractiveResultCore {
 }
 interface InteractiveCitationAnalyticsClient {
-    logOpenGeneratedAnswerSource(citationId: string): CustomAction;
+    logOpenGeneratedAnswerSource(citationId: string, answerId?: string): CustomAction;
 }
 /**
  * Creates a core `InteractiveCitation` controller instance.

package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/generated-answer/headless-generated-answer.d.ts

@@ -1,10 +1,10 @@
 import type { GeneratedAnswerCitation } from '../../api/generated-answer/generated-answer-event-payload.js';
 import type { SearchEngine } from '../../app/search-engine/search-engine.js';
-import type { GeneratedAnswerBase, GeneratedAnswerState, GenerationStep } from '../../features/generated-answer/generated-answer-state.js';
+import type { GeneratedAnswerBase, GeneratedAnswerState, GenerationStep, GenerationStepName } from '../../features/generated-answer/generated-answer-state.js';
 import type { GeneratedResponseFormat } from '../../features/generated-answer/generated-response-format.js';
 import type { GeneratedAnswer, GeneratedAnswerProps, GeneratedAnswerPropsInitialState } from '../core/generated-answer/headless-core-generated-answer.js';
 import { type GeneratedAnswerWithFollowUps, type GeneratedAnswerWithFollowUpsState } from '../knowledge/generated-answer/headless-generated-answer-with-follow-ups.js';
-export type { GeneratedAnswerCitation, GeneratedResponseFormat, GeneratedAnswerState, GeneratedAnswer, GeneratedAnswerWithFollowUps, GeneratedAnswerWithFollowUpsState, GeneratedAnswerBase, GeneratedAnswerProps, GeneratedAnswerPropsInitialState, GenerationStep, };
+export type { GeneratedAnswerCitation, GeneratedResponseFormat, GeneratedAnswerState, GeneratedAnswer, GeneratedAnswerWithFollowUps, GeneratedAnswerWithFollowUpsState, GeneratedAnswerBase, GeneratedAnswerProps, GeneratedAnswerPropsInitialState, GenerationStep, GenerationStepName, };
 /**
  * Creates a `GeneratedAnswer` controller instance.
 

package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/knowledge/generated-answer/headless-generated-answer-with-follow-ups.d.ts

@@ -13,17 +13,30 @@ export interface GeneratedAnswerWithFollowUps extends GeneratedAnswer {
     state: GeneratedAnswerWithFollowUpsState;
     /**
      * Marks the answer as liked.
-     * @param answerId - Optional ID of the answer to like. Defaults to the head answer.
+     * @param answerId - Optional ID of the answer to like. Defaults to the first answer.
      */
     like(answerId?: string): void;
     /**
      * Marks the answer as disliked.
-     * @param answerId - Optional ID of the answer to dislike. Defaults to the head answer.
+     * @param answerId - Optional ID of the answer to dislike. Defaults to the first answer.
      */
     dislike(answerId?: string): void;
+    /**
+     * Logs a custom event indicating a cited source link was hovered.
+     * @param citationId - The ID of the hovered citation.
+     * @param citationHoverTimeMs - The number of milliseconds spent hovering over the citation.
+     * @param answerId - Optional ID of the answer for which the citation was hovered. Defaults to the first answer.
+     */
+    logCitationHover(citationId: string, citationHoverTimeMs: number, answerId?: string): void;
+    /**
+     * Logs a click on a cited source link for analytics.
+     * @param citationId - The ID of the clicked citation.
+     * @param answerId - Optional ID of the answer for which the citation was clicked. Defaults to the first answer.
+     */
+    logCitationClick(citationId: string, answerId?: string): void;
     /**
      * Logs a copy-to-clipboard interaction for analytics.
-     * @param answerId - Optional ID of the copied answer. Defaults to the current answer.
+     * @param answerId - Optional ID of the copied answer. Defaults to the first answer.
      */
     logCopyToClipboard(answerId?: string): void;
     /**

package/force-app/main/default/staticresources/coveoheadless/definitions/features/follow-up-answers/follow-up-answers-actions.d.ts

@@ -1,8 +1,6 @@
 import type { GeneratedAnswerCitation } from '../../api/generated-answer/generated-answer-event-payload.js';
-import type { SearchThunkExtraArguments } from '../../app/search-thunk-extra-arguments.js';
 import { type GenerationStepName } from '../generated-answer/generated-answer-state.js';
 import type { GeneratedContentFormat } from '../generated-answer/generated-response-format.js';
-import { type StateNeededForFollowUpAnswerParams } from './follow-up-answer-request.js';
 export declare const setIsEnabled: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: boolean], boolean, "followUpAnswers/setIsEnabled", never, never>;
 export declare const setFollowUpAnswersConversationId: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: string], string, "followUpAnswers/setFollowUpAnswersConversationId", never, never>;
 export declare const createFollowUpAnswer: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: {
@@ -101,13 +99,3 @@ export declare const followUpStepFinished: import("@reduxjs/toolkit").ActionCrea
     name: GenerationStepName;
     finishedAt: number;
 }, "followUpAnswers/stepFinished", never, never>;
-export declare const generateFollowUpAnswer: import("@reduxjs/toolkit").AsyncThunk<void, string, {
-    state: StateNeededForFollowUpAnswerParams;
-    extra: SearchThunkExtraArguments;
-    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("@reduxjs/toolkit").UnknownAction> | undefined;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-}>;

package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/generated-answer-actions.d.ts

@@ -2,7 +2,7 @@ import { StringValue } from '@coveo/bueno';
 import type { GeneratedAnswerCitationsPayload, GeneratedAnswerMessagePayload } from '../../api/generated-answer/generated-answer-event-payload.js';
 import type { StreamAnswerAPIState } from '../../api/knowledge/stream-answer-api-state.js';
 import type { SearchThunkExtraArguments } from '../../app/search-thunk-extra-arguments.js';
-import type { AnswerApiQueryParams, StateNeededForHeadAnswerParams } from '../../features/generated-answer/generated-answer-request.js';
+import type { AnswerApiQueryParams } from '../../features/generated-answer/generated-answer-request.js';
 import type { ConfigurationSection, DebugSection, GeneratedAnswerSection, SearchSection } from '../../state/state-sections.js';
 import { type GenerationStepName } from './generated-answer-state.js';
 import { type GeneratedResponseFormat } from './generated-response-format.js';
@@ -98,22 +98,4 @@ export declare const generateAnswer: import("@reduxjs/toolkit").AsyncThunk<void,
     fulfilledMeta?: unknown;
     rejectedMeta?: unknown;
 }>;
-/**
- * Thunk to generate the head answer as part of the generated answer with follow-ups feature.
- *
- * This action initiates the generation of the main answer when using the Answer Generation API
- * with an agent configuration. It requires an **agent ID** to be present in the engine configuration.
- *
- * @internal
- */
-export declare const generateHeadAnswer: import("@reduxjs/toolkit").AsyncThunk<void, void, {
-    state: StateNeededForHeadAnswerParams;
-    extra: SearchThunkExtraArguments;
-    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("@reduxjs/toolkit").UnknownAction> | undefined;
-    rejectValue?: unknown;
-    serializedErrorType?: unknown;
-    pendingMeta?: unknown;
-    fulfilledMeta?: unknown;
-    rejectedMeta?: unknown;
-}>;
 export {};

package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/generated-answer-analytics-actions.d.ts

@@ -12,10 +12,14 @@ export type GeneratedAnswerFeedback = {
 };
 export declare const parseEvaluationDetails: (detail: "yes" | "no" | "unknown") => boolean | undefined;
 export declare const logRetryGeneratedAnswer: () => LegacySearchAction;
-export declare const logOpenGeneratedAnswerSource: (citationId: string) => CustomAction;
-export declare const logHoverCitation: (citationId: string, citationHoverTimeInMs: number) => CustomAction;
-export declare const logLikeGeneratedAnswer: () => CustomAction;
-export declare const logDislikeGeneratedAnswer: () => CustomAction;
+export declare function logOpenGeneratedAnswerSource(citationId: string): CustomAction;
+export declare function logOpenGeneratedAnswerSource(citationId: string, answerId: string): CustomAction;
+export declare function logHoverCitation(citationId: string, citationHoverTimeInMs: number): CustomAction;
+export declare function logHoverCitation(citationId: string, citationHoverTimeInMs: number, answerId: string): CustomAction;
+export declare function logLikeGeneratedAnswer(): CustomAction;
+export declare function logLikeGeneratedAnswer(answerId: string): CustomAction;
+export declare function logDislikeGeneratedAnswer(): CustomAction;
+export declare function logDislikeGeneratedAnswer(answerId: string): CustomAction;
 export declare const logGeneratedAnswerFeedback: (feedback: GeneratedAnswerFeedback) => CustomAction;
 export declare const logGeneratedAnswerStreamEnd: (answerGenerated: boolean) => CustomAction;
 export declare const logGeneratedAnswerResponseLinked: () => CustomAction;
@@ -23,18 +27,19 @@ export declare const logGeneratedAnswerShowAnswers: () => CustomAction;
 export declare const logGeneratedAnswerHideAnswers: () => CustomAction;
 export declare const logGeneratedAnswerExpand: () => CustomAction;
 export declare const logGeneratedAnswerCollapse: () => CustomAction;
-export declare const logCopyGeneratedAnswer: () => CustomAction;
+export declare function logCopyGeneratedAnswer(): CustomAction;
+export declare function logCopyGeneratedAnswer(answerId: string): CustomAction;
 export declare const retryGeneratedAnswer: () => SearchAction;
 export declare const generatedAnswerAnalyticsClient: {
-    logCopyGeneratedAnswer: () => CustomAction;
+    logCopyGeneratedAnswer: typeof logCopyGeneratedAnswer;
     logGeneratedAnswerHideAnswers: () => CustomAction;
     logGeneratedAnswerShowAnswers: () => CustomAction;
     logGeneratedAnswerStreamEnd: (answerGenerated: boolean) => CustomAction;
     logGeneratedAnswerFeedback: (feedback: GeneratedAnswerFeedback) => CustomAction;
-    logDislikeGeneratedAnswer: () => CustomAction;
-    logLikeGeneratedAnswer: () => CustomAction;
-    logHoverCitation: (citationId: string, citationHoverTimeInMs: number) => CustomAction;
-    logOpenGeneratedAnswerSource: (citationId: string) => CustomAction;
+    logDislikeGeneratedAnswer: typeof logDislikeGeneratedAnswer;
+    logLikeGeneratedAnswer: typeof logLikeGeneratedAnswer;
+    logHoverCitation: typeof logHoverCitation;
+    logOpenGeneratedAnswerSource: typeof logOpenGeneratedAnswerSource;
     logRetryGeneratedAnswer: () => LegacySearchAction;
     logGeneratedAnswerExpand: () => CustomAction;
     logGeneratedAnswerCollapse: () => CustomAction;

package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/generated-answer-request.d.ts

@@ -1,18 +1,29 @@
 import type { GeneratedAnswerStreamRequest } from '../../api/generated-answer/generated-answer-request.js';
-import type { AnswerParams } from '../../api/knowledge/answer-generation/endpoints/answer/answer-endpoint.js';
 import type { StreamAnswerAPIState } from '../../api/knowledge/stream-answer-api-state.js';
 import type { BaseParam } from '../../api/platform-service-params.js';
 import type { SearchRequest } from '../../api/search/search/search-request.js';
-import type { AuthenticationParam, AutomaticFacetsParams } from '../../api/search/search-api-params.js';
+import type { AnalyticsParam, AuthenticationParam, AutomaticFacetsParams, PipelineRuleParameters } from '../../api/search/search-api-params.js';
 import type { CaseContextParam } from '../../api/service/insight/query/query-request.js';
 import type { NavigatorContext } from '../../app/navigator-context-provider.js';
 import type { SearchAppState } from '../../state/search-app-state.js';
 import type { ConfigurationSection, GeneratedAnswerSection, SearchSection, TabSection } from '../../state/state-sections.js';
+import type { AnyFacetRequest } from '../facets/generic/interfaces/generic-facet-request.js';
 type StateNeededByGeneratedAnswerStream = ConfigurationSection & SearchSection & GeneratedAnswerSection;
 export interface AnswerApiQueryParams extends Omit<SearchRequest, keyof (BaseParam & AuthenticationParam & AutomaticFacetsParams)>, CaseContextParam {
 }
 export declare const buildStreamingRequest: (state: StateNeededByGeneratedAnswerStream) => Promise<GeneratedAnswerStreamRequest>;
 export declare const constructAnswerAPIQueryParams: (state: StreamAnswerAPIState, navigatorContext: NavigatorContext) => AnswerApiQueryParams;
 export type StateNeededForHeadAnswerParams = ConfigurationSection & Partial<SearchAppState> & GeneratedAnswerSection & Partial<TabSection>;
+/**
+ * Parameters for answer generation requests.
+ */
+type AnswerParams = {
+    q: string;
+    facets?: AnyFacetRequest[];
+    searchHub?: string;
+    pipeline?: string;
+    pipelineRuleParameters: PipelineRuleParameters;
+    locale: string;
+} & AnalyticsParam;
 export declare const constructGenerateHeadAnswerParams: (state: StateNeededForHeadAnswerParams, navigatorContext: NavigatorContext) => AnswerParams;
 export {};

package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/generated-answer-selectors.d.ts

@@ -3,7 +3,7 @@ import type { GeneratedAnswerCitation } from '../../controllers/generated-answer
 import type { SearchAppState } from '../../state/search-app-state.js';
 import type { GeneratedAnswerSection } from '../../state/state-sections.js';
 export declare const generativeQuestionAnsweringIdSelector: (state: Partial<SearchAppState>) => string | undefined;
-export declare const isGeneratedAnswerFeatureEnabledWithAnswerGenerationAPI: (state: Partial<SearchAppState>) => state is StreamAnswerAPIState;
+export declare const isGeneratedAnswerFeatureEnabledWithAgentAPI: (state: Partial<SearchAppState>) => state is StreamAnswerAPIState;
 export declare const selectFieldsToIncludeInCitation: (state: Partial<GeneratedAnswerSection>) => string[] | undefined;
 export declare const citationSourceSelector: ((state: Partial<GeneratedAnswerSection>, citationId: string) => GeneratedAnswerCitation | undefined) & {
     clearCache: () => void;

package/force-app/main/default/staticresources/coveoheadless/definitions/features/search/legacy/search-request.d.ts

@@ -17,7 +17,7 @@ export declare const buildSearchRequest: (state: StateNeededBySearchRequest, eve
     facetOptions?: import("../../facet-options/facet-options.js").FacetOptions;
     numberOfResults?: number;
     firstResult?: number;
-    facets?: (import("../../facets/facet-set/interfaces/request.js").FacetRequest | import("../../facets/category-facet-set/interfaces/request.js").CategoryFacetRequest | import("../../facets/range-facets/date-facet-set/interfaces/request.js").DateFacetRequest | import("../../facets/range-facets/numeric-facet-set/interfaces/request.js").NumericFacetRequest)[] | undefined;
+    facets?: (import("../../facets/facet-set/interfaces/request.js").FacetRequest | import("../../facets/category-facet-set/interfaces/request.js").CategoryFacetRequest | import("../../facets/range-facets/numeric-facet-set/interfaces/request.js").NumericFacetRequest | import("../../facets/range-facets/date-facet-set/interfaces/request.js").DateFacetRequest)[] | undefined;
     cq?: string;
     queryCorrection?: {
         enabled?: boolean;

package/force-app/main/default/staticresources/coveoheadless/definitions/features/search/search-request.d.ts

@@ -18,7 +18,7 @@ export declare const buildSearchRequest: (state: StateNeededBySearchRequest, nav
     facetOptions?: import("../facet-options/facet-options.js").FacetOptions;
     numberOfResults?: number;
     firstResult?: number;
-    facets?: (import("../facets/facet-set/interfaces/request.js").FacetRequest | import("../facets/category-facet-set/interfaces/request.js").CategoryFacetRequest | import("../facets/range-facets/date-facet-set/interfaces/request.js").DateFacetRequest | import("../facets/range-facets/numeric-facet-set/interfaces/request.js").NumericFacetRequest)[] | undefined;
+    facets?: (import("../facets/facet-set/interfaces/request.js").FacetRequest | import("../facets/category-facet-set/interfaces/request.js").CategoryFacetRequest | import("../facets/range-facets/numeric-facet-set/interfaces/request.js").NumericFacetRequest | import("../facets/range-facets/date-facet-set/interfaces/request.js").DateFacetRequest)[] | undefined;
     cq?: string;
     queryCorrection?: {
         enabled?: boolean;

package/force-app/main/default/staticresources/coveoheadless/definitions/index.d.ts

@@ -63,7 +63,7 @@ export type { FieldSuggestions, FieldSuggestionsOptions, FieldSuggestionsProps,
 export { buildFieldSuggestions } from './controllers/field-suggestions/facet/headless-field-suggestions.js';
 export type { FoldedCollection, FoldedResult, FoldedResultList, FoldedResultListOptions, FoldedResultListProps, FoldedResultListState, FoldingOptions, } from './controllers/folded-result-list/headless-folded-result-list.js';
 export { buildFoldedResultList } from './controllers/folded-result-list/headless-folded-result-list.js';
-export type { GeneratedAnswer, GeneratedAnswerBase, GeneratedAnswerCitation, GeneratedAnswerProps, GeneratedAnswerPropsInitialState, GeneratedAnswerState, GeneratedAnswerWithFollowUps, GeneratedAnswerWithFollowUpsState, GeneratedResponseFormat, GenerationStep, } from './controllers/generated-answer/headless-generated-answer.js';
+export type { GeneratedAnswer, GeneratedAnswerBase, GeneratedAnswerCitation, GeneratedAnswerProps, GeneratedAnswerPropsInitialState, GeneratedAnswerState, GeneratedAnswerWithFollowUps, GeneratedAnswerWithFollowUpsState, GeneratedResponseFormat, GenerationStep, GenerationStepName, } from './controllers/generated-answer/headless-generated-answer.js';
 export { buildGeneratedAnswer } from './controllers/generated-answer/headless-generated-answer.js';
 export type { InteractiveCitation, InteractiveCitationOptions, InteractiveCitationProps, } from './controllers/generated-answer/headless-interactive-citation.js';
 export { buildInteractiveCitation } from './controllers/generated-answer/headless-interactive-citation.js';

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/product-list/headless-product-list.ssr.d.ts

@@ -2,11 +2,23 @@ import { type ProductListing, type ProductListingState } from '../../../../contr
 import { type Search } from '../../../../controllers/commerce/search/headless-search.js';
 import type { ControllerDefinitionOption, SubControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { Search, ProductListing, ProductListingState as ProductListState };
-export type ProductList = Pick<ProductListing | Search, 'state' | 'subscribe' | 'interactiveProduct' | 'promoteChildToParent'>;
+export type ProductList = Pick<ProductListing | Search, 'state' | 'subscribe' | 'interactiveProduct' | 'interactiveSpotlightContent' | 'promoteChildToParent'>;
+/**
+ * Options for configuring the `ProductList` controller.
+ */
+interface ProductListOptions {
+    /**
+     * When set to true, fills the `results` field rather than the `products` field
+     * in the response. It may also include Spotlight Content in the results.
+     * @default false
+     */
+    enableResults?: boolean;
+}
 /**
  * Defines a `ProductList` controller instance.
  * @group Definers
  *
+ * @param options - The configurable `ProductList` controller options.
  * @returns The `ProductList` controller definition.
  */
-export declare function defineProductList<TOptions extends ControllerDefinitionOption | undefined>(options?: TOptions): SubControllerDefinitionWithoutProps<ProductList, TOptions>;
+export declare function defineProductList<TOptions extends ControllerDefinitionOption | undefined>(options?: TOptions & ProductListOptions): SubControllerDefinitionWithoutProps<ProductList, TOptions>;