phaibel 4.0.7

package/dist/feral/events/subscribers/logger-subscriber.js

@@ -0,0 +1,23 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Logger Event Subscriber
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates a subscriber that logs process lifecycle events.
+ */
+export function createLoggerSubscriber(logger) {
+    return (dispatcher) => {
+        dispatcher.on('process.start', (e) => {
+            logger(`Process "${e.process.key}" started`);
+        });
+        dispatcher.on('process.end', (e) => {
+            logger(`Process "${e.process.key}" ended`);
+        });
+        dispatcher.on('process.node.after', (e) => {
+            logger(`Node "${e.node.key}" → ${e.result.status}: ${e.result.message}`);
+        });
+        dispatcher.on('process.exception', (e) => {
+            logger(`Exception in node: ${e.error.message}`);
+        });
+    };
+}
+//# sourceMappingURL=logger-subscriber.js.map

package/dist/feral/events/subscribers/logger-subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-subscriber.js","sourceRoot":"","sources":["../../../../src/feral/events/subscribers/logger-subscriber.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,sCAAsC;AACtC,gFAAgF;AAUhF;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAClC,MAA6B;IAE7B,OAAO,CAAC,UAAU,EAAE,EAAE;QAClB,UAAU,CAAC,EAAE,CAAoB,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE;YACpD,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,UAAU,CAAC,EAAE,CAAkB,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE;YAChD,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,UAAU,CAAC,EAAE,CAAwB,oBAAoB,EAAE,CAAC,CAAC,EAAE,EAAE;YAC7D,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QACH,UAAU,CAAC,EAAE,CAAwB,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE;YAC5D,MAAM,CAAC,sBAAsB,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}

package/dist/feral/events/subscribers/profiler-subscriber.d.ts

@@ -0,0 +1,8 @@
+import type { EventDispatcher } from '../event-dispatcher.js';
+import type { ProcessTraceCollector, ProcessTrace } from '../../trace/process-trace.js';
+/**
+ * Creates a subscriber that records timing data for each node.
+ * Uses a ProcessTraceCollector to build a trace of the process execution.
+ */
+export declare function createProfilerSubscriber(collector: ProcessTraceCollector, onComplete?: (trace: ProcessTrace) => void): (dispatcher: EventDispatcher) => void;
+//# sourceMappingURL=profiler-subscriber.d.ts.map

package/dist/feral/events/subscribers/profiler-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-subscriber.d.ts","sourceRoot":"","sources":["../../../../src/feral/events/subscribers/profiler-subscriber.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAExF;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,SAAS,EAAE,qBAAqB,EAChC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAC3C,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAqBvC"}

package/dist/feral/events/subscribers/profiler-subscriber.js

@@ -0,0 +1,27 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Agent — Profiler Event Subscriber
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates a subscriber that records timing data for each node.
+ * Uses a ProcessTraceCollector to build a trace of the process execution.
+ */
+export function createProfilerSubscriber(collector, onComplete) {
+    return (dispatcher) => {
+        dispatcher.on('process.start', (e) => {
+            collector.startProcess(e.process.key);
+        });
+        dispatcher.on('process.node.before', (e) => {
+            collector.startNode(e.node.key);
+        });
+        dispatcher.on('process.node.after', (e) => {
+            collector.endNode(e.node.key, e.result.status, e.result.message);
+        });
+        dispatcher.on('process.end', () => {
+            const trace = collector.endProcess();
+            if (onComplete) {
+                onComplete(trace);
+            }
+        });
+    };
+}
+//# sourceMappingURL=profiler-subscriber.js.map

package/dist/feral/events/subscribers/profiler-subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-subscriber.js","sourceRoot":"","sources":["../../../../src/feral/events/subscribers/profiler-subscriber.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,0CAA0C;AAC1C,gFAAgF;AAWhF;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACpC,SAAgC,EAChC,UAA0C;IAE1C,OAAO,CAAC,UAAU,EAAE,EAAE;QAClB,UAAU,CAAC,EAAE,CAAoB,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE;YACpD,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,EAAE,CAAyB,qBAAqB,EAAE,CAAC,CAAC,EAAE,EAAE;YAC/D,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,EAAE,CAAwB,oBAAoB,EAAE,CAAC,CAAC,EAAE,EAAE;YAC7D,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,EAAE,CAAkB,aAAa,EAAE,GAAG,EAAE;YAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC;YACrC,IAAI,UAAU,EAAE,CAAC;gBACb,UAAU,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}

