@doclo/core 0.1.7 → 0.1.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Doclo AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as ProviderVendor, A as AccessMethod } from './validation-BvBAy3nC.js';
-export { G as AggregatedMetrics, B as BBox, r as CategorizeNodeConfig, t as ChunkMetadata, v as ChunkNodeConfig, u as ChunkOutput, n as CitationConfig, k as CitationSourceType, w as CombineNodeConfig, U as CompatibilityRule, C as ConsensusConfig, e as ConsensusMetadata, d as ConsensusRunResult, D as DocumentIR, b as DocumentIRExtras, y as EnhancedExtractionSchema, s as ExtractInputMode, E as ExtractNodeConfig, a0 as ExtractedImage, m as FieldCitation, F as FieldVotingDetails, H as FlowContext, a7 as FlowExecutionError, h as FlowInput, i as FlowInputValidation, j as FlowResult, a8 as FlowValidationError, I as IRLine, a as IRPage, X as JSONSchemaNode, c as LLMJsonProvider, L as LLMProvider, _ as LanguageOptions, l as LineCitation, g as MaybeWithConsensusMetadata, M as MultimodalInput, a9 as NODE_COMPATIBILITY_MATRIX, J as NodeCtx, Q as NodeDef, K as NodeTypeInfo, T as NodeTypeName, N as NormalizedBBox, O as OCRProvider, a1 as OCRProviderOptions, x as OutputNodeConfig, o as OutputWithCitations, f as OutputWithConsensus, Z as PageRangeOptions, p as ParseNodeConfig, Y as ProcessingMode, a3 as ProviderCitation, ak as ProviderIdentity, ai as RESERVED_VARIABLES, R as ReasoningConfig, $ as SegmentationResult, S as SplitDocument, q as SplitNodeConfig, z as StepMetric, V as VLMProvider, a2 as VLMProviderOptions, W as ValidationResult, a4 as aggregateMetrics, ag as canStartForEachItemFlow, ao as createIdentity, ac as getCompatibleTargets, ab as getNodeTypeInfo, aa as getNodeTypeName, ad as getSuggestedConnections, af as getValidForEachStarters, an as isLocalEndpoint, a5 as node, am as parseProviderString, aj as protectReservedVariables, a6 as runPipeline, al as toProviderString, ah as validateJson, ae as validateNodeConnection } from './validation-BvBAy3nC.js';
+import { P as ProviderVendor, A as AccessMethod } from './validation-WrnG3UMe.js';
+export { G as AggregatedMetrics, B as BBox, r as CategorizeNodeConfig, t as ChunkMetadata, v as ChunkNodeConfig, u as ChunkOutput, n as CitationConfig, k as CitationSourceType, w as CombineNodeConfig, U as CompatibilityRule, C as ConsensusConfig, e as ConsensusMetadata, d as ConsensusRunResult, D as DocumentIR, b as DocumentIRExtras, y as EnhancedExtractionSchema, s as ExtractInputMode, E as ExtractNodeConfig, a0 as ExtractedImage, m as FieldCitation, F as FieldVotingDetails, H as FlowContext, a8 as FlowExecutionError, h as FlowInput, i as FlowInputValidation, j as FlowResult, a4 as FlowStepLocation, a9 as FlowValidationError, I as IRLine, a as IRPage, X as JSONSchemaNode, c as LLMJsonProvider, L as LLMProvider, _ as LanguageOptions, l as LineCitation, g as MaybeWithConsensusMetadata, M as MultimodalInput, aa as NODE_COMPATIBILITY_MATRIX, J as NodeCtx, Q as NodeDef, K as NodeTypeInfo, T as NodeTypeName, N as NormalizedBBox, O as OCRProvider, a1 as OCRProviderOptions, x as OutputNodeConfig, o as OutputWithCitations, f as OutputWithConsensus, Z as PageRangeOptions, p as ParseNodeConfig, Y as ProcessingMode, a3 as ProviderCitation, am as ProviderIdentity, aj as RESERVED_VARIABLES, R as ReasoningConfig, $ as SegmentationResult, S as SplitDocument, q as SplitNodeConfig, z as StepMetric, V as VLMProvider, a2 as VLMProviderOptions, W as ValidationResult, a5 as aggregateMetrics, ah as canStartForEachItemFlow, aq as createIdentity, al as extractErrorMessage, ad as getCompatibleTargets, ac as getNodeTypeInfo, ab as getNodeTypeName, ae as getSuggestedConnections, ag as getValidForEachStarters, ap as isLocalEndpoint, a6 as node, ao as parseProviderString, ak as protectReservedVariables, a7 as runPipeline, an as toProviderString, ai as validateJson, af as validateNodeConnection } from './validation-WrnG3UMe.js';
 export { getDocumentPageCount, getPDFPageCount, getPageCountMetadata, getTotalPageCount, splitPDFIntoChunks } from './pdf-utils.js';
 
 /**
@@ -161,7 +161,7 @@ type BaseProviderConfig = {
  */
 type VLMProviderConfig = BaseProviderConfig & {
     type: 'vlm';
-    provider: 'openai' | 'anthropic' | 'google' | 'xai';
+    provider: 'openai' | 'anthropic' | 'google' | 'xai' | 'generic-or';
     model: string;
     via?: 'openrouter' | 'native';
     baseUrl?: string;

package/dist/index.js

@@ -50,8 +50,34 @@ async function runPipeline(steps, input, observabilityContext, flowArtifacts) {
   }
   return { output: acc, artifacts, metrics };
 }
