@doclo/providers-llm 0.1.8 → 0.1.9

package/dist/index.d.ts

@@ -134,6 +134,27 @@ interface LLMDerivedOptions {
     maxChunkSize?: number;
     /** Language hints for the document */
     languageHints?: string[];
+    /**
+     * Normalize date fields to ISO 8601 format (YYYY-MM-DD)
+     * When enabled, date fields in the extraction output will be formatted consistently.
+     * Native support: Extend.ai (extend:type: "date")
+     * LLM support: Via prompting
+     */
+    dateNormalization?: boolean;
+    /**
+     * Normalize currency fields to { amount: number, currency: string } objects
+     * When enabled, monetary values are extracted as structured objects with ISO 4217 currency codes.
+     * Native support: Extend.ai (extend:type: "currency")
+     * LLM support: Via prompting
+     */
+    currencyNormalization?: boolean;
+    /**
+     * Detect and extract signature fields from documents
+     * When enabled, signature presence is detected and locations are reported.
+     * Native support: Extend.ai (extend:type: "signature"), Reducto
+     * LLM support: Via prompting (less reliable)
+     */
+    signatureDetection?: boolean;
 }
 /**
  * Extracted metadata from LLM response (populated when derived options are enabled)
@@ -160,6 +181,25 @@ interface LLMExtractedMetadata {
         text: string;
         pages: number[];
     }>;
+    /** Detected signatures with location and confidence */
+    signatures?: Array<{
+        field: string;
+        detected: boolean;
+        bbox?: [number, number, number, number];
+        page?: number;
+        confidence?: number;
+    }>;
+    /** Normalized currency values (original → normalized mapping) */
+    normalizedCurrencies?: Record<string, {
+        original: string;
+        amount: number;
+        currency: string;
+    }>;
+    /** Normalized date values (original → normalized mapping) */
+    normalizedDates?: Record<string, {
+        original: string;
+        normalized: string;
+    }>;
 }
 /** Provider interface */
 interface LLMProvider {
@@ -457,7 +497,8 @@ declare class OpenAIProvider implements LLMProvider {
     private limits;
     constructor(config: ProviderConfig);
     completeJson<T>(params: {
-        input: MultimodalInput;
+        input?: MultimodalInput;
+        prompt?: MultimodalInput | string;
         schema?: UnifiedSchema<T>;
         mode?: JsonMode;
         max_tokens?: number;
@@ -482,7 +523,8 @@ declare class AnthropicProvider implements LLMProvider {
     private limits;
     constructor(config: ProviderConfig);
     completeJson<T>(params: {
-        input: MultimodalInput;
+        input?: MultimodalInput;
+        prompt?: MultimodalInput | string;
         schema?: UnifiedSchema<T>;
         mode?: JsonMode;
         max_tokens?: number;
@@ -550,7 +592,8 @@ declare class XAIProvider implements LLMProvider {
     private limits;
     constructor(config: ProviderConfig);
     completeJson<T>(params: {
-        input: MultimodalInput;
+        input?: MultimodalInput;
+        prompt?: MultimodalInput | string;
         schema?: UnifiedSchema<T>;
         mode?: JsonMode;
         max_tokens?: number;

package/dist/index.js

@@ -343,25 +343,30 @@ var OpenAIProvider = class {
   }
   async completeJson(params) {
     const startTime = Date.now();
+    const rawInput = params.input ?? params.prompt;
+    if (!rawInput) {
+      throw new Error("Either input or prompt must be provided");
+    }
+    const normalizedInput = typeof rawInput === "string" ? { text: rawInput } : rawInput;
     const mode = params.mode || (params.schema ? "strict" : "relaxed");
     if (mode === "strict" && !params.schema) {
       throw new Error('schema is required when mode is "strict"');
     }
     const extractMetadata = shouldExtractMetadata(params.derivedOptions);
     const shouldEmbedSchema = params.embedSchemaInPrompt !== false && params.schema;
-    let enhancedInput = params.input;
+    let enhancedInput = normalizedInput;
     if (shouldEmbedSchema) {
       const jsonSchema = this.translator.convertZodIfNeeded(params.schema);
       const enhancedText = params.derivedOptions ? combineSchemaUserAndDerivedPrompts(
         jsonSchema,
-        params.input.text || "",
+        normalizedInput.text || "",
         params.derivedOptions
       ) : combineSchemaAndUserPrompt(
         jsonSchema,
-        params.input.text || ""
+        normalizedInput.text || ""
       );
       enhancedInput = {
-        ...params.input,
+        ...normalizedInput,
         text: enhancedText
       };
     } else if (params.derivedOptions) {
@@ -369,8 +374,8 @@ var OpenAIProvider = class {
       const derivedPrompt = buildLLMDerivedFeaturesPrompt2(params.derivedOptions);
       if (derivedPrompt) {
         enhancedInput = {
-          ...params.input,
-          text: (params.input.text || "") + "\n\n" + derivedPrompt
+          ...normalizedInput,
+          text: (normalizedInput.text || "") + "\n\n" + derivedPrompt
         };
       }
     }
@@ -596,25 +601,30 @@ var AnthropicProvider = class {
   }
   async completeJson(params) {
     const startTime = Date.now();
+    const rawInput = params.input ?? params.prompt;
+    if (!rawInput) {
+      throw new Error("Either input or prompt must be provided");
+    }
+    const normalizedInput = typeof rawInput === "string" ? { text: rawInput } : rawInput;
     const mode = params.mode || (params.schema ? "strict" : "relaxed");
     if (mode === "strict" && !params.schema) {
       throw new Error('schema is required when mode is "strict"');
     }
     const extractMetadata = shouldExtractMetadata(params.derivedOptions);
     const shouldEmbedSchema = params.embedSchemaInPrompt !== false && params.schema;
-    let enhancedInput = params.input;
+    let enhancedInput = normalizedInput;
     if (shouldEmbedSchema) {
       const jsonSchema = this.translator.convertZodIfNeeded(params.schema);
       const enhancedText = params.derivedOptions ? combineSchemaUserAndDerivedPrompts(
         jsonSchema,
-        params.input.text || "",
+        normalizedInput.text || "",
         params.derivedOptions
       ) : combineSchemaAndUserPrompt(
         jsonSchema,
-        params.input.text || ""
+        normalizedInput.text || ""
       );
       enhancedInput = {
-        ...params.input,
+        ...normalizedInput,
         text: enhancedText
       };
     } else if (params.derivedOptions) {
@@ -622,8 +632,8 @@ var AnthropicProvider = class {
       const derivedPrompt = buildLLMDerivedFeaturesPrompt2(params.derivedOptions);
       if (derivedPrompt) {
         enhancedInput = {
-          ...params.input,
-          text: (params.input.text || "") + "\n\n" + derivedPrompt
+          ...normalizedInput,
+          text: (normalizedInput.text || "") + "\n\n" + derivedPrompt
         };
       }
     }
@@ -1596,25 +1606,30 @@ var XAIProvider = class {
   }
   async completeJson(params) {
     const startTime = Date.now();
+    const rawInput = params.input ?? params.prompt;
+    if (!rawInput) {
+      throw new Error("Either input or prompt must be provided");
+    }
+    const normalizedInput = typeof rawInput === "string" ? { text: rawInput } : rawInput;
     const mode = params.mode || (params.schema ? "strict" : "relaxed");
     if (mode === "strict" && !params.schema) {
       throw new Error('schema is required when mode is "strict"');
     }
     const extractMetadata = shouldExtractMetadata(params.derivedOptions);
     const shouldEmbedSchema = params.embedSchemaInPrompt !== false && params.schema;
-    let enhancedInput = params.input;
+    let enhancedInput = normalizedInput;
     if (shouldEmbedSchema) {
       const jsonSchema = this.translator.convertZodIfNeeded(params.schema);
       const enhancedText = params.derivedOptions ? combineSchemaUserAndDerivedPrompts(
         jsonSchema,
-        params.input.text || "",
+        normalizedInput.text || "",
         params.derivedOptions
       ) : combineSchemaAndUserPrompt(
         jsonSchema,
-        params.input.text || ""
+        normalizedInput.text || ""
       );
       enhancedInput = {
-        ...params.input,
+        ...normalizedInput,
         text: enhancedText
       };
     } else if (params.derivedOptions) {
@@ -1622,8 +1637,8 @@ var XAIProvider = class {
       const derivedPrompt = buildLLMDerivedFeaturesPrompt2(params.derivedOptions);
       if (derivedPrompt) {
         enhancedInput = {
-          ...params.input,
-          text: (params.input.text || "") + "\n\n" + derivedPrompt
+          ...normalizedInput,
+          text: (normalizedInput.text || "") + "\n\n" + derivedPrompt
         };
       }
     }