phaibel 4.0.7

package/dist/feral/node-code/flow/stop-node-code.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+import type { ConfigurationDescription, ResultDescription } from '../../configuration/configuration-description.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+export declare class StopNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    constructor();
+    process(_context: Context): Promise<Result>;
+}
+//# sourceMappingURL=stop-node-code.d.ts.map

package/dist/feral/node-code/flow/stop-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/flow/stop-node-code.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,qBAAa,YAAa,SAAQ,gBAAgB;IAC9C,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAAM;IACpE,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAErD;;IAMI,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAGpD"}

package/dist/feral/node-code/flow/stop-node-code.js

@@ -0,0 +1,19 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Stop NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { ResultStatus } from '../../result/result.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+import { NodeCodeCategory } from '../node-code.js';
+export class StopNodeCode extends AbstractNodeCode {
+    static configDescriptions = [];
+    static resultDescriptions = [
+        { status: ResultStatus.STOP, description: 'The process has been stopped.' },
+    ];
+    constructor() {
+        super('stop', 'Stop Process', 'The node that stops a process.', NodeCodeCategory.FLOW);
+    }
+    async process(_context) {
+        return this.result(ResultStatus.STOP, 'Stop processing.');
+    }
+}
+//# sourceMappingURL=stop-node-code.js.map

package/dist/feral/node-code/flow/stop-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/flow/stop-node-code.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAIhF,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,OAAO,YAAa,SAAQ,gBAAgB;IAC9C,MAAM,CAAU,kBAAkB,GAA+B,EAAE,CAAC;IACpE,MAAM,CAAU,kBAAkB,GAAwB;QACtD,EAAE,MAAM,EAAE,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,+BAA+B,EAAE;KAC9E,CAAC;IAEF;QACI,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,gCAAgC,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3F,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAiB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC9D,CAAC"}

package/dist/feral/node-code/flow/sub-process-node-code.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+import type { ConfigurationDescription, ResultDescription } from '../../configuration/configuration-description.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+export declare class SubProcessNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=sub-process-node-code.d.ts.map

package/dist/feral/node-code/flow/sub-process-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-process-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/flow/sub-process-node-code.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK5D,qBAAa,kBAAmB,SAAQ,gBAAgB;IACpD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAO5D;IAEF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAGrD;;IAWI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CA2BnD"}

package/dist/feral/node-code/flow/sub-process-node-code.js

