@zeniai/client-epic-state 5.1.34 → 5.1.35-betaAK0

package/lib/view/aiCfoView/aiCfoViewState.d.ts

@@ -37,6 +37,19 @@ export interface SuggestedQuestionsForPageContext extends FetchStateAndError {
     suggestedQuestions: string[];
     generatedAt?: string;
 }
+/** A chat-visible skill shown in the `/` menu. */
+export interface Skill {
+    description: string | null;
+    displayName: string | null;
+    hasScripts: boolean;
+    macroId: string;
+    name: string;
+    parameterHints: Record<string, unknown> | null;
+    semver: string | null;
+}
+export interface SkillsState extends FetchStateAndError {
+    skills: Skill[];
+}
 export interface AiCfoViewState extends FetchStateAndError {
     allChatSessionIds: ID[];
     createSessionAndSubmitState: FetchStateAndError;
@@ -50,6 +63,8 @@ export interface AiCfoViewState extends FetchStateAndError {
         reasoning: FetchStateAndError;
         thought: FetchStateAndError;
     }>;
+    /** Chat-visible skills for the `/` menu. */
+    skills: SkillsState;
     stopSubmitStateByChatSessionId: Record<ID, FetchStateAndError>;
     /** Keyed by `page_context` query value (e.g. balance_sheet). */
     suggestedQuestionsByPageContext: Partial<Record<AiCfoSuggestedQuestionsPageContext, SuggestedQuestionsForPageContext>>;

package/lib/view/aiCfoView/epics/createSessionAndSubmitEpic.js

@@ -69,7 +69,7 @@ function waitForChannelSubscription(pusherInstance, channelName, timeoutMs = 500
     }));
 }
 const createSessionAndSubmitEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(aiCfoViewReducer_1.createSessionAndSubmit.match), (0, operators_1.switchMap)((action) => {
-    const { agentId, userId, questionAnswerId, questionId, createdAt, question, files, pageContext, } = action.payload;
+    const { agentId, userId, questionAnswerId, questionId, createdAt, question, files, pageContext, macroId, } = action.payload;
     const payload = {
         agent_id: agentId,
         ...(pageContext != null && { page_context: pageContext }),
@@ -116,7 +116,7 @@ const createSessionAndSubmitEpic = (actions$, _state$, zeniAPI) => actions$.pipe
                 // This allows fetchChatHistory to run after the question is submitted
                 (0, rxjs_1.of)((0, aiCfoViewReducer_1.createSessionAndSubmitSuccess)(), 
                 // Submit the question after handlers are bound
-                (0, aiCfoViewReducer_1.submitQuestion)(sessionId, questionAnswerId, userId, questionId, createdAt, question, files), 
+                (0, aiCfoViewReducer_1.submitQuestion)(sessionId, questionAnswerId, userId, questionId, createdAt, question, files, macroId), 
                 // Add question payload optimistically after submitQuestion (matches original order)
                 // This is idempotent - won't create duplicates if called multiple times
                 // submitQuestionEpic will find the question already exists and only update the response

package/lib/view/aiCfoView/epics/fetchSkillsEpic.d.ts

@@ -0,0 +1,8 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { fetchSkills, fetchSkillsFailure, fetchSkillsSuccess } from '../aiCfoViewReducer';
+export type ActionType = ReturnType<typeof fetchSkills> | ReturnType<typeof fetchSkillsSuccess> | ReturnType<typeof fetchSkillsFailure>;
+/** GET {aiCfoMicroServiceBaseUrl}/1.0/skills — chat-visible skills for the `/` menu. */
+export declare const fetchSkillsEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/aiCfoView/epics/fetchSkillsEpic.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchSkillsEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../responsePayload");
+const aiCfoViewReducer_1 = require("../aiCfoViewReducer");
+const toSkill = (s) => ({
+    macroId: s.macro_id,
+    name: s.name,
+    displayName: s.display_name,
+    description: s.description,
+    semver: s.semver,
+    parameterHints: s.parameter_hints,
+    hasScripts: s.has_scripts,
+});
+/** GET {aiCfoMicroServiceBaseUrl}/1.0/skills — chat-visible skills for the `/` menu. */
+const fetchSkillsEpic = (actions$, 
+// state$ intentionally unused: the `/` menu dispatches this once per slash-entry
+// (the composer dedupes), so we always re-fetch the (small, singleton) list.
+_state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(aiCfoViewReducer_1.fetchSkills.match), 
+// switchMap: a singleton list endpoint with no key — cancel any in-flight
+// fetch so the latest dispatch wins (no racing writes to `skills`).
+(0, operators_1.switchMap)(() => {
+    // aiCfoMicroServiceBaseUrl already targets the chat service (it serves the
+    // /1.0/agents/{id} submit route too); /1.0/skills lives on the same service.
+    const url = `${zeniAPI.apiEndPoints.aiCfoMicroServiceBaseUrl}/1.0/skills`;
+    return zeniAPI.getJSON(url).pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            // Guard the array: a malformed 2xx body without `skills` must not crash .map.
+            return (0, rxjs_1.of)((0, aiCfoViewReducer_1.fetchSkillsSuccess)({
+                skills: (response.data.skills ?? []).map(toSkill),
+            }));
+        }
+        return (0, rxjs_1.of)((0, aiCfoViewReducer_1.fetchSkillsFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, aiCfoViewReducer_1.fetchSkillsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch skills REST API call failed', error instanceof Error ? { message: error.message } : undefined)))));
+}));
+exports.fetchSkillsEpic = fetchSkillsEpic;

package/lib/view/aiCfoView/epics/submitQuestionEpic.js

@@ -7,7 +7,7 @@ const aiCfoReducer_1 = require("../../../entity/aiCfo/aiCfoReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const aiCfoViewReducer_1 = require("../aiCfoViewReducer");
 const submitQuestionEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(aiCfoViewReducer_1.submitQuestion.match), (0, operators_1.mergeMap)((action) => {
-    const { questionAnswerId, userId, sessionId, questionId, createdAt, question, files, } = action.payload;
+    const { questionAnswerId, userId, sessionId, questionId, createdAt, question, files, macroId, } = action.payload;
     const { aiCfoViewState } = state$.value;
     const { uiState } = aiCfoViewState;
     const agentId = uiState.agentId;
@@ -20,15 +20,21 @@ const submitQuestionEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, oper
         const formData = new FormData();
         formData.append('chat_session_id', sessionId);
         formData.append('message', question);
+        if (macroId != null) {
+            formData.append('macro_id', macroId);
+        }
         for (const file of files) {
             formData.append('files', file, file.name);
         }
         apiCall = zeniAPI.postFormData(endpoint, formData);
     }
     else {
+        // `message` is the display token (e.g. "/flux"); `macro_id` tells the chat
+        // service to expand the skill's instructions as the actual agent prompt.
         apiCall = zeniAPI.postAndGetJSON(endpoint, {
             chat_session_id: sessionId,
             message: question,
+            ...(macroId != null && { macro_id: macroId }),
         });
     }
     return apiCall.pipe((0, operators_1.mergeMap)((response) => {

package/lib/view/expenseAutomationView/epics/accountRecon/parseStatementEpic.d.ts

@@ -0,0 +1,6 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { RootState } from '../../../../reducer';
+import { ZeniAPI } from '../../../../zeniAPI';
+import { parseStatement, parseStatementFailure, parseStatementSuccess, updateParsedStatementData } from '../../reducers/reconciliationViewReducer';
+export type ActionType = ReturnType<typeof parseStatement> | ReturnType<typeof parseStatementSuccess> | ReturnType<typeof parseStatementFailure> | ReturnType<typeof updateParsedStatementData>;
+export declare const parseStatementEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => import("rxjs").Observable<ActionType>;

package/lib/view/expenseAutomationView/epics/accountRecon/parseStatementEpic.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStatementEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../../responsePayload");
+const reconciliationPayload_1 = require("../../payload/reconciliationPayload");
+const reconciliationViewReducer_1 = require("../../reducers/reconciliationViewReducer");
+const parseStatementEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(reconciliationViewReducer_1.parseStatement.match), (0, operators_1.switchMap)((action) => {
+    const { accountId, selectedPeriod, statementUploadId } = action.payload;
+    const parseStatementApi$ = zeniAPI.getJSON(`${zeniAPI.apiEndPoints.reconciliationMicroServiceBaseUrl}/2.0/statement-uploads/${statementUploadId}`);
+    return parseStatementApi$.pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) === true && response.data != null) {
+            const actions = [];
+            const transformedData = (0, reconciliationPayload_1.transformParseStatementPayloadToState)(response.data);
+            actions.push((0, reconciliationViewReducer_1.updateParsedStatementData)({
+                accountId,
+                selectedPeriod,
+                parsedStatementData: transformedData,
+            }));
+            actions.push((0, reconciliationViewReducer_1.parseStatementSuccess)({ accountId, selectedPeriod }));
+            return (0, rxjs_1.from)(actions);
+        }
+        else {
+            return (0, rxjs_1.of)((0, reconciliationViewReducer_1.parseStatementFailure)({
+                accountId,
+                selectedPeriod,
+                error: response.status,
+            }));
+        }
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, reconciliationViewReducer_1.parseStatementFailure)({
+        accountId,
+        selectedPeriod,
+        error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Parse Statement REST API call errored out ' +
+            (error instanceof Error ? error.message : String(error))),
+    }))));
+}));
+exports.parseStatementEpic = parseStatementEpic;

package/lib/view/expenseAutomationView/epics/accountRecon/reparseStatementEpic.d.ts

@@ -0,0 +1,26 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { RootState } from '../../../../reducer';
+import { updateAccountReconReparseStatement } from '../../../../entity/accountRecon/accountReconReducer';
+import { ZeniAPI } from '../../../../zeniAPI';
+import { reparseStatement, reparseStatementFailure, reparseStatementSuccess } from '../../reducers/reconciliationViewReducer';
+export type ActionType = ReturnType<typeof reparseStatement> | ReturnType<typeof reparseStatementSuccess> | ReturnType<typeof reparseStatementFailure> | ReturnType<typeof updateAccountReconReparseStatement>;
+export declare const reparseStatementEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => import("rxjs").Observable<{
+    payload: {
+        accountId: import("../../../..").ID;
+        selectedPeriod: import("../../../..").MonthYearPeriod;
+    };
+    type: "expenseAutomationReconciliationView/reparseStatementSuccess";
+} | {
+    payload: {
+        accountId: import("../../../..").ID;
+        error: import("../../../../responsePayload").ZeniAPIStatus;
+        selectedPeriod: import("../../../..").MonthYearPeriod;
+    };
+    type: "expenseAutomationReconciliationView/reparseStatementFailure";
+} | {
+    payload: {
+        accountReconKey: string;
+        payload: import("../../payload/reconciliationPayload").ReparseStatementResponsePayload;
+    };
+    type: "accountRecon/updateAccountReconReparseStatement";
+}>;

package/lib/view/expenseAutomationView/epics/accountRecon/reparseStatementEpic.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reparseStatementEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const accountReconReducer_1 = require("../../../../entity/accountRecon/accountReconReducer");
+const accountReconState_1 = require("../../../../entity/accountRecon/accountReconState");
+const responsePayload_1 = require("../../../../responsePayload");
+const reconciliationViewReducer_1 = require("../../reducers/reconciliationViewReducer");
+const reparseStatementEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(reconciliationViewReducer_1.reparseStatement.match), (0, operators_1.switchMap)((action) => {
+    const { accountId, selectedPeriod, statementUploadId } = action.payload;
+    const reparseStatementApi$ = zeniAPI.postAndGetJSON(`${zeniAPI.apiEndPoints.reconciliationMicroServiceBaseUrl}/1.0/reconciliation/statements/${statementUploadId}/reparse`);
+    return reparseStatementApi$.pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) === true && response.data != null) {
+            const accountReconKey = (0, accountReconState_1.toAccountReconKey)(accountId, selectedPeriod);
+            return (0, rxjs_1.from)([
+                (0, accountReconReducer_1.updateAccountReconReparseStatement)(accountReconKey, response.data),
+                (0, reconciliationViewReducer_1.reparseStatementSuccess)({ accountId, selectedPeriod }),
+            ]);
+        }
+        else {
+            return (0, rxjs_1.of)((0, reconciliationViewReducer_1.reparseStatementFailure)({
+                accountId,
+                selectedPeriod,
+                error: response.status,
+            }));
+        }
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, reconciliationViewReducer_1.reparseStatementFailure)({
+        accountId,
+        selectedPeriod,
+        error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Reparse Statement REST API call errored out ' +
+            (error instanceof Error ? error.message : String(error))),
+    }))));
+}));
+exports.reparseStatementEpic = reparseStatementEpic;

