@zeniai/client-epic-state 5.1.0-betaSS3 → 5.1.1-beta0ND

package/lib/entity/aiCfo/aiCfoReducer.js

@@ -1,13 +1,14 @@
 "use strict";
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deleteQuestion = exports.clearAiCfo = exports.addQuestionPayload = exports.upsertOrAddQuestionAnswerPayload = exports.upsertAnswerPayload = exports.setChatHistory = exports.setSessions = exports.clearSession = exports.setNewSession = exports.toAiCfoVisualization = exports.initialAiCfoState = void 0;
+exports.clearSyntheticAiCfoAnswers = exports.removeSyntheticAiCfoAnswer = exports.updateSyntheticAiCfoAnswer = exports.appendSyntheticAiCfoAnswer = exports.updateAiCfoAnswerCardPolicyWizardPlan = exports.deleteQuestion = exports.clearAiCfo = exports.addQuestionPayload = exports.upsertOrAddQuestionAnswerPayload = exports.upsertAnswerPayload = exports.setChatHistory = exports.setSessions = exports.clearSession = exports.setNewSession = exports.toAiCfoVisualization = exports.initialAiCfoState = void 0;
 const toolkit_1 = require("@reduxjs/toolkit");
 const zeniDayJS_1 = require("../../zeniDayJS");
 const aiCfoState_1 = require("./aiCfoState");
 exports.initialAiCfoState = {
     aiCfoByChatSessionId: {},
     partialQuestionAnswers: {},
+    syntheticAnswersByChatSessionId: {},
 };
 // Utility: Merge two arrays of Q&A pairs, combining responses for the same question
 function mergeQuestionAnswerPairs(existing, newQAs) {
@@ -117,6 +118,7 @@ function chatHistoryToQA(history) {
                             chainOfThoughtActionSteps: [],
                             artifact: parsedAgentMessage.artifact ?? undefined,
                             artifactTitle: parsedAgentMessage.artifact_title ?? undefined,
+                            artifactHostUrl: parsedAgentMessage.artifact_host_url ?? undefined,
                         },
                         createdAt: (0, zeniDayJS_1.date)(agentMessage.created_at),
                     };
@@ -139,12 +141,174 @@ const toAiCfoVisualization = (visualization) => {
     if (visualization.type == null || visualization.data == null) {
         return undefined;
     }
+    // Reject unknown viz types; `?? 'table'` used to throw in the chart/table decoder
+    // when interactive-form payloads (no `values`) hit it.
+    const normalizedType = (0, aiCfoState_1.toAiCfoVisualizationTypeStrict)(visualization.type);
+    if (normalizedType == null) {
+        return undefined;
+    }
     return {
-        type: (0, aiCfoState_1.toAiCfoVisualizationTypeStrict)(visualization.type) ?? 'table',
-        data: toAiCfoVisualizationData(visualization.data),
+        type: normalizedType,
+        data: normalizedType === 'interactive_form'
+            ? toInteractiveFormVisualization(visualization.data)
+            : toAiCfoVisualizationData(visualization.data),
     };
 };
 exports.toAiCfoVisualization = toAiCfoVisualization;
