@zeniai/client-epic-state 5.0.92-betaNB2 → 5.0.93-beta0ND

package/lib/esm/entity/aiCfo/aiCfoSelector.js

@@ -32,5 +32,21 @@ export function getAiCfoSelectorView(state) {
             : [],
     }))
         .sort((a, b) => b.chatSession.createdAt.valueOf() - a.chatSession.createdAt.valueOf());
-    return { allSessionsWithOrderedQuestionAnswers };
+    return {
+        allSessionsWithOrderedQuestionAnswers,
+        syntheticAnswersByChatSessionId: state.syntheticAnswersByChatSessionId ?? {},
+    };
+}
+export function getSyntheticAiCfoAnswersForChatSession(state, chatSessionId) {
+    const arr = state.syntheticAnswersByChatSessionId?.[chatSessionId] ?? [];
+    return arr
+        .slice()
+        .sort((a, b) => a.createdAt.valueOf() - b.createdAt.valueOf());
+}
+export function getSyntheticAiCfoAnswerByQuestionAnswerId(state, chatSessionId, questionAnswerId) {
+    const arr = state.syntheticAnswersByChatSessionId?.[chatSessionId];
+    if (arr == null) {
+        return undefined;
+    }
+    return arr.find((answer) => answer.sourceQuestionAnswerId === questionAnswerId);
 }

package/lib/esm/entity/aiCfo/aiCfoState.js