package/lib/view/expenseAutomationView/epics/accountRecon/updateStatementInfoEpic.d.ts

@@ -0,0 +1,27 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { RootState } from '../../../../reducer';
+import { ZeniAPI } from '../../../../zeniAPI';
+import { submitStatementUpdate, submitStatementUpdateFailure, submitStatementUpdateSuccess, updateParsedStatementData } from '../../reducers/reconciliationViewReducer';
+export type ActionType = ReturnType<typeof submitStatementUpdate> | ReturnType<typeof submitStatementUpdateSuccess> | ReturnType<typeof submitStatementUpdateFailure> | ReturnType<typeof updateParsedStatementData>;
+export declare const updateStatementInfoEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => import("rxjs").Observable<{
+    payload: {
+        accountId: import("../../../..").ID;
+        parsedStatementData: import("../../types/reconciliationViewState").ParsedStatementData;
+        selectedPeriod: import("../../../../commonStateTypes/timePeriod").MonthYearPeriod;
+    };
+    type: "expenseAutomationReconciliationView/updateParsedStatementData";
+} | {
+    payload: {
+        accountId: import("../../../..").ID;
+        selectedPeriod: import("../../../../commonStateTypes/timePeriod").MonthYearPeriod;
+    };
+    type: "expenseAutomationReconciliationView/submitStatementUpdateSuccess";
+} | {
+    payload: {
+        accountId: import("../../../..").ID;
+        error: import("../../../../responsePayload").ZeniAPIStatus;
+        selectedPeriod: import("../../../../commonStateTypes/timePeriod").MonthYearPeriod;
+        dateConflict?: import("../../types/reconciliationViewState").StatementDateConflict | null;
+    };
+    type: "expenseAutomationReconciliationView/submitStatementUpdateFailure";
+}>;