@@ -0,0 +1,53 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Sub-Process NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// Pauses the current process, runs a child process by key with the SAME
+// shared context, then returns to the parent process.  This enables
+// process composition — Process A can call Process B mid-execution.
+//
+// Requires __process_engine and __process_factory in context (injected
+// by Runner.run() automatically).
+// ─────────────────────────────────────────────────────────────────────────────
+import { ResultStatus } from '../../result/result.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+import { NodeCodeCategory } from '../node-code.js';
+export class SubProcessNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        {
+            key: 'process_key',
+            name: 'Process Key',
+            description: 'The key of the sub-process to run. Supports {context_key} interpolation.',
+            type: 'string',
+        },
+    ];
+    static resultDescriptions = [
+        { status: ResultStatus.OK, description: 'Sub-process completed successfully.' },
+        { status: ResultStatus.ERROR, description: 'Sub-process failed or was not found.' },
+    ];
+    constructor() {
+        super('sub_process', 'Sub-Process', 'Run another Feral process by key with shared context, then return to this process.', NodeCodeCategory.FLOW);
+    }
+    async process(context) {
+        const processKeyTemplate = this.getRequiredConfigValue('process_key');
+        // Interpolate {context_key} tokens in the process key
+        const processKey = processKeyTemplate.replace(/\{(\w+)\}/g, (_, key) => {
+            return String(context.get(key) ?? '');
+        });
+        const engine = context.get('__process_engine');
+        const factory = context.get('__process_factory');
+        if (!engine || !factory) {
+            return this.result(ResultStatus.ERROR, 'Sub-process execution requires __process_engine and __process_factory in context. Ensure you are running via Runner.run().');
+        }
+        try {
+            const subProcess = factory.build(processKey);
+            await engine.process(subProcess, context);
+            return this.result(ResultStatus.OK, `Sub-process "${processKey}" completed.`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return this.result(ResultStatus.ERROR, `Sub-process "${processKey}" failed: ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=sub-process-node-code.js.map

package/dist/feral/node-code/flow/sub-process-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-process-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/flow/sub-process-node-code.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mCAAmC;AACnC,gFAAgF;AAChF,EAAE;AACF,wEAAwE;AACxE,oEAAoE;AACpE,oEAAoE;AACpE,EAAE;AACF,uEAAuE;AACvE,kCAAkC;AAClC,gFAAgF;AAIhF,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAInD,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACpD,MAAM,CAAU,kBAAkB,GAA+B;QAC7D;YACI,GAAG,EAAE,aAAa;YAClB,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,0EAA0E;YACvF,IAAI,EAAE,QAAQ;SACjB;KACJ,CAAC;IAEF,MAAM,CAAU,kBAAkB,GAAwB;QACtD,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,qCAAqC,EAAE;QAC/E,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,sCAAsC,EAAE;KACtF,CAAC;IAEF;QACI,KAAK,CACD,aAAa,EACb,aAAa,EACb,oFAAoF,EACpF,gBAAgB,CAAC,IAAI,CACxB,CAAC;IACN,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC1B,MAAM,kBAAkB,GAAG,IAAI,CAAC,sBAAsB,CAAC,aAAa,CAAW,CAAC;QAEhF,sDAAsD;QACtD,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;YAC3E,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAyB,CAAC;QACvE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAA0B,CAAC;QAE1E,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,MAAM,CACd,YAAY,CAAC,KAAK,EAClB,4HAA4H,CAC/H,CAAC;QACN,CAAC;QAED,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,gBAAgB,UAAU,cAAc,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,gBAAgB,UAAU,aAAa,OAAO,EAAE,CAAC,CAAC;QAC7F,CAAC;IACL,CAAC"}

package/dist/feral/node-code/flow/throw-exception-node-code.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+import type { ConfigurationDescription, ResultDescription } from '../../configuration/configuration-description.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+export declare class ThrowExceptionNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    constructor();
+    process(_context: Context): Promise<Result>;
+}
+//# sourceMappingURL=throw-exception-node-code.d.ts.map

package/dist/feral/node-code/flow/throw-exception-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throw-exception-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/flow/throw-exception-node-code.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,qBAAa,sBAAuB,SAAQ,gBAAgB;IACxD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAE5D;IACF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAAM;;IAMvD,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAIpD"}

package/dist/feral/node-code/flow/throw-exception-node-code.js

@@ -0,0 +1,20 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Throw Exception NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { ProcessError } from '../../errors.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+import { NodeCodeCategory } from '../node-code.js';
+export class ThrowExceptionNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'message', name: 'Message', description: 'The error message to throw.', type: 'string', default: 'Intentional exception from ThrowExceptionNodeCode.' },
+    ];
+    static resultDescriptions = [];
+    constructor() {
+        super('throw_exception', 'Throw Exception', 'Throws an exception (for testing).', NodeCodeCategory.FLOW);
+    }
+    async process(_context) {
+        const message = this.getRequiredConfigValue('message', 'Intentional exception from ThrowExceptionNodeCode.');
+        throw new ProcessError(message);
+    }
+}
+//# sourceMappingURL=throw-exception-node-code.js.map

package/dist/feral/node-code/flow/throw-exception-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throw-exception-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/flow/throw-exception-node-code.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uCAAuC;AACvC,gFAAgF;AAIhF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,OAAO,sBAAuB,SAAQ,gBAAgB;IACxD,MAAM,CAAU,kBAAkB,GAA+B;QAC7D,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,oDAAoD,EAAE;KACjK,CAAC;IACF,MAAM,CAAU,kBAAkB,GAAwB,EAAE,CAAC;IAE7D;QACI,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,oCAAoC,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC7G,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAiB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,oDAAoD,CAAW,CAAC;QACvH,MAAM,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC"}

package/dist/feral/node-code/genai/data-synthesis-prep-node-code.d.ts

@@ -0,0 +1,15 @@
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import type { ConfigurationDescription } from '../../configuration/configuration-description.js';
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+/**
+ * Prepares structured data for LLM synthesis.
+ * Reads context values, formats them as a structured summary,
+ * and stores the result for subsequent LLM prompt injection.
+ */
+export declare class DataSynthesisPrepNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=data-synthesis-prep-node-code.d.ts.map

package/dist/feral/node-code/genai/data-synthesis-prep-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-synthesis-prep-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/data-synthesis-prep-node-code.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGrD;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;IAC3D,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAI5D;;IAMI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAwBnD"}

package/dist/feral/node-code/genai/data-synthesis-prep-node-code.js

@@ -0,0 +1,44 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Data Synthesis Prep NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import { NodeCodeCategory } from '../../node-code/node-code.js';
+import { ResultStatus } from '../../result/result.js';
+/**
+ * Prepares structured data for LLM synthesis.
+ * Reads context values, formats them as a structured summary,
+ * and stores the result for subsequent LLM prompt injection.
+ */
+export class DataSynthesisPrepNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'source_context_paths', name: 'Source Paths', description: 'Comma-separated context paths to collect', type: 'string' },
+        { key: 'output_context_path', name: 'Output Path', description: 'Context path for the prepared data', type: 'string', isOptional: true, default: 'synthesis_data' },
+        { key: 'format', name: 'Format', description: 'Output format: "json" or "text"', type: 'string', isOptional: true, default: 'text' },
+    ];
+    constructor() {
+        super('synthesis_prep', 'Data Synthesis Prep', 'Prepares structured data for LLM synthesis', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const paths = this.getRequiredConfigValue('source_context_paths').split(',').map(p => p.trim());
+        const outputPath = this.getOptionalConfigValue('output_context_path', 'synthesis_data');
+        const format = this.getOptionalConfigValue('format', 'text');
+        const data = {};
+        for (const path of paths) {
+            if (context.has(path)) {
+                data[path] = context.get(path);
+            }
+        }
+        if (format === 'json') {
+            context.set(outputPath, JSON.stringify(data, null, 2));
+        }
+        else {
+            const lines = Object.entries(data).map(([key, value]) => {
+                const valueStr = typeof value === 'object' ? JSON.stringify(value) : String(value);
+                return `${key}: ${valueStr}`;
+            });
+            context.set(outputPath, lines.join('\n'));
+        }
+        return this.result(ResultStatus.OK, `Prepared ${Object.keys(data).length} items for synthesis`);
+    }
+}
+//# sourceMappingURL=data-synthesis-prep-node-code.js.map

package/dist/feral/node-code/genai/data-synthesis-prep-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-synthesis-prep-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/data-synthesis-prep-node-code.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,6CAA6C;AAC7C,gFAAgF;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAIhE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAC3D,MAAM,CAAU,kBAAkB,GAA+B;QAC7D,EAAE,GAAG,EAAE,sBAAsB,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,0CAA0C,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9H,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,oCAAoC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE;QACnK,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;KACvI,CAAC;IAEF;QACI,KAAK,CAAC,gBAAgB,EAAE,qBAAqB,EAAE,4CAA4C,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC1B,MAAM,KAAK,GAAI,IAAI,CAAC,sBAAsB,CAAC,sBAAsB,CAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5G,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,gBAAgB,CAAW,CAAC;QAClG,MAAM,MAAM,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAW,CAAC;QAEvE,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;QACL,CAAC;QAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBACpD,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnF,OAAO,GAAG,GAAG,KAAK,QAAQ,EAAE,CAAC;YACjC,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,sBAAsB,CAAC,CAAC;IACpG,CAAC"}

package/dist/feral/node-code/genai/generate-html-node-code.d.ts

@@ -0,0 +1,13 @@
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import type { ConfigurationDescription } from '../../configuration/configuration-description.js';
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+/**
+ * Converts Markdown content from context to HTML using the `marked` library.
+ */
+export declare class GenerateHtmlNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=generate-html-node-code.d.ts.map

package/dist/feral/node-code/genai/generate-html-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-html-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/generate-html-node-code.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGrD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAI5D;;IAMI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CA+BnD"}

package/dist/feral/node-code/genai/generate-html-node-code.js

@@ -0,0 +1,47 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Generate HTML NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import { NodeCodeCategory } from '../../node-code/node-code.js';
+import { ResultStatus } from '../../result/result.js';
+/**
+ * Converts Markdown content from context to HTML using the `marked` library.
+ */
+export class GenerateHtmlNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'source_context_path', name: 'Source Path', description: 'Context path containing the Markdown content', type: 'string' },
+        { key: 'target_context_path', name: 'Target Path', description: 'Context path to store the HTML output', type: 'string', isOptional: true, default: 'html_output' },
+        { key: 'wrap_html', name: 'Wrap HTML', description: 'Whether to wrap in an HTML document structure', type: 'boolean', isOptional: true, default: false },
+    ];
+    constructor() {
+        super('convert_html', 'Convert to HTML', 'Converts Markdown to HTML', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const sourcePath = this.getRequiredConfigValue('source_context_path');
+        const targetPath = this.getOptionalConfigValue('target_context_path', 'html_output');
+        const wrapHtml = this.getOptionalConfigValue('wrap_html', false);
+        if (!context.has(sourcePath)) {
+            return this.result(ResultStatus.ERROR, `No Markdown content at context path "${sourcePath}"`);
+        }
+        const markdown = String(context.get(sourcePath));
+        try {
+            // Dynamic import of marked so it's only loaded when needed
+            const { marked } = await import('marked');
+            let html = await marked(markdown);
+            if (wrapHtml) {
+                html = `<!DOCTYPE html>
+<html lang="en">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"></head>
+<body>${html}</body>
+</html>`;
+            }
+            context.set(targetPath, html);
+            return this.result(ResultStatus.OK, `Converted Markdown to HTML (${html.length} chars)`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return this.result(ResultStatus.ERROR, `HTML conversion error: ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=generate-html-node-code.js.map

package/dist/feral/node-code/genai/generate-html-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-html-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/generate-html-node-code.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uCAAuC;AACvC,gFAAgF;AAEhF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAIhE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,gBAAgB;IACtD,MAAM,CAAU,kBAAkB,GAA+B;QAC7D,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,8CAA8C,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChI,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,uCAAuC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE;QACnK,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,+CAA+C,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;KAC3J,CAAC;IAEF;QACI,KAAK,CAAC,cAAc,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACjG,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,qBAAqB,CAAW,CAAC;QAChF,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,aAAa,CAAW,CAAC;QAC/F,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC,WAAW,EAAE,KAAK,CAAY,CAAC;QAE5E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,wCAAwC,UAAU,GAAG,CAAC,CAAC;QAClG,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QAEjD,IAAI,CAAC;YACD,2DAA2D;YAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YAElC,IAAI,QAAQ,EAAE,CAAC;gBACX,IAAI,GAAG;;;QAGf,IAAI;QACJ,CAAC;YACG,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,+BAA+B,IAAI,CAAC,MAAM,SAAS,CAAC,CAAC;QAC7F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,0BAA0B,OAAO,EAAE,CAAC,CAAC;QAChF,CAAC;IACL,CAAC"}

package/dist/feral/node-code/genai/generate-markdown-node-code.d.ts

@@ -0,0 +1,27 @@
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import type { ConfigurationDescription } from '../../configuration/configuration-description.js';
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+/**
+ * Section descriptor for structured Markdown generation.
+ */
+export interface MarkdownSection {
+    type: 'heading' | 'paragraph' | 'list' | 'table' | 'code' | 'blockquote';
+    level?: number;
+    content?: string;
+    items?: string[];
+    ordered?: boolean;
+    headers?: string[];
+    rows?: string[][];
+    language?: string;
+}
+/**
+ * Generates Markdown from structured context data or a template.
+ */
+export declare class GenerateMarkdownNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+    private renderSection;
+}
+//# sourceMappingURL=generate-markdown-node-code.d.ts.map

package/dist/feral/node-code/genai/generate-markdown-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-markdown-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/generate-markdown-node-code.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGrD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,gBAAgB;IAC1D,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAI5D;;IAMI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAkChD,OAAO,CAAC,aAAa;CAgCxB"}

package/dist/feral/node-code/genai/generate-markdown-node-code.js

@@ -0,0 +1,81 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Generate Markdown NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import { NodeCodeCategory } from '../../node-code/node-code.js';
+import { ResultStatus } from '../../result/result.js';
+/**
+ * Generates Markdown from structured context data or a template.
+ */
+export class GenerateMarkdownNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'input_context_path', name: 'Input Path', description: 'Context path with structured data or sections array', type: 'string' },
+        { key: 'output_context_path', name: 'Output Path', description: 'Context path for the generated Markdown', type: 'string', isOptional: true, default: 'markdown_data' },
+        { key: 'template_context_path', name: 'Template Path', description: 'Optional: context path for a Markdown template with {placeholder} interpolation', type: 'string', isOptional: true },
+    ];
+    constructor() {
+        super('generate_markdown', 'Generate Markdown', 'Generates Markdown from structured data', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const inputPath = this.getRequiredConfigValue('input_context_path');
+        const outputPath = this.getOptionalConfigValue('output_context_path', 'markdown_data');
+        const templatePath = this.getOptionalConfigValue('template_context_path');
+        if (!context.has(inputPath)) {
+            return this.result(ResultStatus.ERROR, `No data at context path "${inputPath}"`);
+        }
+        // Template mode: interpolate {placeholders} in a Markdown template
+        if (templatePath && context.has(templatePath)) {
+            const template = String(context.get(templatePath));
+            const data = context.get(inputPath);
+            const result = template.replace(/\{(\w+)\}/g, (_, key) => {
+                return data[key] !== undefined ? String(data[key]) : `{${key}}`;
+            });
+            context.set(outputPath, result);
+            return this.result(ResultStatus.OK, `Generated Markdown from template`);
+        }
+        // Structured mode: convert MarkdownSection[] to Markdown string
+        const input = context.get(inputPath);
+        const sections = Array.isArray(input) ? input : [input];
+        const lines = [];
+        for (const section of sections) {
+            lines.push(this.renderSection(section));
+            lines.push(''); // blank line between sections
+        }
+        context.set(outputPath, lines.join('\n').trim());
+        return this.result(ResultStatus.OK, `Generated Markdown with ${sections.length} section(s)`);
+    }
+    renderSection(section) {
+        switch (section.type) {
+            case 'heading': {
+                const level = Math.min(Math.max(section.level ?? 1, 1), 6);
+                return `${'#'.repeat(level)} ${section.content ?? ''}`;
+            }
+            case 'paragraph':
+                return section.content ?? '';
+            case 'blockquote':
+                return (section.content ?? '').split('\n').map(l => `> ${l}`).join('\n');
+            case 'list': {
+                const items = section.items ?? [];
+                return items.map((item, i) => {
+                    const bullet = section.ordered ? `${i + 1}.` : '-';
+                    return `${bullet} ${item}`;
+                }).join('\n');
+            }
+            case 'table': {
+                const headers = section.headers ?? [];
+                const rows = section.rows ?? [];
+                if (headers.length === 0)
+                    return '';
+                const headerLine = `| ${headers.join(' | ')} |`;
+                const separatorLine = `| ${headers.map(() => '---').join(' | ')} |`;
+                const rowLines = rows.map(r => `| ${r.join(' | ')} |`);
+                return [headerLine, separatorLine, ...rowLines].join('\n');
+            }
+            case 'code':
+                return `\`\`\`${section.language ?? ''}\n${section.content ?? ''}\n\`\`\``;
+            default:
+                return section.content ?? '';
+        }
+    }
+}
+//# sourceMappingURL=generate-markdown-node-code.js.map

package/dist/feral/node-code/genai/generate-markdown-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-markdown-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/generate-markdown-node-code.ts"],"names":[],"mappings":"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"}

package/dist/feral/node-code/genai/hydrate-model-node-code.d.ts

@@ -0,0 +1,21 @@
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import type { ConfigurationDescription } from '../../configuration/configuration-description.js';
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+import type { ModelSchemaRegistry } from '../../agent/model-schema.js';
+/**
+ * Extracts JSON from an LLM response and hydrates a model object
+ * based on the schema defined in ModelSchemaRegistry.
+ */
+export declare class HydrateModelNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    private registry?;
+    constructor(registry?: ModelSchemaRegistry);
+    setRegistry(registry: ModelSchemaRegistry): void;
+    process(context: Context): Promise<Result>;
+    /**
+     * Extract JSON from LLM output that may include markdown code fences.
+     */
+    private extractJson;
+}
+//# sourceMappingURL=hydrate-model-node-code.d.ts.map

