hazo_collab_forms 2.2.8 → 3.0.2

package/dist/components/hazo_fb_form/hooks/use_fb_form_state.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Central state management hook for HazoFbForm.
+ */
+import type { HazoFbFormProps, FbRunProgress, FbClassificationResult, FbUnassignedFile, FbGroupAutofillLog, FbFileValidationResult, FbTabId } from '../types.js';
+import type { ClarificationItem, ClarificationReviewDecision } from '../../../types/clarification.js';
+import type { FbFormInstance } from '../../../types/fb_form_instance.js';
+export declare function use_fb_form_state(props: HazoFbFormProps, active_instance_id?: string, active_instance?: FbFormInstance | null): {
+    active_tab: FbTabId;
+    set_active_tab: (tab: FbTabId) => void;
+    run_progress: FbRunProgress;
+    set_run_progress: import("react").Dispatch<import("react").SetStateAction<FbRunProgress>>;
+    update_progress: (update: Partial<FbRunProgress>) => void;
+    classification_results: FbClassificationResult[];
+    set_classification_results: import("react").Dispatch<import("react").SetStateAction<FbClassificationResult[]>>;
+    classifying_file_ids: Set<string>;
+    add_classifying_files: (file_ids: string[]) => void;
+    remove_classifying_files: (file_ids: string[]) => void;
+    queued_file_ids: Set<string>;
+    add_queued_files: (file_ids: string[]) => void;
+    remove_queued_files: (file_ids: string[]) => void;
+    unassigned_files: FbUnassignedFile[];
+    set_unassigned_files: import("react").Dispatch<import("react").SetStateAction<FbUnassignedFile[]>>;
+    group_autofill_log: Record<string, FbGroupAutofillLog>;
+    set_group_autofill_log: import("react").Dispatch<import("react").SetStateAction<Record<string, FbGroupAutofillLog>>>;
+    file_validation_results: Record<string, FbFileValidationResult>;
+    set_file_validation_results: (setter: Record<string, FbFileValidationResult> | ((prev: Record<string, FbFileValidationResult>) => Record<string, FbFileValidationResult>)) => void;
+    suggested_document_types: string[];
+    set_suggested_document_types: import("react").Dispatch<import("react").SetStateAction<string[]>>;
+    draft_clarifications: ClarificationItem[];
+    set_draft_clarifications: (setter: ClarificationItem[] | ((prev: ClarificationItem[]) => ClarificationItem[])) => void;
+    sent_clarifications: ClarificationItem[];
+    manual_review_file_ids: Set<string>;
+    set_manual_review_file_ids: import("react").Dispatch<import("react").SetStateAction<Set<string>>>;
+    validating_file_ids: Set<string>;
+    set_validating_file_ids: import("react").Dispatch<import("react").SetStateAction<Set<string>>>;
+    review_decisions: Map<string, ClarificationReviewDecision>;
+    set_review_decisions: (setter: Map<string, ClarificationReviewDecision> | ((prev: Map<string, ClarificationReviewDecision>) => Map<string, ClarificationReviewDecision>)) => void;
+    ignored_file_ids: Set<string>;
+    set_ignored_file_ids: (setter: Set<string> | ((prev: Set<string>) => Set<string>)) => void;
+    skipped_file_ids: Set<string>;
+    set_skipped_file_ids: (setter: Set<string> | ((prev: Set<string>) => Set<string>)) => void;
+    autofilling_file_ids: Set<string>;
+    set_autofilling_file_ids: import("react").Dispatch<import("react").SetStateAction<Set<string>>>;
+};
+//# sourceMappingURL=use_fb_form_state.d.ts.map

package/dist/components/hazo_fb_form/hooks/use_fb_form_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_fb_form_state.d.ts","sourceRoot":"","sources":["../../../../src/components/hazo_fb_form/hooks/use_fb_form_state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACjK,OAAO,KAAK,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACtG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAQzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,cAAc,GAAG,IAAI;;0BAGnF,OAAO;;;8BAsKH,OAAO,CAAC,aAAa,CAAC;;;;sCAId,MAAM,EAAE;yCAQL,MAAM,EAAE;;iCAQhB,MAAM,EAAE;oCAQL,MAAM,EAAE;;;;;;0CAtKhD,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;;;;uCAenI,iBAAiB,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,CAAC;;;;;;;mCAe1E,GAAG,CAAC,MAAM,EAAE,2BAA2B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,2BAA2B,CAAC,KAAK,GAAG,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;;mCAezI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;;mCAelD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;;;EA2J9D"}

package/dist/components/hazo_fb_form/hooks/use_fb_form_state.js

