phaibel 4.0.7

package/dist/feral/configuration/configuration-manager.d.ts

@@ -0,0 +1,12 @@
+import type { ConfigurationValue } from './configuration-value.js';
+export declare class ConfigurationManager {
+    static readonly DELETE = "_DELETE_";
+    private config;
+    merge(overrides: ConfigurationValue[]): void;
+    hasValue(key: string): boolean;
+    hasDefault(key: string): boolean;
+    getValue(key: string): unknown;
+    getUnmaskedValue(key: string): unknown;
+    getAll(): Map<string, ConfigurationValue>;
+}
+//# sourceMappingURL=configuration-manager.d.ts.map

package/dist/feral/configuration/configuration-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-manager.d.ts","sourceRoot":"","sources":["../../../src/feral/configuration/configuration-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,qBAAa,oBAAoB;IAC7B,MAAM,CAAC,QAAQ,CAAC,MAAM,cAAc;IACpC,OAAO,CAAC,MAAM,CAA8C;IAE5D,KAAK,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAU5C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAK9B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKhC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAO9B,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKtC,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;CAG5C"}

package/dist/feral/configuration/configuration-manager.js

@@ -0,0 +1,41 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Configuration Manager
+// ─────────────────────────────────────────────────────────────────────────────
+export class ConfigurationManager {
+    static DELETE = '_DELETE_';
+    config = new Map();
+    merge(overrides) {
+        for (const cv of overrides) {
+            if (this.config.has(cv.key) && cv.value === ConfigurationManager.DELETE) {
+                this.config.delete(cv.key);
+            }
+            else {
+                this.config.set(cv.key, cv);
+            }
+        }
+    }
+    hasValue(key) {
+        const cv = this.config.get(key);
+        return cv != null && cv.value != null;
+    }
+    hasDefault(key) {
+        const cv = this.config.get(key);
+        return cv != null && cv.default != null;
+    }
+    getValue(key) {
+        const cv = this.config.get(key);
+        if (!cv)
+            return null;
+        if (cv.value != null)
+            return cv.value;
+        return cv.default ?? null;
+    }
+    getUnmaskedValue(key) {
+        const cv = this.config.get(key);
+        return cv?.value ?? cv?.default ?? null;
+    }
+    getAll() {
+        return new Map(this.config);
+    }
+}
+//# sourceMappingURL=configuration-manager.js.map

package/dist/feral/configuration/configuration-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-manager.js","sourceRoot":"","sources":["../../../src/feral/configuration/configuration-manager.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,oCAAoC;AACpC,gFAAgF;AAIhF,MAAM,OAAO,oBAAoB;IAC7B,MAAM,CAAU,MAAM,GAAG,UAAU,CAAC;IAC5B,MAAM,GAAoC,IAAI,GAAG,EAAE,CAAC;IAE5D,KAAK,CAAC,SAA+B;QACjC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,oBAAoB,CAAC,MAAM,EAAE,CAAC;gBACtE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC;QACL,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,GAAW;QAChB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED,UAAU,CAAC,GAAW;QAClB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,QAAQ,CAAC,GAAW;QAChB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,IAAI,EAAE,CAAC,KAAK,IAAI,IAAI;YAAE,OAAO,EAAE,CAAC,KAAK,CAAC;QACtC,OAAO,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED,gBAAgB,CAAC,GAAW;QACxB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,EAAE,EAAE,KAAK,IAAI,EAAE,EAAE,OAAO,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,MAAM;QACF,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC"}

package/dist/feral/configuration/configuration-value.d.ts

@@ -0,0 +1,16 @@
+export declare enum ConfigurationValueType {
+    STANDARD = "STANDARD",
+    SECRET = "SECRET",
+    OPTIONAL = "OPTIONAL",
+    OPTIONAL_SECRET = "OPTIONAL_SECRET"
+}
+export interface ConfigurationValue {
+    key: string;
+    type: ConfigurationValueType;
+    value?: unknown;
+    default?: unknown;
+}
+export declare function isSecret(cv: ConfigurationValue): boolean;
+export declare function resolveValue(cv: ConfigurationValue): unknown;
+export declare function resolveUnmaskedValue(cv: ConfigurationValue): unknown;
+//# sourceMappingURL=configuration-value.d.ts.map