package/lib/view/expenseAutomationView/epics/accountRecon/updateStatementInfoEpic.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateStatementInfoEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const timePeriod_1 = require("../../../../commonStateTypes/timePeriod");
+const responsePayload_1 = require("../../../../responsePayload");
+const reconciliationPayload_1 = require("../../payload/reconciliationPayload");
+const reconciliationViewReducer_1 = require("../../reducers/reconciliationViewReducer");
+const updateStatementInfoEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(reconciliationViewReducer_1.submitStatementUpdate.match), (0, operators_1.switchMap)((action) => {
+    const { accountId, selectedPeriod, statementUploadId } = action.payload;
+    const state = state$.value;
+    const reconciliationView = state.expenseAutomationReconciliationViewState;
+    const accountRecon = reconciliationView.accountReconciliationRecordsBySelectedPeriod[(0, timePeriod_1.toMonthYearPeriodId)(selectedPeriod)]?.reconciliationByAccountID[accountId];
+    const localData = accountRecon?.localData?.statementUpdateLocalData;
+    if (!localData) {
+        return (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
+            accountId,
+            selectedPeriod,
+            error: (0, responsePayload_1.createZeniAPIStatus)('Missing Data', 'No statement update data found'),
+        }));
+    }
+    const hasInvalidUpdates = localData.statementTransactions.updated.some((txn) => txn.statementTransactionId == null);
+    if (hasInvalidUpdates) {
+        return (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
+            accountId,
+            selectedPeriod,
+            error: (0, responsePayload_1.createZeniAPIStatus)('Invalid Data', 'One or more edited transactions are missing statement transaction ids'),
+        }));
+    }
+    const body = (0, reconciliationPayload_1.toStatementUpdateRequestBody)(localData);
+    const updateStatementApi$ = zeniAPI.putAndGetJSON(`${zeniAPI.apiEndPoints.reconciliationMicroServiceBaseUrl}/2.0/statement-uploads/${statementUploadId}`, body);
+    return updateStatementApi$.pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) === true && response.data != null) {
+            const parsedStatementData = (0, reconciliationPayload_1.transformUpdateStatementInfoPayloadToState)(response.data);
+            return (0, rxjs_1.of)((0, reconciliationViewReducer_1.updateParsedStatementData)({
+                accountId,
+                selectedPeriod,
+                parsedStatementData,
+            }), (0, reconciliationViewReducer_1.submitStatementUpdateSuccess)({
+                accountId,
+                selectedPeriod,
+            }));
+        }
+        const dateConflict = (0, reconciliationPayload_1.isStatementDateConflictResponse)(response)
+            ? (0, reconciliationPayload_1.transformStatementDateConflictToState)(response)
+            : null;
+        return (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
+            accountId,
+            selectedPeriod,
+            error: response.status,
+            dateConflict,
+        }));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
+        accountId,
+        selectedPeriod,
+        error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Update Statement REST API call errored out ' +
+            (error instanceof Error ? error.message : String(error))),
+    }))));
+}));
+exports.updateStatementInfoEpic = updateStatementInfoEpic;

