@zeniai/client-epic-state 5.0.65-betaRR5 → 5.0.65-betaRR7

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

@@ -96,85 +96,88 @@ export type CardsCreationInitialDataPayload = {
     mode: 'cards-only';
 };
 /**
- * Vendor / category seed for the AI Card Policy interactive form.
- * `optional_code` carries the MCC (e.g. "6051") for category items; vendor
- * items omit it.
+ * Per-policy allow / block bucket on the wire. The two arrays are
+ * independent (a draft policy may populate both, only one, or neither).
  */
-export interface CardPolicyTagSeedPayload {
-    id: string;
-    is_selected: boolean;
-    label: string;
-    optional_code?: string | null;
+export interface DraftPolicyEntityPayload {
+    category_codes: string[];
+    merchant_names: string[];
 }
-export interface CardPolicyOwnerSeedPayload {
-    display_name: string;
-    user_id: string;
-    role_label?: string | null;
+/**
+ * Spend-limit bucket per policy. `transaction` is the only cadence the
+ * BE ships today; left open-ended for future cadences (e.g.
+ * `monthly`, `quarterly`).
+ */
+export interface DraftPolicySpendLimitsPayload {
+    transaction: number;
+    [cadence: string]: number | undefined;
 }
-export interface CardPolicyCardRowSeedPayload {
-    card_name: string;
-    id: string;
-    is_checked: boolean;
-    last4: string;
-    limit_amount: number;
-    owner: CardPolicyOwnerSeedPayload;
-    utilization_amount: number;
-    limit_cadence?: string | null;
-}
-export interface CardPolicyLimitRowSeedPayload {
-    id: string;
-    is_enabled: boolean;
-    amount?: number | null;
+/**
+ * Single draft policy on the wire. The controller emits one of these
+ * per recommended policy in `step_5_review.draft_policies`. Identity is
+ * positional (no stable `id` from the BE); the FE synthesizes one on
+ * decode.
+ */
+export interface DraftPolicyPayload {
+    allowed_entity: DraftPolicyEntityPayload;
+    apply_to_cards: string[];
+    blocked_entity: DraftPolicyEntityPayload;
+    description: string;
+    /** Enforcement mode for the policy (e.g. `"strict"`). Carried into
+     * state for guided submit; ignored for `auto` / `upload`. */
+    mode: string;
+    name: string;
+    required_receipt_threshold: number;
+    spend_limits: DraftPolicySpendLimitsPayload;
 }
 /**
- * Suggested-policy seed for the 1-step `review-only` variant and Step 5 of
- * the `full-builder` variant. Each chip group is a flat list rendered inside
- * the expandable policy card; the FE classifies them visually via the
- * `chip_kind` discriminator.
+ * `step_5_review` block — the only step in `wizard_plan` the FE reads.
+ * Steps 1–4 are intentionally not modeled.
  */
-export interface CardPolicySuggestedPolicyChipPayload {
-    chip_kind: 'positive' | 'negative' | 'avatar';
-    id: string;
-    label: string;
+export interface CardPolicyStep5ReviewPayload {
+    draft_policies: DraftPolicyPayload[];
+    /** Header text shown above the review list / wizard. */
+    prompt: string;
+    /** How the BE grouped the suggested policies. `"none"` today; may
+     * surface as a header banner in a future iteration. */
+    grouping_source?: string;
 }
-export interface CardPolicySuggestedPolicyChipGroupPayload {
-    chips: CardPolicySuggestedPolicyChipPayload[];
-    id: string;
-    label: string;
+export interface CardPolicyWizardPlanPayload {
+    step_5_review: CardPolicyStep5ReviewPayload;
 }
-export interface CardPolicySuggestedPolicyPayload {
-    chip_groups: CardPolicySuggestedPolicyChipGroupPayload[];
-    id: string;
-    is_checked: boolean;
-    name: string;
+/**
+ * Upload-mode metadata that the `policy-recommendation-from-upload` API
+ * returns alongside the wizard plan. Absent on the initial controller
+ * response; populated after the file upload + recommendation chain.
+ */
+export interface CardPolicyUploadSourcePayload {
+    confidence_score: number;
+    file_name: string;
+    low_confidence_fields: string[];
 }
 /**
- * Discriminated payload for the AI Card Policy interactive form. Mirrors
- * the FE-side `CardPolicyInitialData`.
+ * Discriminated payload for the AI Card Policy interactive form.
+ * All three modes share the same `wizard_plan.step_5_review.draft_policies`
+ * envelope; the FE renders different forms based on `mode`.
  *
- * - `review-only` (1-step): AI auto-applied default rules; user sees only
- *   the policy review.
- * - `full-builder` (5-step): vendors → categories → cards → limits →
- *   review.
- * - `doc-upload` (3-step): upload → cards → review. Vendors / categories
- *   / limits are filled in by the policy-document-extract API on the FE,
- *   so the payload only carries `cards` (still user-picked) and any
- *   optional suggested-policy seed.
+ * - `auto` (1-step review): user reviews suggested policies and submits.
+ * - `guided` (5-step wizard): Steps 1–4 seeded from `draft_policies[0]`,
+ *   Step 5 lists every draft policy.
+ * - `upload` (3-step): upload doc → pick cards → review. Controller
+ *   responses for `mode === "upload"` arrive *before* the user uploads,
+ *   so `wizard_plan` is optional; populated after the upload-recommendation
+ *   API returns.
  */
 export type CardPolicyInitialDataPayload = {
-    policy_kind: 'review-only';
-    suggested_policies: CardPolicySuggestedPolicyPayload[];
+    mode: 'auto';
+    wizard_plan: CardPolicyWizardPlanPayload;
 } | {
-    cards: CardPolicyCardRowSeedPayload[];
-    categories: CardPolicyTagSeedPayload[];
-    default_limits: CardPolicyLimitRowSeedPayload[];
-    policy_kind: 'full-builder';
-    suggested_policies: CardPolicySuggestedPolicyPayload[];
-    vendors: CardPolicyTagSeedPayload[];
+    mode: 'guided';
+    wizard_plan: CardPolicyWizardPlanPayload;
 } | {
-    cards: CardPolicyCardRowSeedPayload[];
-    policy_kind: 'doc-upload';
-    suggested_policies: CardPolicySuggestedPolicyPayload[];
+    mode: 'upload';
+    source?: CardPolicyUploadSourcePayload;
+    wizard_plan?: CardPolicyWizardPlanPayload;
 };
 /**
  * Discriminated visualization payload. The FE narrows on `form_type` and

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

@@ -2,6 +2,7 @@ import { ID } from '../../commonStateTypes/common';
 import { ZeniDate } from '../../zeniDayJS';
 import { AiCfoAnswerPayload, AiCfoVisualizationPayload, ChatSessionPayload, MessagePayload } from './aiCfoPayload';
 import { AiCfoState, AiCfoVisualization, FileAttachmentMetadata } from './aiCfoState';
+import type { CardPolicyUploadSource, CardPolicyWizardPlan } from './aiCfoState';
 export declare const initialAiCfoState: AiCfoState;
 export declare const toAiCfoVisualization: (visualization: AiCfoVisualizationPayload) => AiCfoVisualization | undefined;
 export declare const setNewSession: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
@@ -41,6 +42,11 @@ export declare const setNewSession: import("@reduxjs/toolkit").ActionCreatorWith
 }, "aiCfo/addQuestionPayload">, clearAiCfo: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"aiCfo/clearAiCfo">, deleteQuestion: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     chatSessionId: ID;
     questionAnswerId: ID;
-}, "aiCfo/deleteQuestion">;
+}, "aiCfo/deleteQuestion">, updateAiCfoAnswerCardPolicyWizardPlan: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    answerId: ID;
+    chatSessionId: ID;
+    wizardPlan: CardPolicyWizardPlan;
+    source?: CardPolicyUploadSource;
+}, "aiCfo/updateAiCfoAnswerCardPolicyWizardPlan">;
 declare const _default: import("redux").Reducer<AiCfoState>;
 export default _default;

package/lib/entity/aiCfo/aiCfoReducer.js

@@ -1,7 +1,7 @@
 "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.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");
@@ -268,67 +268,55 @@ const withSynthesizedIds = (cards) => {
         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) => {
-    const suggestedPolicies = (payload.suggested_policies ?? []).map((policy) => ({
-        id: policy.id,
-        isChecked: policy.is_checked,
-        name: policy.name,
-        chipGroups: (policy.chip_groups ?? []).map((group) => ({
-            id: group.id,
-            label: group.label,
-            chips: (group.chips ?? []).map((chip) => ({
-                id: chip.id,
-                label: chip.label,
-                chipKind: chip.chip_kind,
-            })),
-        })),
-    }));
-    if (payload.policy_kind === 'review-only') {
-        return {
-            policyKind: 'review-only',
-            suggestedPolicies,
-        };
-    }
-    const toCardRowSeed = (card) => ({
-        cardName: card.card_name,
-        id: card.id,
-        isChecked: card.is_checked,
-        last4: card.last4,
-        limitAmount: card.limit_amount,
-        limitCadence: card.limit_cadence ?? undefined,
-        owner: {
-            userId: card.owner.user_id,
-            displayName: card.owner.display_name,
-            roleLabel: card.owner.role_label ?? undefined,
-        },
-        utilizationAmount: card.utilization_amount,
-    });
-    if (payload.policy_kind === 'doc-upload') {
+    if (payload.mode === 'upload') {
         return {
-            policyKind: 'doc-upload',
-            suggestedPolicies,
-            cards: (payload.cards ?? []).map(toCardRowSeed),
+            policyKind: 'upload',
+            wizardPlan: payload.wizard_plan != null
+                ? toCardPolicyWizardPlan(payload.wizard_plan)
+                : undefined,
+            source: payload.source != null
+                ? toCardPolicyUploadSource(payload.source)
+                : undefined,
         };
     }
     return {
-        policyKind: 'full-builder',
-        suggestedPolicies,
-        vendors: (payload.vendors ?? []).map(toCardPolicyTagSeed),
-        categories: (payload.categories ?? []).map(toCardPolicyTagSeed),
-        cards: (payload.cards ?? []).map(toCardRowSeed),
-        defaultLimits: (payload.default_limits ?? []).map((row) => ({
-            id: row.id,
-            isEnabled: row.is_enabled,
-            amount: row.amount ?? undefined,
-        })),
+        policyKind: payload.mode,
+        wizardPlan: toCardPolicyWizardPlan(payload.wizard_plan),
     };
 };
-const toCardPolicyTagSeed = (tag) => ({
-    id: tag.id,
-    isSelected: tag.is_selected,
-    label: tag.label,
-    optionalCode: tag.optional_code ?? undefined,
-});
 const toAiCfoVisualizationData = (data) => {
     if ('x' in data && 'y' in data) {
         // Normalize y to always be an array
@@ -642,6 +630,49 @@ const aiCfo = (0, toolkit_1.createSlice)({
                 session.questionAnswers.push(qa);
             }
         },
+        /**
+         * Patch the `card_policy` interactive-form payload for a specific
+         * answer in a chat session to merge in the wizard plan + upload
+         * source metadata returned by
+         * `POST /cards/1.0/ai-cfo/policy-recommendation-from-upload`.
+         *
+         * Dispatched by the recommendation epic after a successful response;
+         * the wizard re-renders Steps 2 + 3 of the upload variant once the
+         * payload becomes a populated `CardPolicyInitialData` with
+         * `policyKind: "upload"` + `wizardPlan` + `source`.
+         *
+         * No-op when the target answer / chat session / form payload is
+         * missing or isn't an upload-mode card-policy interactive form —
+         * the bridge epic is best-effort and silently drops in edge cases
+         * (e.g. the user closed the chat before recommendation returned).
+         */
+        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,
+                };
+            }
+        },
         clearSession(draft, action) {
             const sessionId = action.payload;
             delete draft.aiCfoByChatSessionId[sessionId];
@@ -677,5 +708,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.default = aiCfo.reducer;

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

@@ -126,80 +126,79 @@ export type CardsCreationInitialData = {
     mode: 'cards-only';
 };
 /**
- * Vendor / category seed for the AI Card Policy interactive form.
- * `optionalCode` carries the MCC (e.g. "6051") for category items; vendor
- * items omit it.
+ * Per-policy allow / block bucket. CamelCase mirror of
+ * `DraftPolicyEntityPayload`.
  */
-export interface CardPolicyTagSeed {
-    id: string;
-    isSelected: boolean;
-    label: string;
-    optionalCode?: string;
+export interface CardPolicyDraftPolicyEntity {
+    categoryCodes: string[];
+    merchantNames: string[];
 }
-export interface CardPolicyOwnerSeed {
-    displayName: string;
-    userId: ID;
-    roleLabel?: string;
-}
-export interface CardPolicyCardRowSeed {
-    cardName: string;
-    id: string;
-    isChecked: boolean;
-    last4: string;
-    limitAmount: number;
-    owner: CardPolicyOwnerSeed;
-    utilizationAmount: number;
-    limitCadence?: string;
+/**
+ * Spend-limit bucket per policy. `transaction` is the only cadence the
+ * BE ships today.
+ */
+export interface CardPolicySpendLimits {
+    transaction: number;
 }
-export interface CardPolicyLimitRowSeed {
+/**
+ * Single draft policy in FE state. Identity is positional — the reducer
+ * synthesizes a stable `id` (`draft-0`, `draft-1`, ...) at decode time
+ * since the BE doesn't ship one today.
+ */
+export interface CardPolicyDraftPolicy {
+    allowedEntity: CardPolicyDraftPolicyEntity;
+    applyToCards: string[];
+    blockedEntity: CardPolicyDraftPolicyEntity;
+    description: string;
     id: string;
-    isEnabled: boolean;
-    amount?: number;
+    /** Enforcement mode (e.g. `"strict"`). Carried for guided submit;
+     * ignored by auto / upload submit. */
+    mode: string;
+    name: string;
+    requiredReceiptThreshold: number;
+    spendLimits: CardPolicySpendLimits;
 }
-export interface CardPolicySuggestedPolicyChip {
-    chipKind: 'positive' | 'negative' | 'avatar';
-    id: string;
-    label: string;
+export interface CardPolicyStep5Review {
+    draftPolicies: CardPolicyDraftPolicy[];
+    groupingSource: string;
+    prompt: string;
 }
-export interface CardPolicySuggestedPolicyChipGroup {
-    chips: CardPolicySuggestedPolicyChip[];
-    id: string;
-    label: string;
+export interface CardPolicyWizardPlan {
+    step5Review: CardPolicyStep5Review;
 }
-export interface CardPolicySuggestedPolicy {
-    chipGroups: CardPolicySuggestedPolicyChipGroup[];
-    id: string;
-    isChecked: boolean;
-    name: string;
+/**
+ * Upload-mode metadata returned by the
+ * `policy-recommendation-from-upload` API alongside the wizard plan.
+ */
+export interface CardPolicyUploadSource {
+    confidenceScore: number;
+    fileName: string;
+    lowConfidenceFields: string[];
 }
 /**
  * Initial data for the AI Card Policy interactive form. Discriminated on
- * `policyKind`:
+ * `policyKind`. All three modes consume the same `wizardPlan.step5Review`
+ * envelope; the wizard renders different surfaces per mode.
  *
- * - `review-only` (1-step): AI auto-applied default rules; user sees the
- *   policy review only.
- * - `full-builder` (5-step): vendors → categories → cards → limits →
- *   review.
- * - `doc-upload` (3-step): upload → cards → review. The user uploads a
- *   policy document on Step 1; the cards micro-service extracts the rules
- *   and the form is pre-filled via the `policyDocumentExtraction` slice
- *   before the user lands on Step 2. `cards` is still required because
- *   the user picks which cards the policy applies to in Step 2.
+ * - `auto` (1-step review): chip groups built directly from each draft
+ *   policy. Submit omits `mode` + `spend_limits` + `required_receipt_threshold`.
+ * - `guided` (5-step wizard): Steps 1–4 seeded from `draftPolicies[0]`,
+ *   Step 5 lists every draft. Submit includes all keys.
+ * - `upload` (3-step): upload → cards → review. `wizardPlan` is
+ *   `undefined` until the upload-recommendation API succeeds, then
+ *   populated alongside `source` metadata. Submit includes
+ *   `spend_limits` + `required_receipt_threshold`; omits `mode`.
  */
 export type CardPolicyInitialData = {
-    policyKind: 'review-only';
-    suggestedPolicies: CardPolicySuggestedPolicy[];
+    policyKind: 'auto';
+    wizardPlan: CardPolicyWizardPlan;
 } | {
-    cards: CardPolicyCardRowSeed[];
-    categories: CardPolicyTagSeed[];
-    defaultLimits: CardPolicyLimitRowSeed[];
-    policyKind: 'full-builder';
-    suggestedPolicies: CardPolicySuggestedPolicy[];
-    vendors: CardPolicyTagSeed[];
+    policyKind: 'guided';
+    wizardPlan: CardPolicyWizardPlan;
 } | {
-    cards: CardPolicyCardRowSeed[];
-    policyKind: 'doc-upload';
-    suggestedPolicies: CardPolicySuggestedPolicy[];
+    policyKind: 'upload';
+    source?: CardPolicyUploadSource;
+    wizardPlan?: CardPolicyWizardPlan;
 };
 /**
  * Visualization variant rendered as an interactive RHF form (in lieu of a

package/lib/entity/cardPolicy/cardPolicyPayload.d.ts

@@ -52,9 +52,12 @@ interface CardPolicyTemplateSpendLimitsPayload {
     transaction: number | null;
 }
 /**
- * Request body for `POST /cards/1.0/policy-templates`. Consumers pass the
- * already-camelCased payload to the action creator; the epic re-maps it to
- * the snake_case wire format before sending.
+ * Per-template request shape. `POST /cards/1.0/policy-templates` now
+ * accepts a bulk wrapper (`CreateCardPolicyTemplatesRequest`); this
+ * interface describes a single entry inside the `templates` array.
+ *
+ * `PUT /cards/1.0/policy-templates/{id}` (update) still consumes this
+ * shape directly — see `UpdateCardPolicyTemplateRequest` below.
  */
 export interface CreateCardPolicyTemplateRequest {
     allowedEntity: CardPolicyTemplateEntityList;
@@ -81,6 +84,24 @@ export interface CreateCardPolicyTemplateRequestBody {
     required_receipt_threshold: number | null;
     spend_limits: CardPolicyTemplateSpendLimitsPayload;
 }
+/**
+ * Bulk request for `POST /cards/1.0/policy-templates`. The single-policy
+ * create flow wraps its one request in a length-1 `templates` array;
+ * future multi-policy submit (AI CFO review step) sends N entries in a
+ * single round-trip.
+ *
+ * `sourceChatSessionId` ties the submit back to an AI CFO chat session so
+ * the BE can attribute the created templates to it. Manual create-page
+ * callers omit it.
+ */
+export interface CreateCardPolicyTemplatesRequest {
+    templates: CreateCardPolicyTemplateRequest[];
+    sourceChatSessionId?: string;
+}
+export interface CreateCardPolicyTemplatesRequestBody {
+    templates: CreateCardPolicyTemplateRequestBody[];
+    source_chat_session_id?: string;
+}
 export interface CardPolicyTemplatePayload {
     allowed_entity: CardPolicyTemplateEntityListPayload;
     applied_cards: ID[];
@@ -99,11 +120,55 @@ export interface CardPolicyTemplatePayload {
     tenant_id: ID;
     updated_at: string;
 }
+/**
+ * Per-template response envelope. Still returned by `PUT /policy-templates/{id}`,
+ * `GET /policy-templates/{id}`, and (as the row payload) the list endpoint.
+ * Also nested inside `CreateCardPolicyTemplatesResponseData.templates_created`.
+ */
 export interface CreateCardPolicyTemplateResponseData {
     cards_applied: number;
     template: CardPolicyTemplatePayload;
 }
 export type CreateCardPolicyTemplateResponse = ZeniAPIResponse<CreateCardPolicyTemplateResponseData>;
+/**
+ * Per-item error returned by the bulk POST when one or more templates in
+ * the request fail validation / persistence. The exact field shape is
+ * **TBD** with the BE — `message` is the only guaranteed field today; the
+ * rest are best-effort placeholders that callers should not assume to be
+ * present.
+ *
+ * TODO: lock down the shape (`index`, `name`, `code`) once the BE
+ * documents it. See plan §"Open question to resolve with BE".
+ */
+export interface BulkCreateCardPolicyTemplateErrorPayload {
+    message: string;
+    code?: string;
+    index?: number;
+    name?: string;
+}
+/**
+ * Wire shape returned by the bulk `POST /cards/1.0/policy-templates`.
+ * Partial success is allowed — `templates_created` holds the successfully
+ * created rows (each in the same envelope as the single endpoint), and
+ * `errors` holds per-item failures for the rest. `status.message` follows
+ * the "N of M templates created" convention.
+ */
+export interface CreateCardPolicyTemplatesResponseData {
+    errors: BulkCreateCardPolicyTemplateErrorPayload[];
+    templates_created: CreateCardPolicyTemplateResponseData[];
+}
+export type CreateCardPolicyTemplatesResponse = ZeniAPIResponse<CreateCardPolicyTemplatesResponseData>;
+/**
+ * Camel-cased mirror of `BulkCreateCardPolicyTemplateErrorPayload` stored
+ * on the create-card-policy view slice so the UI can render a partial-success
+ * banner without re-touching the wire types.
+ */
+export interface BulkCreateCardPolicyTemplateError {
+    message: string;
+    code?: string;
+    index?: number;
+    name?: string;
+}
 export type UpdateCardPolicyTemplateRequest = CreateCardPolicyTemplateRequest;
 export type UpdateCardPolicyTemplateRequestBody = CreateCardPolicyTemplateRequestBody;
 export type UpdateCardPolicyTemplateResponseData = CreateCardPolicyTemplateResponseData;
@@ -138,10 +203,26 @@ export declare const toCardPolicyStats: (payload: CardPolicyStatsPayload) => Car
 export declare const toCardPolicyTemplateList: (data: ListCardPolicyTemplatesResponseData) => CardPolicyTemplate[];
 export declare const toCardPolicyTemplate: (payload: CardPolicyTemplatePayload) => CardPolicyTemplate;
 /**
- * Re-shape a camelCase create request into the snake_case wire body.
- * Used by the epic at request time.
+ * 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 declare const toCreateCardPolicyTemplateRequestBody: (request: CreateCardPolicyTemplateRequest) => CreateCardPolicyTemplateRequestBody;
+/**
+ * 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 declare const toCreateCardPolicyTemplatesRequestBody: (request: CreateCardPolicyTemplatesRequest) => CreateCardPolicyTemplatesRequestBody;
+/**
+ * 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 declare const toBulkCreateCardPolicyTemplateError: (payload: BulkCreateCardPolicyTemplateErrorPayload) => BulkCreateCardPolicyTemplateError;
 export declare const toUpdateCardPolicyTemplateRequestBody: (request: CreateCardPolicyTemplateRequest) => CreateCardPolicyTemplateRequestBody;
 /**
  * Seed an edit-form draft (`CreateCardPolicyTemplateRequest`) from an
@@ -173,4 +254,24 @@ export interface PolicyDocumentExtractResponseData {
 }
 export type PolicyDocumentExtractResponse = ZeniAPIResponse<PolicyDocumentExtractResponseData>;
 export declare const toExtractedCardPolicyRules: (payload: ExtractedCardPolicyRulesPayload) => ExtractedCardPolicyRules;
+/**
+ * Wire shape returned by `POST /cards/1.0/ai-cfo/policy-recommendation-from-upload`.
+ * Chained after `extractPolicyDocument` succeeds in the AI CFO `upload`
+ * flow: the FE forwards the just-returned `extracted_rules` and the BE
+ * synthesizes a wizard plan + upload source metadata.
+ *
+ * The response mirrors the same `mode`-discriminated envelope the
+ * controller API ships for `auto` / `guided`, but always with `mode:
+ * "upload"` and a populated `wizard_plan.step_5_review`. The FE merges
+ * the returned `wizard_plan` + `source` into the in-flight AI CFO
+ * answer's `CardPolicyInitialData` via
+ * `updateAiCfoAnswerCardPolicyWizardPlan`.
+ */
+export interface CardPolicyRecommendationFromUploadResponseData {
+    mode: 'upload';
+    source: import('../aiCfo/aiCfoPayload').CardPolicyUploadSourcePayload;
+    tenant_id: string;
+    wizard_plan: import('../aiCfo/aiCfoPayload').CardPolicyWizardPlanPayload;
+}
+export type CardPolicyRecommendationFromUploadResponse = ZeniAPIResponse<CardPolicyRecommendationFromUploadResponseData>;
 export {};