@windagency/valora 2.0.1

package/dist/executor/output-parsing.service.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Output Parsing Service
+ *
+ * Handles parsing and extraction of structured outputs from LLM responses.
+ * Extracted from StageExecutor to follow Single Responsibility Principle.
+ *
+ * Features:
+ * - JSON extraction from markdown code blocks
+ * - Fallback parsing for malformed JSON
+ * - Pattern matching for value extraction
+ * - Default value application for missing fields
+ */
+import { getLogger } from '../output/logger.js';
+type Logger = ReturnType<typeof getLogger>;
+/**
+ * Result of parsing stage outputs
+ */
+export interface ParsedOutputs {
+    /** Extracted output values */
+    outputs: Record<string, unknown>;
+    /** Whether parsing was successful */
+    success: boolean;
+    /** Method used for extraction */
+    method: 'fallback' | 'json' | 'pattern';
+}
+/**
+ * Service for parsing LLM outputs into structured data
+ */
+export declare class OutputParsingService {
+    private readonly logger;
+    constructor(logger?: Logger);
+    /**
+     * Parse stage outputs from completion content
+     */
+    parseStageOutputs(content: string, expectedOutputs: string[]): Record<string, unknown>;
+    /**
+     * Apply default values for missing expected outputs
+     */
+    applyDefaultValues(parsedOutputs: Record<string, unknown>, expectedOutputs: string[]): Record<string, unknown>;
+    /**
+     * Sanitize content by removing control characters and ANSI codes
+     */
+    private sanitizeContent;
+    /**
+     * Extract JSON content from markdown code blocks
+     *
+     * Handles:
+     * - Standard: ```json\n{...}\n```
+     * - No newline: ```json{...}```
+     * - No language: ```{...}```
+     * - Unclosed blocks: ```json{...} (no closing ```)
+     * - Multiple code blocks (takes first JSON one)
+     */
+    extractJsonFromCodeBlocks(content: string): string;
+    /**
+     * Get ordered list of code block patterns to try
+     */
+    private getCodeBlockPatterns;
+    /**
+     * Try to extract JSON using a specific pattern
+     */
+    private tryExtractWithPattern;
+    /**
+     * Try to extract from unclosed code block
+     */
+    private tryExtractUnclosedBlock;
+    /**
+     * Check if content looks like JSON (starts with { or [)
+     */
+    private looksLikeJson;
+    /**
+     * Fix common JSON formatting issues that LLMs often produce
+     */
+    fixCommonJsonIssues(jsonContent: string): string;
+    /**
+     * Extract missing outputs from nested JSON blocks in the content
+     */
+    private extractFromNestedJsonBlocks;
+    /**
+     * Process a single JSON block for missing outputs
+     */
+    private processJsonBlock;
+    /**
+     * Extract missing outputs from a parsed object
+     */
+    private extractMissingFromObject;
+    /**
+     * Extract missing outputs from nested objects within a parsed object
+     */
+    private extractFromNestedObjects;
+    /**
+     * Get a sensible default value for a missing output based on its name
+     */
+    private getDefaultValueForOutput;
+    /**
+     * Check if output name represents an object field
+     */
+    private isObjectField;
+    /**
+     * Check if output name represents a boolean field
+     */
+    private isBooleanField;
+    /**
+     * Check if output name represents an array field
+     */
+    private isArrayField;
+    /**
+     * Check if output name represents a count field
+     */
+    private isCountField;
+    /**
+     * Fallback extraction when JSON parsing fails
+     */
+    private fallbackExtraction;
+    /**
+     * Clean content for extraction by removing control characters
+     */
+    private cleanContentForExtraction;
+    /**
+     * Find JSON object in content
+     */
+    private findJsonObject;
+    /**
+     * Extract outputs from JSON content
+     */
+    private extractOutputsFromJson;
+    /**
+     * Extract a single output value from search targets
+     */
+    private extractSingleOutput;
+    /**
+     * Try to extract a value for a given key from content
+     */
+    private tryExtractValue;
+    /**
+     * Extract value based on its type
+     */
+    private extractValueByType;
+    /**
+     * Extract a string value from JSON content
+     */
+    private extractStringValue;
+    /**
+     * Unescape JSON string escape sequences
+     */
+    private unescapeJsonString;
+    /**
+     * Extract a JSON value (object, array, or primitive) using a regex pattern
+     */
+    private extractJsonValue;
+    /**
+     * Fill missing outputs using pattern matching as a last resort
+     */
+    private fillMissingOutputsWithPatternMatching;
+    /**
+     * Try to extract a value using simple pattern matching
+     */
+    private tryPatternMatching;
+}
+/**
+ * Get the singleton OutputParsingService instance
+ */
+export declare function getOutputParsingService(): OutputParsingService;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetOutputParsingService(): void;
+export {};
+//# sourceMappingURL=output-parsing.service.d.ts.map

package/dist/executor/output-parsing.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parsing.service.d.ts","sourceRoot":"","sources":["../../src/executor/output-parsing.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;CACxC;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,CAAC,EAAE,MAAM;IAI3B;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA0DtF;;OAEG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAmB9G;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;;;;;;OASG;IACH,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAqBlD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAuBhD;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAkBnC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAiBhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAchC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoBhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAYjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,qCAAqC;IAe7C;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAuB1B;AAOD;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAG9D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}