phaibel 4.0.7

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

@@ -0,0 +1 @@
+{"version":3,"file":"merge-strings-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/merge-strings-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;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,gBAAgB;IACtD,MAAM,CAAU,kBAAkB,GAA+B;QAC7D,EAAE,GAAG,EAAE,sBAAsB,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,wCAAwC,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5H,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,yCAAyC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE;QACrK,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,kCAAkC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;KAC5I,CAAC;IAEF;QACI,KAAK,CAAC,eAAe,EAAE,eAAe,EAAE,uCAAuC,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC5G,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC1B,MAAM,WAAW,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;QAClH,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,aAAa,CAAW,CAAC;QAC/F,MAAM,SAAS,GAAG,IAAI,CAAC,sBAAsB,CAAC,WAAW,EAAE,IAAI,CAAW,CAAC;QAE3E,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1C,CAAC;QACL,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,UAAU,KAAK,CAAC,MAAM,kBAAkB,UAAU,GAAG,CAAC,CAAC;IAC/F,CAAC"}

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

@@ -0,0 +1,18 @@
+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';
+/**
+ * Generates a text description of a model schema for LLM consumption.
+ * The output is suitable for inclusion in a prompt that asks the LLM
+ * to produce structured data matching the schema.
+ */
+export declare class ModelToOutputNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    private registry?;
+    constructor(registry?: ModelSchemaRegistry);
+    setRegistry(registry: ModelSchemaRegistry): void;
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=model-to-output-node-code.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-to-output-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/model-to-output-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;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;IACvD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAG5D;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;CAyBnD"}

package/dist/feral/node-code/genai/model-to-output-node-code.js