package/dist/feral/configuration/configuration-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-value.d.ts","sourceRoot":"","sources":["../../../src/feral/configuration/configuration-value.ts"],"names":[],"mappings":"AAIA,oBAAY,sBAAsB;IAC9B,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,eAAe,oBAAoB;CACtC;AAED,MAAM,WAAW,kBAAkB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAExD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAG5D;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAEpE"}

package/dist/feral/configuration/configuration-value.js

@@ -0,0 +1,22 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Configuration Value
+// ─────────────────────────────────────────────────────────────────────────────
+export var ConfigurationValueType;
+(function (ConfigurationValueType) {
+    ConfigurationValueType["STANDARD"] = "STANDARD";
+    ConfigurationValueType["SECRET"] = "SECRET";
+    ConfigurationValueType["OPTIONAL"] = "OPTIONAL";
+    ConfigurationValueType["OPTIONAL_SECRET"] = "OPTIONAL_SECRET";
+})(ConfigurationValueType || (ConfigurationValueType = {}));
+export function isSecret(cv) {
+    return cv.type === ConfigurationValueType.SECRET || cv.type === ConfigurationValueType.OPTIONAL_SECRET;
+}
+export function resolveValue(cv) {
+    if (cv.value != null)
+        return isSecret(cv) ? '*********' : cv.value;
+    return cv.default ?? null;
+}
+export function resolveUnmaskedValue(cv) {
+    return cv.value ?? cv.default ?? null;
+}
+//# sourceMappingURL=configuration-value.js.map

package/dist/feral/configuration/configuration-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-value.js","sourceRoot":"","sources":["../../../src/feral/configuration/configuration-value.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kCAAkC;AAClC,gFAAgF;AAEhF,MAAM,CAAN,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAC9B,+CAAqB,CAAA;IACrB,2CAAiB,CAAA;IACjB,+CAAqB,CAAA;IACrB,6DAAmC,CAAA;AACvC,CAAC,EALW,sBAAsB,KAAtB,sBAAsB,QAKjC;AASD,MAAM,UAAU,QAAQ,CAAC,EAAsB;IAC3C,OAAO,EAAE,CAAC,IAAI,KAAK,sBAAsB,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,KAAK,sBAAsB,CAAC,eAAe,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAsB;IAC/C,IAAI,EAAE,CAAC,KAAK,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC;IACnE,OAAO,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAsB;IACvD,OAAO,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC;AAC1C,CAAC"}

package/dist/feral/context/context.d.ts

@@ -0,0 +1,28 @@
+export interface Context {
+    set(key: string, value: unknown): void;
+    get(key: string): unknown;
+    has(key: string): boolean;
+    remove(key: string): void;
+    clear(key: string): boolean;
+    getAll(): Record<string, unknown>;
+    getInt(key: string): number;
+    getFloat(key: string): number;
+    getString(key: string): string;
+    getArray(key: string): unknown[];
+    getObject<T = Record<string, unknown>>(key: string): T;
+}
+export declare class DefaultContext implements Context {
+    private data;
+    set(key: string, value: unknown): void;
+    get(key: string): unknown;
+    has(key: string): boolean;
+    remove(key: string): void;
+    clear(key: string): boolean;
+    getAll(): Record<string, unknown>;
+    getInt(key: string): number;
+    getFloat(key: string): number;
+    getString(key: string): string;
+    getArray(key: string): unknown[];
+    getObject<T = Record<string, unknown>>(key: string): T;
+}
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/feral/context/context.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACpB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IACjC,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;CAC1D;AAED,qBAAa,cAAe,YAAW,OAAO;IAC1C,OAAO,CAAC,IAAI,CAA+B;IAE3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAItC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ3B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI7B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI9B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE;IAIhC,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;CAGzD"}

package/dist/feral/context/context.js

