npm - @zeniai/client-epic-state - Versions diffs - 5.0.65-betaML1 → 5.0.65-betaRR1 - Mend

@zeniai/client-epic-state 5.0.65-betaML1 → 5.0.65-betaRR1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (115) hide show

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

@@ -20,8 +20,142 @@ export interface ChartVisualizationPayload {
     lines?: string[] | null;
     y_format?: YFormatPayload;
 }
+export interface CardsCardOptionPayload {
+    id: string;
+    label: string;
+    description?: string | null;
+}
+/**
+ * Discriminated payload for the AI Card Creation interactive form. The wire
+ * format mirrors the FE-side `CardsCreationInitialData` field-for-field
+ * (with snake_case field names converted to camelCase by the reducer).
+ *
+ * - `team-then-cards` (legacy): the AI suggests teams; user reviews them in
+ *   step 1, then configures cards in step 2.
+ * - `cards-only` (1-step): the AI has already chosen cards; user lands
+ *   directly on the editable card table for confirmation.
+ */
+export type CardsCreationInitialDataPayload = {
+    card_options: CardsCardOptionPayload[];
+    mode: 'team-then-cards';
+    suggested_owner_user_id_by_team_id: Record<string, string | null>;
+    team_rows: Array<{
+        avg_monthly_spend: string;
+        id: string;
+        label: string;
+        recommended_limit: string;
+        recommended_limit_cadence?: string | null;
+    }>;
+} | {
+    card_options: CardsCardOptionPayload[];
+    card_rows: Array<{
+        card_option_id: string;
+        id: string;
+        /**
+         * Optional team-derived display label rendered in the card cell
+         * trigger (e.g. "Engineering"). Drives the row's first-letter avatar
+         * in step 2.
+         */
+        label?: string | null;
+        recommended_limit?: number | null;
+        suggested_owner_user_id?: string | null;
+    }>;
+    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.
+ */
+export interface CardPolicyTagSeedPayload {
+    id: string;
+    is_selected: boolean;
+    label: string;
+    optional_code?: string | null;
+}
+export interface CardPolicyOwnerSeedPayload {
+    display_name: string;
+    user_id: string;
+    role_label?: string | null;
+}
+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;
+}
+/**
+ * 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.
+ */
+export interface CardPolicySuggestedPolicyChipPayload {
+    chip_kind: 'positive' | 'negative' | 'avatar';
+    id: string;
+    label: string;
+}
+export interface CardPolicySuggestedPolicyChipGroupPayload {
+    chips: CardPolicySuggestedPolicyChipPayload[];
+    id: string;
+    label: string;
+}
+export interface CardPolicySuggestedPolicyPayload {
+    chip_groups: CardPolicySuggestedPolicyChipGroupPayload[];
+    id: string;
+    is_checked: boolean;
+    name: string;
+}
+/**
+ * Discriminated payload for the AI Card Policy interactive form. Mirrors
+ * the FE-side `CardPolicyInitialData`.
+ *
+ * - `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.
+ */
+export type CardPolicyInitialDataPayload = {
+    policy_kind: 'review-only';
+    suggested_policies: CardPolicySuggestedPolicyPayload[];
+} | {
+    cards: CardPolicyCardRowSeedPayload[];
+    categories: CardPolicyTagSeedPayload[];
+    default_limits: CardPolicyLimitRowSeedPayload[];
+    policy_kind: 'full-builder';
+    suggested_policies: CardPolicySuggestedPolicyPayload[];
+    vendors: CardPolicyTagSeedPayload[];
+} | {
+    cards: CardPolicyCardRowSeedPayload[];
+    policy_kind: 'doc-upload';
+    suggested_policies: CardPolicySuggestedPolicyPayload[];
+};
+/**
+ * Discriminated visualization payload. The FE narrows on `form_type` and
+ * casts `payload` to the matching shape.
+ */
+export type InteractiveFormVisualizationPayload = {
+    form_type: 'cards_creation';
+    payload: CardsCreationInitialDataPayload;
+} | {
+    form_type: 'card_policy';
+    payload: CardPolicyInitialDataPayload;
+};
 export interface AiCfoVisualizationPayload {
-    data: TableVisualizationPayload | ChartVisualizationPayload | null;
+    data: TableVisualizationPayload | ChartVisualizationPayload | InteractiveFormVisualizationPayload | null;
     type: string | null;
 }
 export interface AiCfoAnswerPayload {

package/lib/entity/aiCfo/aiCfoReducer.js CHANGED Viewed

@@ -139,12 +139,121 @@ const toAiCfoVisualization = (visualization) => {
     if (visualization.type == null || visualization.data == null) {
         return undefined;
     }
+    const normalizedType = (0, aiCfoState_1.toAiCfoVisualizationTypeStrict)(visualization.type) ?? 'table';
     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) => {
+    const formType = (0, aiCfoState_1.toInteractiveFormTypeStrict)(data.form_type) ?? 'cards_creation';
+    if (formType === 'card_policy') {
+        return {
+            formType: 'card_policy',
+            payload: toCardPolicyInitialData(data.payload),
+        };
+    }
+    return {
+        formType: 'cards_creation',
+        payload: toCardsCreationInitialData(data.payload),
+    };
+};
+const toCardsCreationInitialData = (payload) => {
+    const cardOptions = (payload.card_options ?? []).map((option) => ({
+        id: option.id,
+        label: option.label,
+        description: option.description ?? undefined,
+    }));
+    if (payload.mode === 'cards-only') {
+        return {
+            mode: 'cards-only',
+            cardOptions,
+            cardRows: (payload.card_rows ?? []).map((row) => ({
+                cardOptionId: row.card_option_id,
+                id: row.id,
+                label: row.label ?? undefined,
+                recommendedLimit: row.recommended_limit ?? undefined,
+                suggestedOwnerUserId: row.suggested_owner_user_id ?? undefined,
+            })),
+        };
+    }
+    return {
+        mode: 'team-then-cards',
+        cardOptions,
+        suggestedOwnerUserIdByTeamId: Object.fromEntries(Object.entries(payload.suggested_owner_user_id_by_team_id ?? {}).map(([teamId, userId]) => [teamId, userId ?? undefined])),
+        teamRows: (payload.team_rows ?? []).map((row) => ({
+            avgMonthlySpend: row.avg_monthly_spend,
+            id: row.id,
+            label: row.label,
+            recommendedLimit: row.recommended_limit,
+            recommendedLimitCadence: row.recommended_limit_cadence ?? undefined,
+        })),
+    };
+};
+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') {
+        return {
+            policyKind: 'doc-upload',
+            suggestedPolicies,
+            cards: (payload.cards ?? []).map(toCardRowSeed),
+        };
+    }
+    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,
+        })),
+    };
+};
+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

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

