@gengage/assistant-fe 0.6.17 → 0.6.18

package/dist/agentic/recipes/catalog-assistant-flow.d.ts

@@ -0,0 +1,50 @@
+import type { Flow, FlowStepCtx } from '../types.js';
+export type CatalogAssistantRoute = 'addToCart' | 'compare' | 'similar' | 'search' | 'review' | 'like' | 'home' | 'product';
+export interface CatalogAssistantCopy {
+    productQuestion: string;
+    compareQuestion: string;
+    searchGoal: string;
+    similarGoal: string;
+    cartActionLabel: string;
+    cartSuccess: string | ((ctx: FlowStepCtx) => string);
+    cartFailure: string | ((ctx: FlowStepCtx) => string);
+    comparisonReady: string | ((ctx: FlowStepCtx) => string);
+    comparisonFallback: (products: unknown[]) => string;
+    productFallback: (product: unknown | undefined) => string;
+    searchResult: (products: unknown[], goal: string) => string;
+    reviewUnavailable: string | ((ctx: FlowStepCtx) => string);
+    likeAcknowledged: string | ((ctx: FlowStepCtx) => string);
+    homeIntro: string | ((ctx: FlowStepCtx) => string);
+}
+export interface CatalogAssistantRoutePatterns {
+    addToCart?: RegExp;
+    compare?: RegExp;
+    similar?: RegExp;
+    search?: RegExp;
+}
+export interface CatalogAssistantFlowOptions {
+    accountId: string;
+    homeUrl: string;
+    copy: CatalogAssistantCopy;
+    cacheTtlS?: number;
+    limit?: number;
+    routePatterns?: CatalogAssistantRoutePatterns;
+    readPageToolName?: string;
+    searchToolName?: string;
+    similarityToolName?: string;
+    resolveProductsToolName?: string;
+    addToCartToolName?: string;
+    productAnswerOpName?: string;
+    topPicksOpName?: string;
+    compareOpName?: string;
+    anonymousRequestText?: (request: FlowStepCtx['request']) => string;
+    trimProductFacts?: (product: unknown) => unknown;
+    trimProductFactsList?: (products: unknown[]) => unknown[];
+    productFromPage?: (page: unknown) => unknown | undefined;
+}
+export interface CatalogAssistantFlowResult {
+    flow: Flow;
+    flows: Record<string, Flow>;
+}
+export declare function createCatalogAssistantFlow(options: CatalogAssistantFlowOptions): CatalogAssistantFlowResult;
+export declare function routeCatalogAssistantRequest(request: FlowStepCtx['request'] | undefined, patterns?: CatalogAssistantRoutePatterns): CatalogAssistantRoute;

package/dist/agentic/recipes/input-text/actions.d.ts

@@ -0,0 +1,15 @@
+export interface ProductActionOptions {
+    includeCompare?: boolean;
+    includeSpecs?: boolean;
+    includeSimilar?: boolean;
+    labels?: {
+        compare?: string;
+        specs?: string;
+        similar?: string;
+    };
+}
+export declare function productActions(product: Record<string, unknown>, options?: ProductActionOptions): Record<string, unknown>[];
+export declare function productPanelActions(products: unknown, options?: ProductActionOptions): Record<string, unknown>[];
+export declare function actionCandidatePayload(label: unknown, requestDetails: unknown): Record<string, unknown>;
+export declare function normalizeSuggestedActions(actions: unknown, limit?: number): Record<string, unknown>[];
+export declare function normalizeActionLabel(label: unknown, maxLength?: number): string;

package/dist/agentic/recipes/input-text/index.d.ts

@@ -0,0 +1,4 @@
+export { hasProductImage, hasUsablePrice, hasVisibleShoppingFacts, normalizeQueryText, productRankScore, productSearchText, rankedSearchProducts, rankingTokens, type RankedSearchOptions, } from './ranking.js';
+export { panelProductScore, prioritizePanelProducts, productsMatchingParams, uniqueProducts } from './products.js';
+export { actionCandidatePayload, normalizeActionLabel, normalizeSuggestedActions, productActions, productPanelActions, type ProductActionOptions, } from './actions.js';
+export { compareCachedResultSteps, compareResultSteps, compareSearchSteps, compareSteps, intentQuestionSteps, panelQuestionSteps, productQuestionSteps, searchResultSteps, searchSteps, suggestedActionSteps, type CanonicalStepOptions, } from './steps.js';