package/dist/feral/node-code/genai/hydrate-model-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate-model-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/hydrate-model-node-code.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAI5D;IAEF,OAAO,CAAC,QAAQ,CAAC,CAAsB;gBAE3B,QAAQ,CAAC,EAAE,mBAAmB;IAK1C,WAAW,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAI1C,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IA8ChD;;OAEG;IACH,OAAO,CAAC,WAAW;CAetB"}

package/dist/feral/node-code/genai/hydrate-model-node-code.js

@@ -0,0 +1,83 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Hydrate Model NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import { NodeCodeCategory } from '../../node-code/node-code.js';
+import { ResultStatus } from '../../result/result.js';
+/**
+ * Extracts JSON from an LLM response and hydrates a model object
+ * based on the schema defined in ModelSchemaRegistry.
+ */
+export class HydrateModelNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'model_key', name: 'Model Key', description: 'Key of the model schema in the registry', type: 'string' },
+        { key: 'source_context_path', name: 'Source Path', description: 'Context path containing the LLM response', type: 'string' },
+        { key: 'target_context_path', name: 'Target Path', description: 'Context path to store the hydrated model', type: 'string', isOptional: true, default: 'model_data' },
+    ];
+    registry;
+    constructor(registry) {
+        super('hydrate_model', 'Hydrate Model', 'Extracts and validates a model from LLM response', NodeCodeCategory.DATA);
+        this.registry = registry;
+    }
+    setRegistry(registry) {
+        this.registry = registry;
+    }
+    async process(context) {
+        if (!this.registry) {
+            return this.result(ResultStatus.ERROR, 'No ModelSchemaRegistry configured');
+        }
+        const modelKey = this.getRequiredConfigValue('model_key');
+        const sourcePath = this.getRequiredConfigValue('source_context_path');
+        const targetPath = this.getOptionalConfigValue('target_context_path', 'model_data');
+        if (!context.has(sourcePath)) {
+            return this.result(ResultStatus.ERROR, `No LLM response at context path "${sourcePath}"`);
+        }
+        const raw = String(context.get(sourcePath));
+        try {
+            const schema = this.registry.get(modelKey);
+            // Extract JSON from potential markdown code fence or raw JSON
+            const json = this.extractJson(raw);
+            const parsed = JSON.parse(json);
+            // Validate required fields
+            const missing = [];
+            for (const prop of schema.properties) {
+                if (prop.required && (parsed[prop.name] === undefined || parsed[prop.name] === null)) {
+                    if (prop.default !== undefined) {
+                        parsed[prop.name] = prop.default;
+                    }
+                    else {
+                        missing.push(prop.name);
+                    }
+                }
+            }
+            if (missing.length > 0) {
+                return this.result(ResultStatus.ERROR, `Missing required fields: ${missing.join(', ')}`);
+            }
+            context.set(targetPath, parsed);
+            return this.result(ResultStatus.OK, `Hydrated model "${modelKey}" with ${Object.keys(parsed).length} fields`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return this.result(ResultStatus.ERROR, `Model hydration error: ${message}`);
+        }
+    }
+    /**
+     * Extract JSON from LLM output that may include markdown code fences.
+     */
+    extractJson(text) {
+        // Try to extract from code fence
+        const fenceMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+        if (fenceMatch)
+            return fenceMatch[1].trim();
+        // Try to find raw JSON object
+        const objectMatch = text.match(/\{[\s\S]*\}/);
+        if (objectMatch)
+            return objectMatch[0];
+        // Try to find raw JSON array
+        const arrayMatch = text.match(/\[[\s\S]*\]/);
+        if (arrayMatch)
+            return arrayMatch[0];
+        return text.trim();
+    }
+}
+//# sourceMappingURL=hydrate-model-node-code.js.map