@@ -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,141 @@ export interface ChartVisualization {
     lines?: string[];
     yFormat?: YFormat;
 }
+export interface CardsCardOption {
+    id: string;
+    label: string;
+    description?: string;
+}
+/**
+ * Initial data for the AI Card Creation interactive form. Discriminated on
+ * `mode`:
+ *
+ * - `team-then-cards` (default): AI suggests teams; user reviews them in
+ *   step 1, then configures one card per team in step 2.
+ * - `cards-only` (1-step): AI has already chosen cards; user lands directly
+ *   on the editable card table for confirmation.
+ */
+export type CardsCreationInitialData = {
+    cardOptions: CardsCardOption[];
+    mode: 'team-then-cards';
+    /**
+     * Map of `teamRow.id` -> suggested owner `userId`. Resolved against
+     * `allUsers` (sourced from the tenant) at render time.
+     */
+    suggestedOwnerUserIdByTeamId: Record<string, ID | undefined>;
+    teamRows: Array<{
+        avgMonthlySpend: string;
+        id: string;
+        label: string;
+        recommendedLimit: string;
+        recommendedLimitCadence?: string;
+    }>;
+} | {
+    cardOptions: CardsCardOption[];
+    cardRows: Array<{
+        cardOptionId: string;
+        id: string;
+        /**
+         * Optional team-derived display label rendered in the card cell
+         * trigger (e.g. "Engineering"). Drives the row's first-letter avatar
+         * in step 2.
+         */
+        label?: string;
+        recommendedLimit?: number;
+        suggestedOwnerUserId?: ID;
+    }>;
+    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.
+ */
+export interface CardPolicyTagSeed {
+    id: string;
+    isSelected: boolean;
+    label: string;
+    optionalCode?: 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;
+}
+export interface CardPolicyLimitRowSeed {
+    id: string;
+    isEnabled: boolean;
+    amount?: number;
+}
+export interface CardPolicySuggestedPolicyChip {
+    chipKind: 'positive' | 'negative' | 'avatar';
+    id: string;
+    label: string;
+}
+export interface CardPolicySuggestedPolicyChipGroup {
+    chips: CardPolicySuggestedPolicyChip[];
+    id: string;
+    label: string;
+}
+export interface CardPolicySuggestedPolicy {
+    chipGroups: CardPolicySuggestedPolicyChipGroup[];
+    id: string;
+    isChecked: boolean;
+    name: string;
+}
+/**
+ * Initial data for the AI Card Policy interactive form. Discriminated on
+ * `policyKind`:
+ *
+ * - `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.
+ */
+export type CardPolicyInitialData = {
+    policyKind: 'review-only';
+    suggestedPolicies: CardPolicySuggestedPolicy[];
+} | {
+    cards: CardPolicyCardRowSeed[];
+    categories: CardPolicyTagSeed[];
+    defaultLimits: CardPolicyLimitRowSeed[];
+    policyKind: 'full-builder';
+    suggestedPolicies: CardPolicySuggestedPolicy[];
+    vendors: CardPolicyTagSeed[];
+} | {
+    cards: CardPolicyCardRowSeed[];
+    policyKind: 'doc-upload';
+    suggestedPolicies: CardPolicySuggestedPolicy[];
+};
+/**
+ * Visualization variant rendered as an interactive RHF form (in lieu of a
+ * chart or table). Discriminated on `formType`; each branch carries its own
+ * payload shape.
+ */
+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";

package/lib/entity/aiCfo/aiCfoState.js CHANGED Viewed

@@ -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.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);

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