@@ -0,0 +1,44 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Context
+// ─────────────────────────────────────────────────────────────────────────────
+export class DefaultContext {
+    data = {};
+    set(key, value) {
+        this.data[key] = value;
+    }
+    get(key) {
+        return this.data[key] ?? null;
+    }
+    has(key) {
+        return key in this.data && this.data[key] != null;
+    }
+    remove(key) {
+        this.data[key] = null;
+    }
+    clear(key) {
+        if (this.has(key)) {
+            this.data[key] = null;
+            return true;
+        }
+        return false;
+    }
+    getAll() {
+        return { ...this.data };
+    }
+    getInt(key) {
+        return Number(this.data[key]) | 0;
+    }
+    getFloat(key) {
+        return Number(this.data[key]);
+    }
+    getString(key) {
+        return String(this.data[key] ?? '');
+    }
+    getArray(key) {
+        return Array.isArray(this.data[key]) ? this.data[key] : [];
+    }
+    getObject(key) {
+        return this.data[key];
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/feral/context/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/feral/context/context.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAkBhF,MAAM,OAAO,cAAc;IACf,IAAI,GAA4B,EAAE,CAAC;IAE3C,GAAG,CAAC,GAAW,EAAE,KAAc;QAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAW;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,GAAW;QACX,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACtD,CAAC;IAED,MAAM,CAAC,GAAW;QACd,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,GAAW;QACb,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACtB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM;QACF,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,GAAW;QACd,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,QAAQ,CAAC,GAAW;QAChB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,SAAS,CAAC,GAAW;QACjB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ,CAAC,GAAW;QAChB,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,CAAC;IAED,SAAS,CAA8B,GAAW;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAM,CAAC;IAC/B,CAAC;CACJ"}

package/dist/feral/engine/process-engine.d.ts

@@ -0,0 +1,23 @@
+import type { EventDispatcher } from '../events/event-dispatcher.js';
+import type { Catalog } from '../catalog/catalog.js';
+import type { NodeCodeFactory } from '../node-code/node-code-factory.js';
+import type { Context } from '../context/context.js';
+import type { Process } from '../process/process.js';
+/**
+ * Core execution loop.
+ *
+ * Resolves NodeCode from CatalogNode references, layers configuration
+ * (NodeCode defaults → CatalogNode config → ProcessNode config),
+ * and runs the directed node graph sequentially.
+ */
+export declare class ProcessEngine {
+    private eventDispatcher;
+    private catalog;
+    private nodeCodeFactory;
+    private cachedNodeCodes;
+    constructor(eventDispatcher: EventDispatcher, catalog: Catalog, nodeCodeFactory: NodeCodeFactory);
+    process(processDefn: Process, context: Context, startNodeKey?: string): Promise<void>;
+    private getConfiguredNodeCode;
+    private processNode;
+}
+//# sourceMappingURL=process-engine.d.ts.map

package/dist/feral/engine/process-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-engine.d.ts","sourceRoot":"","sources":["../../../src/feral/engine/process-engine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIrD;;;;;;GAMG;AACH,qBAAa,aAAa;IAIlB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,eAAe;IAL3B,OAAO,CAAC,eAAe,CAAoC;gBAG/C,eAAe,EAAE,eAAe,EAChC,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,eAAe;IAGtC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,SAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC5F,OAAO,CAAC,qBAAqB;YAqEf,WAAW;CAiB5B"}

package/dist/feral/engine/process-engine.js

@@ -0,0 +1,134 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Process Engine
+// ─────────────────────────────────────────────────────────────────────────────
+import { ConfigurationValueType } from '../configuration/configuration-value.js';
+import { ResultStatus } from '../result/result.js';
+import { EdgeCollection } from '../process/edge.js';
+import { InvalidNodeKeyError } from '../errors.js';
+/**
+ * Core execution loop.
+ *
+ * Resolves NodeCode from CatalogNode references, layers configuration
+ * (NodeCode defaults → CatalogNode config → ProcessNode config),
+ * and runs the directed node graph sequentially.
+ */
+export class ProcessEngine {
+    eventDispatcher;
+    catalog;
+    nodeCodeFactory;
+    cachedNodeCodes = new Map();
+    constructor(eventDispatcher, catalog, nodeCodeFactory) {
+        this.eventDispatcher = eventDispatcher;
+        this.catalog = catalog;
+        this.nodeCodeFactory = nodeCodeFactory;
+    }
+    async process(processDefn, context, startNodeKey = 'start') {
+        const nodeMap = new Map(processDefn.nodes.map(n => [n.key, n]));
+        const edgeCollection = new EdgeCollection();
+        for (const edge of processDefn.edges) {
+            edgeCollection.addEdge(edge);
+        }
+        // Merge process context into runtime context
+        for (const [k, v] of Object.entries(processDefn.context.getAll())) {
+            context.set(k, v);
+        }
+        this.eventDispatcher.dispatch({ type: 'process.start', process: processDefn, context });
+        let currentKey = startNodeKey;
+        let node = nodeMap.get(currentKey);
+        if (!node)
+            throw new InvalidNodeKeyError(currentKey);
+        let nodeCode = this.getConfiguredNodeCode(node);
+        let result = await this.processNode(node, nodeCode, context);
+        while (result.status !== ResultStatus.STOP) {
+            const edges = edgeCollection.getEdgesByNodeAndResult(currentKey, result.status);
+            if (edges.length === 0) {
+                throw new Error(`No edge found for node "${currentKey}" with result "${result.status}".`);
+            }
+            currentKey = edges[0].toKey;
+            node = nodeMap.get(currentKey);
+            if (!node)
+                throw new InvalidNodeKeyError(currentKey);
+            nodeCode = this.getConfiguredNodeCode(node);
+            result = await this.processNode(node, nodeCode, context);
+        }
+        this.eventDispatcher.dispatch({ type: 'process.end', process: processDefn, context });
+    }
+    getConfiguredNodeCode(node) {
+        if (this.cachedNodeCodes.has(node.key)) {
+            return this.cachedNodeCodes.get(node.key);
+        }
+        const catalogNode = this.catalog.getCatalogNode(node.catalogNodeKey);
+        const nodeCode = this.nodeCodeFactory.getNodeCode(catalogNode.nodeCodeKey);
+        // Get config descriptions from the NodeCode class
+        const Ctor = nodeCode.constructor;
+        const descriptions = Ctor.configDescriptions ?? [];
+        // Build ConfigurationValue objects from descriptions
+        const configValues = new Map();
+        const requiredKeys = new Set();
+        for (const desc of descriptions) {
+            const type = desc.isSecret
+                ? (desc.isOptional ? ConfigurationValueType.OPTIONAL_SECRET : ConfigurationValueType.SECRET)
+                : (desc.isOptional ? ConfigurationValueType.OPTIONAL : ConfigurationValueType.STANDARD);
+            const cv = { key: desc.key, type, default: desc.default };
+            configValues.set(desc.key, cv);
+            if (!desc.isOptional && desc.default == null) {
+                requiredKeys.add(desc.key);
+            }
+        }
+        // Validate keys from catalog & process config (unless node allows extras)
+        const validKeys = new Set(configValues.keys());
+        if (!nodeCode.allowExtraConfig) {
+            for (const k of Object.keys(catalogNode.configuration)) {
+                if (!validKeys.has(k)) {
+                    throw new Error(`Catalog config key "${k}" invalid for node "${catalogNode.key}". Valid: ${[...validKeys].join(', ')}`);
+                }
+            }
+            for (const k of Object.keys(node.configuration)) {
+                if (!validKeys.has(k)) {
+                    throw new Error(`Process config key "${k}" invalid for node "${node.key}". Valid: ${[...validKeys].join(', ')}`);
+                }
+            }
+        }
+        // Merge: catalog config, then process node config overrides
+        const merged = { ...catalogNode.configuration, ...node.configuration };
+        for (const [k, v] of Object.entries(merged)) {
+            let cv = configValues.get(k);
+            if (!cv) {
+                // Extra key allowed by allowExtraConfig — create an OPTIONAL entry
+                cv = { key: k, type: ConfigurationValueType.OPTIONAL };
+                configValues.set(k, cv);
+            }
+            configValues.set(k, { ...cv, value: v });
+            requiredKeys.delete(k);
+        }
+        // Remove required keys that have defaults
+        for (const [k, cv] of configValues) {
+            if (cv.default != null)
+                requiredKeys.delete(k);
+        }
+        if (requiredKeys.size > 0) {
+            throw new Error(`Missing required config: ${[...requiredKeys].join(', ')} for node "${node.key}".`);
+        }
+        nodeCode.addConfiguration(Array.from(configValues.values()));
+        this.cachedNodeCodes.set(node.key, nodeCode);
+        return nodeCode;
+    }
+    async processNode(node, nodeCode, context) {
+        this.eventDispatcher.dispatch({ type: 'process.node.before', node, context });
+        try {
+            const result = await nodeCode.process(context);
+            this.eventDispatcher.dispatch({ type: 'process.node.after', node, context, result });
+            return result;
+        }
+        catch (error) {
+            this.eventDispatcher.dispatch({
+                type: 'process.exception',
+                nodeCode,
+                context,
+                error: error instanceof Error ? error : new Error(String(error)),
+            });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=process-engine.js.map

package/dist/feral/engine/process-engine.js.map

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

package/dist/feral/errors.d.ts

@@ -0,0 +1,28 @@
+export declare class FeralError extends Error {
+    constructor(message: string);
+}
+export declare class InvalidConfigurationError extends FeralError {
+    constructor(message: string);
+}
+export declare class InvalidNodeCodeKeyError extends FeralError {
+    constructor(key: string);
+}
+export declare class InvalidNodeKeyError extends FeralError {
+    constructor(key: string);
+}
+export declare class MaximumNodeRunsError extends FeralError {
+    constructor(key: string, max: number);
+}
+export declare class MissingConfigurationValueError extends FeralError {
+    constructor(key: string);
+}
+export declare class ProcessError extends FeralError {
+    constructor(message: string);
+}
+export declare class ModelSchemaNotFoundError extends FeralError {
+    constructor(key: string);
+}
+export declare class AgentMaxIterationsError extends FeralError {
+    constructor(maxIterations: number);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/feral/errors.ts"],"names":[],"mappings":"AAIA,qBAAa,UAAW,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,yBAA0B,SAAQ,UAAU;gBACzC,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,uBAAwB,SAAQ,UAAU;gBACvC,GAAG,EAAE,MAAM;CAI1B;AAED,qBAAa,mBAAoB,SAAQ,UAAU;gBACnC,GAAG,EAAE,MAAM;CAI1B;AAED,qBAAa,oBAAqB,SAAQ,UAAU;gBACpC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAIvC;AAED,qBAAa,8BAA+B,SAAQ,UAAU;gBAC9C,GAAG,EAAE,MAAM;CAI1B;AAED,qBAAa,YAAa,SAAQ,UAAU;gBAC5B,OAAO,EAAE,MAAM;CAI9B;AAED,qBAAa,wBAAyB,SAAQ,UAAU;gBACxC,GAAG,EAAE,MAAM;CAI1B;AAED,qBAAa,uBAAwB,SAAQ,UAAU;gBACvC,aAAa,EAAE,MAAM;CAIpC"}

package/dist/feral/errors.js

@@ -0,0 +1,58 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Error Classes
+// ─────────────────────────────────────────────────────────────────────────────
+export class FeralError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FeralError';
+    }
+}
+export class InvalidConfigurationError extends FeralError {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidConfigurationError';
+    }
+}
+export class InvalidNodeCodeKeyError extends FeralError {
+    constructor(key) {
+        super(`Invalid NodeCode key: "${key}"`);
+        this.name = 'InvalidNodeCodeKeyError';
+    }
+}
+export class InvalidNodeKeyError extends FeralError {
+    constructor(key) {
+        super(`Invalid node key: "${key}"`);
+        this.name = 'InvalidNodeKeyError';
+    }
+}
+export class MaximumNodeRunsError extends FeralError {
+    constructor(key, max) {
+        super(`Node "${key}" exceeded maximum runs (${max})`);
+        this.name = 'MaximumNodeRunsError';
+    }
+}
+export class MissingConfigurationValueError extends FeralError {
+    constructor(key) {
+        super(`Missing required configuration value: "${key}"`);
+        this.name = 'MissingConfigurationValueError';
+    }
+}
+export class ProcessError extends FeralError {
+    constructor(message) {
+        super(message);
+        this.name = 'ProcessError';
+    }
+}
+export class ModelSchemaNotFoundError extends FeralError {
+    constructor(key) {
+        super(`Model schema not found: "${key}"`);
+        this.name = 'ModelSchemaNotFoundError';
+    }
+}
+export class AgentMaxIterationsError extends FeralError {
+    constructor(maxIterations) {
+        super(`Agent exceeded maximum iterations (${maxIterations})`);
+        this.name = 'AgentMaxIterationsError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/feral/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/feral/errors.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,MAAM,OAAO,UAAW,SAAQ,KAAK;IACjC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7B,CAAC;CACJ;AAED,MAAM,OAAO,yBAA0B,SAAQ,UAAU;IACrD,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC5C,CAAC;CACJ;AAED,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACnD,YAAY,GAAW;QACnB,KAAK,CAAC,0BAA0B,GAAG,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IAC1C,CAAC;CACJ;AAED,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IAC/C,YAAY,GAAW;QACnB,KAAK,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AAED,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAChD,YAAY,GAAW,EAAE,GAAW;QAChC,KAAK,CAAC,SAAS,GAAG,4BAA4B,GAAG,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AAED,MAAM,OAAO,8BAA+B,SAAQ,UAAU;IAC1D,YAAY,GAAW;QACnB,KAAK,CAAC,0CAA0C,GAAG,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IACjD,CAAC;CACJ;AAED,MAAM,OAAO,YAAa,SAAQ,UAAU;IACxC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC/B,CAAC;CACJ;AAED,MAAM,OAAO,wBAAyB,SAAQ,UAAU;IACpD,YAAY,GAAW;QACnB,KAAK,CAAC,4BAA4B,GAAG,GAAG,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,CAAC;CACJ;AAED,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACnD,YAAY,aAAqB;QAC7B,KAAK,CAAC,sCAAsC,aAAa,GAAG,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IAC1C,CAAC;CACJ"}

package/dist/feral/events/event-dispatcher.d.ts

@@ -0,0 +1,9 @@
+import type { ProcessEvent } from './events.js';
+export type EventHandler<T extends ProcessEvent = ProcessEvent> = (event: T) => void;
+export declare class EventDispatcher {
+    private handlers;
+    on<T extends ProcessEvent>(type: T['type'], handler: EventHandler<T>): void;
+    off<T extends ProcessEvent>(type: T['type'], handler: EventHandler<T>): void;
+    dispatch(event: ProcessEvent): void;
+}
+//# sourceMappingURL=event-dispatcher.d.ts.map

package/dist/feral/events/event-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/feral/events/event-dispatcher.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAErF,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAA0C;IAE1D,EAAE,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAK3E,GAAG,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAQ5E,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;CAMtC"}

package/dist/feral/events/event-dispatcher.js

@@ -0,0 +1,27 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Event Dispatcher
+// ─────────────────────────────────────────────────────────────────────────────
+export class EventDispatcher {
+    handlers = new Map();
+    on(type, handler) {
+        if (!this.handlers.has(type))
+            this.handlers.set(type, []);
+        this.handlers.get(type).push(handler);
+    }
+    off(type, handler) {
+        const list = this.handlers.get(type);
+        if (list) {
+            const idx = list.indexOf(handler);
+            if (idx >= 0)
+                list.splice(idx, 1);
+        }
+    }
+    dispatch(event) {
+        const list = this.handlers.get(event.type);
+        if (list) {
+            for (const handler of list)
+                handler(event);
+        }
+    }
+}
+//# sourceMappingURL=event-dispatcher.js.map

package/dist/feral/events/event-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-dispatcher.js","sourceRoot":"","sources":["../../../src/feral/events/event-dispatcher.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAMhF,MAAM,OAAO,eAAe;IAChB,QAAQ,GAAgC,IAAI,GAAG,EAAE,CAAC;IAE1D,EAAE,CAAyB,IAAe,EAAE,OAAwB;QAChE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,OAAuB,CAAC,CAAC;IAC3D,CAAC;IAED,GAAG,CAAyB,IAAe,EAAE,OAAwB;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI,EAAE,CAAC;YACP,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAuB,CAAC,CAAC;YAClD,IAAI,GAAG,IAAI,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,KAAmB;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,IAAI,EAAE,CAAC;YACP,KAAK,MAAM,OAAO,IAAI,IAAI;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;CACJ"}

package/dist/feral/events/events.d.ts

@@ -0,0 +1,41 @@
+import type { Process } from '../process/process.js';
+import type { ProcessNode } from '../process/node.js';
+import type { Context } from '../context/context.js';
+import type { Result } from '../result/result.js';
+import type { NodeCode } from '../node-code/node-code.js';
+export interface ProcessStartEvent {
+    type: 'process.start';
+    process: Process;
+    context: Context;
+}
+export interface ProcessEndEvent {
+    type: 'process.end';
+    process: Process;
+    context: Context;
+}
+export interface ProcessNodeBeforeEvent {
+    type: 'process.node.before';
+    node: ProcessNode;
+    context: Context;
+}
+export interface ProcessNodeAfterEvent {
+    type: 'process.node.after';
+    node: ProcessNode;
+    context: Context;
+    result: Result;
+}
+export interface ProcessExceptionEvent {
+    type: 'process.exception';
+    nodeCode: NodeCode;
+    context: Context;
+    error: Error;
+}
+export interface ProcessNodeNotifyEvent {
+    type: 'process.node.notify';
+    nodeCode: NodeCode;
+    context: Context;
+    notice: string;
+}
+export type ProcessEvent = ProcessStartEvent | ProcessEndEvent | ProcessNodeBeforeEvent | ProcessNodeAfterEvent | ProcessExceptionEvent | ProcessNodeNotifyEvent;
+export type EventType = ProcessEvent['type'];
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/feral/events/events.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAClB,iBAAiB,GACjB,eAAe,GACf,sBAAsB,GACtB,qBAAqB,GACrB,qBAAqB,GACrB,sBAAsB,CAAC;AAE7B,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC"}

package/dist/feral/events/events.js

@@ -0,0 +1,5 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Event Types
+// ─────────────────────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=events.js.map

package/dist/feral/events/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/feral/events/events.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF"}

package/dist/feral/events/subscribers/cycle-detection-subscriber.d.ts

@@ -0,0 +1,7 @@
+import type { EventDispatcher } from '../event-dispatcher.js';
+/**
+ * Creates a subscriber that detects infinite loops by counting
+ * how many times each node executes. Throws if a node exceeds maxRuns.
+ */
+export declare function createCycleDetectionSubscriber(maxRuns: number): (dispatcher: EventDispatcher) => void;
+//# sourceMappingURL=cycle-detection-subscriber.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-detection-subscriber.d.ts","sourceRoot":"","sources":["../../../../src/feral/events/subscribers/cycle-detection-subscriber.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;;GAGG;AACH,wBAAgB,8BAA8B,CAC1C,OAAO,EAAE,MAAM,GAChB,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAYvC"}

package/dist/feral/events/subscribers/cycle-detection-subscriber.js

@@ -0,0 +1,21 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Feral CCF — Cycle Detection Event Subscriber
+// ─────────────────────────────────────────────────────────────────────────────
+import { MaximumNodeRunsError } from '../../errors.js';
+/**
+ * Creates a subscriber that detects infinite loops by counting
+ * how many times each node executes. Throws if a node exceeds maxRuns.
+ */
+export function createCycleDetectionSubscriber(maxRuns) {
+    return (dispatcher) => {
+        const counts = new Map();
+        dispatcher.on('process.node.before', (e) => {
+            const count = (counts.get(e.node.key) ?? 0) + 1;
+            counts.set(e.node.key, count);
+            if (count > maxRuns) {
+                throw new MaximumNodeRunsError(e.node.key, maxRuns);
+            }
+        });
+    };
+}
+//# sourceMappingURL=cycle-detection-subscriber.js.map

package/dist/feral/events/subscribers/cycle-detection-subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-detection-subscriber.js","sourceRoot":"","sources":["../../../../src/feral/events/subscribers/cycle-detection-subscriber.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAIvD;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC1C,OAAe;IAEf,OAAO,CAAC,UAAU,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEzC,UAAU,CAAC,EAAE,CAAyB,qBAAqB,EAAE,CAAC,CAAC,EAAE,EAAE;YAC/D,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9B,IAAI,KAAK,GAAG,OAAO,EAAE,CAAC;gBAClB,MAAM,IAAI,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACxD,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { EventDispatcher } from '../event-dispatcher.js';
+/**
+ * Creates a subscriber that logs process lifecycle events.
+ */
+export declare function createLoggerSubscriber(logger: (msg: string) => void): (dispatcher: EventDispatcher) => void;
+//# sourceMappingURL=logger-subscriber.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger-subscriber.d.ts","sourceRoot":"","sources":["../../../../src/feral/events/subscribers/logger-subscriber.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAQ9D;;GAEG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC9B,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAevC"}