hazo_collab_forms 3.1.6 → 5.0.0

package/dist/components/thread_form/utils/file_decision_state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_decision_state.js","sourceRoot":"","sources":["../../../../src/components/thread_form/utils/file_decision_state.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,YAAoD,EACpD,iBAAyC;IAEzC,MAAM,OAAO,GAAG,YAAY,IAAI,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEjE,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,aAAa,GAAG,IAAI,CAAC;YACrB,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;aAAM,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,WAAW;QACb,CAAC;aAAM,CAAC;YACN,UAAU;YACV,YAAY,GAAG,KAAK,CAAC;YACrB,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,YAAY,IAAI,CAAC,aAAa;QACxC,SAAS,EAAE,aAAa;QACxB,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/components/thread_form/utils/merge_send_back.d.ts

@@ -0,0 +1,13 @@
+import type { ThreadTask, ThreadMessage } from '../types.js';
+/**
+ * Decide where a new send_back message should land in the form's tasks array.
+ *
+ * If there is already an open clarifications task (one whose `parent_task_id`
+ * matches and whose `status !== 'completed'`), append the message to that task.
+ * Otherwise, ask the caller to build a fresh clarifications task and append it
+ * to the array.
+ *
+ * Pure: returns a new array; never mutates the input.
+ */
+export declare function merge_send_back_message(tasks: ThreadTask[], parent_task_id: string, new_msg: ThreadMessage, build_new_task: (msg: ThreadMessage) => ThreadTask): ThreadTask[];
+//# sourceMappingURL=merge_send_back.d.ts.map

package/dist/components/thread_form/utils/merge_send_back.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge_send_back.d.ts","sourceRoot":"","sources":["../../../../src/components/thread_form/utils/merge_send_back.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EAAE,EACnB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,aAAa,EACtB,cAAc,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,UAAU,GACjD,UAAU,EAAE,CAed"}

package/dist/components/thread_form/utils/merge_send_back.js

@@ -0,0 +1,23 @@
+/**
+ * Decide where a new send_back message should land in the form's tasks array.
+ *
+ * If there is already an open clarifications task (one whose `parent_task_id`
+ * matches and whose `status !== 'completed'`), append the message to that task.
+ * Otherwise, ask the caller to build a fresh clarifications task and append it
+ * to the array.
+ *
+ * Pure: returns a new array; never mutates the input.
+ */
+export function merge_send_back_message(tasks, parent_task_id, new_msg, build_new_task) {
+    const existing_index = tasks.findIndex(t => t.parent_task_id === parent_task_id && t.status !== 'completed');
+    if (existing_index === -1) {
+        return [...tasks, build_new_task(new_msg)];
+    }
+    const existing = tasks[existing_index];
+    const updated = {
+        ...existing,
+        thread: [...existing.thread, new_msg],
+    };
+    return tasks.map((t, i) => (i === existing_index ? updated : t));
+}
+//# sourceMappingURL=merge_send_back.js.map

package/dist/components/thread_form/utils/merge_send_back.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge_send_back.js","sourceRoot":"","sources":["../../../../src/components/thread_form/utils/merge_send_back.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAmB,EACnB,cAAsB,EACtB,OAAsB,EACtB,cAAkD;IAElD,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,CACpC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,cAAc,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CACrE,CAAC;IAEF,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,OAAO,GAAe;QAC1B,GAAG,QAAQ;QACX,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;KACtC,CAAC;IACF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/lib/autofill_handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autofill_handler.d.ts","sourceRoot":"","sources":["../../src/lib/autofill_handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,aAAa,CAAC;AAQrB,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAErD;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAErD;;;OAGG;IACH,kBAAkB,EAAE;QAClB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAClD,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACzC,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,GAAG,OAAO,CAAC;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnF,CAAC;IAEF;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE5G;;OAEG;IACH,gBAAgB,CAAC,EAAE;QACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC,CAAC;QAClF,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5E,OAAO,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACrG,CAAC;CACH;AAwED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,IA2BtC,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAyIhE"}
+{"version":3,"file":"autofill_handler.d.ts","sourceRoot":"","sources":["../../src/lib/autofill_handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,aAAa,CAAC;AAQrB,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAErD;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAErD;;;OAGG;IACH,kBAAkB,EAAE;QAClB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAClD,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACzC,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,GAAG,OAAO,CAAC;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnF,CAAC;IAEF;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE5G;;OAEG;IACH,gBAAgB,CAAC,EAAE;QACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC,CAAC;QAClF,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5E,OAAO,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACrG,CAAC;CACH;AA6DD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,IAKtC,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAkIhE"}

package/dist/lib/autofill_handler.js

@@ -63,19 +63,6 @@ function build_field_list_string(fields) {
         return desc;
     }).join('\n');
 }