@@ -0,0 +1,171 @@
+import { ID } from '../../commonStateTypes/common';
+import { ZeniAPIResponse } from '../../responsePayload';
+import { CardPolicyStats, CardPolicyTemplate, CardPolicyTemplateEntityList, CardPolicyTemplateMode, CardPolicyTemplateSpendLimits, ExtractedCardPolicyRules, MccCategory } from './cardPolicyState';
+export interface MccCategoryPayload {
+    count: number;
+    mcc_codes: string[];
+    name: string;
+}
+/**
+ * Wire shape for `GET /cards/1.0/cards/mcc-codes`. Beyond the universe of
+ * MCC categories used to populate the category search dropdown, the
+ * endpoint also ships **suggested** allow / block merchants and categories
+ * that the chip-pickers seed into their cloud body before the user starts
+ * editing.
+ *
+ * Field spellings (`*_catagories`) preserve the BE wire format verbatim;
+ * the camelCase mapper below corrects to `Categories`.
+ */
+export interface CardPolicyMccCategoriesPayload {
+    categories: MccCategoryPayload[];
+    suggested_allow_catagories?: MccCategoryPayload[];
+    suggested_allow_merchants?: string[];
+    suggested_block_catagories?: MccCategoryPayload[];
+    suggested_block_merchants?: string[];
+}
+export type CardPolicyMccCategoriesResponse = ZeniAPIResponse<CardPolicyMccCategoriesPayload>;
+export declare const toMccCategory: (payload: MccCategoryPayload) => MccCategory;
+/**
+ * Vendor row returned by `/accounting/1.0/vendors`. The card-policy
+ * vendor search dropdown only needs `vendor_id` + `name`; we deliberately
+ * ignore the rest of the payload to keep this slice independent of the
+ * heavy `vendor` entity store.
+ */
+export interface CardPolicyVendorSearchVendorPayload {
+    name: string;
+    vendor_id: string;
+}
+export interface CardPolicyVendorSearchData {
+    vendors: CardPolicyVendorSearchVendorPayload[];
+}
+export type CardPolicyVendorSearchResponse = ZeniAPIResponse<CardPolicyVendorSearchData>;
+export interface CardPolicyVendorSearchOption {
+    name: string;
+    vendorId: string;
+}
+export declare const toCardPolicyVendorSearchOption: (payload: CardPolicyVendorSearchVendorPayload) => CardPolicyVendorSearchOption;
+interface CardPolicyTemplateEntityListPayload {
+    category_codes: string[];
+    merchant_names: string[];
+}
+interface CardPolicyTemplateSpendLimitsPayload {
+    transaction: number;
+}
+/**
+ * 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.
+ */
+export interface CreateCardPolicyTemplateRequest {
+    allowedEntity: CardPolicyTemplateEntityList;
+    applyToCards: ID[];
+    blockedEntity: CardPolicyTemplateEntityList;
+    description: string;
+    mode: CardPolicyTemplateMode;
+    name: string;
+    requiredReceiptThreshold: number;
+    spendLimits: CardPolicyTemplateSpendLimits;
+}
+export interface CreateCardPolicyTemplateRequestBody {
+    allowed_entity: CardPolicyTemplateEntityListPayload;
+    apply_to_cards: ID[];
+    blocked_entity: CardPolicyTemplateEntityListPayload;
+    description: string;
+    mode: string;
+    name: string;
+    required_receipt_threshold: number;
+    spend_limits: CardPolicyTemplateSpendLimitsPayload;
+}
+export interface CardPolicyTemplatePayload {
+    allowed_entity: CardPolicyTemplateEntityListPayload;
+    applied_cards: ID[];
+    blocked_entity: CardPolicyTemplateEntityListPayload;
+    cards_count: number;
+    category_restrictions: unknown[];
+    created_at: string;
+    created_by: ID;
+    description: string;
+    mode: string;
+    name: string;
+    required_receipt_threshold: number;
+    spend_limits: CardPolicyTemplateSpendLimitsPayload;
+    status: string;
+    template_id: ID;
+    tenant_id: ID;
+    updated_at: string;
+}
+export interface CreateCardPolicyTemplateResponseData {
+    cards_applied: number;
+    template: CardPolicyTemplatePayload;
+}
+export type CreateCardPolicyTemplateResponse = ZeniAPIResponse<CreateCardPolicyTemplateResponseData>;
+export type UpdateCardPolicyTemplateRequest = CreateCardPolicyTemplateRequest;
+export type UpdateCardPolicyTemplateRequestBody = CreateCardPolicyTemplateRequestBody;
+export type UpdateCardPolicyTemplateResponseData = CreateCardPolicyTemplateResponseData;
+export type UpdateCardPolicyTemplateResponse = CreateCardPolicyTemplateResponse;
+export type CardPolicyDetailResponseData = CreateCardPolicyTemplateResponseData;
+export type CardPolicyDetailResponse = CreateCardPolicyTemplateResponse;
+/**
+ * Aggregate counters returned alongside the templates list. Stored on
+ * the entity slice (alongside `cardPolicyTemplateById`) so any list
+ * surface can read it without re-fetching.
+ */
+export interface CardPolicyStatsPayload {
+    active_policies: number;
+    total_cards: number;
+    total_templates: number;
+}
+/**
+ * Each list row is wrapped in the same `{cards_applied, template}`
+ * envelope the create endpoint returns. Only the `template` portion is
+ * stored on the entity slice; `cards_applied` is a one-shot summary
+ * carried over from create and not surfaced in the list state today.
+ */
+export interface CardPolicyListRowPayload {
+    data: CreateCardPolicyTemplateResponseData;
+}
+export interface ListCardPolicyTemplatesResponseData {
+    stats: CardPolicyStatsPayload;
+    templates: CardPolicyListRowPayload[];
+}
+export type ListCardPolicyTemplatesResponse = ZeniAPIResponse<ListCardPolicyTemplatesResponseData>;
+export declare const toCardPolicyStats: (payload: CardPolicyStatsPayload) => CardPolicyStats;
+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.
+ */
+export declare const toCreateCardPolicyTemplateRequestBody: (request: CreateCardPolicyTemplateRequest) => CreateCardPolicyTemplateRequestBody;
+export declare const toUpdateCardPolicyTemplateRequestBody: (request: CreateCardPolicyTemplateRequest) => CreateCardPolicyTemplateRequestBody;
+/**
+ * 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 declare const toCardPolicyEditFormDraft: (template: CardPolicyTemplate) => CreateCardPolicyTemplateRequest;
+/**
+ * Wire shape returned by `POST /cards/1.0/policy-documents/extract`.
+ * The backend OCRs / parses an uploaded policy document (PDF, image, etc.)
+ * and returns a best-effort set of policy rules + a confidence score.
+ *
+ * Consumers (manual `CardPolicyCreatePage` + AI CFO `CardPolicyInteractiveForm`)
+ * use `toExtractedCardPolicyRules` to map this onto the camelCase FE shape
+ * and then feed the result through `applyExtractedPolicyRulesToFormValues`
+ * (`@zeniai/web-components`) to seed the RHF form.
+ */
+export interface ExtractedCardPolicyRulesPayload {
+    allowed_entity: CardPolicyTemplateEntityListPayload;
+    blocked_entity: CardPolicyTemplateEntityListPayload;
+    confidence_score: number;
+    policy_name: string;
+    required_receipt_threshold: number;
+    transaction_limit: number;
+}
+export interface PolicyDocumentExtractResponseData {
+    extracted_rules: ExtractedCardPolicyRulesPayload;
+    message: string;
+}
+export type PolicyDocumentExtractResponse = ZeniAPIResponse<PolicyDocumentExtractResponseData>;
+export declare const toExtractedCardPolicyRules: (payload: ExtractedCardPolicyRulesPayload) => ExtractedCardPolicyRules;
+export {};