+function extractErrorMessage(errorText) {
+  if (errorText.length < 10 || !errorText.trim().startsWith("{")) {
+    return errorText;
+  }
+  try {
+    const parsed = JSON.parse(errorText);
+    if (parsed.detail) {
+      return parsed.detail;
+    }
+    if (parsed.error?.message) {
+      return parsed.error.message;
+    }
+    if (typeof parsed.error === "string") {
+      return parsed.error;
+    }
+    if (parsed.message) {
+      return parsed.message;
+    }
+    if (parsed.error?.status && parsed.error?.message) {
+      return `${parsed.error.status}: ${parsed.error.message}`;
+    }
+    return errorText.length > 200 ? errorText.substring(0, 200) + "..." : errorText;
+  } catch {
+    return errorText.length > 500 ? errorText.substring(0, 500) + "..." : errorText;
+  }
+}
 var FlowExecutionError = class _FlowExecutionError extends Error {
-  constructor(message, failedStep, failedStepIndex, failedStepType, completedSteps, originalError, partialArtifacts) {
+  constructor(message, failedStep, failedStepIndex, failedStepType, completedSteps, originalError, partialArtifacts, flowPath, allCompletedSteps) {
     super(message);
     this.failedStep = failedStep;
     this.failedStepIndex = failedStepIndex;
@@ -59,11 +85,43 @@ var FlowExecutionError = class _FlowExecutionError extends Error {
     this.completedSteps = completedSteps;
     this.originalError = originalError;
     this.partialArtifacts = partialArtifacts;
+    this.flowPath = flowPath;
+    this.allCompletedSteps = allCompletedSteps;
     this.name = "FlowExecutionError";
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, _FlowExecutionError);
     }
   }
+  /**
+   * Returns a formatted string showing the execution path.
+   * Example: "parse → conditional:Invoice → extract"
+   */
+  getFormattedPath() {
+    if (!this.flowPath || this.flowPath.length === 0) {
+      return this.failedStep;
+    }
+    return this.flowPath.map((loc) => {
+      let label = loc.stepId;
+      if (loc.branch) {
+        label += `:${loc.branch}`;
+      }
+      if (loc.itemIndex !== void 0) {
+        label += `[${loc.itemIndex}]`;
+      }
+      return label;
+    }).join(" \u2192 ");
+  }
+  /**
+   * Returns the root cause error (innermost originalError).
+   * Useful when errors are nested multiple levels deep.
+   */
+  getRootCause() {
+    let cause = this.originalError;
+    while (cause instanceof _FlowExecutionError && cause.originalError) {
+      cause = cause.originalError;
+    }
+    return cause;
+  }
 };
 var FlowValidationError = class _FlowValidationError extends Error {
   constructor(message, reason, suggestions, sourceNode, targetNode, sourceOutputType, targetInputTypes) {
@@ -2253,6 +2311,7 @@ export {
   detectMimeTypeFromBase64Async,
   detectMimeTypeFromBytes,
   extractBase64,
+  extractErrorMessage,
   getAllModels,
   getAllProviders,
   getCheapestProviderFor,