@@ -0,0 +1,49 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Model to Output 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 a text description of a model schema for LLM consumption.
+ * The output is suitable for inclusion in a prompt that asks the LLM
+ * to produce structured data matching the schema.
+ */
+export class ModelToOutputNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'model_key', name: 'Model Key', description: 'Key of the model schema in the registry', type: 'string' },
+        { key: 'output_context_path', name: 'Output Path', description: 'Context path for the prompt text', type: 'string', isOptional: true, default: 'model_prompt' },
+    ];
+    registry;
+    constructor(registry) {
+        super('model_to_output', 'Model to Output', 'Generates LLM prompt from model schema', 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 outputPath = this.getOptionalConfigValue('output_context_path', 'model_prompt');
+        try {
+            const promptText = this.registry.toPromptText(modelKey);
+            const fullPrompt = [
+                'You must respond with a JSON object that matches the following model schema:',
+                '',
+                promptText,
+                '',
+                'Respond ONLY with valid JSON, no other text.',
+            ].join('\n');
+            context.set(outputPath, fullPrompt);
+            return this.result(ResultStatus.OK, `Generated prompt for model "${modelKey}"`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return this.result(ResultStatus.ERROR, `Model prompt error: ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=model-to-output-node-code.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-to-output-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/model-to-output-node-code.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,yCAAyC;AACzC,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;AAGtD;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,gBAAgB;IACvD,MAAM,CAAU,kBAAkB,GAA+B;QAC7D,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,yCAAyC,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/G,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,kCAAkC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE;KAClK,CAAC;IAEM,QAAQ,CAAuB;IAEvC,YAAY,QAA8B;QACtC,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,wCAAwC,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC7G,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,WAAW,CAAC,QAA6B;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAW,CAAC;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,qBAAqB,EAAE,cAAc,CAAW,CAAC;QAEhG,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxD,MAAM,UAAU,GAAG;gBACf,8EAA8E;gBAC9E,EAAE;gBACF,UAAU;gBACV,EAAE;gBACF,8CAA8C;aACjD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,+BAA+B,QAAQ,GAAG,CAAC,CAAC;QACpF,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,uBAAuB,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;IACL,CAAC"}

package/dist/feral/node-code/genai/openai-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';
+/**
+ * Calls an OpenAI-compatible chat completions API.
+ * Interleaves system/user/assistant messages from context paths.
+ */
+export declare class OpenAiNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=openai-node-code.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openai-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/openai-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,cAAe,SAAQ,gBAAgB;IAChD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAS5D;;IAMI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAgDnD"}

package/dist/feral/node-code/genai/openai-node-code.js

@@ -0,0 +1,66 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — OpenAI NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import { NodeCodeCategory } from '../../node-code/node-code.js';
+import { ResultStatus } from '../../result/result.js';
+/**
+ * Calls an OpenAI-compatible chat completions API.
+ * Interleaves system/user/assistant messages from context paths.
+ */
+export class OpenAiNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'api_key', name: 'API Key', description: 'OpenAI API key', type: 'string', isOptional: false, isSecret: true },
+        { key: 'model', name: 'Model', description: 'Model identifier (e.g. gpt-4o)', type: 'string', isOptional: true, default: 'gpt-4o' },
+        { key: 'system_context_path', name: 'System Prompt Path', description: 'Context path for the system message', type: 'string', isOptional: true, default: 'system_prompt' },
+        { key: 'prompt_context_path', name: 'Prompt Path', description: 'Context path for the user prompt', type: 'string' },
+        { key: 'response_context_path', name: 'Response Path', description: 'Context path to store the response', type: 'string', isOptional: true, default: 'ai_response' },
+        { key: 'temperature', name: 'Temperature', description: 'Sampling temperature (0-2)', type: 'float', isOptional: true, default: 0.7 },
+        { key: 'max_tokens', name: 'Max Tokens', description: 'Maximum tokens in the response', type: 'int', isOptional: true, default: 4096 },
+        { key: 'base_url', name: 'Base URL', description: 'API base URL (for Perplexity, etc.)', type: 'string', isOptional: true },
+    ];
+    constructor() {
+        super('open_ai', 'OpenAI Chat', 'Calls OpenAI-compatible chat completions API', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const apiKey = this.getRequiredConfigValue('api_key');
+        const model = this.getOptionalConfigValue('model', 'gpt-4o');
+        const systemPath = this.getOptionalConfigValue('system_context_path', 'system_prompt');
+        const promptPath = this.getRequiredConfigValue('prompt_context_path');
+        const responsePath = this.getOptionalConfigValue('response_context_path', 'ai_response');
+        const temperature = Number(this.getOptionalConfigValue('temperature', 0.7));
+        const maxTokens = Number(this.getOptionalConfigValue('max_tokens', 4096));
+        const baseUrl = this.getOptionalConfigValue('base_url');
+        if (!context.has(promptPath)) {
+            return this.result(ResultStatus.ERROR, `No prompt at context path "${promptPath}"`);
+        }
+        const prompt = String(context.get(promptPath));
+        // Build messages array
+        const messages = [];
+        if (context.has(systemPath)) {
+            messages.push({ role: 'system', content: String(context.get(systemPath)) });
+        }
+        messages.push({ role: 'user', content: prompt });
+        try {
+            const { default: OpenAI } = await import('openai');
+            const client = new OpenAI({
+                apiKey,
+                ...(baseUrl ? { baseURL: baseUrl } : {}),
+            });
+            const completion = await client.chat.completions.create({
+                model,
+                messages: messages,
+                temperature,
+                max_tokens: maxTokens,
+            });
+            const responseContent = completion.choices[0]?.message?.content ?? '';
+            context.set(responsePath, responseContent);
+            return this.result(ResultStatus.OK, `OpenAI ${model} response (${responseContent.length} chars)`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return this.result(ResultStatus.ERROR, `OpenAI error: ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=openai-node-code.js.map

package/dist/feral/node-code/genai/openai-node-code.js.map

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

package/dist/feral/node-code/genai/write-entity-node-code.d.ts

@@ -0,0 +1,22 @@
+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';
+/**
+ * Pluggable entity persister interface.
+ * Consumers must provide an implementation.
+ */
+export interface EntityPersister {
+    persist(entityType: string, data: Record<string, unknown>): Promise<string | number>;
+}
+/**
+ * Persists an entity from context using a pluggable EntityPersister.
+ */
+export declare class WriteEntityNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    private persister?;
+    constructor(persister?: EntityPersister);
+    setPersister(persister: EntityPersister): void;
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=write-entity-node-code.d.ts.map

package/dist/feral/node-code/genai/write-entity-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-entity-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/write-entity-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,MAAM,WAAW,eAAe;IAC5B,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACxF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;IACrD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAI5D;IAEF,OAAO,CAAC,SAAS,CAAC,CAAkB;gBAExB,SAAS,CAAC,EAAE,eAAe;IAKvC,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAIxC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAwBnD"}

package/dist/feral/node-code/genai/write-entity-node-code.js

@@ -0,0 +1,46 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Write Entity NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import { NodeCodeCategory } from '../../node-code/node-code.js';
+import { ResultStatus } from '../../result/result.js';
+/**
+ * Persists an entity from context using a pluggable EntityPersister.
+ */
+export class WriteEntityNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'entity_type', name: 'Entity Type', description: 'Type/table name of the entity', type: 'string' },
+        { key: 'source_context_path', name: 'Source Path', description: 'Context path containing the entity data', type: 'string' },
+        { key: 'id_context_path', name: 'ID Path', description: 'Context path to store the persisted entity ID', type: 'string', isOptional: true, default: 'entity_id' },
+    ];
+    persister;
+    constructor(persister) {
+        super('write_entity', 'Write Entity', 'Persists an entity via pluggable EntityPersister', NodeCodeCategory.DATA);
+        this.persister = persister;
+    }
+    setPersister(persister) {
+        this.persister = persister;
+    }
+    async process(context) {
+        if (!this.persister) {
+            return this.result(ResultStatus.ERROR, 'No EntityPersister configured');
+        }
+        const entityType = this.getRequiredConfigValue('entity_type');
+        const sourcePath = this.getRequiredConfigValue('source_context_path');
+        const idPath = this.getOptionalConfigValue('id_context_path', 'entity_id');
+        if (!context.has(sourcePath)) {
+            return this.result(ResultStatus.ERROR, `No entity data at context path "${sourcePath}"`);
+        }
+        const data = context.get(sourcePath);
+        try {
+            const id = await this.persister.persist(entityType, data);
+            context.set(idPath, id);
+            return this.result(ResultStatus.OK, `Persisted ${entityType} with ID ${id}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return this.result(ResultStatus.ERROR, `Entity persist error: ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=write-entity-node-code.js.map

package/dist/feral/node-code/genai/write-entity-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-entity-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/write-entity-node-code.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,sCAAsC;AACtC,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;AAUtD;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IACrD,MAAM,CAAU,kBAAkB,GAA+B;QAC7D,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,+BAA+B,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzG,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,yCAAyC,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3H,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,+CAA+C,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE;KACpK,CAAC;IAEM,SAAS,CAAmB;IAEpC,YAAY,SAA2B;QACnC,KAAK,CAAC,cAAc,EAAE,cAAc,EAAE,kDAAkD,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACjH,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED,YAAY,CAAC,SAA0B;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC1B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,+BAA+B,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,aAAa,CAAW,CAAC;QACxE,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,qBAAqB,CAAW,CAAC;QAChF,MAAM,MAAM,GAAG,IAAI,CAAC,sBAAsB,CAAC,iBAAiB,EAAE,WAAW,CAAW,CAAC;QAErF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,mCAAmC,UAAU,GAAG,CAAC,CAAC;QAC7F,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAA4B,CAAC;QAEhE,IAAI,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,aAAa,UAAU,YAAY,EAAE,EAAE,CAAC,CAAC;QACjF,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,yBAAyB,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;IACL,CAAC"}

package/dist/feral/node-code/genai/write-file-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';
+/**
+ * Writes a context value to a file on disk.
+ */
+export declare class WriteFileNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=write-file-node-code.d.ts.map

package/dist/feral/node-code/genai/write-file-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/write-file-node-code.ts"],"names":[],"mappings":"AAMA,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;AAKrD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;IACnD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAI5D;;IAMI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAsCnD"}

package/dist/feral/node-code/genai/write-file-node-code.js

@@ -0,0 +1,59 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Write File NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import { NodeCodeCategory } from '../../node-code/node-code.js';
+import { ResultStatus } from '../../result/result.js';
+import { findVaultRoot } from '../../../state/manager.js';
+import { assertPathAllowedSync, FileAccessDeniedError } from '../../security/file-access-guard.js';
+/**
+ * Writes a context value to a file on disk.
+ */
+export class WriteFileNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'source_context_path', name: 'Source Path', description: 'Context path containing the content to write', type: 'string' },
+        { key: 'file_path', name: 'File Path', description: 'Destination file path (can use {context_key} interpolation)', type: 'string' },
+        { key: 'create_directories', name: 'Create Dirs', description: 'Whether to create parent directories', type: 'boolean', isOptional: true, default: true },
+    ];
+    constructor() {
+        super('write_file', 'Write File', 'Writes context value to a file', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const sourcePath = this.getRequiredConfigValue('source_context_path');
+        let filePath = this.getRequiredConfigValue('file_path');
+        const createDirs = this.getOptionalConfigValue('create_directories', true);
+        if (!context.has(sourcePath)) {
+            return this.result(ResultStatus.ERROR, `No content at context path "${sourcePath}"`);
+        }
+        // Interpolate context values in file path
+        filePath = filePath.replace(/\{(\w+)\}/g, (_, key) => {
+            return String(context.get(key) ?? '');
+        });
+        const content = context.get(sourcePath);
+        const text = typeof content === 'string' ? content : JSON.stringify(content, null, 2);
+        try {
+            const vaultRoot = await findVaultRoot();
+            assertPathAllowedSync(filePath, vaultRoot);
+        }
+        catch (error) {
+            if (error instanceof FileAccessDeniedError) {
+                return this.result(ResultStatus.ERROR, error.message);
+            }
+            throw error;
+        }
+        try {
+            if (createDirs) {
+                mkdirSync(dirname(filePath), { recursive: true });
+            }
+            writeFileSync(filePath, text, 'utf-8');
+            return this.result(ResultStatus.OK, `Wrote ${text.length} chars to ${filePath}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return this.result(ResultStatus.ERROR, `Write file error: ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=write-file-node-code.js.map

package/dist/feral/node-code/genai/write-file-node-code.js.map

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

package/dist/feral/node-code/genai/write-to-redis-node-code.d.ts

@@ -0,0 +1,23 @@
+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';
+/**
+ * Pluggable key-value store interface.
+ * Consumers provide implementations (Redis, etc.).
+ */
+export interface KeyValueStore {
+    set(key: string, value: string, ttlSeconds?: number): Promise<void>;
+    get(key: string): Promise<string | null>;
+}
+/**
+ * Writes a context value to a key-value store via pluggable KeyValueStore.
+ */
+export declare class WriteToRedisNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    private store?;
+    constructor(store?: KeyValueStore);
+    setStore(store: KeyValueStore): void;
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=write-to-redis-node-code.d.ts.map

package/dist/feral/node-code/genai/write-to-redis-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-to-redis-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/genai/write-to-redis-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,MAAM,WAAW,aAAa;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAI5D;IAEF,OAAO,CAAC,KAAK,CAAC,CAAgB;gBAElB,KAAK,CAAC,EAAE,aAAa;IAKjC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAI9B,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CA2BnD"}

package/dist/feral/node-code/genai/write-to-redis-node-code.js

@@ -0,0 +1,48 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Write to Redis NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+import { AbstractNodeCode } from '../../node-code/abstract-node-code.js';
+import { NodeCodeCategory } from '../../node-code/node-code.js';
+import { ResultStatus } from '../../result/result.js';
+/**
+ * Writes a context value to a key-value store via pluggable KeyValueStore.
+ */
+export class WriteToRedisNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        { key: 'key', name: 'Key', description: 'Key to store the value under (supports {context} interpolation)', type: 'string' },
+        { key: 'source_context_path', name: 'Source Path', description: 'Context path containing the value to store', type: 'string' },
+        { key: 'ttl', name: 'TTL', description: 'Time-to-live in seconds (optional)', type: 'int', isOptional: true },
+    ];
+    store;
+    constructor(store) {
+        super('write_redis', 'Write to Key-Value Store', 'Writes context value to a key-value store', NodeCodeCategory.DATA);
+        this.store = store;
+    }
+    setStore(store) {
+        this.store = store;
+    }
+    async process(context) {
+        if (!this.store) {
+            return this.result(ResultStatus.ERROR, 'No KeyValueStore configured');
+        }
+        let key = this.getRequiredConfigValue('key');
+        const sourcePath = this.getRequiredConfigValue('source_context_path');
+        const ttl = this.getOptionalConfigValue('ttl');
+        // Interpolate context values in key
+        key = key.replace(/\{(\w+)\}/g, (_, k) => String(context.get(k) ?? ''));
+        if (!context.has(sourcePath)) {
+            return this.result(ResultStatus.ERROR, `No data at context path "${sourcePath}"`);
+        }
+        const value = context.get(sourcePath);
+        const serialized = typeof value === 'string' ? value : JSON.stringify(value);
+        try {
+            await this.store.set(key, serialized, ttl ?? undefined);
+            return this.result(ResultStatus.OK, `Stored value at key "${key}"${ttl ? ` (TTL: ${ttl}s)` : ''}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return this.result(ResultStatus.ERROR, `KV store write error: ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=write-to-redis-node-code.js.map

package/dist/feral/node-code/genai/write-to-redis-node-code.js.map

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

package/dist/feral/node-code/input/prompt-input-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 PromptInputNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=prompt-input-node-code.d.ts.map

package/dist/feral/node-code/input/prompt-input-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-input-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/input/prompt-input-node-code.ts"],"names":[],"mappings":"AAUA,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,mBAAoB,SAAQ,gBAAgB;IACrD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAqB5D;IAEF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAGrD;;IAWI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CA6BnD"}

package/dist/feral/node-code/input/prompt-input-node-code.js

@@ -0,0 +1,70 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Prompt Input NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// Pauses process execution to ask the user a question via the terminal.
+// Stores the answer in context.  Supports {context_key} interpolation
+// in the prompt text so the question can reference previous context values.
+// ─────────────────────────────────────────────────────────────────────────────
+import inquirer from 'inquirer';
+import { ResultStatus } from '../../result/result.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+import { NodeCodeCategory } from '../node-code.js';
+export class PromptInputNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        {
+            key: 'prompt',
+            name: 'Prompt',
+            description: 'The question to ask the user. Supports {context_key} interpolation.',
+            type: 'string',
+        },
+        {
+            key: 'context_path',
+            name: 'Context Path',
+            description: 'Context key where the user\'s answer will be stored.',
+            type: 'string',
+            default: 'user_answer',
+        },
+        {
+            key: 'default_value',
+            name: 'Default Value',
+            description: 'Optional default value shown to the user.',
+            type: 'string',
+            isOptional: true,
+        },
+    ];
+    static resultDescriptions = [
+        { status: ResultStatus.OK, description: 'User provided an answer.' },
+        { status: 'skipped', description: 'User provided no answer (empty input).' },
+    ];
+    constructor() {
+        super('prompt_input', 'Prompt Input', 'Ask the user a question and store their answer in context.', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const promptTemplate = this.getRequiredConfigValue('prompt');
+        const contextPath = this.getRequiredConfigValue('context_path', 'user_answer');
+        const defaultValue = this.getOptionalConfigValue('default_value');
+        // Interpolate {context_key} tokens
+        const prompt = this.interpolate(promptTemplate, context);
+        const askQuestion = context.get('_askQuestion');
+        let trimmed;
+        if (askQuestion) {
+            trimmed = ((await askQuestion(prompt)) ?? '').trim();
+        }
+        else {
+            const { answer } = await inquirer.prompt([{
+                    type: 'input',
+                    name: 'answer',
+                    message: prompt,
+                    ...(defaultValue ? { default: this.interpolate(defaultValue, context) } : {}),
+                }]);
+            trimmed = answer.trim();
+        }
+        if (!trimmed) {
+            return this.result('skipped', 'User provided no answer.');
+        }
+        context.set(contextPath, trimmed);
+        return this.result(ResultStatus.OK, `Stored "${trimmed}" in ${contextPath}`);
+    }
+}
+//# sourceMappingURL=prompt-input-node-code.js.map

package/dist/feral/node-code/input/prompt-input-node-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-input-node-code.js","sourceRoot":"","sources":["../../../../src/feral/node-code/input/prompt-input-node-code.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,oCAAoC;AACpC,gFAAgF;AAChF,EAAE;AACF,wEAAwE;AACxE,sEAAsE;AACtE,4EAA4E;AAC5E,gFAAgF;AAEhF,OAAO,QAAQ,MAAM,UAAU,CAAC;AAGhC,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,mBAAoB,SAAQ,gBAAgB;IACrD,MAAM,CAAU,kBAAkB,GAA+B;QAC7D;YACI,GAAG,EAAE,QAAQ;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qEAAqE;YAClF,IAAI,EAAE,QAAQ;SACjB;QACD;YACI,GAAG,EAAE,cAAc;YACnB,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,sDAAsD;YACnE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,aAAa;SACzB;QACD;YACI,GAAG,EAAE,eAAe;YACpB,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,2CAA2C;YACxD,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,IAAI;SACnB;KACJ,CAAC;IAEF,MAAM,CAAU,kBAAkB,GAAwB;QACtD,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,0BAA0B,EAAE;QACpE,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,wCAAwC,EAAE;KAC/E,CAAC;IAEF;QACI,KAAK,CACD,cAAc,EACd,cAAc,EACd,4DAA4D,EAC5D,gBAAgB,CAAC,IAAI,CACxB,CAAC;IACN,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC1B,MAAM,cAAc,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAW,CAAC;QACvE,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,CAAC,cAAc,EAAE,aAAa,CAAW,CAAC;QACzF,MAAM,YAAY,GAAG,IAAI,CAAC,sBAAsB,CAAC,eAAe,CAAkB,CAAC;QAEnF,mCAAmC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAEzD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAA6D,CAAC;QAC5G,IAAI,OAAe,CAAC;QACpB,IAAI,WAAW,EAAE,CAAC;YACd,OAAO,GAAG,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzD,CAAC;aAAM,CAAC;YACJ,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;oBACtC,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,MAAM;oBACf,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChF,CAAC,CAAC,CAAC;YACJ,OAAO,GAAI,MAAiB,CAAC,IAAI,EAAE,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,WAAW,OAAO,QAAQ,WAAW,EAAE,CAAC,CAAC;IACjF,CAAC"}

package/dist/feral/node-code/input/prompt-select-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 PromptSelectNodeCode extends AbstractNodeCode {
+    static readonly configDescriptions: ConfigurationDescription[];
+    static readonly resultDescriptions: ResultDescription[];
+    constructor();
+    process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=prompt-select-node-code.d.ts.map

package/dist/feral/node-code/input/prompt-select-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-select-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/input/prompt-select-node-code.ts"],"names":[],"mappings":"AAUA,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,oBAAqB,SAAQ,gBAAgB;IACtD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAoB5D;IAEF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAErD;;IAWI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAyBnD"}

package/dist/feral/node-code/input/prompt-select-node-code.js

@@ -0,0 +1,65 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Prompt Select NodeCode
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// Pauses process execution to present the user with a list of choices.
+// Stores the selected value in context.  Supports {context_key} interpolation
+// in the prompt text.
+// ─────────────────────────────────────────────────────────────────────────────
+import inquirer from 'inquirer';
+import { ResultStatus } from '../../result/result.js';
+import { AbstractNodeCode } from '../abstract-node-code.js';
+import { NodeCodeCategory } from '../node-code.js';
+export class PromptSelectNodeCode extends AbstractNodeCode {
+    static configDescriptions = [
+        {
+            key: 'prompt',
+            name: 'Prompt',
+            description: 'The question to ask the user. Supports {context_key} interpolation.',
+            type: 'string',
+        },
+        {
+            key: 'options',
+            name: 'Options',
+            description: 'Comma-separated list of choices to present.',
+            type: 'string',
+        },
+        {
+            key: 'context_path',
+            name: 'Context Path',
+            description: 'Context key where the selected value will be stored.',
+            type: 'string',
+            default: 'user_selection',
+        },
+    ];
+    static resultDescriptions = [
+        { status: ResultStatus.OK, description: 'User selected a choice.' },
+    ];
+    constructor() {
+        super('prompt_select', 'Prompt Select', 'Present the user with choices and store their selection in context.', NodeCodeCategory.DATA);
+    }
+    async process(context) {
+        const promptTemplate = this.getRequiredConfigValue('prompt');
+        const optionsRaw = this.getRequiredConfigValue('options');
+        const contextPath = this.getRequiredConfigValue('context_path', 'user_selection');
+        const prompt = this.interpolate(promptTemplate, context);
+        const choices = optionsRaw.split(',').map(s => s.trim()).filter(Boolean);
+        const askQuestion = context.get('_askQuestion');
+        let selection;
+        if (askQuestion) {
+            selection = await askQuestion(prompt, choices);
+        }
+        else {
+            const result = await inquirer.prompt([{
+                    type: 'list',
+                    name: 'selection',
+                    message: prompt,
+                    choices,
+                }]);
+            selection = result.selection;
+        }
+        context.set(contextPath, selection);
+        return this.result(ResultStatus.OK, `User selected "${selection}", stored in ${contextPath}`);
+    }
+}
+//# sourceMappingURL=prompt-select-node-code.js.map