package/dist/feral/feral-tool-registry.d.ts

@@ -0,0 +1,18 @@
+import type { ProcessFactory } from './process/process-factory.js';
+import type { Runner } from './runner/runner.js';
+import type { ServiceTool } from '../tools/types.js';
+/**
+ * Scans all Feral processes for `tool` metadata and produces ServiceTool
+ * objects with a generic execute() that delegates to runner.run().
+ */
+export declare class FeralToolRegistry {
+    private processFactory;
+    private runner;
+    private tools;
+    constructor(processFactory: ProcessFactory, runner: Runner);
+    getTool(name: string): ServiceTool | undefined;
+    hasTool(name: string): boolean;
+    listTools(): ServiceTool[];
+    private buildTools;
+}
+//# sourceMappingURL=feral-tool-registry.d.ts.map

package/dist/feral/feral-tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feral-tool-registry.d.ts","sourceRoot":"","sources":["../../src/feral/feral-tool-registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,mBAAmB,CAAC;AAGxE;;;GAGG;AACH,qBAAa,iBAAiB;IAItB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,MAAM;IAJlB,OAAO,CAAC,KAAK,CAAuC;gBAGxC,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,MAAM;IAO1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI9C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,SAAS,IAAI,WAAW,EAAE;IAM1B,OAAO,CAAC,UAAU;CAsDrB"}

package/dist/feral/feral-tool-registry.js

@@ -0,0 +1,78 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral Tool Registry
+//
+// Auto-generates ServiceTool objects from Feral processes that include
+// a `tool` metadata block in their JSON definition.  This eliminates
+// the need for hand-written registerServiceTool() wrappers for every
+// CRUD operation.
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Scans all Feral processes for `tool` metadata and produces ServiceTool
+ * objects with a generic execute() that delegates to runner.run().
+ */
+export class FeralToolRegistry {
+    processFactory;
+    runner;
+    tools = new Map();
+    constructor(processFactory, runner) {
+        this.processFactory = processFactory;
+        this.runner = runner;
+        this.buildTools();
+    }
+    // ── Public API ──────────────────────────────────────────────────────
+    getTool(name) {
+        return this.tools.get(name);
+    }
+    hasTool(name) {
+        return this.tools.has(name);
+    }
+    listTools() {
+        return Array.from(this.tools.values());
+    }
+    // ── Internals ───────────────────────────────────────────────────────
+    buildTools() {
+        const processes = this.processFactory.getAllProcesses();
+        for (const process of processes) {
+            if (!process.tool)
+                continue; // skip processes without tool metadata
+            const meta = process.tool;
+            const runner = this.runner;
+            const processKey = process.key;
+            const tool = {
+                name: processKey,
+                description: process.description || processKey,
+                type: meta.type,
+                ...(meta.capability && { capability: meta.capability }),
+                ...(meta.input_schema && { inputSchema: meta.input_schema }),
+                execute: async (input, context) => {
+                    context.log.info(`Running Feral process: ${processKey}`);
+                    const inputRecord = (input ?? {});
+                    const ctx = await runner.run(processKey, inputRecord);
+                    const output = ctx.get('output');
+                    const error = ctx.get('error');
+                    if (error) {
+                        return { success: false, output: null, error: String(error) };
+                    }
+                    const result = {
+                        success: true,
+                        output: output ?? inputRecord,
+                    };
+                    // Apply canvas update if the process declares a canvas_type
+                    if (meta.canvas_type) {
+                        const title = inputRecord.title || '';
+                        const content = inputRecord.content || '';
+                        result.canvasUpdate = {
+                            type: meta.canvas_type,
+                            title,
+                            content,
+                            dirty: false,
+                        };
+                    }
+                    return result;
+                },
+            };
+            this.tools.set(processKey, tool);
+        }
+    }
+}
+//# sourceMappingURL=feral-tool-registry.js.map

package/dist/feral/feral-tool-registry.js.map

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

package/dist/feral/index.d.ts