package/dist/feral/node-code/genai/hydrate-model-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate-model-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/hydrate-model-node-code.ts"],"names":[],"mappings":"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"}

package/dist/feral/node-code/genai/merge-strings-node-code.d.ts

@@ -0,0 +1,14 @@
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import type { ConfigurationDescription } from '../../configuration/configuration-description.js';
+import type { Context } from '../../context/context.js';
+import type { Result } from '../../result/result.js';
+/**
+ * Concatenates an array of strings from context into a single string.
+ * Useful for assembling multi-part prompts.
+ */
+export declare class MergeStringsNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=merge-strings-node-code.d.ts.map

package/dist/feral/node-code/genai/merge-strings-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-strings-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/merge-strings-node-code.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAEzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AACjG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGrD;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAI5D;;IAMI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAenD"}

package/dist/feral/node-code/genai/merge-strings-node-code.js

@@ -0,0 +1,34 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Merge Strings NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import { NodeCodeCategory } from '../../node-code/node-code.js';
+import { ResultStatus } from '../../result/result.js';
+/**
+ * Concatenates an array of strings from context into a single string.
+ * Useful for assembling multi-part prompts.
+ */
+export class MergeStringsNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'source_context_paths', name: 'Source Paths', description: 'Comma-separated context paths to merge', type: 'string' },
+        { key: 'target_context_path', name: 'Target Path', description: 'Context path to store the merged result', type: 'string', isOptional: true, default: 'merged_text' },
+        { key: 'separator', name: 'Separator', description: 'Separator between merged strings', type: 'string', isOptional: true, default: '\n' },
+    ];
+    constructor() {
+        super('merge_strings', 'Merge Strings', 'Concatenates context strings into one', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const sourcePaths = this.getRequiredConfigValue('source_context_paths').split(',').map(p => p.trim());
+        const targetPath = this.getOptionalConfigValue('target_context_path', 'merged_text');
+        const separator = this.getOptionalConfigValue('separator', '\n');
+        const parts = [];
+        for (const path of sourcePaths) {
+            if (context.has(path)) {
+                parts.push(String(context.get(path)));
+            }
+        }
+        context.set(targetPath, parts.join(separator));
+        return this.result(ResultStatus.OK, `Merged ${parts.length} strings into "${targetPath}"`);
+    }
+}
+//# sourceMappingURL=merge-strings-node-code.js.map