package/dist/agentic/recipes/input-text/products.d.ts

@@ -0,0 +1,4 @@
+export declare function uniqueProducts(products: unknown): Record<string, unknown>[];
+export declare function productsMatchingParams(products: unknown, params: unknown): Record<string, unknown>[];
+export declare function prioritizePanelProducts(products: unknown, panelProducts: unknown, limit?: number): Record<string, unknown>[];
+export declare function panelProductScore(product: Record<string, unknown>, panelKeys: ReadonlySet<string>): number;

package/dist/agentic/recipes/input-text/ranking.d.ts

@@ -0,0 +1,14 @@
+export interface RankedSearchOptions {
+    limit?: number;
+    query?: unknown;
+    searchInput?: Record<string, unknown> | null;
+    intent?: Record<string, unknown> | null;
+}
+export declare function rankedSearchProducts(products: unknown, options?: RankedSearchOptions): Record<string, unknown>[];
+export declare function productRankScore(product: Record<string, unknown>, options?: RankedSearchOptions): number;
+export declare function rankingTokens(options?: RankedSearchOptions): string[];
+export declare function hasUsablePrice(product: Record<string, unknown>): boolean;
+export declare function hasProductImage(product: Record<string, unknown>): boolean;
+export declare function hasVisibleShoppingFacts(product: Record<string, unknown>): boolean;
+export declare function productSearchText(product: Record<string, unknown>): string;
+export declare function normalizeQueryText(value: unknown): string;

package/dist/agentic/recipes/input-text/steps.d.ts

@@ -0,0 +1,31 @@
+import type { FlowPatch, FlowStep, FlowValue } from '../../types.js';
+export interface CanonicalStepOptions {
+    steps?: FlowStep[];
+    toolName?: string;
+    beOpName?: string;
+    input?: FlowValue<unknown>;
+    cacheTtlS?: FlowValue<number | undefined>;
+    cacheKey?: FlowValue<string | undefined>;
+    browserCache?: FlowValue<boolean | {
+        ttlMs?: number;
+    } | undefined>;
+    out?: string;
+    errorOut?: string;
+    patch?: FlowPatch;
+    onError?: readonly FlowStep[];
+    emitProducts?: boolean;
+    emitProductDetails?: boolean;
+    emitComparison?: boolean;
+    emitActions?: boolean;
+    emitText?: FlowValue<string>;
+}
+export declare function intentQuestionSteps(options?: CanonicalStepOptions): FlowStep[];
+export declare function searchSteps(options?: CanonicalStepOptions): FlowStep[];
+export declare function productQuestionSteps(options?: CanonicalStepOptions): FlowStep[];
+export declare function panelQuestionSteps(options?: CanonicalStepOptions): FlowStep[];
+export declare function compareSteps(options?: CanonicalStepOptions): FlowStep[];
+export declare function compareSearchSteps(options?: CanonicalStepOptions): FlowStep[];
+export declare function compareCachedResultSteps(options?: CanonicalStepOptions): FlowStep[];
+export declare function compareResultSteps(options?: CanonicalStepOptions): FlowStep[];
+export declare function searchResultSteps(options?: CanonicalStepOptions): FlowStep[];
+export declare function suggestedActionSteps(options?: CanonicalStepOptions): FlowStep[];

package/dist/agentic/util/account-config.d.ts

@@ -0,0 +1,8 @@
+export interface AccountConfigPayloadOptions {
+    baseKeys?: readonly string[];
+    opAllowlist?: Readonly<Record<string, readonly string[]>>;
+}
+export declare function withAccountConfig<T extends Record<string, unknown>>(payload: T, accountConfig: Record<string, unknown> | null | undefined, opName: string, options?: AccountConfigPayloadOptions): T & {
+    account_config?: Record<string, unknown>;
+};
+export declare function compactAccountConfig(accountConfig: Record<string, unknown> | null | undefined, opName: string, options?: AccountConfigPayloadOptions): Record<string, unknown>;

package/dist/agentic/util/privacy.d.ts

@@ -0,0 +1,12 @@
+import type { ProcessActionRequest } from '../../common/transport.js';
+export interface RedactionPattern {
+    pattern: RegExp;
+    replacement: string | ((value: string) => string);
+}
+export interface RedactionPatternPack {
+    patterns?: readonly RedactionPattern[];
+}
+export declare const defaultPiiPatterns: readonly RedactionPattern[];
+export declare const defaultPiiPatternPack: RedactionPatternPack;
+export declare function redactPii(value: unknown, patternPack?: RedactionPatternPack): string;
+export declare function anonymousRequestText(request: ProcessActionRequest | null | undefined, patternPack?: RedactionPatternPack): string;