@@ -0,0 +1,88 @@
+export { FeralError, InvalidConfigurationError, InvalidNodeCodeKeyError, InvalidNodeKeyError, MaximumNodeRunsError, MissingConfigurationValueError, ProcessError, ModelSchemaNotFoundError, AgentMaxIterationsError, } from './errors.js';
+export { ResultStatus, createResult } from './result/result.js';
+export type { Result, ResultStatusValue } from './result/result.js';
+export { DefaultContext } from './context/context.js';
+export type { Context } from './context/context.js';
+export { ConfigurationValueType, isSecret, resolveValue, resolveUnmaskedValue } from './configuration/configuration-value.js';
+export type { ConfigurationValue } from './configuration/configuration-value.js';
+export { ConfigurationManager } from './configuration/configuration-manager.js';
+export type { ConfigurationDescription, ResultDescription } from './configuration/configuration-description.js';
+export { NodeCodeCategory } from './node-code/node-code.js';
+export type { NodeCode, NodeCodeCategoryValue } from './node-code/node-code.js';
+export { AbstractNodeCode } from './node-code/abstract-node-code.js';
+export { NodeCodeFactory } from './node-code/node-code-factory.js';
+export type { NodeCodeSource } from './node-code/node-code-factory.js';
+export { StartNodeCode } from './node-code/flow/start-node-code.js';
+export { StopNodeCode } from './node-code/flow/stop-node-code.js';
+export { NoopNodeCode } from './node-code/flow/noop-node-code.js';
+export { ComparatorNodeCode } from './node-code/flow/comparator-node-code.js';
+export { ContextValueResultNodeCode } from './node-code/flow/context-value-result-node-code.js';
+export { ThrowExceptionNodeCode } from './node-code/flow/throw-exception-node-code.js';
+export { SetContextValueNodeCode } from './node-code/data/set-context-value-node-code.js';
+export { SetContextTableNodeCode } from './node-code/data/set-context-table-node-code.js';
+export { CalculationNodeCode } from './node-code/data/calculation-node-code.js';
+export { CounterNodeCode } from './node-code/data/counter-node-code.js';
+export { HttpNodeCode } from './node-code/data/http-node-code.js';
+export { JsonDecodeNodeCode } from './node-code/data/json-decode-node-code.js';
+export { JsonEncodeNodeCode } from './node-code/data/json-encode-node-code.js';
+export { LogNodeCode } from './node-code/data/log-node-code.js';
+export { RandomValueNodeCode } from './node-code/data/random-value-node-code.js';
+export { ReadFileNodeCode } from './node-code/data/read-file-node-code.js';
+export { createCatalogNode } from './catalog/catalog-node.js';
+export type { CatalogNode } from './catalog/catalog-node.js';
+export { Catalog } from './catalog/catalog.js';
+export type { CatalogSource } from './catalog/catalog.js';
+export type { ProcessNode } from './process/node.js';
+export type { Edge } from './process/edge.js';
+export { EdgeCollection } from './process/edge.js';
+export type { Process } from './process/process.js';
+export { hydrateProcess, hydrateProcessFromString } from './process/process-json-hydrator.js';
+export type { ProcessConfigJson } from './process/process-json-hydrator.js';
+export { ProcessFactory } from './process/process-factory.js';
+export type { ProcessSource } from './process/process-factory.js';
+export { JsonProcessSource } from './process/json-process-source.js';
+export type { ProcessStartEvent, ProcessEndEvent, ProcessNodeBeforeEvent, ProcessNodeAfterEvent, ProcessExceptionEvent, ProcessNodeNotifyEvent, ProcessEvent, EventType, } from './events/events.js';
+export { EventDispatcher } from './events/event-dispatcher.js';
+export type { EventHandler } from './events/event-dispatcher.js';
+export { createLoggerSubscriber } from './events/subscribers/logger-subscriber.js';
+export { createCycleDetectionSubscriber } from './events/subscribers/cycle-detection-subscriber.js';
+export { createProfilerSubscriber } from './events/subscribers/profiler-subscriber.js';
+export { ProcessEngine } from './engine/process-engine.js';
+export { Runner } from './runner/runner.js';
+export { BuiltInCatalogSource } from './catalog/built-in-catalog-source.js';
+export { JsonCatalogSource } from './catalog/json-catalog-source.js';
+export { loadFeralCatalogConfig, saveFeralCatalogConfig } from './catalog/feral-catalog-config.js';
+export type { FeralCatalogConfigJson, CatalogNodeConfigJson } from './catalog/feral-catalog-config.js';
+export { SlackCatalogSource } from './catalog/slack-catalog-source.js';
+export { AgentCatalogSource } from './catalog/agent-catalog-source.js';
+export { EntityCatalogSource } from './catalog/entity-catalog-source.js';
+export { SlackBlockBuilderNodeCode } from './node-code/slack/slack-block-builder-node-code.js';
+export { SlackPostWebhookNodeCode } from './node-code/slack/slack-post-webhook-node-code.js';
+export { SlackProcessSlashCommandNodeCode } from './node-code/slack/slack-process-slash-command-node-code.js';
+export { MergeStringsNodeCode } from './node-code/genai/merge-strings-node-code.js';
+export { DataSynthesisPrepNodeCode } from './node-code/genai/data-synthesis-prep-node-code.js';
+export { WriteFileNodeCode } from './node-code/genai/write-file-node-code.js';
+export { GenerateMarkdownNodeCode } from './node-code/genai/generate-markdown-node-code.js';
+export { GenerateHtmlNodeCode } from './node-code/genai/generate-html-node-code.js';
+export { WriteEntityNodeCode } from './node-code/genai/write-entity-node-code.js';
+export type { EntityPersister } from './node-code/genai/write-entity-node-code.js';
+export { WriteToRedisNodeCode } from './node-code/genai/write-to-redis-node-code.js';
+export type { KeyValueStore } from './node-code/genai/write-to-redis-node-code.js';
+export { OpenAiNodeCode } from './node-code/genai/openai-node-code.js';
+export { ModelToOutputNodeCode } from './node-code/genai/model-to-output-node-code.js';
+export { HydrateModelNodeCode } from './node-code/genai/hydrate-model-node-code.js';
+export { ListEntitiesNodeCode } from './node-code/entity/list-entities-node-code.js';
+export { FindEntityNodeCode } from './node-code/entity/find-entity-node-code.js';
+export { CreateEntityNodeCode } from './node-code/entity/create-entity-node-code.js';
+export { UpdateEntityNodeCode } from './node-code/entity/update-entity-node-code.js';
+export { DeleteEntityNodeCode } from './node-code/entity/delete-entity-node-code.js';
+export { SortEntitiesNodeCode } from './node-code/entity/sort-entities-node-code.js';
+export type { TraceEntry, ProcessTrace, ProcessTraceCollector } from './trace/process-trace.js';
+export { DefaultProcessTraceCollector } from './trace/process-trace.js';
+export { PromptInputNodeCode } from './node-code/input/prompt-input-node-code.js';
+export { PromptSelectNodeCode } from './node-code/input/prompt-select-node-code.js';
+export * as Slack from './slack/index.js';
+export * as Agent from './agent/index.js';
+export { bootstrapFeral } from './bootstrap.js';
+export type { FeralRuntime } from './bootstrap.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/feral/index.d.ts.map

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