@@ -7,7 +7,14 @@ export const ALL_AI_CFO_CHARTS_TYPES = [
 export const ALL_AI_CFO_VISUALIZATION_TYPES = [
     ...ALL_AI_CFO_CHARTS_TYPES,
     'table',
+    'interactive_form',
 ];
+export const ALL_INTERACTIVE_FORM_TYPES = [
+    'cards_creation',
+    'card_policy',
+];
+export const toInteractiveFormType = (v) => stringToUnion(v, ALL_INTERACTIVE_FORM_TYPES);
+export const toInteractiveFormTypeStrict = (v) => stringToUnionStrict(v, ALL_INTERACTIVE_FORM_TYPES);
 export const toAiCfoVisualizationType = (v) => stringToUnion(v, ALL_AI_CFO_VISUALIZATION_TYPES);
 export const toAiCfoVisualizationTypeStrict = (v) => stringToUnionStrict(v, ALL_AI_CFO_VISUALIZATION_TYPES);
 export const toAiCfoChartType = (v) => stringToUnion(v, ALL_AI_CFO_CHARTS_TYPES);
@@ -58,3 +65,11 @@ export const toMessageSender = (v) => stringToUnion(v, ALL_MESSAGE_SENDERS);
 export const toMessageType = (v) => stringToUnion(v, ALL_MESSAGE_TYPES);
 export const toMessageSenderStrict = (v) => stringToUnionStrict(v, ALL_MESSAGE_SENDERS);
 export const toMessageTypeStrict = (v) => stringToUnionStrict(v, ALL_MESSAGE_TYPES);
+// Client-synthesized AI CFO answer bubbles (Creating…/Created) pushed when the user
+// submits an interactive form; not streamed from the backend.
+export const ALL_SYNTHETIC_AI_CFO_ANSWER_KINDS = [
+    'creating_cards',
+    'creating_policy',
+    'created_cards',
+    'created_policy',
+];

package/lib/esm/entity/cardPolicy/cardPolicyPayload.js

@@ -0,0 +1,130 @@
+import { date } from '../../zeniDayJS';
+import { toCardPolicyTemplateMode, toCardPolicyTemplateStatus, } from './cardPolicyState';
+export const toMccCategory = (payload) => ({
+    count: payload.count,
+    mccCodes: payload.mcc_codes ?? [],
+    name: payload.name,
+});
+export const toCardPolicyVendorSearchOption = (payload) => ({
+    vendorId: payload.vendor_id,
+    name: payload.vendor_name,
+});
+export const toCardPolicyStats = (payload) => ({
+    activePolicies: payload.active_policies,
+    totalCards: payload.total_cards,
+    totalTemplates: payload.total_templates,
+});
+export const toCardPolicyTemplateList = (data) => (data.templates ?? []).map((row) => toCardPolicyTemplate(row.data.template));
+const toCardPolicyTemplateEntityList = (payload) => ({
+    categoryCodes: payload.category_codes ?? [],
+    merchantNames: payload.merchant_names ?? [],
+});
+export const toCardPolicyTemplate = (payload) => ({
+    allowedEntity: toCardPolicyTemplateEntityList(payload.allowed_entity),
+    appliedCards: payload.applied_cards ?? [],
+    blockedEntity: toCardPolicyTemplateEntityList(payload.blocked_entity),
+    cardsCount: payload.cards_count,
+    categoryRestrictions: payload.category_restrictions ?? [],
+    createdAt: date(payload.created_at),
+    createdBy: payload.created_by,
+    description: payload.description,
+    mode: toCardPolicyTemplateMode(payload.mode),
+    name: payload.name,
+    requiredReceiptThreshold: payload.required_receipt_threshold,
+    spendLimits: {
+        transaction: payload.spend_limits.transaction,
+    },
+    status: toCardPolicyTemplateStatus(payload.status),
+    templateId: payload.template_id,
+    tenantId: payload.tenant_id,
+    updatedAt: date(payload.updated_at),
+});
+/**
+ * Re-shape a single camelCase create request into the snake_case wire
+ * body. Used by the bulk-create mapper to build each entry of the
+ * `templates` array, and directly by the update epic (PUT) since the
+ * update endpoint still consumes a single object.
+ */
+export const toCreateCardPolicyTemplateRequestBody = (request) => ({
+    allowed_entity: {
+        category_codes: request.allowedEntity.categoryCodes,
+        merchant_names: request.allowedEntity.merchantNames,
+    },
+    apply_to_cards: request.applyToCards,
+    blocked_entity: {
+        category_codes: request.blockedEntity.categoryCodes,
+        merchant_names: request.blockedEntity.merchantNames,
+    },
+    description: request.description,
+    mode: request.mode ?? 'strict',
+    name: request.name,
+    required_receipt_threshold: request.requiredReceiptThreshold,
+    spend_limits: {
+        transaction: request.spendLimits.transaction,
+    },
+});
+/**
+ * Re-shape a bulk create request into the snake_case wire body for
+ * `POST /cards/1.0/policy-templates`. Maps each entry through
+ * `toCreateCardPolicyTemplateRequestBody` and only emits
+ * `source_chat_session_id` when the camelCase counterpart is defined,
+ * so manual-create callers don't ship a stray `undefined` over the wire.
+ */
+export const toCreateCardPolicyTemplatesRequestBody = (request) => {
+    const body = {
+        templates: request.templates.map(toCreateCardPolicyTemplateRequestBody),
+    };
+    if (request.sourceChatSessionId != null) {
+        body.source_chat_session_id = request.sourceChatSessionId;
+    }
+    return body;
+};
+/**
+ * Map a single bulk-response error payload to its camelCased view shape.
+ * Defensive against missing optional fields (see `BulkCreateCardPolicyTemplateErrorPayload`
+ * docstring — the BE contract isn't fully locked yet).
+ */
+export const toBulkCreateCardPolicyTemplateError = (payload) => ({
+    message: payload.message,
+    code: payload.code,
+    index: payload.index,
+    name: payload.name,
+});
+// Update body uses the exact same wire shape as create — the PUT
+// endpoint is a full replace and was not affected by the bulk migration.
+export const toUpdateCardPolicyTemplateRequestBody = toCreateCardPolicyTemplateRequestBody;
+/**
+ * Seed an edit-form draft (`CreateCardPolicyTemplateRequest`) from an
+ * existing camelCased `CardPolicyTemplate`. Used by the detail-fetch
+ * epic so the edit page can render with the saved values pre-populated.
+ */
+export const toCardPolicyEditFormDraft = (template) => ({
+    allowedEntity: {
+        categoryCodes: [...template.allowedEntity.categoryCodes],
+        merchantNames: [...template.allowedEntity.merchantNames],
+    },
+    applyToCards: [...template.appliedCards],
+    blockedEntity: {
+        categoryCodes: [...template.blockedEntity.categoryCodes],
+        merchantNames: [...template.blockedEntity.merchantNames],
+    },
+    description: template.description,
+    mode: template.mode,
+    name: template.name,
+    requiredReceiptThreshold: template.requiredReceiptThreshold,
+    spendLimits: { transaction: template.spendLimits.transaction },
+});
+export const toExtractedCardPolicyRules = (payload) => ({
+    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 ?? [],
+    },
+    confidenceScore: payload.confidence_score,
+    policyName: payload.policy_name,
+    requiredReceiptThreshold: payload.required_receipt_threshold,
+    transactionLimit: payload.transaction_limit,
+});