@@ -0,0 +1,223 @@
+/**
+ * Central state management hook for HazoFbForm.
+ */
+'use client';
+import { useState, useCallback, useEffect, useMemo, useRef } from 'react';
+import { use_logger } from '../../../logger/index.js';
+import { VIRTUAL_INSTANCE_ID } from '../hazo_fb_form.js';
+const EMPTY_VALIDATION = {};
+const EMPTY_CLARIFICATIONS = [];
+const EMPTY_REVIEW_DECISIONS = new Map();
+const EMPTY_STRING_SET = new Set();
+export function use_fb_form_state(props, active_instance_id, active_instance) {
+    const logger = use_logger();
+    const [active_tab, set_active_tab_raw] = useState(props.initial_tab ?? 'front');
+    const set_active_tab = useCallback((tab) => {
+        logger.debug('[use_fb_form_state] tab_changed', { tab, instance_id: active_instance_id });
+        set_active_tab_raw(tab);
+    }, [active_instance_id]);
+    const [run_progress, set_run_progress] = useState({
+        status: 'idle',
+        total_steps: 0,
+        completed_steps: 0,
+    });
+    const [classification_results, set_classification_results] = useState(props.classification_results ?? []);
+    const [classifying_file_ids, set_classifying_file_ids] = useState(new Set());
+    const [unassigned_files, set_unassigned_files] = useState([]);
+    const [group_autofill_log, set_group_autofill_log] = useState({});
+    const [suggested_document_types, set_suggested_document_types] = useState([]);
+    const [queued_file_ids, set_queued_file_ids] = useState(new Set());
+    const [manual_review_file_ids, set_manual_review_file_ids] = useState(new Set());
+    const [validating_file_ids, set_validating_file_ids] = useState(new Set());
+    // ── Per-instance state (keyed by instance_id to avoid stale data on switch) ──
+    const instance_key = active_instance_id ?? VIRTUAL_INSTANCE_ID;
+    // File validation results — per-instance so auto-populate doesn't leak across instances
+    const [validation_map, set_validation_map] = useState({});
+    const file_validation_results = validation_map[instance_key] ?? EMPTY_VALIDATION;
+    const set_file_validation_results = useCallback((setter) => {
+        set_validation_map((prev) => {
+            const current = prev[instance_key] ?? {};
+            const next = typeof setter === 'function' ? setter(current) : setter;
+            return { ...prev, [instance_key]: next };
+        });
+    }, [instance_key]);
+    // Draft clarifications — per-instance so switching doesn't flash stale drafts
+    const [drafts_map, set_drafts_map] = useState({});
+    const draft_clarifications = drafts_map[instance_key] ?? EMPTY_CLARIFICATIONS;
+    const set_draft_clarifications = useCallback((setter) => {
+        set_drafts_map((prev) => {
+            const current = prev[instance_key] ?? [];
+            const next = typeof setter === 'function' ? setter(current) : setter;
+            return { ...prev, [instance_key]: next };
+        });
+    }, [instance_key]);
+    // Review decisions — per-instance so switching doesn't mix decisions
+    const [review_decisions_map, set_review_decisions_map] = useState({});
+    const review_decisions = review_decisions_map[instance_key] ?? EMPTY_REVIEW_DECISIONS;
+    const set_review_decisions = useCallback((setter) => {
+        set_review_decisions_map((prev) => {
+            const current = prev[instance_key] ?? new Map();
+            const next = typeof setter === 'function' ? setter(current) : setter;
+            return { ...prev, [instance_key]: next };
+        });
+    }, [instance_key]);
+    // Ignored file IDs — per-instance (files where agent chose "dismiss_ignore")
+    const [ignored_map, set_ignored_map] = useState({});
+    const ignored_file_ids = ignored_map[instance_key] ?? EMPTY_STRING_SET;
+    const set_ignored_file_ids = useCallback((setter) => {
+        set_ignored_map((prev) => {
+            const current = prev[instance_key] ?? new Set();
+            const next = typeof setter === 'function' ? setter(current) : setter;
+            return { ...prev, [instance_key]: next };
+        });
+    }, [instance_key]);
+    // Skipped file IDs — per-instance (files where agent chose "skip_process")
+    const [skipped_map, set_skipped_map] = useState({});
+    const skipped_file_ids = skipped_map[instance_key] ?? EMPTY_STRING_SET;
+    const set_skipped_file_ids = useCallback((setter) => {
+        set_skipped_map((prev) => {
+            const current = prev[instance_key] ?? new Set();
+            const next = typeof setter === 'function' ? setter(current) : setter;
+            return { ...prev, [instance_key]: next };
+        });
+    }, [instance_key]);
+    // Reset per-instance ephemeral state when switching instances
+    const prev_instance_id = useRef(active_instance_id);
+    useEffect(() => {
+        if (active_instance_id !== undefined && active_instance_id !== prev_instance_id.current) {
+            logger.info('[use_fb_form_state] instance_switch_reset', { from: prev_instance_id.current, to: active_instance_id });
+            prev_instance_id.current = active_instance_id;
+            set_active_tab_raw(props.initial_tab ?? 'front');
+            set_run_progress({ status: 'idle', total_steps: 0, completed_steps: 0 });
+            set_classification_results(props.classification_results ?? []);
+            set_classifying_file_ids(new Set());
+            set_queued_file_ids(new Set());
+            set_unassigned_files([]);
+            set_group_autofill_log({});
+            set_suggested_document_types([]);
+            set_validating_file_ids(new Set());
+            // draft_clarifications and file_validation_results are per-instance — no reset needed
+        }
+    }, [active_instance_id]);
+    // Read sent clarifications: per-instance in multi-instance mode, shared in single-instance
+    const sent_clarifications = useMemo(() => {
+        if (active_instance && active_instance_id && active_instance_id !== VIRTUAL_INSTANCE_ID) {
+            return active_instance.sent_clarifications ?? [];
+        }
+        // Single-instance fallback: read from shared back_form_data
+        const raw = props.back_form_data?.['__clarifications'];
+        return Array.isArray(raw) ? raw : [];
+    }, [active_instance, active_instance_id, props.back_form_data]);
+    // Auto-populate drafts from file_validation_results, deduplicating against sent items
+    useEffect(() => {
+        const all_errors = [];
+        for (const result of Object.values(file_validation_results)) {
+            if (result.errors && result.errors.length > 0) {
+                all_errors.push(...result.errors);
+            }
+        }
+        if (all_errors.length === 0) {
+            set_draft_clarifications((prev) => prev.length > 0 ? [] : prev);
+            return;
+        }
+        // Build dedup sets from already-sent clarifications
+        const sent_ids = new Set(sent_clarifications.map((c) => c.id));
+        const sent_keys = new Set(sent_clarifications
+            .filter((c) => c.rule_id && c.target_field_id)
+            .map((c) => `${c.rule_id}::${c.target_field_id}`));
+        // Filter out already-sent items (by id match OR by rule_id::target_field_id match)
+        const new_drafts = all_errors.filter((item) => {
+            // Direct ID match — this error was already sent
+            if (sent_ids.has(item.id))
+                return false;
+            // Composite key match — same rule + target was already sent (handles re-run with new IDs)
+            if (item.rule_id && item.target_field_id && sent_keys.has(`${item.rule_id}::${item.target_field_id}`))
+                return false;
+            return true;
+        });
+        // Only update if the set of draft IDs actually changed
+        set_draft_clarifications((prev) => {
+            const prev_ids = new Set(prev.map((d) => d.id));
+            const next_ids = new Set(new_drafts.map((d) => d.id));
+            if (prev_ids.size === next_ids.size && [...prev_ids].every((id) => next_ids.has(id)))
+                return prev;
+            return new_drafts;
+        });
+    }, [file_validation_results, sent_clarifications, set_draft_clarifications]);
+    const update_progress = useCallback((update) => {
+        set_run_progress((prev) => ({ ...prev, ...update }));
+    }, []);
+    const add_classifying_files = useCallback((file_ids) => {
+        set_classifying_file_ids((prev) => {
+            const next = new Set(prev);
+            for (const id of file_ids)
+                next.add(id);
+            return next;
+        });
+    }, []);
+    const remove_classifying_files = useCallback((file_ids) => {
+        set_classifying_file_ids((prev) => {
+            const next = new Set(prev);
+            for (const id of file_ids)
+                next.delete(id);
+            return next;
+        });
+    }, []);
+    const add_queued_files = useCallback((file_ids) => {
+        set_queued_file_ids((prev) => {
+            const next = new Set(prev);
+            for (const id of file_ids)
+                next.add(id);
+            return next;
+        });
+    }, []);
+    const remove_queued_files = useCallback((file_ids) => {
+        set_queued_file_ids((prev) => {
+            const next = new Set(prev);
+            for (const id of file_ids)
+                next.delete(id);
+            return next;
+        });
+    }, []);
+    // Files currently being autofilled (for spinner display on file chips)
+    const [autofilling_file_ids, set_autofilling_file_ids] = useState(new Set());
+    return {
+        active_tab,
+        set_active_tab,
+        run_progress,
+        set_run_progress,
+        update_progress,
+        classification_results,
+        set_classification_results,
+        classifying_file_ids,
+        add_classifying_files,
+        remove_classifying_files,
+        queued_file_ids,
+        add_queued_files,
+        remove_queued_files,
+        unassigned_files,
+        set_unassigned_files,
+        group_autofill_log,
+        set_group_autofill_log,
+        file_validation_results,
+        set_file_validation_results,
+        suggested_document_types,
+        set_suggested_document_types,
+        draft_clarifications,
+        set_draft_clarifications,
+        sent_clarifications,
+        manual_review_file_ids,
+        set_manual_review_file_ids,
+        validating_file_ids,
+        set_validating_file_ids,
+        review_decisions,
+        set_review_decisions,
+        ignored_file_ids,
+        set_ignored_file_ids,
+        skipped_file_ids,
+        set_skipped_file_ids,
+        autofilling_file_ids,
+        set_autofilling_file_ids,
+    };
+}
+//# sourceMappingURL=use_fb_form_state.js.map