package/dist/feral/index.js

@@ -0,0 +1,89 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Public API
+// ─────────────────────────────────────────────────────────────────────────────
+// Errors
+export { FeralError, InvalidConfigurationError, InvalidNodeCodeKeyError, InvalidNodeKeyError, MaximumNodeRunsError, MissingConfigurationValueError, ProcessError, ModelSchemaNotFoundError, AgentMaxIterationsError, } from './errors.js';
+// Result
+export { ResultStatus, createResult } from './result/result.js';
+// Context
+export { DefaultContext } from './context/context.js';
+// Configuration
+export { ConfigurationValueType, isSecret, resolveValue, resolveUnmaskedValue } from './configuration/configuration-value.js';
+export { ConfigurationManager } from './configuration/configuration-manager.js';
+// NodeCode
+export { NodeCodeCategory } from './node-code/node-code.js';
+export { AbstractNodeCode } from './node-code/abstract-node-code.js';
+export { NodeCodeFactory } from './node-code/node-code-factory.js';
+// Built-in Flow Nodes
+export { StartNodeCode } from './node-code/flow/start-node-code.js';
+export { StopNodeCode } from './node-code/flow/stop-node-code.js';
+export { NoopNodeCode } from './node-code/flow/noop-node-code.js';
+export { ComparatorNodeCode } from './node-code/flow/comparator-node-code.js';
+export { ContextValueResultNodeCode } from './node-code/flow/context-value-result-node-code.js';
+export { ThrowExceptionNodeCode } from './node-code/flow/throw-exception-node-code.js';
+// Built-in Data Nodes
+export { SetContextValueNodeCode } from './node-code/data/set-context-value-node-code.js';
+export { SetContextTableNodeCode } from './node-code/data/set-context-table-node-code.js';
+export { CalculationNodeCode } from './node-code/data/calculation-node-code.js';
+export { CounterNodeCode } from './node-code/data/counter-node-code.js';
+export { HttpNodeCode } from './node-code/data/http-node-code.js';
+export { JsonDecodeNodeCode } from './node-code/data/json-decode-node-code.js';
+export { JsonEncodeNodeCode } from './node-code/data/json-encode-node-code.js';
+export { LogNodeCode } from './node-code/data/log-node-code.js';
+export { RandomValueNodeCode } from './node-code/data/random-value-node-code.js';
+export { ReadFileNodeCode } from './node-code/data/read-file-node-code.js';
+// Catalog
+export { createCatalogNode } from './catalog/catalog-node.js';
+export { Catalog } from './catalog/catalog.js';
+export { EdgeCollection } from './process/edge.js';
+export { hydrateProcess, hydrateProcessFromString } from './process/process-json-hydrator.js';
+export { ProcessFactory } from './process/process-factory.js';
+export { JsonProcessSource } from './process/json-process-source.js';
+export { EventDispatcher } from './events/event-dispatcher.js';
+export { createLoggerSubscriber } from './events/subscribers/logger-subscriber.js';
+export { createCycleDetectionSubscriber } from './events/subscribers/cycle-detection-subscriber.js';
+export { createProfilerSubscriber } from './events/subscribers/profiler-subscriber.js';
+// Engine
+export { ProcessEngine } from './engine/process-engine.js';
+// Runner
+export { Runner } from './runner/runner.js';
+// Catalog Config + Sources
+export { BuiltInCatalogSource } from './catalog/built-in-catalog-source.js';
+export { JsonCatalogSource } from './catalog/json-catalog-source.js';
+export { loadFeralCatalogConfig, saveFeralCatalogConfig } from './catalog/feral-catalog-config.js';
+export { SlackCatalogSource } from './catalog/slack-catalog-source.js';
+export { AgentCatalogSource } from './catalog/agent-catalog-source.js';
+export { EntityCatalogSource } from './catalog/entity-catalog-source.js';
+// Slack NodeCodes
+export { SlackBlockBuilderNodeCode } from './node-code/slack/slack-block-builder-node-code.js';
+export { SlackPostWebhookNodeCode } from './node-code/slack/slack-post-webhook-node-code.js';
+export { SlackProcessSlashCommandNodeCode } from './node-code/slack/slack-process-slash-command-node-code.js';
+// GenAI NodeCodes
+export { MergeStringsNodeCode } from './node-code/genai/merge-strings-node-code.js';
+export { DataSynthesisPrepNodeCode } from './node-code/genai/data-synthesis-prep-node-code.js';
+export { WriteFileNodeCode } from './node-code/genai/write-file-node-code.js';
+export { GenerateMarkdownNodeCode } from './node-code/genai/generate-markdown-node-code.js';
+export { GenerateHtmlNodeCode } from './node-code/genai/generate-html-node-code.js';
+export { WriteEntityNodeCode } from './node-code/genai/write-entity-node-code.js';
+export { WriteToRedisNodeCode } from './node-code/genai/write-to-redis-node-code.js';
+export { OpenAiNodeCode } from './node-code/genai/openai-node-code.js';
+export { ModelToOutputNodeCode } from './node-code/genai/model-to-output-node-code.js';
+export { HydrateModelNodeCode } from './node-code/genai/hydrate-model-node-code.js';
+// Entity NodeCodes
+export { ListEntitiesNodeCode } from './node-code/entity/list-entities-node-code.js';
+export { FindEntityNodeCode } from './node-code/entity/find-entity-node-code.js';
+export { CreateEntityNodeCode } from './node-code/entity/create-entity-node-code.js';
+export { UpdateEntityNodeCode } from './node-code/entity/update-entity-node-code.js';
+export { DeleteEntityNodeCode } from './node-code/entity/delete-entity-node-code.js';
+export { SortEntitiesNodeCode } from './node-code/entity/sort-entities-node-code.js';
+export { DefaultProcessTraceCollector } from './trace/process-trace.js';
+// Input NodeCodes
+export { PromptInputNodeCode } from './node-code/input/prompt-input-node-code.js';
+export { PromptSelectNodeCode } from './node-code/input/prompt-select-node-code.js';
+// Slack SDK (re-export sub-module)
+export * as Slack from './slack/index.js';
+// Agent (re-export sub-module)
+export * as Agent from './agent/index.js';
+// Bootstrap
+export { bootstrapFeral } from './bootstrap.js';
+//# sourceMappingURL=index.js.map