+const toInteractiveFormVisualization = (data) => {
+    // When `form_type` is missing / mistyped, infer from payload shape so a malformed
+    // card-policy answer doesn't get decoded as cards_creation (wrong form + submit path).
+    const formType = (0, aiCfoState_1.toInteractiveFormTypeStrict)(data.form_type) ??
+        inferInteractiveFormTypeFromPayload(data.payload);
+    if (formType === 'card_policy') {
+        return {
+            formType: 'card_policy',
+            payload: toCardPolicyInitialData(data.payload),
+        };
+    }
+    return {
+        formType: 'cards_creation',
+        payload: toCardsCreationInitialData(data.payload),
+    };
+};
+const inferInteractiveFormTypeFromPayload = (payload) => {
+    if (payload != null && typeof payload === 'object' && 'mode' in payload) {
+        const mode = payload.mode;
+        if (mode === 'auto' || mode === 'guided' || mode === 'upload') {
+            return 'card_policy';
+        }
+    }
+    return 'cards_creation';
+};
+const toCardsCreationInitialData = (payload) => {
+    const suggestedCards = payload.suggested_cards ?? [];
+    const ordered = [...suggestedCards].sort((a, b) => KIND_RANK[a.card_type] - KIND_RANK[b.card_type]);
+    const withUniqueIds = withSynthesizedIds(ordered);
+    const suggestedOnly = withUniqueIds.filter(({ card }) => card.is_suggested);
+    const cardNameOptions = withUniqueIds.map(({ card, uniqueId }) => ({
+        id: uniqueId,
+        kind: toCardKind(card.card_type),
+        label: card.card_name,
+    }));
+    const suggestedOwnerUserIdByTeamId = Object.fromEntries(suggestedOnly.map(({ card, uniqueId }) => [
+        uniqueId,
+        normalizeOwnerId(card.owner_id),
+    ]));
+    const common = {
+        cardNameOptions,
+        suggestedOwnerUserIdByTeamId,
+    };
+    if (payload.mode === 'create') {
+        return {
+            ...common,
+            mode: 'create',
+            cardRows: suggestedOnly.map(({ card, uniqueId }) => ({
+                cardKind: toCardKind(card.card_type),
+                id: uniqueId,
+                label: card.card_name,
+                recommendedLimit: card.credit_limit > 0 ? card.credit_limit : undefined,
+                suggestedOwnerUserId: normalizeOwnerId(card.owner_id),
+            })),
+        };
+    }
+    return {
+        ...common,
+        mode: 'review',
+        teamRows: suggestedOnly.map(({ card, uniqueId }) => ({
+            avgMonthlySpend: CURRENCY_FORMATTER.format(card.avg_spend),
+            cardKind: toCardKind(card.card_type),
+            id: uniqueId,
+            label: card.card_name,
+            recommendedLimit: CURRENCY_FORMATTER.format(card.credit_limit),
+            recommendedLimitCadence: 'Monthly',
+        })),
+    };
+};
+const CURRENCY_FORMATTER = new Intl.NumberFormat('en-US', {
+    style: 'currency',
+    currency: 'USD',
+    maximumFractionDigits: 0,
+});
+// BE emits `null` or `""` for "no owner picked"; collapse both to `undefined`.
+const normalizeOwnerId = (ownerId) => (ownerId != null && ownerId !== '' ? ownerId : undefined);
+const KIND_RANK = {
+    vendor: 0,
+    category: 1,
+    department: 2,
+};
+const toCardKind = (cardType) => {
+    if (cardType === 'department') {
+        return 'class';
+    }
+    if (cardType === 'category') {
+        return 'category';
+    }
+    return 'vendor';
+};
+// Falls back to `${kind}__${card_name_id}__${index}` when `card_name_id` collides
+// (sample payloads ship the literal `"vendor_uuid"`), to keep RHF row keys unique.
+const withSynthesizedIds = (cards) => {
+    const seen = new Set();
+    return cards.map((card, index) => {
+        const preferred = card.card_name_id;
+        if (preferred != null && preferred !== '' && !seen.has(preferred)) {
+            seen.add(preferred);
+            return { card, uniqueId: preferred };
+        }
+        const synthesized = `${card.card_type}__${preferred ?? 'unknown'}__${index}`;
+        seen.add(synthesized);
+        return { card, uniqueId: synthesized };
+    });
+};
+const toCardPolicyDraftPolicy = (payload, index) => ({
+    id: `draft-${index}`,
+    name: payload.name,
+    description: payload.description ?? '',
+    mode: payload.mode,
+    allowedEntity: {
+        categoryCodes: payload.allowed_entity?.category_codes ?? [],
+        merchantNames: payload.allowed_entity?.merchant_names ?? [],
+    },
+    blockedEntity: {
+        categoryCodes: payload.blocked_entity?.category_codes ?? [],
+        merchantNames: payload.blocked_entity?.merchant_names ?? [],
+    },
+    applyToCards: payload.apply_to_cards ?? [],
+    requiredReceiptThreshold: payload.required_receipt_threshold ?? 0,
+    spendLimits: {
+        transaction: payload.spend_limits?.transaction ?? 0,
+    },
+});
+const toCardPolicyStep5Review = (payload) => ({
+    draftPolicies: (payload.draft_policies ?? []).map(toCardPolicyDraftPolicy),
+    groupingSource: payload.grouping_source ?? 'none',
+    prompt: payload.prompt ?? '',
+});
+const toCardPolicyWizardPlan = (payload) => ({
+    step5Review: toCardPolicyStep5Review(payload.step_5_review),
+});
+const toCardPolicyUploadSource = (payload) => ({
+    confidenceScore: payload.confidence_score,
+    fileName: payload.file_name,
+    lowConfidenceFields: payload.low_confidence_fields ?? [],
+});
+const toCardPolicyInitialData = (payload) => {
+    if (payload.mode === 'upload') {
+        return {
+            policyKind: 'upload',
+            wizardPlan: payload.wizard_plan != null
+                ? toCardPolicyWizardPlan(payload.wizard_plan)
+                : undefined,
+            source: payload.source != null
+                ? toCardPolicyUploadSource(payload.source)
+                : undefined,
+        };
+    }
+    return {
+        policyKind: payload.mode,
+        wizardPlan: toCardPolicyWizardPlan(payload.wizard_plan),
+    };
+};
 const toAiCfoVisualizationData = (data) => {
     if ('x' in data && 'y' in data) {
         // Normalize y to always be an array
@@ -187,7 +351,7 @@ const toAiCfoVisualizationData = (data) => {
     };
 };
 const toResponseBlockType = (answer, userId) => {
-    const { metadata, state, type, text, visualization, table, follow_up_questions, assumptions, insights, summarized_title, artifact, artifact_title, } = answer;
+    const { metadata, state, type, text, visualization, table, follow_up_questions, assumptions, insights, summarized_title, artifact, artifact_title, artifact_host_url, } = answer;
     const { chat_session_id, message_id, timestamp, chain_of_thought_action_steps: chainOfThoughtActionSteps = [], } = metadata;
     return {
         messageId: message_id,
@@ -207,6 +371,7 @@ const toResponseBlockType = (answer, userId) => {
             chainOfThoughtActionSteps,
             artifact: artifact ?? undefined,
             artifactTitle: artifact_title ?? undefined,
+            artifactHostUrl: artifact_host_url ?? undefined,
         },
         createdAt: (0, zeniDayJS_1.date)(timestamp),
     };
@@ -378,10 +543,8 @@ const aiCfo = (0, toolkit_1.createSlice)({
             // Update state - append new complete Q&As to existing ones
             session.questionAnswers = mergeQuestionAnswerPairs(session.questionAnswers, completeQAs);
         },
-        /**
-         * Upsert a Q/A pair: if the questionAnswerId exists, upsert the response block; if not, add a new Q/A entry.
-         * Used for push notification payloads that may introduce a new question.
-         */
+        // Upserts the response block when `questionAnswerId` exists; otherwise adds the Q/A
+        // entry. Used for push notification payloads that may introduce a new question.
         upsertOrAddQuestionAnswerPayload(draft, action) {
             const { chatSessionId, questionAnswerId, question: { questionId, createdAt, text }, answerPayload, userId, insertQuestionAnswer, } = action.payload;
             const session = draft.aiCfoByChatSessionId[chatSessionId];
@@ -458,10 +621,82 @@ const aiCfo = (0, toolkit_1.createSlice)({
                 session.questionAnswers.push(qa);
             }
         },
+        // Patches an upload-mode card-policy answer with the wizard plan + source returned
+        // by `policy-recommendation-from-upload`. No-op for non-upload / missing targets.
+        updateAiCfoAnswerCardPolicyWizardPlan(draft, action) {
+            const { answerId, chatSessionId, source, wizardPlan } = action.payload;
+            const session = draft.aiCfoByChatSessionId[chatSessionId];
+            if (session == null) {
+                return;
+            }
+            const qa = session.questionAnswers.find((entry) => entry.questionAnswerId === answerId);
+            if (qa == null) {
+                return;
+            }
+            for (const response of Object.values(qa.responses)) {
+                const visualization = response?.content.visualization;
+                if (visualization == null ||
+                    visualization.type !== 'interactive_form') {
+                    continue;
+                }
+                const data = visualization.data;
+                if (data.formType !== 'card_policy' ||
+                    data.payload.policyKind !== 'upload') {
+                    continue;
+                }
+                data.payload = {
+                    ...data.payload,
+                    wizardPlan,
+                    source: source ?? data.payload.source,
+                };
+            }
+        },
+        // Renders a "Creating…" placeholder while the cards/policy create mutation runs.
+        // Caller supplies a stable `id` (updated in place by `updateSyntheticAiCfoAnswer`).
+        appendSyntheticAiCfoAnswer(draft, action) {
+            const { chatSessionId, id, kind, createdAt, entityIds, sourceQuestionAnswerId, } = action.payload;
+            if (draft.syntheticAnswersByChatSessionId[chatSessionId] == null) {
+                draft.syntheticAnswersByChatSessionId[chatSessionId] = [];
+            }
+            draft.syntheticAnswersByChatSessionId[chatSessionId].push({
+                id,
+                kind,
+                entityIds: entityIds ?? [],
+                createdAt,
+                sourceQuestionAnswerId,
+            });
+        },
+        // Transitions a bubble from `creating_*` to `created_*` once the mutation completes.
+        updateSyntheticAiCfoAnswer(draft, action) {
+            const { chatSessionId, id, kind, entityIds } = action.payload;
+            const list = draft.syntheticAnswersByChatSessionId[chatSessionId];
+            if (list == null) {
+                return;
+            }
+            const entry = list.find((item) => item.id === id);
+            if (entry == null) {
+                return;
+            }
+            entry.kind = kind;
+            if (entityIds != null) {
+                entry.entityIds = entityIds;
+            }
+        },
+        removeSyntheticAiCfoAnswer(draft, action) {
+            const { chatSessionId, id } = action.payload;
+            const list = draft.syntheticAnswersByChatSessionId[chatSessionId];
+            if (list == null) {
+                return;
+            }
+            draft.syntheticAnswersByChatSessionId[chatSessionId] = list.filter((item) => item.id !== id);
+        },
+        clearSyntheticAiCfoAnswers(draft, action) {
+            delete draft.syntheticAnswersByChatSessionId[action.payload];
+        },
         clearSession(draft, action) {
             const sessionId = action.payload;
             delete draft.aiCfoByChatSessionId[sessionId];
-            // Clear partial Q&A if it belongs to the cleared session
+            delete draft.syntheticAnswersByChatSessionId[sessionId];
             if (draft.partialQuestionAnswers?.[sessionId] != null) {
                 draft.partialQuestionAnswers[sessionId] = undefined;
             }
@@ -469,6 +704,7 @@ const aiCfo = (0, toolkit_1.createSlice)({
         clearAiCfo(draft) {
             draft.aiCfoByChatSessionId = {};
             draft.partialQuestionAnswers = {};
+            draft.syntheticAnswersByChatSessionId = {};
         },
         deleteQuestion(draft, action) {
             const { chatSessionId, questionAnswerId } = action.payload;
@@ -481,6 +717,12 @@ const aiCfo = (0, toolkit_1.createSlice)({
             if (idx !== -1) {
                 session.questionAnswers.splice(idx, 1);
             }
+            // Drop synthetic bubbles whose sourceQuestionAnswerId is the deleted Q/A; otherwise "Creating…" / "Created" tiles outlive their Q/A.
+            const syntheticAnswers = draft.syntheticAnswersByChatSessionId[chatSessionId];
+            if (syntheticAnswers != null) {
+                draft.syntheticAnswersByChatSessionId[chatSessionId] =
+                    syntheticAnswers.filter((answer) => answer.sourceQuestionAnswerId !== questionAnswerId);
+            }
         },
     },
 });
@@ -493,5 +735,5 @@ const toChatSession = (chatSessionPayload) => {
         createdAt: (0, zeniDayJS_1.date)(created_at),
     };
 };
-_a = aiCfo.actions, exports.setNewSession = _a.setNewSession, exports.clearSession = _a.clearSession, exports.setSessions = _a.setSessions, exports.setChatHistory = _a.setChatHistory, exports.upsertAnswerPayload = _a.upsertAnswerPayload, exports.upsertOrAddQuestionAnswerPayload = _a.upsertOrAddQuestionAnswerPayload, exports.addQuestionPayload = _a.addQuestionPayload, exports.clearAiCfo = _a.clearAiCfo, exports.deleteQuestion = _a.deleteQuestion;
+_a = aiCfo.actions, exports.setNewSession = _a.setNewSession, exports.clearSession = _a.clearSession, exports.setSessions = _a.setSessions, exports.setChatHistory = _a.setChatHistory, exports.upsertAnswerPayload = _a.upsertAnswerPayload, exports.upsertOrAddQuestionAnswerPayload = _a.upsertOrAddQuestionAnswerPayload, exports.addQuestionPayload = _a.addQuestionPayload, exports.clearAiCfo = _a.clearAiCfo, exports.deleteQuestion = _a.deleteQuestion, exports.updateAiCfoAnswerCardPolicyWizardPlan = _a.updateAiCfoAnswerCardPolicyWizardPlan, exports.appendSyntheticAiCfoAnswer = _a.appendSyntheticAiCfoAnswer, exports.updateSyntheticAiCfoAnswer = _a.updateSyntheticAiCfoAnswer, exports.removeSyntheticAiCfoAnswer = _a.removeSyntheticAiCfoAnswer, exports.clearSyntheticAiCfoAnswers = _a.clearSyntheticAiCfoAnswers;
 exports.default = aiCfo.reducer;

package/lib/entity/aiCfo/aiCfoSelector.d.ts

@@ -1,13 +1,16 @@
 import { ID } from '../../commonStateTypes/common';
-import { AiCfoQuestionWithAnswer, AiCfoState, ChatSession } from './aiCfoState';
+import { AiCfoQuestionWithAnswer, AiCfoState, ChatSession, SyntheticAiCfoAnswer } from './aiCfoState';
 export declare function getAllQuestionAnswersForChatSession(state: AiCfoState, chatSessionId: ID): AiCfoQuestionWithAnswer[];
 export declare function getQuestionAnswerByIdForChatSession(state: AiCfoState, chatSessionId: ID, questionAnswerId: ID): AiCfoQuestionWithAnswer | undefined;
 export declare function getAllQuestionsForChatSession(state: AiCfoState, chatSessionId: ID): string[];
 export interface AiCfoSelectorView {
     allSessionsWithOrderedQuestionAnswers: ChatSessionWithOrderedQuestionAnswers[];
+    syntheticAnswersByChatSessionId: Record<ID, SyntheticAiCfoAnswer[]>;
 }
 export interface ChatSessionWithOrderedQuestionAnswers {
     chatSession: ChatSession;
     questionAnswers: AiCfoQuestionWithAnswer[];
 }
 export declare function getAiCfoSelectorView(state: AiCfoState): AiCfoSelectorView;
+export declare function getSyntheticAiCfoAnswersForChatSession(state: AiCfoState, chatSessionId: ID): SyntheticAiCfoAnswer[];
+export declare function getSyntheticAiCfoAnswerByQuestionAnswerId(state: AiCfoState, chatSessionId: ID, questionAnswerId: ID): SyntheticAiCfoAnswer | undefined;

package/lib/entity/aiCfo/aiCfoSelector.js

@@ -4,6 +4,8 @@ exports.getAllQuestionAnswersForChatSession = getAllQuestionAnswersForChatSessio
 exports.getQuestionAnswerByIdForChatSession = getQuestionAnswerByIdForChatSession;
 exports.getAllQuestionsForChatSession = getAllQuestionsForChatSession;
 exports.getAiCfoSelectorView = getAiCfoSelectorView;
+exports.getSyntheticAiCfoAnswersForChatSession = getSyntheticAiCfoAnswersForChatSession;
+exports.getSyntheticAiCfoAnswerByQuestionAnswerId = getSyntheticAiCfoAnswerByQuestionAnswerId;
 function getAllQuestionAnswersForChatSession(state, chatSessionId) {
     const arr = state.aiCfoByChatSessionId[chatSessionId]?.questionAnswers ?? [];
     return arr
@@ -38,5 +40,21 @@ function getAiCfoSelectorView(state) {
             : [],
     }))
         .sort((a, b) => b.chatSession.createdAt.valueOf() - a.chatSession.createdAt.valueOf());
-    return { allSessionsWithOrderedQuestionAnswers };
+    return {
+        allSessionsWithOrderedQuestionAnswers,
+        syntheticAnswersByChatSessionId: state.syntheticAnswersByChatSessionId ?? {},
+    };
+}
+function getSyntheticAiCfoAnswersForChatSession(state, chatSessionId) {
+    const arr = state.syntheticAnswersByChatSessionId?.[chatSessionId] ?? [];
+    return arr
+        .slice()
+        .sort((a, b) => a.createdAt.valueOf() - b.createdAt.valueOf());
+}
+function getSyntheticAiCfoAnswerByQuestionAnswerId(state, chatSessionId, questionAnswerId) {
+    const arr = state.syntheticAnswersByChatSessionId?.[chatSessionId];
+    if (arr == null) {
+        return undefined;
+    }
+    return arr.find((answer) => answer.sourceQuestionAnswerId === questionAnswerId);
 }

package/lib/entity/aiCfo/aiCfoState.d.ts

@@ -9,9 +9,13 @@ export interface AiCfoAnswerParagraph {
     }>;
 }
 export declare const ALL_AI_CFO_CHARTS_TYPES: readonly ["bar_chart", "pie_chart", "line_chart"];
-export declare const ALL_AI_CFO_VISUALIZATION_TYPES: readonly ["bar_chart", "pie_chart", "line_chart", "table"];
-export declare const toAiCfoVisualizationType: (v: string) => "bar_chart" | "pie_chart" | "line_chart" | "table";
-export declare const toAiCfoVisualizationTypeStrict: (v: string) => "bar_chart" | "pie_chart" | "line_chart" | "table" | undefined;
+export declare const ALL_AI_CFO_VISUALIZATION_TYPES: readonly ["bar_chart", "pie_chart", "line_chart", "table", "interactive_form"];
+export declare const ALL_INTERACTIVE_FORM_TYPES: readonly ["cards_creation", "card_policy"];
+export declare const toInteractiveFormType: (v: string) => "cards_creation" | "card_policy";
+export declare const toInteractiveFormTypeStrict: (v: string) => "cards_creation" | "card_policy" | undefined;
+export type InteractiveFormType = ReturnType<typeof toInteractiveFormType>;
+export declare const toAiCfoVisualizationType: (v: string) => "bar_chart" | "pie_chart" | "line_chart" | "table" | "interactive_form";
+export declare const toAiCfoVisualizationTypeStrict: (v: string) => "bar_chart" | "pie_chart" | "line_chart" | "table" | "interactive_form" | undefined;
 export type AiCfoVisualizationType = ReturnType<typeof toAiCfoVisualizationType>;
 export declare const toAiCfoChartType: (v: string) => "bar_chart" | "pie_chart" | "line_chart";
 export declare const toAiCfoChartTypeStrict: (v: string) => "bar_chart" | "pie_chart" | "line_chart" | undefined;
@@ -53,8 +57,87 @@ export interface ChartVisualization {
     lines?: string[];
     yFormat?: YFormat;
 }
+export type CardsCardKind = 'vendor' | 'class' | 'category';
+export interface CardNameOption {
+    id: string;
+    kind: CardsCardKind;
+    label: string;
+}
+export interface CardsCreationCommonData {
+    cardNameOptions: CardNameOption[];
+    suggestedOwnerUserIdByTeamId: Record<string, ID | undefined>;
+}
+export type CardsCreationInitialData = (CardsCreationCommonData & {
+    mode: 'review';
+    teamRows: Array<{
+        avgMonthlySpend: string;
+        cardKind: CardsCardKind;
+        id: string;
+        label: string;
+        recommendedLimit: string;
+        recommendedLimitCadence?: string;
+    }>;
+}) | (CardsCreationCommonData & {
+    cardRows: Array<{
+        cardKind: CardsCardKind;
+        id: string;
+        label: string;
+        recommendedLimit?: number;
+        suggestedOwnerUserId?: ID;
+    }>;
+    mode: 'create';
+});
+export interface CardPolicyDraftPolicyEntity {
+    categoryCodes: string[];
+    merchantNames: string[];
+}
+export interface CardPolicySpendLimits {
+    transaction: number;
+}
+export interface CardPolicyDraftPolicy {
+    allowedEntity: CardPolicyDraftPolicyEntity;
+    applyToCards: string[];
+    blockedEntity: CardPolicyDraftPolicyEntity;
+    description: string;
+    id: string;
+    mode: string;
+    name: string;
+    requiredReceiptThreshold: number;
+    spendLimits: CardPolicySpendLimits;
+}
+export interface CardPolicyStep5Review {
+    draftPolicies: CardPolicyDraftPolicy[];
+    groupingSource: string;
+    prompt: string;
+}
+export interface CardPolicyWizardPlan {
+    step5Review: CardPolicyStep5Review;
+}
+export interface CardPolicyUploadSource {
+    confidenceScore: number;
+    fileName: string;
+    lowConfidenceFields: string[];
+}
+export type CardPolicyInitialData = {
+    policyKind: 'auto';
+    wizardPlan: CardPolicyWizardPlan;
+} | {
+    policyKind: 'guided';
+    wizardPlan: CardPolicyWizardPlan;
+} | {
+    policyKind: 'upload';
+    source?: CardPolicyUploadSource;
+    wizardPlan?: CardPolicyWizardPlan;
+};
+export type InteractiveFormVisualization = {
+    formType: 'cards_creation';
+    payload: CardsCreationInitialData;
+} | {
+    formType: 'card_policy';
+    payload: CardPolicyInitialData;
+};
 export interface AiCfoVisualization {
-    data: TableVisualization | ChartVisualization;
+    data: TableVisualization | ChartVisualization | InteractiveFormVisualization;
     type: AiCfoVisualizationType;
 }
 export declare const toMessageSender: (v: string) => "user" | "agent";
@@ -78,6 +161,7 @@ export interface AnswerContentBlockBase {
     insights: string;
     text: string;
     artifact?: string;
+    artifactHostUrl?: string;
     artifactTitle?: string;
     summarizedTitle?: string;
     table?: AiCfoVisualization;
@@ -112,7 +196,17 @@ export interface ChatSessionWithMessages {
     chatSession: ChatSession;
     questionAnswers: AiCfoQuestionWithAnswer[];
 }
+export declare const ALL_SYNTHETIC_AI_CFO_ANSWER_KINDS: readonly ["creating_cards", "creating_policy", "created_cards", "created_policy", "errored_cards", "errored_policy"];
+export type SyntheticAiCfoAnswerKind = (typeof ALL_SYNTHETIC_AI_CFO_ANSWER_KINDS)[number];
+export interface SyntheticAiCfoAnswer {
+    createdAt: ZeniDate;
+    entityIds: ID[];
+    id: ID;
+    kind: SyntheticAiCfoAnswerKind;
+    sourceQuestionAnswerId: ID;
+}
 export interface AiCfoState {
     aiCfoByChatSessionId: Record<ID, ChatSessionWithMessages>;
     partialQuestionAnswers: Record<ID, AiCfoQuestionWithAnswer | undefined>;
+    syntheticAnswersByChatSessionId: Record<ID, SyntheticAiCfoAnswer[]>;
 }

package/lib/entity/aiCfo/aiCfoState.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toMessageTypeStrict = exports.toMessageSenderStrict = exports.toMessageType = exports.toMessageSender = exports.toAiCfoAnswerResponseTypeStrict = exports.toAiCfoAnswerStateTypeStrict = exports.toAiCfoAnswerResponseType = exports.toAiCfoAnswerStateType = exports.toYFormatScaleStrict = exports.toYFormatUnitStrict = exports.toYFormatTypeStrict = exports.toYFormatScale = exports.toYFormatUnit = exports.toYFormatType = exports.ALL_Y_FORMAT_SCALES = exports.ALL_Y_FORMAT_NON_CURRENCY_UNITS = exports.ALL_Y_FORMAT_TYPES = exports.ALL_AI_CFO_ANSWER_RESPONSE_TYPES = exports.ALL_AI_CFO_ANSWER_STATE_TYPES = exports.toAiCfoChartTypeStrict = exports.toAiCfoChartType = exports.toAiCfoVisualizationTypeStrict = exports.toAiCfoVisualizationType = exports.ALL_AI_CFO_VISUALIZATION_TYPES = exports.ALL_AI_CFO_CHARTS_TYPES = void 0;
+exports.ALL_SYNTHETIC_AI_CFO_ANSWER_KINDS = exports.toMessageTypeStrict = exports.toMessageSenderStrict = exports.toMessageType = exports.toMessageSender = exports.toAiCfoAnswerResponseTypeStrict = exports.toAiCfoAnswerStateTypeStrict = exports.toAiCfoAnswerResponseType = exports.toAiCfoAnswerStateType = exports.toYFormatScaleStrict = exports.toYFormatUnitStrict = exports.toYFormatTypeStrict = exports.toYFormatScale = exports.toYFormatUnit = exports.toYFormatType = exports.ALL_Y_FORMAT_SCALES = exports.ALL_Y_FORMAT_NON_CURRENCY_UNITS = exports.ALL_Y_FORMAT_TYPES = exports.ALL_AI_CFO_ANSWER_RESPONSE_TYPES = exports.ALL_AI_CFO_ANSWER_STATE_TYPES = exports.toAiCfoChartTypeStrict = exports.toAiCfoChartType = exports.toAiCfoVisualizationTypeStrict = exports.toAiCfoVisualizationType = exports.toInteractiveFormTypeStrict = exports.toInteractiveFormType = exports.ALL_INTERACTIVE_FORM_TYPES = exports.ALL_AI_CFO_VISUALIZATION_TYPES = exports.ALL_AI_CFO_CHARTS_TYPES = void 0;
 const stringToUnion_1 = require("../../commonStateTypes/stringToUnion");
 exports.ALL_AI_CFO_CHARTS_TYPES = [
     'bar_chart',
@@ -10,7 +10,16 @@ exports.ALL_AI_CFO_CHARTS_TYPES = [
 exports.ALL_AI_CFO_VISUALIZATION_TYPES = [
     ...exports.ALL_AI_CFO_CHARTS_TYPES,
     'table',
+    'interactive_form',
 ];
+exports.ALL_INTERACTIVE_FORM_TYPES = [
+    'cards_creation',
+    'card_policy',
+];
+const toInteractiveFormType = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_INTERACTIVE_FORM_TYPES);
+exports.toInteractiveFormType = toInteractiveFormType;
+const toInteractiveFormTypeStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, exports.ALL_INTERACTIVE_FORM_TYPES);
+exports.toInteractiveFormTypeStrict = toInteractiveFormTypeStrict;
 const toAiCfoVisualizationType = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_AI_CFO_VISUALIZATION_TYPES);
 exports.toAiCfoVisualizationType = toAiCfoVisualizationType;
 const toAiCfoVisualizationTypeStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, exports.ALL_AI_CFO_VISUALIZATION_TYPES);
@@ -79,3 +88,13 @@ const toMessageSenderStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v,
 exports.toMessageSenderStrict = toMessageSenderStrict;
 const toMessageTypeStrict = (v) => (0, stringToUnion_1.stringToUnionStrict)(v, ALL_MESSAGE_TYPES);
 exports.toMessageTypeStrict = toMessageTypeStrict;
+// Client-synthesized AI CFO answer bubbles (Creating…/Created) pushed when the user
+// submits an interactive form; not streamed from the backend.
+exports.ALL_SYNTHETIC_AI_CFO_ANSWER_KINDS = [
+    'creating_cards',
+    'creating_policy',
+    'created_cards',
+    'created_policy',
+    'errored_cards',
+    'errored_policy',
+];

package/lib/entity/approvalRule/approvalRuleConflict.d.ts

@@ -0,0 +1,56 @@
+import { ID } from '../../commonStateTypes/common';
+import { ApprovalRule, Criteria } from './approvalRuleState';
+/**
+ * Approval Rules 3.0 — frontend overlap detection.
+ *
+ * Per product spec, two rules overlap iff:
+ *   1. Their vendor criteria are exactly equal (same operator and
+ *      the same set of vendor IDs, or both absent), AND
+ *   2. Their department criteria are exactly equal (same shape), AND
+ *   3. Their amount intervals intersect.
+ *
+ * The intuition: we only flag overlap when the non-amount criteria
+ * are identical, because the typical mistake is "I tried to create a
+ * second rule for the same vendor / department slice at a different
+ * amount threshold and forgot the existing one". Subset / superset
+ * overlaps (e.g. one rule has a department condition and the other
+ * does not) are intentionally not flagged in this iteration.
+ *
+ * Amount intervals are:
+ *   - greater_than(N)   → [N, +∞)
+ *   - less_than(N)      → (-∞, N]
+ *   - range(min, max)   → [min, max]
+ *   - amount absent     → (-∞, +∞)
+ *
+ * Two intervals overlap iff max(lo) <= min(hi).
+ *
+ * Exclusions from the comparison pool:
+ *   - The rule being edited (caller passes `excludeRuleId`).
+ *   - Fallback rules — they are a separate concept (match-all-others)
+ *     and not subject to the per-criteria overlap check.
+ *
+ * Callers should filter `existingRules` to the relevant entityType
+ * (BillPay vs Reimbursement) before passing — the function does not
+ * cross-check entityType.
+ *
+ * Pure function: no side effects, deterministic. Returns the list of
+ * overlapping rules. Empty list means no overlap.
+ */
+/**
+ * Structural shape of a rule the algorithm needs. The detector only
+ * reads `criteria`, `isFallback`, and `approvalRuleId`; it never
+ * touches `steps`, so callers may pass any 'ApprovalRule' subtype
+ * (e.g. `ApprovalRuleWithUser`) and we keep the richer type in the
+ * output.
+ */
+export type RuleForOverlapCheck = Pick<ApprovalRule, 'approvalRuleId' | 'criteria' | 'isFallback'>;
+export interface RuleOverlap<TRule extends RuleForOverlapCheck = ApprovalRule> {
+    conflictingRule: TRule;
+}
+export interface DetectRuleOverlapInput<TRule extends RuleForOverlapCheck = ApprovalRule> {
+    candidateCriteria: Criteria[];
+    existingRules: TRule[];
+    /** When editing an existing rule, exclude it from the comparison. */
+    excludeRuleId?: ID;
+}
+export declare function detectRuleOverlap<TRule extends RuleForOverlapCheck>({ candidateCriteria, existingRules, excludeRuleId, }: DetectRuleOverlapInput<TRule>): RuleOverlap<TRule>[];