-/** Check if extraction data is effectively empty (all values null/undefined/empty). */
-function is_empty_data(data) {
-    const values = Object.values(data);
-    if (values.length === 0)
-        return true;
-    return values.every((v) => {
-        if (v === null || v === undefined || v === '')
-            return true;
-        if (Array.isArray(v) && v.length === 0)
-            return true;
-        return false;
-    });
-}
 // ============================================================================
 // Route Handler Factory
 // ============================================================================
@@ -94,26 +81,6 @@ export function create_autofill_route(options) {
     const { extraction_service, metadata_service } = options;
     const file_resolver = options.file_resolver;
     const on_error = options.on_error ?? ((err, ctx) => console.error(`[autofill] ${ctx}:`, err));
-    /**
-     * Generate a default extraction prompt from field schemas.
-     * Used as fallback when prompt lookup fails.
-     */
-    function generate_default_prompt(fields) {
-        const field_list = build_field_list_string(fields);
-        return `Extract the following fields from this document and return ONLY valid JSON (no markdown, no explanation).
-
-Fields to extract:
-${field_list}
-
-Return a JSON object where keys are the field IDs shown in quotes above.
-For numeric fields, return the value as a string (e.g., "1234.56").
-For checkbox fields, return true or false.
-For date fields, return the date in YYYY-MM-DD format.
-For data table fields, return an array of row objects where each key matches a column ID.
-If a field cannot be found in the document, omit it from the response.
-
-Return ONLY the JSON object, no other text.`;
-    }
     return async function POST(request) {
         try {
             const body = await request.json();
@@ -161,18 +128,15 @@ Return ONLY the JSON object, no other text.`;
             // Build field_list string for prompt variable substitution
             const field_list = build_field_list_string(fields);
             const buffer = Buffer.from(file_b64, 'base64');
-            // Try prompt-based extraction
-            let result = await extraction_service.extract(buffer, mime_type, {
+            // Prompt-based extraction. The prompt MUST exist in hazo_prompts —
+            // there is no hardcoded fallback. If extraction fails or returns empty,
+            // surface that to the caller rather than silently retrying with a
+            // generated prompt (which would mask missing/broken DB prompts).
+            const result = await extraction_service.extract(buffer, mime_type, {
                 promptArea: prompt_area,
                 promptKey: prompt_key,
                 promptVariables: { field_list },
             });
-            // Fallback: generated default prompt
-            if (!result.success || !result.data || is_empty_data(result.data)) {
-                result = await extraction_service.extract(buffer, mime_type, {
-                    customPrompt: generate_default_prompt(fields),
-                });
-            }
             // Persist extraction to hazo_files
             if (result.success && result.data && metadata_service && body.file_id) {
                 try {
@@ -213,9 +177,6 @@ Return ONLY the JSON object, no other text.`;
                     prompt_area,
                     prompt_key,
                     resolved_prompt,
-                    fallback_prompt_used: (!resolved_prompt)
-                        ? generate_default_prompt(fields)
-                        : undefined,
                 },
             });
         }

package/dist/lib/autofill_handler.js.map

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