package/dist/feral/index.js.map

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

package/dist/feral/node-code/abstract-node-code.d.ts

@@ -0,0 +1,38 @@
+import type { Context } from '../context/context.js';
+import type { ConfigurationValue } from '../configuration/configuration-value.js';
+import { ConfigurationManager } from '../configuration/configuration-manager.js';
+import type { Result } from '../result/result.js';
+import { type ResultStatusValue } from '../result/result.js';
+import type { NodeCode, NodeCodeCategoryValue } from './node-code.js';
+/**
+ * Base class for all NodeCode implementations.
+ * Replaces PHP traits (NodeCodeMetaTrait, ResultsTrait, ConfigurationTrait, etc.)
+ */
+export declare abstract class AbstractNodeCode implements NodeCode {
+    readonly key: string;
+    readonly name: string;
+    readonly description: string;
+    readonly categoryKey: NodeCodeCategoryValue;
+    protected configManager: ConfigurationManager;
+    constructor(key: string, name: string, description: string, categoryKey: NodeCodeCategoryValue);
+    addConfiguration(values: ConfigurationValue[]): void;
+    /** Helper: create a Result */
+    protected result(status: ResultStatusValue, message?: string): Result;
+    /** Helper: get a required config value, throw if missing */
+    protected getRequiredConfigValue(key: string, fallback?: unknown): unknown;
+    /** Helper: get an optional config value */
+    protected getOptionalConfigValue(key: string, fallback?: unknown): unknown;
+    /**
+     * Replace {key} and {key|pipe} tokens in a template with context values.
+     *
+     * Simple:   {title}          → context.get('title')
+     * Piped:    {title|date}     → extract YYYY-MM-DD from title
+     *           {title|after:—}  → everything after "—"
+     *           {title|regex:(\d{4}-\d{2}-\d{2})} → first capture group
+     *
+     * Multiple pipes can be chained: {title|after:—|trim|date}
+     */
+    protected interpolate(template: string, context: Context): string;
+    abstract process(context: Context): Promise<Result>;
+}
+//# sourceMappingURL=abstract-node-code.d.ts.map

