/* eslint-disable n8n-nodes-base/node-dirname-against-convention */ import { jsonParse, type IExecuteFunctions, type INodeType, type INodeTypeDescription, type SupplyData, NodeOperationError, NodeConnectionType, } from 'n8n-workflow'; import { parseSchema } from 'json-schema-to-zod'; import { z } from 'zod'; import type { JSONSchema7 } from 'json-schema'; import { StructuredOutputParser } from 'langchain/output_parsers'; import { OutputParserException } from '@langchain/core/output_parsers'; import get from 'lodash/get'; import { logWrapper } from '../../../utils/logWrapper'; import { getConnectionHintNoticeField } from '../../../utils/sharedFields'; const STRUCTURED_OUTPUT_KEY = '__structured__output'; const STRUCTURED_OUTPUT_OBJECT_KEY = '__structured__output__object'; const STRUCTURED_OUTPUT_ARRAY_KEY = '__structured__output__array'; class N8nStructuredOutputParser extends StructuredOutputParser { async parse(text: string): Promise> { try { const parsed = (await super.parse(text)) as object; return ( get(parsed, [STRUCTURED_OUTPUT_KEY, STRUCTURED_OUTPUT_OBJECT_KEY]) ?? get(parsed, [STRUCTURED_OUTPUT_KEY, STRUCTURED_OUTPUT_ARRAY_KEY]) ?? get(parsed, STRUCTURED_OUTPUT_KEY) ?? parsed ); } catch (e) { // eslint-disable-next-line n8n-nodes-base/node-execute-block-wrong-error-thrown throw new OutputParserException(`Failed to parse. Text: "${text}". Error: ${e}`, text); } } static fromZedJsonSchema( schema: JSONSchema7, nodeVersion: number, ): StructuredOutputParser> { // Make sure to remove the description from root schema const { description, ...restOfSchema } = schema; const zodSchemaString = parseSchema(restOfSchema as JSONSchema7); // TODO: This is obviously not great and should be replaced later!!! // eslint-disable-next-line @typescript-eslint/no-implied-eval const itemSchema = new Function('z', `return (${zodSchemaString})`)(z) as z.ZodSchema; let returnSchema: z.ZodSchema; if (nodeVersion === 1) { returnSchema = z.object({ [STRUCTURED_OUTPUT_KEY]: z .object({ [STRUCTURED_OUTPUT_OBJECT_KEY]: itemSchema.optional(), [STRUCTURED_OUTPUT_ARRAY_KEY]: z.array(itemSchema).optional(), }) .describe( `Wrapper around the output data. It can only contain ${STRUCTURED_OUTPUT_OBJECT_KEY} or ${STRUCTURED_OUTPUT_ARRAY_KEY} but never both.`, ) .refine( (data) => { // Validate that one and only one of the properties exists return ( Boolean(data[STRUCTURED_OUTPUT_OBJECT_KEY]) !== Boolean(data[STRUCTURED_OUTPUT_ARRAY_KEY]) ); }, { message: 'One and only one of __structured__output__object and __structured__output__array should be present.', path: [STRUCTURED_OUTPUT_KEY], }, ), }); } else { returnSchema = z.object({ output: itemSchema.optional(), }); } return N8nStructuredOutputParser.fromZodSchema(returnSchema); } } export class OutputParserStructured implements INodeType { description: INodeTypeDescription = { displayName: 'Structured Output Parser', name: 'outputParserStructured', icon: 'fa:code', group: ['transform'], version: [1, 1.1], defaultVersion: 1.1, description: 'Return data in a defined JSON format', defaults: { name: 'Structured Output Parser', }, codex: { alias: ['json', 'zod'], categories: ['AI'], subcategories: { AI: ['Output Parsers'], }, resources: { primaryDocumentation: [ { url: 'https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.outputparserstructured/', }, ], }, }, // eslint-disable-next-line n8n-nodes-base/node-class-description-inputs-wrong-regular-node inputs: [], // eslint-disable-next-line n8n-nodes-base/node-class-description-outputs-wrong outputs: [NodeConnectionType.AiOutputParser], outputNames: ['Output Parser'], properties: [ getConnectionHintNoticeField([NodeConnectionType.AiChain, NodeConnectionType.AiAgent]), { displayName: 'JSON Schema', name: 'jsonSchema', type: 'json', description: 'JSON Schema to structure and validate the output against', default: `{ "type": "object", "properties": { "state": { "type": "string" }, "cities": { "type": "array", "items": { "type": "string" } } } }`, typeOptions: { rows: 10, }, required: true, }, { displayName: 'The schema has to be defined in the JSON Schema format. Look at this page for examples.', name: 'notice', type: 'notice', default: '', }, ], }; async supplyData(this: IExecuteFunctions, itemIndex: number): Promise { const schema = this.getNodeParameter('jsonSchema', itemIndex) as string; let itemSchema: JSONSchema7; try { itemSchema = jsonParse(schema); // If the type is not defined, we assume it's an object if (itemSchema.type === undefined) { itemSchema = { type: 'object', properties: itemSchema.properties || (itemSchema as { [key: string]: JSONSchema7 }), }; } } catch (error) { throw new NodeOperationError(this.getNode(), 'Error during parsing of JSON Schema.'); } const nodeVersion = this.getNode().typeVersion; const parser = N8nStructuredOutputParser.fromZedJsonSchema(itemSchema, nodeVersion); return { response: logWrapper(parser, this), }; } }