package/lib/view/expenseAutomationView/epics/transactionCategorization/fetchTransactionCategorizationEpic.js

@@ -17,7 +17,8 @@ const fetchTransactionCategorizationEpic = (actions$, state$, zeniAPI) => action
 (0, operators_1.groupBy)((action) => action.payload.selectedTab), (0, operators_1.mergeMap)((group$) => group$.pipe((0, operators_1.switchMap)((action) => {
     const { expenseAutomationViewState: { selectedPeriodByTenantId }, expenseAutomationTransactionsViewState, } = state$.value;
     const { period, keepExistingListItems, selectedTab, refreshViewInBackground, } = action.payload;
-    const uiState = expenseAutomationTransactionsViewState.transactionCategorizationView[selectedTab].uiState;
+    const uiState = expenseAutomationTransactionsViewState
+        .transactionCategorizationView[selectedTab].uiState;
     const { pageToken, sortOrder, sortKey } = uiState;
     const requestSearchString = uiState.searchString;
     const currentTenant = (0, tenantSelector_1.getCurrentTenant)(state$.value);

package/lib/view/expenseAutomationView/epics/transactionCategorization/fetchTransactionCategorizationViewEpic.js

@@ -55,7 +55,8 @@ const fetchTransactionCategorizationViewEpic = (actions$, state$) => actions$.pi
     // fresh fetch on click. refreshViewInBackground=true keeps it silent.
     if (searchString === undefined) {
         transactionsViewState_1.TRANSACTIONS_TABS.filter((tab) => tab !== selectedTab).forEach((otherTab) => {
-            const otherTabFetchState = expenseAutomationTransactionsViewState.transactionCategorizationView[otherTab].fetchState;
+            const otherTabFetchState = expenseAutomationTransactionsViewState
+                .transactionCategorizationView[otherTab].fetchState;
             if (otherTabFetchState === 'Not-Started') {
                 updateActions.push((0, transactionsViewReducer_1.fetchTransactionCategorization)(otherTab, period, false, false, undefined, undefined, true, undefined, isUncategorizedExpenseCategoryEnabled));
             }
@@ -68,7 +69,8 @@ const fetchTransactionCategorizationViewEpic = (actions$, state$) => actions$.pi
     // if available; otherwise issue a background fetch.
     if (searchString !== undefined) {
         transactionsViewState_1.TRANSACTIONS_TABS.filter((tab) => tab !== selectedTab).forEach((otherTab) => {
-            const otherTabSearchString = expenseAutomationTransactionsViewState.transactionCategorizationView[otherTab].uiState.searchString;
+            const otherTabSearchString = expenseAutomationTransactionsViewState
+                .transactionCategorizationView[otherTab].uiState.searchString;
             if (searchString !== otherTabSearchString) {
                 updateActions.push((0, transactionsViewReducer_1.fetchTransactionCategorization)(otherTab, period, true, keepExistingListItems, searchString, undefined, true, true, isUncategorizedExpenseCategoryEnabled));
             }

package/lib/view/expenseAutomationView/payload/reconciliationPayload.d.ts

@@ -8,8 +8,8 @@ import { FilePayload } from '../../../entity/file/filePayload';
 import { MatchedTransactionPayload } from '../../../entity/transaction/payloadTypes/reconciliationTransactionPayloads';
 import { UserPayload } from '../../../entity/user/userPayload';
 import { RootState } from '../../../reducer';
-import { ZeniAPIResponse } from '../../../responsePayload';
-import { BalancesLocalData, SaveReconcileDetailActionPayload } from '../types/reconciliationViewState';
+import { ZeniAPIResponse, ZeniAPIStatus } from '../../../responsePayload';
+import { BalancesLocalData, ParsedStatementData, SaveReconcileDetailActionPayload, StatementDateConflict, StatementUpdateLocalData, StatementUpdateLocalDataPayload } from '../types/reconciliationViewState';
 export interface DetectionInfoPayload {
     account_id: string;
     bank_balance: number | null;
@@ -31,6 +31,31 @@ interface ExclusionInfoPayload {
 export interface ExcludedAccountPayload extends AccountAndPaymentAccountPayload {
     exclusion_info: ExclusionInfoPayload;
 }
+export interface ReconciliationProgressBarPayload {
+    ai_percentage_share: number;
+    complete_percentage: number;
+    human_percentage_share: number;
+    remaining_percentage: number;
+}
+export interface ReconciliationSummaryPayload {
+    accounts: {
+        done: number;
+        failed: number;
+        in_progress: number;
+        total: number;
+    };
+    accounts_to_connect_count: number;
+    auto_matched: {
+        matched_txns: number;
+        total_txns: number;
+    };
+    needs_review: {
+        account_count: number;
+        txn_count: number;
+    };
+    time_saved_percentage: number;
+    progress_bar?: ReconciliationProgressBarPayload;
+}
 export interface ReconciliationPayload {
     accounts: AccountAndPaymentAccountPayload[];
     files: FilePayload[];
@@ -39,6 +64,7 @@ export interface ReconciliationPayload {
     detection_info?: DetectionInfoPayload;
     detection_reason?: string;
     excluded_accounts?: ExcludedAccountPayload[];
+    summary?: ReconciliationSummaryPayload;
 }
 export type ReconciliationResponse = ZeniAPIResponse<ReconciliationPayload>;
 export interface SaveReconciliationReviewPayload {
@@ -86,16 +112,156 @@ export interface UploadStatementDocumentAIPayload {
     processor_run_id: string;
 }
 export type UploadStatementDocumentAIResponse = ZeniAPIResponse<UploadStatementDocumentAIPayload>;
+export interface StatementUploadSummaryPayload {
+    account_type: string;
+    statement_data_status: StatusCodeWithLabelPayload;
+    statement_end_date: string;
+    statement_start_date: string;
+    statement_status: StatusCodeWithLabelPayload;
+    statement_upload_id: string;
+}
 export interface UploadStatementResponsePayload {
     file: FilePayload;
-    statement_upload: {
-        account_type: string;
-        statement_data_status: StatusCodeWithLabelPayload;
-        statement_end_date: string;
-        statement_start_date: string;
-        statement_status: StatusCodeWithLabelPayload;
-        statement_upload_id: string;
-    };
+    statement_upload: StatementUploadSummaryPayload;
 }
 export type UploadStatementResponse = ZeniAPIResponse<UploadStatementResponsePayload>;
+export interface PolygonPointPayload {
+    x: number;
+    y: number;
+}
+export interface CitationPayload {
+    page: number;
+    page_height: number;
+    page_width: number;
+    polygon: PolygonPointPayload[];
+    reference_text: string;
+}
+export interface StatementTransactionPayload {
+    amount: number;
+    citation: CitationPayload[];
+    is_user_added: boolean;
+    is_user_edited: boolean;
+    statement_transaction_id: string;
+    transaction_date: string;
+    transaction_direction: 'debit' | 'credit';
+    transaction_memo: string;
+}
+export interface ReconciliationMetaPayload {
+    end_date: string;
+    reconciliation_id: string;
+    start_date: string;
+    status: string;
+}
+export interface StatementMetaPayload {
+    closing_balance: number;
+    opening_balance: number;
+    statement_data_status: StatusCodeWithLabelPayload;
+    statement_end_date: string;
+    statement_start_date: string;
+    statement_status: StatusCodeWithLabelPayload;
+    statement_upload_id: string;
+    total_deposits: number;
+    total_payments: number;
+}
+export interface AccountInfoPayload {
+    account_id: string;
+    account_name: string;
+    account_type: string;
+    currency_code: string;
+    last_4_digits: string | null;
+}
+export interface FileInfoPayload {
+    file_id: string;
+    file_name: string;
+    signed_url: string;
+}
+export interface AiSummaryFieldPayload {
+    code: string;
+    label: string;
+}
+export interface PreviousReconciliationInfoPayload {
+    end_date: string;
+    reconciled_at: string;
+    reconciled_by_user_id: string;
+    reconciliation_id: string;
+    start_date: string;
+}
+export interface AiSummaryChainStatusPayload {
+    code: string;
+    expected_start_date: string | null;
+    label: string;
+    previous_reconciliation_info: PreviousReconciliationInfoPayload | null;
+}
+export interface AiSummaryPayload {
+    account_identified: string | null;
+    chain_status: AiSummaryChainStatusPayload;
+    exceptions_detected: number;
+    fields_captured: AiSummaryFieldPayload[];
+    transactions_extracted: number;
+}
+export interface StatementUploadPayload {
+    account: AccountInfoPayload;
+    file: FileInfoPayload | null;
+    statement_meta: StatementMetaPayload;
+    statement_transactions: StatementTransactionPayload[];
+    ai_summary?: AiSummaryPayload | null;
+}
+export interface ParseStatementResponsePayload {
+    reconciliation: ReconciliationMetaPayload;
+    statement_upload: StatementUploadPayload;
+}
+export interface ReparseStatementResponsePayload {
+    statement_upload: StatementUploadSummaryPayload;
+}
+export type ParseStatementResponse = ZeniAPIResponse<ParseStatementResponsePayload>;
+export type ReparseStatementResponse = ZeniAPIResponse<ReparseStatementResponsePayload>;
+/**
+ * Statement period chain validation (Confirm & Save).
+ *
+ * - 200 (auto-trim): the BE trimmed the start date and returns a
+ *   `date_adjustment` block alongside the usual reconciliation /
+ *   statement_upload data.
+ * - 409: the upload was rejected (total overlap or gap). The error fields
+ *   (`error_code`, `expected_start_date`, `previous_reconciliation_info`)
+ *   live at the top level of the response, next to `status`.
+ */
+export type StatementChainErrorCode = 'STATEMENT_RANGE_ALREADY_RECONCILED' | 'STATEMENT_RANGE_HAS_GAP';
+export interface StatementDateAdjustmentPayload {
+    adjusted_start_date: string;
+    original_start_date: string;
+    previous_reconciliation_info: PreviousReconciliationInfoPayload;
+    reason: string;
+}
+export interface UpdateStatementInfoResponsePayload {
+    reconciliation: ReconciliationMetaPayload;
+    statement_upload: StatementUploadPayload;
+    date_adjustment?: StatementDateAdjustmentPayload | null;
+}
+/** 2xx Confirm & Save — carries parsed statement data, no chain-validation errors. */
+export interface UpdateStatementInfoSuccessResponse extends ZeniAPIResponse<UpdateStatementInfoResponsePayload> {
+    error_code?: undefined;
+    expected_start_date?: undefined;
+    previous_reconciliation_info?: undefined;
+}
+/** 409 Confirm & Save — chain validation rejected the statement period. */
+export interface UpdateStatementInfoConflictResponse extends ZeniAPIResponse<UpdateStatementInfoResponsePayload | undefined> {
+    error_code: StatementChainErrorCode;
+    status: ZeniAPIStatus & {
+        code: 409;
+    };
+    expected_start_date?: string | null;
+    previous_reconciliation_info?: PreviousReconciliationInfoPayload | null;
+}
+export type UpdateStatementInfoResponse = UpdateStatementInfoSuccessResponse | UpdateStatementInfoConflictResponse;
+export declare function isStatementDateConflictResponse(response: UpdateStatementInfoResponse): response is UpdateStatementInfoConflictResponse;
+/**
+ * Builds date-conflict state from a 409 Confirm & Save response.
+ * Returns null for non-409 responses or 409s without a recognized error code.
+ */
+export declare function transformStatementDateConflictToState(response: UpdateStatementInfoResponse): StatementDateConflict | null;
+export declare function transformParseStatementPayloadToState(payload: ParseStatementResponsePayload): ParsedStatementData;
+export declare function transformUpdateStatementInfoPayloadToState(payload: UpdateStatementInfoResponsePayload): ParsedStatementData;
+export declare function transformStatementUpdateStateToPayload(localData: StatementUpdateLocalData): StatementUpdateLocalDataPayload;
+/** API request body for PUT statement-uploads; cast lives here for putAndGetJSON. */
+export declare function toStatementUpdateRequestBody(localData: StatementUpdateLocalData): Record<string, unknown>;
 export {};