package/dist/agentic/widgets/endpoints.d.ts

@@ -0,0 +1,12 @@
+import type { InjectorBridgeEndpoint, InjectorEndpointHandler } from '../../common/transport.js';
+import type { EndpointCachePolicyResolver } from '../adaptor/fetch-bridge.js';
+export interface EndpointCachePolicyOptions {
+    partitionPrefix: string;
+    version?: string;
+    ttlMs?: number;
+}
+export declare function endpointStableKey(endpoint: InjectorBridgeEndpoint, request: unknown, version?: string): string;
+export declare function createEndpointCachePolicies(options: EndpointCachePolicyOptions): Partial<Record<InjectorBridgeEndpoint, EndpointCachePolicyResolver>>;
+export declare function createEndpointHandlers(handlers: Partial<Record<InjectorBridgeEndpoint, InjectorEndpointHandler>>): Partial<Record<InjectorBridgeEndpoint, InjectorEndpointHandler>>;
+export declare function ndjsonResponse(lines: unknown[], init?: ResponseInit): Response;
+export declare function jsonResponse(value: unknown, init?: ResponseInit): Response;

package/dist/agentic/worker.d.ts

@@ -2,13 +2,21 @@ export { ContextStore } from './context/context-store.js';
 export { action, done, error, metadata, textChunk, uiSpec } from './events/builders.js';
 export { AgentError, beErrorToAgentError, caughtToStreamError, httpErrorToAgentError, } from './events/error-taxonomy.js';
 export { normalizeProduct, trimProductFactsCore, trimProductFactsListCore } from './events/product-normalize.js';
+export { compactContextProducts } from './events/context-products.js';
+export { alignProductsToTable, comparisonResultForUi, normalizeComparisonTable } from './events/comparison.js';
 export { actionButtonsUiSpec, comparisonUiSpec, productDetailsUiSpec, productsUiSpec } from './events/ui-specs.js';
 export { createFlow } from './flow/create-flow.js';
 export { resolveFlow } from './flow/dispatch.js';
+export { createCatalogAssistantFlow, routeCatalogAssistantRequest, type CatalogAssistantCopy, type CatalogAssistantFlowOptions, type CatalogAssistantFlowResult, type CatalogAssistantRoute, type CatalogAssistantRoutePatterns, } from './recipes/catalog-assistant-flow.js';
+export { actionCandidatePayload, compareCachedResultSteps, compareResultSteps, compareSearchSteps, compareSteps, hasProductImage, hasUsablePrice, hasVisibleShoppingFacts, intentQuestionSteps, normalizeActionLabel, normalizeQueryText, normalizeSuggestedActions, panelProductScore, panelQuestionSteps, prioritizePanelProducts, productActions, productPanelActions, productQuestionSteps, productRankScore, productSearchText, productsMatchingParams, rankedSearchProducts, rankingTokens, searchResultSteps, searchSteps, suggestedActionSteps, uniqueProducts, } from './recipes/input-text/index.js';
 export { buildPhotoSimilarityProfile, buildProductSimilarityProfile, buildSimilarityQueries, normalizeSimilarityText, rankSimilarProducts, scoreSimilarityCandidate, tokenizeSimilarityText, type PhotoSimilaritySignals, type ProductSimilarityProfile, type SimilarityProductLike, type SimilarityRankedProduct, type SimilarityRankingOptions, type SimilarityScore, type SimilarityWeights, } from './similarity.js';
 export { requestText } from './util/request-text.js';
+export { anonymousRequestText, defaultPiiPatternPack, defaultPiiPatterns, redactPii } from './util/privacy.js';
+export { compactAccountConfig, withAccountConfig } from './util/account-config.js';
 export { llmCacheKey, productFactsKey, productSkuKey, stableKey, textKey } from './util/cache-key.js';
 export type { LlmCacheKeyOptions, ProductFactsKeyOptions, ProductKeyOptions } from './util/cache-key.js';
+export type { RedactionPattern, RedactionPatternPack } from './util/privacy.js';
+export type { AccountConfigPayloadOptions } from './util/account-config.js';
 export { elapsedMs, nowIso } from './util/time.js';
 export { invokeBeOp } from './worker/be-client.js';
 export { startWorker } from './worker/entry.js';