package/lib/esm/entity/cardPolicy/cardPolicyReducer.js

@@ -0,0 +1,171 @@
+import { createSlice } from '@reduxjs/toolkit';
+import { toCardPolicyTemplate, toCardPolicyVendorSearchOption, toExtractedCardPolicyRules, toMccCategory, } from './cardPolicyPayload';
+// `buildVendorChipId(name)` calls `name.trim().toLowerCase()`; empty/whitespace names would crash or collapse into one colliding chip-id.
+const isUsableMerchantName = (name) => typeof name === 'string' && name.trim() !== '';
+const initialPolicyDocumentExtractionState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    extractedRules: undefined,
+    uploadedFileName: undefined,
+};
+const initialPolicyRecommendationFromUploadState = {
+    fetchState: 'Not-Started',
+    answerId: undefined,
+    chatSessionId: undefined,
+    error: undefined,
+};
+const initialVendorSearchState = {
+    fetchState: 'Not-Started',
+    searchString: '',
+    vendors: [],
+    error: undefined,
+};
+export const initialState = {
+    cardPolicyTemplateById: {},
+    mccCategories: [],
+    mccCategoriesError: undefined,
+    mccCategoriesFetchState: 'Not-Started',
+    policyDocumentExtraction: initialPolicyDocumentExtractionState,
+    policyRecommendationFromUpload: initialPolicyRecommendationFromUploadState,
+    suggestedAllowCategories: [],
+    suggestedAllowMerchants: [],
+    suggestedBlockCategories: [],
+    suggestedBlockMerchants: [],
+    vendorSearch: initialVendorSearchState,
+    cardPolicyStats: undefined,
+};
+const cardPolicy = createSlice({
+    name: 'cardPolicy',
+    initialState,
+    reducers: {
+        fetchCardPolicyMccCategories(draft) {
+            draft.mccCategoriesFetchState = 'In-Progress';
+            draft.mccCategoriesError = undefined;
+        },
+        updateCardPolicyMccCategories(draft, action) {
+            draft.mccCategories = (action.payload.categories ?? []).map(toMccCategory);
+            // BE-suggested seeds pre-populate the chip cloud; `isUsableMerchantName` drops names that would break `buildVendorChipId`.
+            draft.suggestedAllowMerchants = (action.payload.suggested_allow_merchants ?? []).filter(isUsableMerchantName);
+            draft.suggestedBlockMerchants = (action.payload.suggested_block_merchants ?? []).filter(isUsableMerchantName);
+            draft.suggestedAllowCategories = (action.payload.suggested_allow_catagories ?? []).map(toMccCategory);
+            draft.suggestedBlockCategories = (action.payload.suggested_block_catagories ?? []).map(toMccCategory);
+            draft.mccCategoriesFetchState = 'Completed';
+            draft.mccCategoriesError = undefined;
+        },
+        updateCardPolicyMccCategoriesFailure(draft, action) {
+            draft.mccCategoriesFetchState = 'Error';
+            draft.mccCategoriesError = action.payload;
+        },
+        updateCreatedCardPolicyTemplate(draft, action) {
+            const template = toCardPolicyTemplate(action.payload);
+            draft.cardPolicyTemplateById[template.templateId] = template;
+        },
+        // Full replace so server-side deletes evict locally too; the view slice owns the ordered ID list.
+        updateCardPolicyTemplates(draft, action) {
+            const byId = {};
+            for (const template of action.payload) {
+                byId[template.templateId] = template;
+            }
+            draft.cardPolicyTemplateById = byId;
+        },
+        removeCardPolicyTemplate(draft, action) {
+            delete draft.cardPolicyTemplateById[action.payload];
+        },
+        updateCardPolicyStats(draft, action) {
+            draft.cardPolicyStats = action.payload;
+        },
+        // Captures the first file name so the upload pill can render without callers retaining a File ref.
+        extractPolicyDocument: {
+            reducer(draft, action) {
+                draft.policyDocumentExtraction.fetchState = 'In-Progress';
+                draft.policyDocumentExtraction.error = undefined;
+                draft.policyDocumentExtraction.extractedRules = undefined;
+                draft.policyDocumentExtraction.uploadedFileName =
+                    action.meta.uploadedFileName;
+                draft.policyDocumentExtraction.aiCfoAnswerId =
+                    action.payload.aiCfoAnswerId;
+                draft.policyDocumentExtraction.aiCfoChatSessionId =
+                    action.payload.aiCfoChatSessionId;
+                // Extraction + recommendation model one upload lifecycle; reset together so a re-upload doesn't read stale lifecycle from the prior chain.
+                draft.policyRecommendationFromUpload = {
+                    ...initialPolicyRecommendationFromUploadState,
+                };
+            },
+            prepare(files, aiCfoAnswerId, aiCfoChatSessionId) {
+                return {
+                    payload: { files, aiCfoAnswerId, aiCfoChatSessionId },
+                    meta: { uploadedFileName: files[0]?.name },
+                };
+            },
+        },
+        updatePolicyDocumentExtractionSuccess(draft, action) {
+            draft.policyDocumentExtraction.fetchState = 'Completed';
+            draft.policyDocumentExtraction.error = undefined;
+            draft.policyDocumentExtraction.extractedRules =
+                toExtractedCardPolicyRules(action.payload);
+        },
+        updatePolicyDocumentExtractionFailure(draft, action) {
+            draft.policyDocumentExtraction.fetchState = 'Error';
+            draft.policyDocumentExtraction.error = action.payload;
+            draft.policyDocumentExtraction.extractedRules = undefined;
+        },
+        clearPolicyDocumentExtraction(draft) {
+            draft.policyDocumentExtraction = {
+                ...initialPolicyDocumentExtractionState,
+            };
+            // Pair with extractPolicyDocument: the two sub-slices reset and advance together.
+            draft.policyRecommendationFromUpload = {
+                ...initialPolicyRecommendationFromUploadState,
+            };
+        },
+        // Chained after extractPolicyDocument; epic merges the returned wizard plan into the AI CFO answer identified by answerId + chatSessionId.
+        fetchCardPolicyRecommendationFromUpload: {
+            reducer(draft, action) {
+                draft.policyRecommendationFromUpload.fetchState = 'In-Progress';
+                draft.policyRecommendationFromUpload.answerId = action.payload.answerId;
+                draft.policyRecommendationFromUpload.chatSessionId =
+                    action.payload.chatSessionId;
+                draft.policyRecommendationFromUpload.error = undefined;
+            },
+            prepare(answerId, chatSessionId, extractedRules) {
+                return { payload: { answerId, chatSessionId, extractedRules } };
+            },
+        },
+        updatePolicyRecommendationFromUploadSuccess(draft) {
+            draft.policyRecommendationFromUpload.fetchState = 'Completed';
+            draft.policyRecommendationFromUpload.error = undefined;
+        },
+        updatePolicyRecommendationFromUploadFailure(draft, action) {
+            draft.policyRecommendationFromUpload.fetchState = 'Error';
+            draft.policyRecommendationFromUpload.error = action.payload;
+        },
+        // Empty searchString = top vendors by YTD spend; non-empty filters server-side.
+        fetchCardPolicyVendorOptions: {
+            reducer(draft, action) {
+                draft.vendorSearch.fetchState = 'In-Progress';
+                draft.vendorSearch.searchString = action.payload.searchString;
+                draft.vendorSearch.error = undefined;
+            },
+            prepare(searchString) {
+                return { payload: { searchString: searchString ?? '' } };
+            },
+        },
+        updateCardPolicyVendorOptions(draft, action) {
+            // Same `buildVendorChipId` guard as the suggested-merchants seeds above.
+            draft.vendorSearch.vendors = (action.payload.vendors ?? [])
+                .map(toCardPolicyVendorSearchOption)
+                .filter((vendor) => isUsableMerchantName(vendor.name));
+            draft.vendorSearch.fetchState = 'Completed';
+            draft.vendorSearch.error = undefined;
+        },
+        updateCardPolicyVendorOptionsFailure(draft, action) {
+            draft.vendorSearch.fetchState = 'Error';
+            draft.vendorSearch.error = action.payload;
+        },
+        clearCardPolicy(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { fetchCardPolicyMccCategories, fetchCardPolicyVendorOptions, updateCardPolicyMccCategories, updateCardPolicyMccCategoriesFailure, updateCardPolicyVendorOptions, updateCardPolicyVendorOptionsFailure, updateCreatedCardPolicyTemplate, updateCardPolicyTemplates, removeCardPolicyTemplate, updateCardPolicyStats, extractPolicyDocument, updatePolicyDocumentExtractionSuccess, updatePolicyDocumentExtractionFailure, clearPolicyDocumentExtraction, fetchCardPolicyRecommendationFromUpload, updatePolicyRecommendationFromUploadSuccess, updatePolicyRecommendationFromUploadFailure, clearCardPolicy, } = cardPolicy.actions;
+export default cardPolicy.reducer;

package/lib/esm/entity/cardPolicy/cardPolicySelector.js

@@ -0,0 +1,75 @@
+export function getCardPolicyMccCategories(state) {
+    return state.mccCategories;
+}
+export function getCardPolicyMccCategoriesFetchState(state) {
+    return state.mccCategoriesFetchState;
+}
+export function getCardPolicyMccCategoriesError(state) {
+    return state.mccCategoriesError;
+}
+export function getCardPolicyTemplateById(state, templateId) {
+    return state.cardPolicyTemplateById[templateId];
+}
+export function getAllCardPolicyTemplates(state) {
+    return Object.values(state.cardPolicyTemplateById);
+}
+/**
+ * Resolve an ordered list of `templateId`s against the entity store and
+ * return the corresponding `CardPolicyTemplate[]` in the same order.
+ * Missing IDs (e.g. stale local state during a refetch) are silently
+ * dropped. Pair with `getCardPolicyTemplateIds` from the view slice to
+ * render the Policy List page in server order.
+ */
+export function getCardPolicyTemplatesByIds(state, templateIds) {
+    return templateIds
+        .map((id) => state.cardPolicyTemplateById[id])
+        .filter((template) => template != null);
+}
+export function getCardPolicyStats(state) {
+    return state.cardPolicyStats;
+}
+export function getPolicyDocumentExtractionFetchState(state) {
+    return state.policyDocumentExtraction.fetchState;
+}
+export function getPolicyDocumentExtractionError(state) {
+    return state.policyDocumentExtraction.error;
+}
+export function getExtractedCardPolicyRules(state) {
+    return state.policyDocumentExtraction.extractedRules;
+}
+export function getUploadedPolicyDocumentFileName(state) {
+    return state.policyDocumentExtraction.uploadedFileName;
+}
+export function getPolicyRecommendationFromUploadFetchState(state) {
+    return state.policyRecommendationFromUpload.fetchState;
+}
+export function getPolicyRecommendationFromUploadError(state) {
+    return state.policyRecommendationFromUpload.error;
+}
+export function getPolicyRecommendationFromUploadAnswerId(state) {
+    return state.policyRecommendationFromUpload.answerId;
+}
+export function getPolicyRecommendationFromUploadChatSessionId(state) {
+    return state.policyRecommendationFromUpload.chatSessionId;
+}
+export function getCardPolicySuggestedAllowMerchants(state) {
+    return state.suggestedAllowMerchants;
+}
+export function getCardPolicySuggestedBlockMerchants(state) {
+    return state.suggestedBlockMerchants;
+}
+export function getCardPolicySuggestedAllowCategories(state) {
+    return state.suggestedAllowCategories;
+}
+export function getCardPolicySuggestedBlockCategories(state) {
+    return state.suggestedBlockCategories;
+}
+export function getCardPolicyVendorSearchOptions(state) {
+    return state.vendorSearch.vendors;
+}
+export function getCardPolicyVendorSearchFetchState(state) {
+    return state.vendorSearch.fetchState;
+}
+export function getCardPolicyVendorSearchString(state) {
+    return state.vendorSearch.searchString;
+}

package/lib/esm/entity/cardPolicy/cardPolicyState.js

@@ -0,0 +1,9 @@
+import { stringToUnion } from '../../commonStateTypes/stringToUnion';
+export const ALL_CARD_POLICY_TEMPLATE_MODES = ['strict', 'flexible'];
+export const toCardPolicyTemplateMode = (v) => stringToUnion(v, ALL_CARD_POLICY_TEMPLATE_MODES);
+export const ALL_CARD_POLICY_TEMPLATE_STATUSES = [
+    'active',
+    'inactive',
+    'archived',
+];
+export const toCardPolicyTemplateStatus = (v) => stringToUnion(v, ALL_CARD_POLICY_TEMPLATE_STATUSES);

package/lib/esm/entity/cardPolicy/extractPolicyDocumentEpic.js

@@ -0,0 +1,64 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap, switchMap, takeUntil } from 'rxjs/operators';
+import { createZeniAPIStatus, isSuccessStatus } from '../../responsePayload';
+import { clearPolicyDocumentExtraction, extractPolicyDocument, updatePolicyDocumentExtractionFailure, updatePolicyDocumentExtractionSuccess, } from './cardPolicyReducer';
+/**
+ * Build a multipart `FormData` body for `POST /cards/1.0/policy-documents/extract`.
+ *
+ * Uses the same `attachment_file_<i>` / `attachment_json_<i>` field-naming
+ * convention as the charge-card receipt upload (`uploadReceipts.ts` in
+ * `web-components`) so backends that already support that wire shape
+ * accept this endpoint without bespoke parsing.
+ */
+const buildPolicyDocumentFormData = (files) => {
+    const data = new FormData();
+    files.forEach((file, index) => {
+        data.append(`attachment_file_${index}`, file);
+        const attachmentJson = JSON.stringify({
+            file_name: file.name,
+            content_type: file.type,
+            size: file.size,
+        });
+        data.append(`attachment_json_${index}`, attachmentJson);
+    });
+    return data;
+};
+/**
+ * Listens for `extractPolicyDocument`, POSTs the file(s) as multipart
+ * form-data to the cards micro-service's policy-document extract endpoint,
+ * and dispatches success / failure into the entity slice.
+ *
+ * Consumed by:
+ *  - Manual `CardPolicyCreatePage` (read result via
+ *    `getExtractedCardPolicyRules` then pre-fill the RHF form via
+ *    `applyExtractedPolicyRulesToFormValues` from `@zeniai/web-components`).
+ *  - (Future) AI CFO upload surface — same action + selector contract.
+ */
+export const extractPolicyDocumentEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(extractPolicyDocument.match), 
+// `switchMap` (vs `mergeMap`) cancels any in-flight extract whenever a
+// new upload is dispatched. With `mergeMap` an older, slower response
+// could win the race: `updatePolicyDocumentExtractionSuccess` would
+// fire with stale `extractedRules` and the chained bridge epic would
+// pair them with whatever `aiCfoAnswerId` / `aiCfoChatSessionId` are
+// currently in state — recommending the old file's rules against the
+// wrong AI CFO answer.
+switchMap((action) => {
+    const formData = buildPolicyDocumentFormData(action.payload.files);
+    return zeniAPI
+        .postFormData(`${zeniAPI.apiEndPoints.cardMicroServiceBaseUrl}/1.0/policy-documents/extract`, formData)
+        .pipe(mergeMap((response) => {
+        if (isSuccessStatus(response) &&
+            response.data != null &&
+            response.data.extracted_rules != null) {
+            return of(updatePolicyDocumentExtractionSuccess(response.data.extracted_rules));
+        }
+        return of(updatePolicyDocumentExtractionFailure(response.status));
+    }), catchError((error) => of(updatePolicyDocumentExtractionFailure(createZeniAPIStatus('Unexpected Error', 'Extract card-policy document REST API call errored out' +
+        JSON.stringify(error))))), 
+    // `clearPolicyDocumentExtraction` (e.g. user clicks the "× Policy.pdf"
+    // pill) tears down the in-flight extract subscription, so a late
+    // response can't re-flip `policyDocumentExtraction.fetchState` back
+    // to `Completed` or repopulate `extractedRules` after the user
+    // already dismissed the upload.
+    takeUntil(actions$.pipe(filter(clearPolicyDocumentExtraction.match))));
+}));

package/lib/esm/entity/cardPolicy/fetchCardPolicyVendorOptionsEpic.js

@@ -0,0 +1,43 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { createZeniAPIStatus, isSuccessStatus } from '../../responsePayload';
+import { fetchCardPolicyVendorOptions, updateCardPolicyVendorOptions, updateCardPolicyVendorOptionsFailure, } from './cardPolicyReducer';
+const buildQuery = (searchString) => ({
+    view: 'vendor_list',
+    page_token: null,
+    sort_by: 'year_to_date_spend',
+    sort_order: 'desc',
+    search_text: searchString,
+    vendor_name: searchString,
+});
+/**
+ * Card-policy vendor search.
+ *
+ * Listens for `fetchCardPolicyVendorOptions` and hits the same
+ * `/accounting/1.0/vendors` endpoint the Vendors-tab uses, but writes
+ * results onto the dedicated `cardPolicyState.vendorSearch` slice — no
+ * fan-out to the global `vendor` / `account` / `class` / `vendorList`
+ * entities. That isolation is important: the user may be configuring a
+ * card policy in parallel with browsing the Vendors tab, and we don't
+ * want either flow to clobber the other's list state.
+ *
+ * Uses `switchMap` so the latest typed search wins — earlier in-flight
+ * requests are abandoned, which is the right semantics for a
+ * search-as-you-type UX.
+ *
+ * Consumers:
+ *  - Manual `CardPolicyCreate / EditScreen`
+ *  - AI CFO `CardPolicyInteractiveForm` (vendor step)
+ */
+export const fetchCardPolicyVendorOptionsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchCardPolicyVendorOptions.match), switchMap((action) => {
+    const query = buildQuery(action.payload.searchString);
+    const apiUrl = `${zeniAPI.apiEndPoints.accountMicroServiceBaseUrl}/1.0/vendors` +
+        `?query=${encodeURIComponent(JSON.stringify(query))}`;
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessStatus(response) && response.data != null) {
+            return of(updateCardPolicyVendorOptions(response.data));
+        }
+        return of(updateCardPolicyVendorOptionsFailure(response.status));
+    }), catchError((error) => of(updateCardPolicyVendorOptionsFailure(createZeniAPIStatus('Unexpected Error', 'Fetch card policy vendor options REST API call errored out' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/entity/cardPolicy/policyDocumentExtractionToRecommendationBridgeEpic.js

@@ -0,0 +1,35 @@
+import { EMPTY, of } from 'rxjs';
+import { filter, mergeMap } from 'rxjs/operators';
+import { fetchCardPolicyRecommendationFromUpload, updatePolicyDocumentExtractionSuccess, } from './cardPolicyReducer';
+/**
+ * Bridge epic — chains the AI CFO `upload`-mode flow's two API hops.
+ *
+ * The first hop (`extractPolicyDocument` → multipart POST to
+ * `policy-documents/extract`) lives on the cardPolicy slice and is
+ * shared with the manual `CardPolicyCreatePage`. The second hop
+ * (`fetchCardPolicyRecommendationFromUpload` → JSON POST to
+ * `ai-cfo/policy-recommendation-from-upload`) is AI-CFO only.
+ *
+ * The chain is gated on `policyDocumentExtraction.aiCfoAnswerId` being
+ * populated — manual callers leave it undefined, so the bridge is a
+ * silent no-op there.
+ *
+ * Splitting this off from `policyRecommendationFromUploadEpic` keeps
+ * the wizard component a pure renderer: it dispatches
+ * `extractPolicyDocument(files, answerId, chatSessionId)` once, then
+ * subscribes to `cardPolicyState` lifecycle flags to drive its
+ * "Extracting…" / "Recommending…" pill.
+ */
+export const policyDocumentExtractionToRecommendationBridgeEpic = (actions$, state$) => actions$.pipe(filter(updatePolicyDocumentExtractionSuccess.match), mergeMap((action) => {
+    const extraction = state$.value.cardPolicyState.policyDocumentExtraction;
+    const aiCfoAnswerId = extraction.aiCfoAnswerId;
+    const aiCfoChatSessionId = extraction.aiCfoChatSessionId;
+    const extractedRules = extraction.extractedRules;
+    if (aiCfoAnswerId == null ||
+        aiCfoChatSessionId == null ||
+        extractedRules == null) {
+        return EMPTY;
+    }
+    void action;
+    return of(fetchCardPolicyRecommendationFromUpload(aiCfoAnswerId, aiCfoChatSessionId, extractedRules));
+}));