package/dist/components/hazo_fb_form/hooks/use_fb_form_state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_fb_form_state.js","sourceRoot":"","sources":["../../../../src/components/hazo_fb_form/hooks/use_fb_form_state.ts"],"names":[],"mappings":"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"}

package/dist/components/hazo_fb_form/hooks/use_llm_run.d.ts

@@ -0,0 +1,46 @@
+/**
+ * LLM "Run" pipeline hook - handles per-file classification + file routing to back-office.
+ *
+ * After classification, files are routed to matching back-office groups by tag_id,
+ * then autofill is triggered automatically on each group.
+ */
+import type { HazoFbFormProps, FbRunProgress, FbClassificationResult, FbRunMode, FbUnassignedFile, FbGroupAutofillLog, FbFileValidationResult } from '../types.js';
+import type { ClarificationItem } from '../../../types/clarification.js';
+interface UseLlmRunOptions {
+    props: HazoFbFormProps;
+    update_progress: (update: Partial<FbRunProgress>) => void;
+    classification_results: FbClassificationResult[];
+    set_classification_results: (results: FbClassificationResult[] | ((prev: FbClassificationResult[]) => FbClassificationResult[])) => void;
+    set_active_tab: (tab: import('../types.js').FbTabId) => void;
+    add_classifying_files: (file_ids: string[]) => void;
+    remove_classifying_files: (file_ids: string[]) => void;
+    add_queued_files: (file_ids: string[]) => void;
+    remove_queued_files: (file_ids: string[]) => void;
+    set_unassigned_files: (files: FbUnassignedFile[]) => void;
+    set_group_autofill_log: (value: Record<string, FbGroupAutofillLog> | ((prev: Record<string, FbGroupAutofillLog>) => Record<string, FbGroupAutofillLog>)) => void;
+    set_file_validation_results: (value: Record<string, FbFileValidationResult> | ((prev: Record<string, FbFileValidationResult>) => Record<string, FbFileValidationResult>)) => void;
+    /** File IDs that should skip validation and be marked as manual_review */
+    manual_review_file_ids: Set<string>;
+    /** Sent/responded clarifications for detecting user-resolved rules */
+    sent_clarifications: ClarificationItem[];
+    /** Pending clarification responses (not yet flushed via submit) */
+    pending_clarification_responses: Map<string, import('../../../types/clarification.js').ClarificationResponse>;
+    /** Draft clarifications (from current validation run) */
+    draft_clarifications: ClarificationItem[];
+    /** Current file validation results (for trigger_complete eligibility check) */
+    file_validation_results: Record<string, FbFileValidationResult>;
+    /** Setter for autofilling file IDs (spinner display) */
+    set_autofilling_file_ids: React.Dispatch<React.SetStateAction<Set<string>>>;
+    /** Setter for validating file IDs (status display) */
+    set_validating_file_ids: React.Dispatch<React.SetStateAction<Set<string>>>;
+}
+export declare function use_llm_run({ props, update_progress, classification_results, set_classification_results, set_active_tab, add_classifying_files, remove_classifying_files, add_queued_files, remove_queued_files, set_unassigned_files, set_group_autofill_log, set_file_validation_results, manual_review_file_ids, sent_clarifications, pending_clarification_responses, draft_clarifications, file_validation_results, set_autofilling_file_ids, set_validating_file_ids }: UseLlmRunOptions): {
+    trigger_run: (mode?: FbRunMode) => Promise<void>;
+    trigger_complete: () => Promise<void>;
+    trigger_classify_file: (field_id: string, file_id: string, file_name: string) => Promise<void>;
+    trigger_assign_file: (file_id: string, tag_id: string) => Promise<void>;
+    route_skipped_files: (file_ids: string[]) => Promise<void>;
+    trigger_backoffice_run: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=use_llm_run.d.ts.map

package/dist/components/hazo_fb_form/hooks/use_llm_run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_llm_run.d.ts","sourceRoot":"","sources":["../../../../src/components/hazo_fb_form/hooks/use_llm_run.ts"],"names":[],"mappings":"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"}