@gengage/assistant-fe 0.6.21 → 0.6.23

package/README.md

@@ -146,8 +146,8 @@ npm run catalog                                # Visual component catalog at :30
 npm run docs:build                             # Build contributor docs with VitePress
 ```
 
-This repo builds the SDK package only. Hosted account demos and exact client PDP/PLP clones live in
-`gengage-assistant-injector` and are deployed from that repository to gengage CDN location.
+This repo builds the SDK package only. Hosted account demos and exact client PDP/PLP clones live
+outside the SDK and should not be committed here.
 
 ---
 
@@ -157,6 +157,8 @@ This repo builds the SDK package only. Hosted account demos and exact client PDP
 |-----|-------------|
 | [Docs Index](docs/index.md) | Full documentation map |
 | [API Reference](docs/api-reference.md) | Public entry points and config surfaces |
+| [Agentic Overview](docs/agentic-overview.md) | Agentic SDK architecture and compatibility rules |
+| [Agentic Integration Guide](docs/agentic-integration-guide.md) | From-scratch browser-local agentic integration guide |
 | [Architecture](docs/architecture.md) | System design, widget lifecycle, data flows |
 | [Wire Protocol](docs/wire-protocol.md) | Backend NDJSON streaming contract |
 | [Customization](docs/customization.md) | CSS tokens, component overrides, XSS rules |

package/dist/agentic/adaptor/create-adaptor.d.ts

@@ -1,5 +1,6 @@
+import { type MainRpcMemory } from '../worker/rpc.js';
 import type { InjectorAdapter } from '../../common/transport.js';
-import type { AccountModule, BeaconCallback, ToolMap } from '../types.js';
+import type { AccountModule, BeaconCallback, ConfirmationCallback, ToolMap } from '../types.js';
 interface CreateInjectorAdapterArgs {
     accountId: string;
     worker: Worker;
@@ -10,10 +11,12 @@ interface CreateInjectorAdapterArgs {
     defaultLocale?: string | undefined;
     tools?: ToolMap | undefined;
     beacon?: BeaconCallback | undefined;
+    confirmation?: ConfirmationCallback | undefined;
+    memory?: MainRpcMemory | undefined;
 }
-export declare function createInjectorAdapter({ accountId, worker, beUrl, devJwtSecret, tokenBrokerUrl, tokenBrokerAudience, defaultLocale, tools, beacon, }: CreateInjectorAdapterArgs): InjectorAdapter;
+export declare function createInjectorAdapter({ accountId, worker, beUrl, devJwtSecret, tokenBrokerUrl, tokenBrokerAudience, defaultLocale, tools, beacon, confirmation, memory, }: CreateInjectorAdapterArgs): InjectorAdapter;
 interface CreateMainThreadInjectorAdapterArgs extends Omit<CreateInjectorAdapterArgs, 'worker'> {
     accountModule: AccountModule;
 }
-export declare function createMainThreadInjectorAdapter({ accountId, accountModule, beUrl, devJwtSecret, tokenBrokerUrl, tokenBrokerAudience, defaultLocale, tools, beacon, }: CreateMainThreadInjectorAdapterArgs): InjectorAdapter;
+export declare function createMainThreadInjectorAdapter({ accountId, accountModule, beUrl, devJwtSecret, tokenBrokerUrl, tokenBrokerAudience, defaultLocale, tools, beacon, confirmation, memory, }: CreateMainThreadInjectorAdapterArgs): InjectorAdapter;
 export {};

package/dist/agentic/adaptor/mount.d.ts

@@ -1,4 +1,5 @@
-import type { AccountModule, BeaconCallback, ToolMap } from '../types.js';
+import type { AccountModule, BeaconCallback, ConfirmationCallback, ToolMap } from '../types.js';
+import type { MainRpcMemory } from '../worker/rpc.js';
 interface MountAccountArgs {
     accountId: string;
     beUrl: string;
@@ -10,7 +11,10 @@ interface MountAccountArgs {
     accountModule: AccountModule;
     tools?: ToolMap;
     beacon?: BeaconCallback;
+    confirmation?: ConfirmationCallback;
+    memory?: MainRpcMemory;
     allowBlobWorker?: boolean;
+    signal?: AbortSignal;
 }
 interface AgentDiagnostics {
     accountId: string;
@@ -23,6 +27,8 @@ interface AgentDiagnostics {
 }
 export interface AgentController {
     type: 'agent';
+    signal: AbortSignal;
+    addCleanup: (cleanup: () => void) => void;
     stop: () => void;
     diagnostics: () => AgentDiagnostics;
 }
@@ -33,7 +39,7 @@ interface ModuleWorkerHandle {
 interface CreateModuleWorkerOptions {
     allowBlobWorker?: boolean;
 }
-export declare function mountAccount({ accountId, beUrl, devJwtSecret, tokenBrokerUrl, tokenBrokerAudience, workerUrl, defaultLocale, accountModule, tools, beacon, allowBlobWorker, }: MountAccountArgs): AgentController;
+export declare function mountAccount({ accountId, beUrl, devJwtSecret, tokenBrokerUrl, tokenBrokerAudience, workerUrl, defaultLocale, accountModule, tools, beacon, confirmation, memory, allowBlobWorker, signal, }: MountAccountArgs): AgentController;
 export declare function canUseModuleWorker(workerUrl: string): boolean;
 export declare function createModuleWorker(workerUrl: string, name: string, options?: CreateModuleWorkerOptions): ModuleWorkerHandle;
 export {};

package/dist/agentic/{similarity.d.ts → algos/similarity.d.ts}

@@ -40,7 +40,10 @@ export interface PhotoSimilaritySignals {
 }
 export interface SimilarityRankingOptions {
     limit?: number;
+    maxCandidates?: number;
     queryLimit?: number;
+    locale?: string;
+    similarityMapper?: ((raw: Record<string, unknown>) => ProductSimilarityProfile | null) | undefined;
     ignoreSkus?: string[];
     stopWords?: Iterable<string>;
     facetKeys?: string[];
@@ -50,6 +53,11 @@ export interface SimilarityRankingOptions {
     hitCounts?: ReadonlyMap<string, number> | Record<string, number>;
     weights?: Partial<SimilarityWeights>;
 }
+export interface SimilarityAsyncRankingOptions extends SimilarityRankingOptions {
+    batchSize?: number;
+    signal?: AbortSignal;
+    yield?: () => Promise<void>;
+}
 export interface SimilarityWeights {
     token: number;
     keyword: number;
@@ -68,10 +76,11 @@ export type SimilarityRankedProduct<T> = T & {
     similarity_score: number;
     similarity_reasons: string[];
 };
-export declare function normalizeSimilarityText(value: unknown): string;
-export declare function tokenizeSimilarityText(value: unknown, stopWords?: Iterable<string>): string[];
+export declare function normalizeSimilarityText(value: unknown, locale?: string): string;
+export declare function tokenizeSimilarityText(value: unknown, stopWords?: Iterable<string>, locale?: string): string[];
 export declare function buildProductSimilarityProfile(product: SimilarityProductLike | ProductSimilarityProfile, options?: SimilarityRankingOptions): ProductSimilarityProfile;
 export declare function buildPhotoSimilarityProfile(signals: PhotoSimilaritySignals, options?: SimilarityRankingOptions): ProductSimilarityProfile;
 export declare function buildSimilarityQueries(source: SimilarityProductLike | ProductSimilarityProfile, options?: SimilarityRankingOptions): string[];
 export declare function scoreSimilarityCandidate(source: ProductSimilarityProfile, candidate: SimilarityProductLike, options?: SimilarityRankingOptions): SimilarityScore;
 export declare function rankSimilarProducts<T extends SimilarityProductLike>(source: SimilarityProductLike | ProductSimilarityProfile, candidates: T[], options?: SimilarityRankingOptions): Array<SimilarityRankedProduct<T>>;
+export declare function rankSimilarProductsAsync<T extends SimilarityProductLike>(source: SimilarityProductLike | ProductSimilarityProfile, candidates: T[], options?: SimilarityAsyncRankingOptions): Promise<Array<SimilarityRankedProduct<T>>>;

package/dist/agentic/algos/similarity.js

@@ -0,0 +1,261 @@
+var w = /* @__PURE__ */ new Set([
+  "and",
+  "are",
+  "for",
+  "from",
+  "the",
+  "with"
+]), z = {
+  token: 0.26,
+  keyword: 0.22,
+  category: 0.18,
+  facet: 0.16,
+  color: 0.08,
+  attribute: 0.06,
+  price: 0.08,
+  retrieval: 0.08
+}, F = [
+  "amber",
+  "beige",
+  "black",
+  "blue",
+  "blush",
+  "bronze",
+  "brown",
+  "cream",
+  "gold",
+  "green",
+  "grey",
+  "ivory",
+  "lilac",
+  "mixed",
+  "orange",
+  "pastel",
+  "pink",
+  "purple",
+  "red",
+  "silver",
+  "white",
+  "yellow"
+];
+function h(e, t) {
+  return String(e ?? "").toLocaleLowerCase(t || void 0).normalize("NFKD").replace(new RegExp("\\p{Diacritic}", "gu"), "").replace(/[^\p{L}\p{N}]+/gu, " ").replace(/\s+/gu, " ").trim();
+}
+function y(e, t = w, r) {
+  const i = t instanceof Set ? t : /* @__PURE__ */ new Set([...w, ...t]), n = /* @__PURE__ */ new Set(), o = [];
+  for (const c of h(e, r).split(/\s+/u))
+    c.length < 3 || i.has(c) || n.has(c) || (n.add(c), o.push(c));
+  return o;
+}
+function g(e, t = {}) {
+  if (B(e)) return e;
+  const r = t.similarityMapper?.(e);
+  if (r) return r;
+  const i = t.facetKeys, n = l(e.category_names ?? e.category), o = l(e.category_ids), c = E(e.facet_hits), m = Object.entries(c).filter(([s]) => !i || i.some((O) => h(O, t.locale) === h(s, t.locale))).map(([, s]) => s), a = f(e.name, e.title), u = f(e.brand), p = t.sourceKeywords ?? [], T = [
+    a,
+    u,
+    ...n,
+    ...m,
+    ...l(e.promotions),
+    f(e.description),
+    ...p
+  ].join(" "), b = y(T, t.stopWords, t.locale), x = f(t.sourceProductType, K(n, a, b, t.locale), b[0]), S = d([...D(T, F, t.locale), ...Object.entries(c).filter(([s]) => /colou?r/iu.test(s)).flatMap(([, s]) => y(s, t.stopWords, t.locale))], t.locale), _ = d([...m.flatMap((s) => y(s, t.stopWords, t.locale)), ...l(e.promotions).flatMap((s) => y(s, t.stopWords, t.locale))], t.locale).slice(0, 24);
+  return {
+    sku: f(e.sku),
+    title: a,
+    brand: u,
+    productType: x,
+    categoryNames: n,
+    categoryIds: o,
+    facets: c,
+    keywords: d([...p.flatMap((s) => y(s, t.stopWords, t.locale)), ...b], t.locale).slice(0, 12),
+    tokens: b,
+    colors: S,
+    attributes: _,
+    price: C(e)
+  };
+}
+function v(e, t = {}) {
+  const r = f(e.product_type, e.productType), i = f(e.title, r, l(e.keywords).join(" ")), n = d([
+    ...l(e.keywords),
+    ...l(e.colors),
+    ...l(e.materials),
+    ...l(e.styles),
+    ...l(e.attributes)
+  ]);
+  return g({
+    sku: "__photo__",
+    name: i,
+    category_names: r ? [r] : [],
+    facet_hits: {
+      colors: l(e.colors).join(", "),
+      materials: l(e.materials).join(", "),
+      styles: l(e.styles).join(", "),
+      attributes: l(e.attributes).join(", ")
+    },
+    promotions: n
+  }, {
+    ...t,
+    sourceProductType: r,
+    sourceKeywords: n
+  });
+}
+function U(e, t = {}) {
+  const r = g(e, t);
+  return d([
+    ...t.sourceQueries ?? [],
+    M([
+      r.productType,
+      ...r.colors.slice(0, 1),
+      ...r.attributes.slice(0, 2)
+    ]),
+    M([r.productType, ...r.keywords.slice(0, 3)]),
+    M([r.categoryNames[r.categoryNames.length - 1], ...r.keywords.slice(0, 2)]),
+    M(r.title.split(/\s+/u).slice(0, 6)),
+    r.productType
+  ].map((i) => i.trim()).filter(Boolean)).slice(0, t.queryLimit ?? 6);
+}
+function j(e, t, r = {}) {
+  const i = {
+    ...z,
+    ...r.weights
+  }, n = g(t, r), o = [], c = k(e.tokens, n.tokens, r.locale), m = k(e.keywords, n.tokens, r.locale), a = R(e.categoryNames, n.categoryNames, r.locale) || k(P(e.categoryNames, r.locale), P(n.categoryNames, r.locale), r.locale), u = k(e.attributes, n.attributes, r.locale), p = k(e.colors, n.colors, r.locale), T = k(e.attributes, n.tokens, r.locale), b = W(e.price, n.price), x = I(n.sku, r.hitCounts) > 0 ? 1 : 0, S = Q(e, n), _ = c * i.token + m * i.keyword + a * i.category + u * i.facet + p * i.color + T * i.attribute + b * i.price + x * i.retrieval, s = q(S ? _ : _ * 0.35);
+  return S && e.productType && e.productType === n.productType && o.push("same product type"), a > 0.4 && o.push("similar category"), u > 0.2 && o.push("matching product attributes"), p > 0 && o.push("matching colour"), b > 0.8 && o.push("similar price"), S || o.push("weaker product-type match"), {
+    score: Number(s.toFixed(4)),
+    reasons: o
+  };
+}
+function $(e, t, r = {}) {
+  const i = g(e, r), n = new Set([i.sku, ...r.ignoreSkus ?? []].filter(Boolean));
+  return A(t.filter((o) => {
+    const c = f(o.sku);
+    return c && !n.has(c);
+  }), r.maxCandidates).map((o) => {
+    const c = j(i, o, r);
+    return {
+      ...o,
+      similarity_score: c.score,
+      similarity_reasons: c.reasons
+    };
+  }).sort((o, c) => c.similarity_score - o.similarity_score).slice(0, Math.max(1, Math.min(r.limit ?? 12, 100)));
+}
+async function G(e, t, r = {}) {
+  const i = g(e, r), n = new Set([i.sku, ...r.ignoreSkus ?? []].filter(Boolean)), o = A(t.filter((a) => {
+    const u = f(a.sku);
+    return u && !n.has(u);
+  }), r.maxCandidates), c = Math.max(1, Math.floor(r.batchSize ?? 50)), m = [];
+  for (let a = 0; a < o.length; a += 1) {
+    N(r.signal);
+    const u = o[a], p = j(i, u, r);
+    m.push({
+      ...u,
+      similarity_score: p.score,
+      similarity_reasons: p.reasons
+    }), (a + 1) % c === 0 && await L(r.yield);
+  }
+  return N(r.signal), m.sort((a, u) => u.similarity_score - a.similarity_score).slice(0, Math.max(1, Math.min(r.limit ?? 12, 100)));
+}
+function A(e, t) {
+  if (t === void 0) return e;
+  const r = Math.floor(Number(t));
+  return Number.isFinite(r) && r > 0 ? e.slice(0, r) : e;
+}
+async function L(e) {
+  if (e) {
+    await e();
+    return;
+  }
+  await new Promise((t) => {
+    const r = globalThis;
+    if (typeof r.scheduler?.yield == "function") {
+      r.scheduler.yield().then(t, t);
+      return;
+    }
+    if (typeof setTimeout == "function") {
+      setTimeout(t, 0);
+      return;
+    }
+    t();
+  });
+}
+function N(e) {
+  if (e?.aborted)
+    throw new DOMException("Similarity ranking aborted.", "AbortError");
+}
+function B(e) {
+  return !!(e && typeof e == "object" && Array.isArray(e.tokens));
+}
+function f(...e) {
+  for (const t of e) if (typeof t == "string" && t.trim()) return t.trim();
+  return "";
+}
+function l(e) {
+  return Array.isArray(e) ? e.map((t) => f(t)).filter(Boolean) : typeof e == "string" && e.trim() ? e.split(/[,;/|]+/u).map((t) => t.trim()).filter(Boolean) : [];
+}
+function E(e) {
+  return !e || typeof e != "object" || Array.isArray(e) ? {} : Object.fromEntries(Object.entries(e).map(([t, r]) => [t, f(r)]).filter(([, t]) => t));
+}
+function C(e) {
+  const t = Number(e.price_discounted);
+  if (Number.isFinite(t) && t > 0) return t;
+  const r = Number(e.price);
+  return Number.isFinite(r) && r > 0 ? r : 0;
+}
+function d(e, t) {
+  const r = /* @__PURE__ */ new Set(), i = [];
+  for (const n of e) {
+    const o = h(n, t);
+    !o || r.has(o) || (r.add(o), i.push(o));
+  }
+  return i;
+}
+function D(e, t, r) {
+  const i = ` ${h(e, r)} `;
+  return t.filter((n) => i.includes(` ${h(n, r)} `));
+}
+function K(e, t, r, i) {
+  const n = h(e[e.length - 1] ?? e[0] ?? "", i);
+  if (n) {
+    const o = y(n, w, i), c = new Set(y(t, w, i));
+    return o.find((m) => c.has(m)) ?? o[0] ?? n;
+  }
+  return r[0] ?? "";
+}
+function M(e) {
+  return e.map((t) => h(t)).filter(Boolean).join(" ").replace(/\s+/gu, " ").trim().slice(0, 120);
+}
+function P(e, t) {
+  return e.flatMap((r) => y(r, w, t));
+}
+function k(e, t, r) {
+  const i = d(e, r), n = new Set(d(t, r));
+  return i.length === 0 || n.size === 0 ? 0 : i.filter((o) => n.has(o)).length / i.length;
+}
+function R(e, t, r) {
+  const i = d(e, r), n = new Set(d(t, r));
+  return i.length === 0 || n.size === 0 ? 0 : i.filter((o) => n.has(o)).length / i.length;
+}
+function W(e, t) {
+  return e <= 0 || t <= 0 ? 0 : Math.min(e, t) / Math.max(e, t);
+}
+function I(e, t) {
+  return !e || !t ? 0 : typeof t.get == "function" ? t.get(e) ?? 0 : t[e] ?? 0;
+}
+function Q(e, t) {
+  if (!e.productType || !t.productType || e.productType === t.productType) return !0;
+  const r = new Set(y(e.productType)), i = /* @__PURE__ */ new Set([...y(t.productType), ...t.tokens]);
+  return [...r].some((n) => i.has(n));
+}
+function q(e) {
+  return Math.max(0, Math.min(1, e));
+}
+export {
+  v as buildPhotoSimilarityProfile,
+  g as buildProductSimilarityProfile,
+  U as buildSimilarityQueries,
+  h as normalizeSimilarityText,
+  $ as rankSimilarProducts,
+  G as rankSimilarProductsAsync,
+  j as scoreSimilarityCandidate,
+  y as tokenizeSimilarityText
+};

package/dist/agentic/context/chat-context.d.ts

@@ -1,15 +1,17 @@
-import type { ChatContext } from '../types.js';
+import type { ChatContext, ChatMessage } from '../types.js';
 interface CreateChatContextArgs {
     accountId: string;
     locale?: string | undefined;
     parentUrl?: string | undefined;
     threadId?: string | undefined;
     incomingContext?: unknown;
+    messageLimit?: number | undefined;
 }
 interface IncomingMessageLike {
     role?: unknown;
     content?: unknown;
 }
 export declare function createChatContext(args: CreateChatContextArgs): ChatContext;
-export declare function appendMessage(context: ChatContext, message: IncomingMessageLike): ChatContext;
+export declare function appendMessage(context: ChatContext, message: IncomingMessageLike, messageLimit?: number): ChatContext;
+export declare function limitMessages(messages: ChatMessage[], messageLimit?: number): ChatMessage[];
 export {};

package/dist/agentic/context/context-store.d.ts

@@ -7,16 +7,26 @@ interface ContextStoreOptions {
     rpc: RpcFn;
     persistentPanelKeys?: readonly string[] | undefined;
     panelKeyLimits?: Record<string, number> | undefined;
+    messageLimit?: number | undefined;
+    maxThreads?: number | undefined;
+    threadTtlMs?: number | undefined;
 }
 type PatchInput = Partial<ChatContext> | null | undefined | ((current: ChatContext) => Partial<ChatContext> | null | undefined);
 export declare class ContextStore {
     #private;
-    constructor({ accountId, locale, parentUrl, rpc, persistentPanelKeys, panelKeyLimits, }: ContextStoreOptions);
+    constructor({ accountId, locale, parentUrl, rpc, persistentPanelKeys, panelKeyLimits, messageLimit, maxThreads, threadTtlMs, }: ContextStoreOptions);
+    get size(): number;
+    get(threadId?: string | null | undefined): ChatContext | null;
+    getPanel(threadId?: string | null | undefined): ChatContext['panel'] | null;
+    getRecentProducts(threadId?: string | null | undefined, key?: string): readonly unknown[];
     load(request: (ProcessActionRequest & {
         sessionId?: string;
     }) | null | undefined): Promise<ChatContext>;
     patch(threadId: string | null | undefined, patch: PatchInput): ChatContext | null;
     appendUserMessage(threadId: string | null | undefined, text: string): ChatContext | null;
     commit(threadId: string | null | undefined): Promise<ChatContext | null>;
+    delete(threadId: string | null | undefined): boolean;
+    clear(): void;
+    pruneExpired(now?: number): number;
 }
 export {};

package/dist/agentic/context/persistence.d.ts

@@ -10,4 +10,5 @@ interface SaveArgs extends LoadArgs {
 }
 export declare function loadStickyContext({ accountId, threadId, rpc }: LoadArgs): Promise<Record<string, unknown>>;
 export declare function saveStickyContext({ accountId, threadId, extensions, panel, rpc }: SaveArgs): Promise<void>;
+export declare function stickyContextKey(accountId: string, threadId: string): string;
 export {};

package/dist/agentic/contracts/agentic-contracts.d.ts

@@ -0,0 +1,133 @@
+export type LocaleCode = string;
+export type MoneyValue = number | string;
+export interface GssProductFeature {
+    key: string;
+    value: string | number | boolean;
+    group?: string;
+    unit?: string;
+    source?: string;
+}
+export interface GssProductSeller {
+    id?: string;
+    name: string;
+    rating?: number;
+    url?: string;
+}
+export interface GssProductReview {
+    id?: string;
+    author?: string;
+    rating?: number;
+    title?: string;
+    text?: string;
+    date?: string;
+}
+export interface GssProductQuestionAnswer {
+    question: string;
+    answer?: string;
+    date?: string;
+}
+export interface GssShippingOption {
+    label: string;
+    price?: MoneyValue;
+    currency?: string;
+    eta?: string;
+}
+export interface GssInstallmentOption {
+    count: number;
+    monthlyAmount?: MoneyValue;
+    totalAmount?: MoneyValue;
+    bank?: string;
+    currency?: string;
+}
+export interface GssProductDetails {
+    sku?: string;
+    id?: string;
+    name?: string;
+    title?: string;
+    brand?: string;
+    url?: string;
+    image?: string;
+    imageUrl?: string;
+    images?: string[];
+    category?: string;
+    category_names?: string[];
+    price?: MoneyValue;
+    price_discounted?: MoneyValue;
+    price_currency?: string;
+    description?: string;
+    features?: GssProductFeature[];
+    specs?: Record<string, unknown>;
+    seller?: GssProductSeller;
+    qna?: GssProductQuestionAnswer[];
+    reviews?: GssProductReview[];
+    rating?: number;
+    review_count?: number;
+    in_stock?: boolean;
+    availability?: 'in_stock' | 'out_of_stock' | 'preorder' | 'unknown' | string;
+    shipping?: GssShippingOption[];
+    installment?: GssInstallmentOption[];
+    facets?: Record<string, string | string[] | number | boolean>;
+}
+export interface BeOpInputBase {
+    locale?: LocaleCode;
+    account_config?: Record<string, unknown>;
+}
+export interface IntentOpInput extends BeOpInputBase {
+    utterance: string;
+    page_context?: Record<string, unknown>;
+    structured_context?: Record<string, unknown>;
+}
+export interface IntentOpOutput {
+    intent?: {
+        kind?: string;
+        confidence?: number;
+        rationale?: string;
+    };
+    search_params?: Record<string, unknown>;
+    flow_params?: Record<string, unknown>;
+}
+export interface ProductAnswerInput extends BeOpInputBase {
+    question: string;
+    products: GssProductDetails[];
+    page_context?: Record<string, unknown>;
+}
+export interface ProductAnswerOutput {
+    answer?: string;
+    citations?: Array<{
+        sku?: string;
+        key?: string;
+        value?: string;
+    }>;
+    status?: string;
+}
+export interface CompareInput extends BeOpInputBase {
+    products: GssProductDetails[];
+    criteria?: string[];
+}
+export interface CompareOutput {
+    summary?: string;
+    table?: Record<string, Array<string | number | boolean | null>>;
+    recommended_choice_sku?: string;
+    key_differences?: string[];
+    special_considerations?: string[];
+    status?: string;
+}
+export type UiSpecElementType = 'ActionButtons' | 'ComparisonTable' | 'ProductCard' | 'ProductGrid' | 'ReviewSummary' | 'TextBlock' | string;
+export interface UiSpecElement<Props extends Record<string, unknown> = Record<string, unknown>> {
+    type: UiSpecElementType;
+    props?: Props;
+    children?: string[];
+}
+export interface UiSpec {
+    elements: Record<string, UiSpecElement>;
+    root?: string;
+}
+export interface UiSpecEvent {
+    type: 'ui_spec';
+    widget?: 'chat' | 'qna' | 'simrel' | 'similarity' | string;
+    spec: UiSpec;
+}
+export interface RefPayload {
+    kind: string;
+    id: string;
+}

package/dist/agentic/debug/activity-collector.d.ts

@@ -0,0 +1,14 @@
+export declare function createActivityCollector({ accountId, clock }?: {
+    clock?: (() => number) | undefined;
+}): {
+    accountId: any;
+    readonly entries: never[];
+    clear(): void;
+    record: (entry: any) => any;
+    subscribe(listener: any): () => void;
+};
+export declare function getOrCreateActivityCollector(accountId: any): any;
+export declare function normalizeEntry(entry: any): any;
+export declare function sectionForKind(kind: any): "Flow" | "Intent" | "Backend" | "Tools" | "Telemetry" | "Runtime";
+export declare function severityForEntry(entry: any): "error" | "warn" | "info";
+export declare function groupForEntry(entry: any): any;

package/dist/agentic/debug/activity-instrumentation.d.ts

@@ -0,0 +1,22 @@
+export declare function wrapActivityTools(tools: any, collector: any): any;
+export declare function wrapActivityBeacon(beacon: any, collector: any): any;
+export declare function wrapActivityTransport(accountId: any, collector: any): boolean;
+export declare function installActivityFetchPatch({ accountId, collector, promptBaseUrl }?: {}): void;
+export declare function recordBeDebugPayload(collector: any, payload: any): void;
+export declare function fetchPromptSource({ accountId, opName, promptBaseUrl }: {
+    accountId: any;
+    opName: any;
+    promptBaseUrl: any;
+}): Promise<{
+    url: string;
+    error: string;
+    yaml?: never;
+} | {
+    url: string;
+    yaml: string;
+    error?: never;
+} | {
+    error: any;
+    url?: never;
+    yaml?: never;
+} | null>;

package/dist/agentic/debug/activity-overlay.d.ts

@@ -0,0 +1,3 @@
+export declare function mountActivityOverlay(collector: any): HTMLElement | null;
+export declare function filterActivityEntries(entries: any, state?: {}): any[];
+export declare function formatJsonHtml(value: any): string;

package/dist/agentic/debug/activity-state.d.ts

@@ -0,0 +1,37 @@
+export declare function buildActivityVisualization(entries?: never[]): {
+    flow: {
+        status: string;
+        sessionId: string;
+        requestType: string;
+        actionType: string;
+        model: string;
+        current: string;
+        errors: number;
+        warnings: number;
+        startedAt: null;
+        lastAt: null;
+        tools: never[];
+        beOps: never[];
+        uiSurfaces: never[];
+        timeline: never[];
+    };
+    context: {
+        intent: null;
+        route: null;
+        panel: null;
+        threadExtensions: {};
+        pageProduct: null;
+        products: null;
+        ui: null;
+        lastText: string;
+    };
+};
+export declare function summarizeDebugState(value: any, source?: string): {
+    [k: string]: unknown;
+} | null;
+export declare function summarizePanelState(panel: any): {
+    [k: string]: unknown;
+} | null;
+export declare function summarizeUiSpec(spec: any, widget?: string, panelHint?: string): {
+    [k: string]: unknown;
+} | null;

package/dist/agentic/debug/local-dev.d.ts

@@ -0,0 +1,18 @@
+export declare function installLocalAgenticActivityDebug({ accountId, config, tools, beacon }?: {
+    config?: {} | undefined;
+}): {
+    enabled: boolean;
+    tools: any;
+    beacon: any;
+    record(): void;
+    wrapTransport(): void;
+    collector?: never;
+} | {
+    enabled: boolean;
+    collector: any;
+    tools: any;
+    beacon: any;
+    record: (entry: any) => any;
+    wrapTransport: () => boolean;
+};
+export declare function shouldInstallActivityDebug(accountId: any, config?: {}): boolean;

package/dist/agentic/events/product-normalize.d.ts

@@ -32,7 +32,10 @@ export interface TrimmedProductFacts {
     rating?: unknown;
     review_count?: unknown;
 }
-export declare function normalizeProduct(product: unknown): NormalizedProduct | null;
+export interface ProductNormalizeOptions {
+    catalogMapper?: ((raw: Record<string, unknown>) => NormalizedProduct | null) | undefined;
+}
+export declare function normalizeProduct(product: unknown, options?: ProductNormalizeOptions): NormalizedProduct | null;
 /**
  * Compact product facts for BE LLM-op evidence. Account-agnostic core —
  * keeps fields aligned with BE's shared productSchema (sharedSchemas.ts)