package/dist/lib/classification_handler.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Server-side classification route handler factory.
+ *
+ * Creates a POST handler that classifies uploaded documents via LLM analysis,
+ * returning document type, tags, confidence, and optional metadata.
+ *
+ * Usage:
+ *   import { create_classification_route } from 'hazo_collab_forms/lib';
+ *   export const POST = create_classification_route({ hazo_connect_adapter: getHazoConnect() });
+ *
+ * Uses standard Web API Request/Response for portability.
+ * hazo_llm_api is dynamically imported so it's only required at runtime.
+ */
+import 'server-only';
+export interface ClassificationRouteOptions {
+    /** Path to SQLite database for prompt library */
+    sqlite_path?: string;
+    /** Pre-configured hazo_connect adapter (takes precedence over sqlite_path) */
+    hazo_connect_adapter?: unknown;
+    /** Error handler */
+    on_error?: (err: unknown, ctx: string) => void;
+    /**
+     * prompt_area for the classification prompt lookup. Default: 'document'.
+     */
+    prompt_area?: string;
+    /**
+     * prompt_key for the classification prompt lookup. Default: 'classification'.
+     */
+    prompt_key?: string;
+}
+export interface ClassificationDocumentType {
+    type_id: string;
+    type_label: string;
+    description?: string;
+}
+export interface ClassificationAllowedTag {
+    tag_id: string;
+    tag_label: string;
+    description?: string;
+}
+export interface ClassificationRequest {
+    file_b64: string;
+    file_name: string;
+    mime_type: string;
+    /**
+     * Optional allow-list of document types. When provided, the LLM is
+     * instructed to choose exactly one type_id from this list (or 'unknown'
+     * if nothing fits). Substituted into the prompt as {{document_types}} and
+     * {{document_type}} (the prompt uses both forms).
+     */
+    document_types?: ClassificationDocumentType[];
+    /**
+     * Optional allow-list of classification tags. When provided, the LLM is
+     * instructed to use only these tag_ids. Rendered into {{tag_list}}.
+     */
+    available_tags?: ClassificationAllowedTag[];
+    /**
+     * Optional pre-rendered tag-list string. Takes precedence over
+     * available_tags if both are supplied.
+     */
+    tag_list?: string;
+    /**
+     * Optional free-form client text to aid classification. Substituted into
+     * the prompt as {{client_text}}.
+     */
+    client_text?: string;
+}
+export interface ClassificationTagReason {
+    name: string;
+    reason: string;
+}
+export interface ClassificationResponse {
+    success: boolean;
+    document_type?: string;
+    tags?: string[];
+    /** Per-tag reasons from the LLM, preserved for debug/review. */
+    tag_reasons?: ClassificationTagReason[];
+    confidence?: number;
+    document_date?: string;
+    document_nature?: string;
+    /**
+     * Structured monetary fields lifted out of the document during classification —
+     * populated when the classification prompt asks for them (e.g. for invoice or
+     * receipt doc types). Used by the aggregate sum_match resolver to compare
+     * receipt totals against an expected amount.
+     */
+    extracted_fields?: {
+        total?: number;
+        date?: string;
+        vendor?: string;
+        property_address?: string;
+    };
+    error?: string;
+}
+/**
+ * Creates a POST route handler for document classification.
+ *
+ * The handler:
+ * 1. Validates the request payload
+ * 2. Sends the document to an LLM for classification
+ * 3. Parses the response into structured classification data
+ * 4. Returns the classification result
+ */
+export declare function create_classification_route(options?: ClassificationRouteOptions): (request: Request) => Promise<Response>;
+//# sourceMappingURL=classification_handler.d.ts.map

package/dist/lib/classification_handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification_handler.d.ts","sourceRoot":"","sources":["../../src/lib/classification_handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,aAAa,CAAC;AAQrB,MAAM,WAAW,0BAA0B;IACzC,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oBAAoB;IACpB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAC9C;;;OAGG;IACH,cAAc,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gEAAgE;IAChE,WAAW,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuLD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE,0BAA0B,IAyDnD,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CA2JhE"}

package/dist/lib/classification_handler.js