package/dist/feral/node-code/abstract-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-node-code.d.ts","sourceRoot":"","sources":["../../../src/feral/node-code/abstract-node-code.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAyDtE;;;GAGG;AACH,8BAAsB,gBAAiB,YAAW,QAAQ;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,SAAS,CAAC,aAAa,EAAE,oBAAoB,CAAC;gBAElC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB;IAQ9F,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAIpD,8BAA8B;IAC9B,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,SAAK,GAAG,MAAM;IAIjE,4DAA4D;IAC5D,SAAS,CAAC,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO;IAO1E,2CAA2C;IAC3C,SAAS,CAAC,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO;IAI1E;;;;;;;;;OASG;IACH,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM;IAsBjE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CACtD"}

package/dist/feral/node-code/abstract-node-code.js

@@ -0,0 +1,127 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Abstract NodeCode Base Class
+// ─────────────────────────────────────────────────────────────────────────────
+import { ConfigurationManager } from '../configuration/configuration-manager.js';
+import { createResult } from '../result/result.js';
+import { MissingConfigurationValueError } from '../errors.js';
+// Date pattern: YYYY-MM-DD (optionally followed by time)
+const DATE_RE = /\d{4}-\d{2}-\d{2}/;
+/**
+ * Apply a pipe transform to a string value.
+ *
+ * Supported pipes:
+ *   {key|date}              — extract first YYYY-MM-DD date
+ *   {key|after:delim}       — everything after the first occurrence of delim (trimmed)
+ *   {key|before:delim}      — everything before the first occurrence of delim (trimmed)
+ *   {key|trim}              — trim whitespace
+ *   {key|lower}             — lowercase
+ *   {key|upper}             — uppercase
+ *   {key|regex:pattern}     — extract first capture group (or full match) of regex
+ */
+function applyPipe(value, pipe) {
+    const colonIdx = pipe.indexOf(':');
+    const pipeName = colonIdx >= 0 ? pipe.slice(0, colonIdx) : pipe;
+    const pipeArg = colonIdx >= 0 ? pipe.slice(colonIdx + 1) : '';
+    switch (pipeName) {
+        case 'date': {
+            const m = DATE_RE.exec(value);
+            return m ? m[0] : value;
+        }
+        case 'after': {
+            const idx = value.indexOf(pipeArg);
+            return idx >= 0 ? value.slice(idx + pipeArg.length).trim() : value;
+        }
+        case 'before': {
+            const idx = value.indexOf(pipeArg);
+            return idx >= 0 ? value.slice(0, idx).trim() : value;
+        }
+        case 'trim':
+            return value.trim();
+        case 'lower':
+            return value.toLowerCase();
+        case 'upper':
+            return value.toUpperCase();
+        case 'regex': {
+            try {
+                const re = new RegExp(pipeArg);
+                const m = re.exec(value);
+                if (!m)
+                    return value;
+                // Return first capture group if available, else full match
+                return m[1] ?? m[0];
+            }
+            catch {
+                return value;
+            }
+        }
+        default:
+            return value;
+    }
+}
+/**
+ * Base class for all NodeCode implementations.
+ * Replaces PHP traits (NodeCodeMetaTrait, ResultsTrait, ConfigurationTrait, etc.)
+ */
+export class AbstractNodeCode {
+    key;
+    name;
+    description;
+    categoryKey;
+    configManager;
+    constructor(key, name, description, categoryKey) {
+        this.key = key;
+        this.name = name;
+        this.description = description;
+        this.categoryKey = categoryKey;
+        this.configManager = new ConfigurationManager();
+    }
+    addConfiguration(values) {
+        this.configManager.merge(values);
+    }
+    /** Helper: create a Result */
+    result(status, message = '') {
+        return createResult(status, message);
+    }
+    /** Helper: get a required config value, throw if missing */
+    getRequiredConfigValue(key, fallback) {
+        const val = this.configManager.getValue(key);
+        if (val != null)
+            return val;
+        if (fallback !== undefined)
+            return fallback;
+        throw new MissingConfigurationValueError(key);
+    }
+    /** Helper: get an optional config value */
+    getOptionalConfigValue(key, fallback) {
+        return this.configManager.getValue(key) ?? fallback ?? null;
+    }
+    /**
+     * Replace {key} and {key|pipe} tokens in a template with context values.
+     *
+     * Simple:   {title}          → context.get('title')
+     * Piped:    {title|date}     → extract YYYY-MM-DD from title
+     *           {title|after:—}  → everything after "—"
+     *           {title|regex:(\d{4}-\d{2}-\d{2})} → first capture group
+     *
+     * Multiple pipes can be chained: {title|after:—|trim|date}
+     */
+    interpolate(template, context) {
+        return template.replace(/\{([^}]+)\}/g, (match, expr) => {
+            const parts = expr.split('|');
+            const key = parts[0].trim();
+            // Key must be a simple identifier
+            if (!/^\w+$/.test(key))
+                return match;
+            let value = context.get(key);
+            if (value === undefined || value === null)
+                return '';
+            let str = String(value);
+            // Apply pipe transforms
+            for (let i = 1; i < parts.length; i++) {
+                str = applyPipe(str, parts[i].trim());
+            }
+            return str;
+        });
+    }
+}
+//# sourceMappingURL=abstract-node-code.js.map

package/dist/feral/node-code/abstract-node-code.js.map

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

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

package/dist/feral/node-code/data/calculation-node-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculation-node-code.d.ts","sourceRoot":"","sources":["../../../../src/feral/node-code/data/calculation-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,mBAAoB,SAAQ,gBAAgB;IACrD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,CAM5D;IACF,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,CAGrD;;IAMI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAsCnD"}