@@ -0,0 +1,342 @@
+/**
+ * Server-side classification route handler factory.
+ *
+ * Creates a POST handler that classifies uploaded documents via LLM analysis,
+ * returning document type, tags, confidence, and optional metadata.
+ *
+ * Usage:
+ *   import { create_classification_route } from 'hazo_collab_forms/lib';
+ *   export const POST = create_classification_route({ hazo_connect_adapter: getHazoConnect() });
+ *
+ * Uses standard Web API Request/Response for portability.
+ * hazo_llm_api is dynamically imported so it's only required at runtime.
+ */
+import 'server-only';
+import { get_config } from './config.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+function is_image_mime(mime_type) {
+    return mime_type.startsWith('image/');
+}
+function is_document_mime(mime_type) {
+    return mime_type === 'application/pdf';
+}
+/** Render the document-types list as a multi-line string for prompt substitution. */
+function render_document_types(list) {
+    if (!list || list.length === 0) {
+        return '(none — respond with "unknown" for document_type)';
+    }
+    return list.map(dt => {
+        const label = dt.type_label ?? dt.type_id;
+        const desc = dt.description ? ` — ${dt.description}` : '';
+        return `- ${dt.type_id}: ${label}${desc}`;
+    }).join('\n');
+}
+/** Render the allowed-tags list as a multi-line string for prompt substitution. */
+function render_tag_list(list) {
+    if (!list || list.length === 0) {
+        return '(no allow-list — return an empty tags array)';
+    }
+    return list.map(t => {
+        const label = t.tag_label ?? t.tag_id;
+        const desc = t.description ? ` — ${t.description}` : '';
+        return `- ${t.tag_id}: ${label}${desc}`;
+    }).join('\n');
+}
+/** Substitute {{var}} placeholders. Unknown variables are left as-is. */
+function substitute_variables(prompt, variables) {
+    return prompt.replace(/\{\{(\w+)\}\}/g, (_, key) => variables[key] ?? `{{${key}}}`);
+}
+/**
+ * Parse LLM response for classification results.
+ *
+ * The prompt asks for an array (one entry per file); for single-file
+ * classification we take the first entry.
+ */
+function parse_classification_response(text) {
+    const cleaned = text.trim();
+    const candidates = [cleaned];
+    const fence_match = cleaned.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fence_match)
+        candidates.push(fence_match[1].trim());
+    const array_match = cleaned.match(/\[[\s\S]*\]/);
+    if (array_match)
+        candidates.push(array_match[0]);
+    const object_match = cleaned.match(/\{[\s\S]*\}/);
+    if (object_match)
+        candidates.push(object_match[0]);
+    for (const candidate of candidates) {
+        try {
+            const parsed = JSON.parse(candidate);
+            const item = pick_first_entry(parsed);
+            if (item)
+                return extract_classification_fields(item);
+        }
+        catch {
+            // Try next candidate
+        }
+    }
+    return {
+        document_type: 'unknown',
+        tags: [],
+        tag_reasons: [],
+        confidence: 0,
+        document_nature: cleaned.slice(0, 200),
+    };
+}
+function pick_first_entry(parsed) {
+    if (Array.isArray(parsed)) {
+        return parsed[0] ?? null;
+    }
+    if (parsed && typeof parsed === 'object') {
+        return parsed;
+    }
+    return null;
+}
+function extract_classification_fields(parsed) {
+    const raw_tags = Array.isArray(parsed.tags) ? parsed.tags : [];
+    const tags = [];
+    const tag_reasons = [];
+    for (const t of raw_tags) {
+        if (typeof t === 'string') {
+            tags.push(t);
+        }
+        else if (t && typeof t === 'object') {
+            const name = String(t.name ?? '').trim();
+            if (!name)
+                continue;
+            tags.push(name);
+            const reason = t.reason;
+            if (typeof reason === 'string' && reason.trim()) {
+                tag_reasons.push({ name, reason: reason.trim() });
+            }
+        }
+    }
+    // document_type may come through as a string or a single-element array.
+    let document_type = 'unknown';
+    const raw_dt = parsed.document_type;
+    if (typeof raw_dt === 'string' && raw_dt.trim()) {
+        document_type = raw_dt.trim();
+    }
+    else if (Array.isArray(raw_dt) && raw_dt.length > 0 && typeof raw_dt[0] === 'string') {
+        document_type = raw_dt[0].trim() || 'unknown';
+    }
+    // confidence as decimal; if the LLM slips and returns a percent (>1.5), normalise.
+    let confidence = 0;
+    if (typeof parsed.confidence === 'number' && Number.isFinite(parsed.confidence)) {
+        confidence = parsed.confidence > 1.5 ? parsed.confidence / 100 : parsed.confidence;
+        if (confidence < 0)
+            confidence = 0;
+        if (confidence > 1)
+            confidence = 1;
+    }
+    const document_date = typeof parsed.document_date === 'string' && parsed.document_date.trim()
+        ? parsed.document_date.trim()
+        : undefined;
+    const document_nature = typeof parsed.document_nature === 'string' && parsed.document_nature.trim()
+        ? parsed.document_nature.trim()
+        : undefined;
+    // Structured fields — accept either a nested `extracted_fields` object or
+    // top-level keys for backward compatibility. Growing set: add new keys here
+    // as the prompt evolves. Missing keys stay undefined so downstream
+    // resolvers can detect "not extracted" cleanly.
+    let extracted_fields;
+    const ef_source = (parsed.extracted_fields && typeof parsed.extracted_fields === 'object')
+        ? parsed.extracted_fields
+        : parsed;
+    const total_raw = ef_source.total ?? ef_source.amount ?? ef_source.invoice_total;
+    const date_raw = ef_source.invoice_date ?? ef_source.receipt_date ?? (parsed.extracted_fields ? ef_source.date : undefined);
+    const vendor_raw = ef_source.vendor ?? ef_source.supplier ?? ef_source.payee;
+    const address_raw = ef_source.property_address ?? ef_source.address ?? ef_source.site_address;
+    let total;
+    if (typeof total_raw === 'number' && Number.isFinite(total_raw)) {
+        total = total_raw;
+    }
+    else if (typeof total_raw === 'string' && total_raw.trim()) {
+        const n = parseFloat(total_raw.replace(/[^\d.\-]/g, ''));
+        if (Number.isFinite(n))
+            total = n;
+    }
+    const date_str = typeof date_raw === 'string' && date_raw.trim() ? date_raw.trim() : undefined;
+    const vendor_str = typeof vendor_raw === 'string' && vendor_raw.trim() ? vendor_raw.trim() : undefined;
+    const address_str = typeof address_raw === 'string' && address_raw.trim() ? address_raw.trim() : undefined;
+    if (total !== undefined || date_str || vendor_str || address_str) {
+        extracted_fields = {
+            ...(total !== undefined ? { total } : {}),
+            ...(date_str ? { date: date_str } : {}),
+            ...(vendor_str ? { vendor: vendor_str } : {}),
+            ...(address_str ? { property_address: address_str } : {}),
+        };
+    }
+    return { document_type, tags, tag_reasons, confidence, document_date, document_nature, extracted_fields };
+}
+// ============================================================================
+// Route Handler Factory
+// ============================================================================
+/**
+ * Creates a POST route handler for document classification.
+ *
+ * The handler:
+ * 1. Validates the request payload
+ * 2. Sends the document to an LLM for classification
+ * 3. Parses the response into structured classification data
+ * 4. Returns the classification result
+ */
+export function create_classification_route(options) {
+    const sqlite_path = options?.sqlite_path ?? get_config('hazo_connect', 'prompt_sqlite_path') ?? 'data/prompt_library.sqlite';
+    const hazo_connect_adapter = options?.hazo_connect_adapter;
+    const on_error = options?.on_error ?? ((err, ctx) => console.error(`[classification] ${ctx}:`, err));
+    const prompt_area = options?.prompt_area ?? 'document';
+    const prompt_key = options?.prompt_key ?? 'classification';
+    // Cache the dynamic import
+    let llm_api_module = null;
+    let init_promise = null;
+    async function get_llm_api() {
+        if (!llm_api_module) {
+            try {
+                const module_id = 'hazo_llm_api/server';
+                llm_api_module = await import(/* webpackIgnore: true */ module_id);
+            }
+            catch {
+                throw new Error('hazo_llm_api is required for classification. Install it: npm install hazo_llm_api');
+            }
+        }
+        return llm_api_module;
+    }
+    async function ensure_initialized() {
+        const api = await get_llm_api();
+        if (!api.is_initialized()) {
+            if (!init_promise) {
+                const init_config = hazo_connect_adapter
+                    ? { hazo_connect_adapter }
+                    : { sqlite_path };
+                init_promise = api.initialize_llm_api(init_config).then(() => { });
+            }
+            await init_promise;
+        }
+    }
+    return async function POST(request) {
+        try {
+            const body = await request.json();
+            const { file_b64, file_name, mime_type, document_types, available_tags, tag_list, client_text } = body;
+            // Validate required fields
+            if (!file_b64 || !file_name || !mime_type) {
+                return Response.json({ success: false, error: 'file_b64, file_name, and mime_type are required' }, { status: 400 });
+            }
+            // Initialize LLM API
+            await ensure_initialized();
+            const api = await get_llm_api();
+            // Load prompt from hazo_prompts. No hardcoded fallback — error loudly so
+            // missing prompts get spotted in dev rather than silently using stale code.
+            const connect = api.get_hazo_connect?.() ?? null;
+            if (!connect) {
+                return Response.json({ success: false, error: 'hazo_llm_api hazo_connect is not available — cannot load prompts from hazo_prompts' }, { status: 500 });
+            }
+            const lookup = await connect.get_by_area_key(prompt_area, prompt_key);
+            const db_prompt = lookup.success ? lookup.data?.prompt_text_full : undefined;
+            if (!db_prompt) {
+                return Response.json({ success: false, error: `Prompt ${prompt_area}/${prompt_key} not found in hazo_prompts. Seed it before calling this route.` }, { status: 500 });
+            }
+            // The prompt uses a mix of {{document_types}} and {{document_type}} to
+            // mean the doc-types list; map both to the same rendered list.
+            const doc_types_text = render_document_types(document_types);
+            const tags_text = tag_list ?? render_tag_list(available_tags);
+            const prompt_text = substitute_variables(db_prompt, {
+                document_types: doc_types_text,
+                document_type: doc_types_text,
+                tag_list: tags_text,
+                client_text: client_text ?? '(none)',
+                // Single-file flow: synthesise a minimal file_list. The LLM still
+                // inspects the file contents; file_id is just a correlation key.
+                file_list: `- ${file_name}`,
+            });
+            // Call LLM based on mime type
+            let llm_response;
+            if (is_image_mime(mime_type)) {
+                llm_response = await api.hazo_llm_image_text({
+                    prompt: prompt_text,
+                    image_b64: file_b64,
+                    image_mime_type: mime_type,
+                });
+            }
+            else if (is_document_mime(mime_type)) {
+                llm_response = await api.hazo_llm_document_text({
+                    prompt: prompt_text,
+                    document_b64: file_b64,
+                    document_mime_type: mime_type,
+                });
+            }
+            else {
+                // Fallback: treat as image
+                llm_response = await api.hazo_llm_image_text({
+                    prompt: prompt_text,
+                    image_b64: file_b64,
+                    image_mime_type: mime_type,
+                });
+            }
+            if (!llm_response.success || !llm_response.text) {
+                return Response.json({ success: false, error: llm_response.error ?? 'LLM call failed' }, { status: 500 });
+            }
+            // Parse classification result
+            const result = parse_classification_response(llm_response.text);
+            // Enforce the document_types allow-list. The prompt instructs the LLM to
+            // pick from the list, but LLMs occasionally invent their own label (e.g.
+            // "property_statement" when only "rental_statement" is configured). When
+            // that happens, fall back to 'unknown' so downstream validation doesn't
+            // key off a type the rest of the system has never heard of.
+            let document_type = result.document_type;
+            if (document_types && document_types.length > 0 && document_type !== 'unknown') {
+                const allowed = new Set(document_types.map(d => d.type_id));
+                if (!allowed.has(document_type)) {
+                    on_error(new Error(`LLM returned document_type "${document_type}" which is not in the configured allow-list (${[...allowed].join(', ')}). Falling back to "unknown".`), 'document_type not in allow-list');
+                    document_type = 'unknown';
+                }
+            }
+            // Defensive warning — if the LLM came back "unknown" AND we never gave
+            // it an allow-list to choose from, that's almost certainly the root
+            // cause. Surface a clear hint so future debugging doesn't repeat the
+            // hazo_app_config-empty rabbit hole.
+            if (document_type === 'unknown' &&
+                result.confidence === 0 &&
+                (!document_types || document_types.length === 0)) {
+                const msg = `[classification_handler] document_type='unknown' with confidence=0 — and no document_types allow-list was passed. ` +
+                    `Likely cause: the consumer didn't provide \`available_document_types\` (or the underlying config table is empty). ` +
+                    `Populate the doc-types config (e.g. via the doc-type-editor page or a seed script) so the LLM has a list to choose from.`;
+                console.warn(msg);
+                on_error(new Error(msg), 'empty document_types allow-list');
+            }
+            // Enforce the tags allow-list when provided.
+            let tags = result.tags;
+            let tag_reasons = result.tag_reasons;
+            if (available_tags && available_tags.length > 0) {
+                const allowed_tags = new Set(available_tags.map(t => t.tag_id));
+                tags = tags.filter(t => allowed_tags.has(t));
+                tag_reasons = tag_reasons.filter(r => allowed_tags.has(r.name));
+            }
+            const response = {
+                success: true,
+                document_type,
+                tags,
+                tag_reasons,
+                confidence: result.confidence,
+                document_date: result.document_date,
+                document_nature: result.document_nature,
+                ...(result.extracted_fields ? { extracted_fields: result.extracted_fields } : {}),
+            };
+            // Debug: when extraction came back empty for an invoice/receipt-type doc,
+            // include the raw LLM text on the response so the consumer can inspect it
+            // in the Debug JSON dialog. Stripped on extraction success to keep
+            // payloads small.
+            if (!result.extracted_fields && (document_type === 'invoice' || document_type === 'receipt' || document_type === 'tax_invoice')) {
+                response._debug_llm_text = llm_response.text;
+            }
+            return Response.json(response);
+        }
+        catch (error) {
+            on_error(error, 'unhandled error');
+            return Response.json({ success: false, error: error instanceof Error ? error.message : 'Unknown error' }, { status: 500 });
+        }
+    };
+}
+//# sourceMappingURL=classification_handler.js.map